@besales/mcp 0.45.0 → 0.46.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/dist/resources/docs/crm-integration.md +3 -1
  2. package/dist/resources/workflows/compare-models.md +4 -3
  3. package/dist/resources/workflows/connect-crm-from-scratch.md +8 -0
  4. package/dist/schemas/mcp-tools.json +431 -30
  5. package/dist/tools/definitions/agent-design.d.ts +8 -0
  6. package/dist/tools/definitions/agent-design.js +3 -0
  7. package/dist/tools/definitions/agent-design.js.map +1 -1
  8. package/dist/tools/definitions/broadcast-analytics.d.ts +5 -4
  9. package/dist/tools/definitions/broadcast-analytics.js +14 -4
  10. package/dist/tools/definitions/broadcast-analytics.js.map +1 -1
  11. package/dist/tools/definitions/broadcast-scheduler.d.ts +14 -1
  12. package/dist/tools/definitions/broadcast-scheduler.js +64 -5
  13. package/dist/tools/definitions/broadcast-scheduler.js.map +1 -1
  14. package/dist/tools/definitions/crm-platform.js +20 -0
  15. package/dist/tools/definitions/crm-platform.js.map +1 -1
  16. package/dist/tools/definitions/follow-up.js +2 -0
  17. package/dist/tools/definitions/follow-up.js.map +1 -1
  18. package/dist/tools/definitions/getcourse-cold-welcome.d.ts +8 -0
  19. package/dist/tools/definitions/getcourse-cold-welcome.js +49 -3
  20. package/dist/tools/definitions/getcourse-cold-welcome.js.map +1 -1
  21. package/dist/tools/definitions/link-tracking.js +22 -0
  22. package/dist/tools/definitions/link-tracking.js.map +1 -1
  23. package/dist/tools/definitions/model-comparison.js +6 -3
  24. package/dist/tools/definitions/model-comparison.js.map +1 -1
  25. package/dist/tools/definitions/platform-setup.d.ts +29 -0
  26. package/dist/tools/definitions/platform-setup.js +14 -1
  27. package/dist/tools/definitions/platform-setup.js.map +1 -1
  28. package/dist/tools/definitions/shared.d.ts +120 -0
  29. package/dist/tools/definitions/shared.js +96 -0
  30. package/dist/tools/definitions/shared.js.map +1 -1
  31. package/dist/tools/definitions/trigger-contact-claims.d.ts +7 -0
  32. package/dist/tools/definitions/trigger-contact-claims.js +58 -0
  33. package/dist/tools/definitions/trigger-contact-claims.js.map +1 -0
  34. package/dist/tools/definitions.d.ts +70 -5
  35. package/dist/tools/definitions.js +2 -0
  36. package/dist/tools/definitions.js.map +1 -1
  37. package/dist/tools/registry-mapping-cases-core.js +11 -2
  38. package/dist/tools/registry-mapping-cases-core.js.map +1 -1
  39. package/dist/tools/trigger-action-config.js +4 -0
  40. package/dist/tools/trigger-action-config.js.map +1 -1
  41. package/dist/types/api-contract.gen.d.ts +976 -37
  42. package/docs/agent-usage-guide.full.ru.md +1 -0
  43. package/package.json +1 -1
@@ -206,7 +206,9 @@ enum CrmType {
206
206
 
207
207
  Чтобы сообщения от бота отображались в карточке сделки AmoCRM, нужен **отдельный Amojo-канал** (`chats.amojo.amocrm.ru`). AmoCRM требует обращения в техподдержку для получения `channelId` + `channelSecretKey`. Без этого канала бот может управлять сделкой, но переписка не появится в карточке.
208
208
 
209
- Endpoint в Animaly для привязки канала: `POST /api/amo-crm/channel-connect`.
209
+ **Заявку отдаёт бэкенд — `besales_crm_amocrm_channel_registration`.** Тул возвращает адрес вебхука воркспейса и готовый текст письма в поддержку AmoCRM (форма письма задана их документацией: 14 пронумерованных ответов), плюс `placeholders` — места, которые заполняет человек (номер учётной записи, Id интеграции, скриншот). Пересылай текст **дословно** и не собирай адрес сам: письмо регистрирует у AmoCRM адрес, на который потом идут входящие, поэтому пересказ или самодельный адрес дают канал, смотрящий не туда, — и заметно это становится только пропажей сообщений. Ту же заявку показывает страница AmoCRM в интерфейсе (`GET /api/amo-crm/channel-registration`) — источник один, копий текста нет.
210
+
211
+ Полученные от поддержки `channelId` + `channelSecretKey` привязываются в интерфейсе: `POST /api/amo-crm/channel-connect`. Через MCP этого шага нет.
210
212
 
211
213
  Чтобы сообщения от бота отображались в карточке сделки AmoCRM:
212
214
 
@@ -15,12 +15,13 @@
15
15
  сейчас). Выбери **~5 моделей** под use-case агента (продажи → живой тон;
16
16
  рассуждение → reasoning-модели; дёшево/много → budget). `defaultModelIds` —
17
17
  разумный набор по умолчанию, если оператор не назвал модели.
18
- - `available=false` → провайдер не настроен. claude/grok/deepseek/gemini/qwen идут
19
- через OpenRouter (нужен `OPENROUTER_API_KEY` на стороне prompt-services).
18
+ - `available=false` → провайдер не настроен. GLM и prefixed Qwen (`qwen/*`) идут
19
+ через OpenRouter (`OPENROUTER_API_KEY`), а `qwen3.8-flash` — напрямую через
20
+ Alibaba DashScope (`DASHSCOPE_API_KEY`) на стороне prompt-services.
20
21
 
21
22
  2. **`besales_model_comparison_run_start`** `{ agent_id, models?, dialogue_count? }`
22
23
  — запуск (async). По умолчанию `dialogue_count=5`; `models` опционально (тогда
23
- набор по умолчанию). До **21 модели** и **20 диалогов**, если оператор просит
24
+ набор по умолчанию). До **23 моделей** и **20 диалогов**, если оператор просит
24
25
  больше. Возвращает `run_id`.
25
26
 
26
27
  3. **`besales_model_comparison_get`** `{ agent_id, run_id }` — поллируй до
@@ -52,6 +52,14 @@ field-mapping / operators.
52
52
 
53
53
  Уникальность: один AmoCRM на workspace (`(workspaceId, AMOCRM)`).
54
54
 
55
+ **Follow-up шаг — переписка в карточке сделки.** `READY` даёт управление сделками и контактами,
56
+ но сообщения бота в карточке НЕ появятся, пока AmoCRM не зарегистрирует чат-канал: `channelId`
57
+ и `channelSecretKey` выдаёт только их техподдержка, по письму заданной формы. Адрес вебхука и
58
+ готовый текст письма отдаёт `besales_crm_amocrm_channel_registration` — пересылай их человеку
59
+ дословно, адрес сам не собирай. Ключи от поддержки он привяжет в интерфейсе
60
+ (`POST /api/amo-crm/channel-connect`); через MCP этого шага нет. Предупреди об этом шаге сразу,
61
+ как о local-app у Bitrix24, — иначе клиент считает настройку законченной, а переписки не видит.
62
+
55
63
  ## BITRIX24 — подключение
56
64
 
57
65
  Несекретные: `domain` (`<portal>.bitrix24.ru`), `client_id`. Секрет: `client_secret`.