pachca · lookinway · Jun 19, 2026 · Jun 19, 2026
diff --git a/apps/docs/content/guides/cli/installation.mdx b/apps/docs/content/guides/cli/installation.mdx
@@ -67,7 +67,7 @@ pachca doctor
 # ✔ Конфиг         ~/.config/pachca/config.toml (права: 600)
 # ✔ Профиль        personal (user: Иван Иванов)
 # ✔ Токен          действителен (11 скоупов)
-# ✔ CLI            v2026.6.0 (актуальная версия)
+# ✔ CLI            v2026.6.2 (актуальная версия)
 ```
 
 ## Обновление

diff --git a/apps/docs/content/updates/2026-06-19.md b/apps/docs/content/updates/2026-06-19.md
@@ -0,0 +1,14 @@
+---
+date: "2026-06-19"
+title: "Настройки входящего вебхука бота и сортировка в поиске сообщений"
+---
+
+При создании и редактировании бота теперь можно настроить его входящий вебхук: шаблон форматирования `template`, шаблонизатор `template_engine` (`liquid` или `mustache`), поле верификации `challenge_key` и показ превью ссылок `link_preview_enabled`. Эти же поля возвращаются в объекте бота. Подробнее о шаблонах и верификации — в гайде [Входящие вебхуки](/guides/incoming-webhooks).
+
+- [Новый бот](POST /bots)
+- [Редактирование бота](PUT /bots/{id})
+- [Информация о боте](GET /bots/{id})
+
+В поиске сообщений появился параметр `sort` — сортировка результатов: `created_at` (по дате создания, по умолчанию) или `relevance` (по релевантности).
+
+- [Поиск сообщений](GET /search/messages)
diff --git a/apps/docs/data/releases.json b/apps/docs/data/releases.json
@@ -1,4 +1,71 @@
 [
+  {
+    "product": "sdk",
+    "version": "1.0.24",
+    "date": "2026-06-19",
+    "changes": [
+      {
+        "type": "+",
+        "description": "У бота поля настроек входящего вебхука: `template`, `template_engine`, `challenge_key`, `link_preview_enabled`"
+      },
+      {
+        "type": "+",
+        "description": "Параметр `sort` в поиске сообщений (`GET /search/messages`): `created_at` или `relevance`"
+      },
+      {
+        "type": "-",
+        "description": "Python SDK: исправлен `NameError` в авто-ретрае при ответах `429` и `5xx`"
+      }
+    ]
+  },
+  {
+    "product": "generator",
+    "version": "1.1.7",
+    "date": "2026-06-19",
+    "changes": [
+      {
+        "type": "-",
+        "description": "Python: согласованы имя объявления и вызова jitter-функции в ретрае (раньше ретрай падал `NameError` на `429`/`5xx`)"
+      }
+    ]
+  },
+  {
+    "product": "cli",
+    "version": "2026.6.2",
+    "date": "2026-06-19",
+    "changes": [
+      {
+        "type": "+",
+        "command": "bots create",
+        "description": "`pachca bots create` — настройки входящего вебхука: `--template`, `--template-engine`, `--challenge-key`, `--link-preview-enabled`"
+      },
+      {
+        "type": "+",
+        "command": "bots update",
+        "description": "`pachca bots update` — настройки входящего вебхука: `--template`, `--template-engine`, `--challenge-key`, `--link-preview-enabled`"
+      },
+      {
+        "type": "+",
+        "command": "search list-messages",
+        "description": "`pachca search list-messages` — параметр `--sort` (сортировка: `created_at` или `relevance`)"
+      }
+    ]
+  },
+  {
+    "product": "n8n",
+    "version": "2.0.12",
+    "date": "2026-06-19",
+    "changes": [
+      {
+        "type": "+",
+        "description": "Bot: настройки входящего вебхука в операциях `Create`/`Update` и в ответе — `Template`, `Template Engine`, `Challenge Key`, `Link Preview Enabled`"
+      },
+      {
+        "type": "+",
+        "description": "Search: операция поиска сообщений — поле `Sort` (сортировка `Created At` или `Relevance`)"
+      }
+    ]
+  },
   {
     "product": "cli",
     "version": "2026.6.1",

diff --git a/apps/docs/public/.well-known/agent-skills/index.json b/apps/docs/public/.well-known/agent-skills/index.json
@@ -34,7 +34,7 @@
       "type": "skill-md",
       "description": "Pachca — управление ботами, вебхуки и превью ссылок. Используй этот скилл, когда пользователь хочет настроить бота, создать бота, настроить вебхуки, обработать вебхук, проверить подпись вебхука (X-Signature), обработать callback нажатия кнопки, создать дайджест-бота или настроить превью ссылок. НЕ для отправки обычных сообщений, показа форм или модальных окон.",
       "url": "/.well-known/skills/pachca-bots/SKILL.md",
-      "digest": "sha256:98e7723682caab3f1075167a59eb4f3103567cdf2cf47e46451a69f83e628140"
+      "digest": "sha256:af954e83c29598ff329cedbb8bb3c2a7488fc1a9a5e0ea9d28e0c474d0b527d3"
     },
     {
       "name": "pachca-forms",

diff --git a/apps/docs/public/.well-known/skills/index.json b/apps/docs/public/.well-known/skills/index.json
@@ -34,7 +34,7 @@
       "type": "skill-md",
       "description": "Pachca — управление ботами, вебхуки и превью ссылок. Используй этот скилл, когда пользователь хочет настроить бота, создать бота, настроить вебхуки, обработать вебхук, проверить подпись вебхука (X-Signature), обработать callback нажатия кнопки, создать дайджест-бота или настроить превью ссылок. НЕ для отправки обычных сообщений, показа форм или модальных окон.",
       "url": "/.well-known/skills/pachca-bots/SKILL.md",
-      "digest": "sha256:98e7723682caab3f1075167a59eb4f3103567cdf2cf47e46451a69f83e628140"
+      "digest": "sha256:af954e83c29598ff329cedbb8bb3c2a7488fc1a9a5e0ea9d28e0c474d0b527d3"
     },
     {
       "name": "pachca-forms",

diff --git a/apps/docs/public/.well-known/skills/pachca-bots/SKILL.md b/apps/docs/public/.well-known/skills/pachca-bots/SKILL.md
@@ -109,6 +109,7 @@ Help: `npx -y @pachca/cli --help` | Workflows: `npx -y @pachca/cli guide`
 
 - Rate limit: ~50 req/sec. On 429 — wait and retry.
 - `webhook.trigger_on`: allowed values — `commands` (Только на команды (триггер-слова) из commands), `all_messages` (На все сообщения в чатах, где есть бот), `unfurl` (На развёртывание ссылок (link previews))
+- `webhook.template_engine`: allowed values — `liquid` (Liquid — условия, циклы и фильтры), `mustache` (Mustache — простая подстановка без логики)
 - `limit`: max 50
 - Pagination: cursor-based (limit + cursor)
 

diff --git a/apps/docs/public/api/bots/create.md b/apps/docs/public/api/bots/create.md
@@ -31,6 +31,11 @@
     Значения: `commands` — Только на команды (триггер-слова) из commands, `all_messages` — На все сообщения в чатах, где есть бот, `unfurl` — На развёртывание ссылок (link previews)
   - `commands: array of string` — Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands. Пример: `["/task","/help"]`
   - `scopes: array of string` — Скоупы (права доступа) токена бота. Если не указано, бот получает набор по умолчанию.. Пример: `["messages:create"]`
+  - `template: string` — Шаблон форматирования входящего вебхука. Пример: `"Заказ от {{ client }} на сумму {{ amount }} ₽"`
+  - `template_engine: string` — Шаблонизатор для обработки шаблона входящего вебхука
+    Значения: `liquid` — Liquid — условия, циклы и фильтры, `mustache` — Mustache — простая подстановка без логики
+  - `challenge_key: string` — Название поля проверки для верификации входящего вебхука. Пример: `"challenge"`
+  - `link_preview_enabled: boolean` (default: true) — Показывать превью ссылок в сообщениях входящего вебхука. Пример: `true`
 
 ### Пример
 
@@ -49,7 +54,9 @@
     ],
     "scopes": [
       "messages:create"
-    ]
+    ],
+    "template": "Заказ от {{ client }} на сумму {{ amount }} ₽",
+    "challenge_key": "challenge"
   }
 }
 ```
@@ -74,7 +81,9 @@ curl "https://api.pachca.com/api/shared/v1/bots" \
     ],
     "scopes": [
       "messages:create"
-    ]
+    ],
+    "template": "Заказ от {{ client }} на сумму {{ amount }} ₽",
+    "challenge_key": "challenge"
   }
 }'
 ```
@@ -96,6 +105,11 @@ curl "https://api.pachca.com/api/shared/v1/bots" \
       Значения: `commands` — Только на команды (триггер-слова) из commands, `all_messages` — На все сообщения в чатах, где есть бот, `unfurl` — На развёртывание ссылок (link previews)
     - `commands: array of string` (required) — Команды бота (триггер-слова). Пример: `["/task"]`
     - `scopes: array of string` (required) — Скоупы (права доступа) токена бота. Пример: `["messages:create"]`
+    - `template: string` (required) — Шаблон форматирования входящего вебхука. `null`, если не задан.. Пример: `"Заказ от {{ client }} на сумму {{ amount }} ₽"`
+    - `template_engine: string` (required) — Шаблонизатор для обработки шаблона входящего вебхука
+      Значения: `liquid` — Liquid — условия, циклы и фильтры, `mustache` — Mustache — простая подстановка без логики
+    - `challenge_key: string` (required) — Название поля проверки для верификации входящего вебхука. `null`, если не задано.. Пример: `"challenge"`
+    - `link_preview_enabled: boolean` (required) — Показывать превью ссылок в сообщениях входящего вебхука. Пример: `true`
   - `access_token: string` (required) — Токен доступа бота. Выдаётся только при создании. Повторно получить токен можно только через интерфейс (вкладка «API» настроек бота).. Пример: `"bm90X2FfcmVhbF90b2tlbg"`
 
 **Пример ответа:**
@@ -117,7 +131,11 @@ curl "https://api.pachca.com/api/shared/v1/bots" \
       ],
       "scopes": [
         "messages:create"
-      ]
+      ],
+      "template": "Заказ от {{ client }} на сумму {{ amount }} ₽",
+      "template_engine": "liquid",
+      "challenge_key": "challenge",
+      "link_preview_enabled": true
     },
     "access_token": "bm90X2FfcmVhbF90b2tlbg"
   }

diff --git a/apps/docs/public/api/bots/get.md b/apps/docs/public/api/bots/get.md
@@ -43,6 +43,11 @@ curl "https://api.pachca.com/api/shared/v1/bots/1738816" \
       Значения: `commands` — Только на команды (триггер-слова) из commands, `all_messages` — На все сообщения в чатах, где есть бот, `unfurl` — На развёртывание ссылок (link previews)
     - `commands: array of string` (required) — Команды бота (триггер-слова). Пример: `["/task"]`
     - `scopes: array of string` (required) — Скоупы (права доступа) токена бота. Пример: `["messages:create"]`
+    - `template: string` (required) — Шаблон форматирования входящего вебхука. `null`, если не задан.. Пример: `"Заказ от {{ client }} на сумму {{ amount }} ₽"`
+    - `template_engine: string` (required) — Шаблонизатор для обработки шаблона входящего вебхука
+      Значения: `liquid` — Liquid — условия, циклы и фильтры, `mustache` — Mustache — простая подстановка без логики
+    - `challenge_key: string` (required) — Название поля проверки для верификации входящего вебхука. `null`, если не задано.. Пример: `"challenge"`
+    - `link_preview_enabled: boolean` (required) — Показывать превью ссылок в сообщениях входящего вебхука. Пример: `true`
 
 **Пример ответа:**
 
@@ -63,7 +68,11 @@ curl "https://api.pachca.com/api/shared/v1/bots/1738816" \
       ],
       "scopes": [
         "messages:create"
-      ]
+      ],
+      "template": "Заказ от {{ client }} на сумму {{ amount }} ₽",
+      "template_engine": "liquid",
+      "challenge_key": "challenge",
+      "link_preview_enabled": true
     }
   }
 }

diff --git a/apps/docs/public/api/bots/update-webhook.md b/apps/docs/public/api/bots/update-webhook.md
@@ -63,6 +63,11 @@ curl -X PUT "https://api.pachca.com/api/shared/v1/bot/webhook" \
       Значения: `commands` — Только на команды (триггер-слова) из commands, `all_messages` — На все сообщения в чатах, где есть бот, `unfurl` — На развёртывание ссылок (link previews)
     - `commands: array of string` (required) — Команды бота (триггер-слова). Пример: `["/task"]`
     - `scopes: array of string` (required) — Скоупы (права доступа) токена бота. Пример: `["messages:create"]`
+    - `template: string` (required) — Шаблон форматирования входящего вебхука. `null`, если не задан.. Пример: `"Заказ от {{ client }} на сумму {{ amount }} ₽"`
+    - `template_engine: string` (required) — Шаблонизатор для обработки шаблона входящего вебхука
+      Значения: `liquid` — Liquid — условия, циклы и фильтры, `mustache` — Mustache — простая подстановка без логики
+    - `challenge_key: string` (required) — Название поля проверки для верификации входящего вебхука. `null`, если не задано.. Пример: `"challenge"`
+    - `link_preview_enabled: boolean` (required) — Показывать превью ссылок в сообщениях входящего вебхука. Пример: `true`
 
 **Пример ответа:**
 
@@ -83,7 +88,11 @@ curl -X PUT "https://api.pachca.com/api/shared/v1/bot/webhook" \
       ],
       "scopes": [
         "messages:create"
-      ]
+      ],
+      "template": "Заказ от {{ client }} на сумму {{ amount }} ₽",
+      "template_engine": "liquid",
+      "challenge_key": "challenge",
+      "link_preview_enabled": true
     }
   }
 }

diff --git a/apps/docs/public/api/bots/update.md b/apps/docs/public/api/bots/update.md
@@ -40,6 +40,11 @@
     Значения: `commands` — Только на команды (триггер-слова) из commands, `all_messages` — На все сообщения в чатах, где есть бот, `unfurl` — На развёртывание ссылок (link previews)
   - `commands: array of string` — Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands. Пример: `["/task","/help"]`
   - `scopes: array of string` — Скоупы (права доступа) токена бота. Если не указано, бот получает набор по умолчанию.. Пример: `["messages:create"]`
+  - `template: string` — Шаблон форматирования входящего вебхука. Пример: `"Заказ от {{ client }} на сумму {{ amount }} ₽"`
+  - `template_engine: string` — Шаблонизатор для обработки шаблона входящего вебхука
+    Значения: `liquid` — Liquid — условия, циклы и фильтры, `mustache` — Mustache — простая подстановка без логики
+  - `challenge_key: string` — Название поля проверки для верификации входящего вебхука. Пример: `"challenge"`
+  - `link_preview_enabled: boolean` (default: true) — Показывать превью ссылок в сообщениях входящего вебхука. Пример: `true`
 
 ### Пример
 
@@ -58,7 +63,9 @@
     ],
     "scopes": [
       "messages:create"
-    ]
+    ],
+    "template": "Заказ от {{ client }} на сумму {{ amount }} ₽",
+    "challenge_key": "challenge"
   }
 }
 ```
@@ -83,7 +90,9 @@ curl -X PUT "https://api.pachca.com/api/shared/v1/bots/1738816" \
     ],
     "scopes": [
       "messages:create"
-    ]
+    ],
+    "template": "Заказ от {{ client }} на сумму {{ amount }} ₽",
+    "challenge_key": "challenge"
   }
 }'
 ```
@@ -105,6 +114,11 @@ curl -X PUT "https://api.pachca.com/api/shared/v1/bots/1738816" \
       Значения: `commands` — Только на команды (триггер-слова) из commands, `all_messages` — На все сообщения в чатах, где есть бот, `unfurl` — На развёртывание ссылок (link previews)
     - `commands: array of string` (required) — Команды бота (триггер-слова). Пример: `["/task"]`
     - `scopes: array of string` (required) — Скоупы (права доступа) токена бота. Пример: `["messages:create"]`
+    - `template: string` (required) — Шаблон форматирования входящего вебхука. `null`, если не задан.. Пример: `"Заказ от {{ client }} на сумму {{ amount }} ₽"`
+    - `template_engine: string` (required) — Шаблонизатор для обработки шаблона входящего вебхука
+      Значения: `liquid` — Liquid — условия, циклы и фильтры, `mustache` — Mustache — простая подстановка без логики
+    - `challenge_key: string` (required) — Название поля проверки для верификации входящего вебхука. `null`, если не задано.. Пример: `"challenge"`
+    - `link_preview_enabled: boolean` (required) — Показывать превью ссылок в сообщениях входящего вебхука. Пример: `true`
 
 **Пример ответа:**
 
@@ -125,7 +139,11 @@ curl -X PUT "https://api.pachca.com/api/shared/v1/bots/1738816" \
       ],
       "scopes": [
         "messages:create"
-      ]
+      ],
+      "template": "Заказ от {{ client }} на сумму {{ amount }} ₽",
+      "template_engine": "liquid",
+      "challenge_key": "challenge",
+      "link_preview_enabled": true
     }
   }
 }