@besales/mcp 1.0.0-beta.2 → 1.0.0-beta.4

package/dist/schemas/mcp-tools.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "besales-mcp Tool Definitions",
   "version": "1.2.0-draft",
-  "lastUpdated": "2026-09-11",
+  "lastUpdated": "2026-11-09",
   "description": "MCP tool schemas для besales-mcp npm package. Активная v2-поверхность содержит ICP, Sandbox, Knowledge, prompt operations и stateless Platform Setup Bridge. Setup Pipeline session tools сохранены как Phase 4+ future design, но не входят в active toolset.",
   "executionModes": {
     "summary": "Каждая active LLM-операция имеет 2 MCP tools: get_instructions + submit. Claude локально между tools выполняет LLM-вызовы своими моделями. Auto-detection через JWT scope mcp:* → external default.",
@@ -3872,7 +3872,7 @@
     },
     {
       "name": "besales_trigger_upsert",
-      "description": "Create trigger, patch trigger metadata, or replace its full action set (replace_actions=true) for an agent. Without replace_actions existing actions are not bulk-replaced; webhook, operator, silent AI, CRM, calendar, outbound and follow-up actions require explicit_confirmation. В ответе вместо самих шагов и условий приходит их количество (actionsCount / activationsCount): эхо повторяло отправленное целиком и уносило контекст на каждой правке, а правят их десятками подряд. Текущий состав читается через besales_platform_context_get. Включённое действие, сохраняющее почту, названную клиентом (шаг SAVE_CONTACT_INFO с полем email ровно {{slots.email}}), записывается только с allow_repeat_in_conversation=true, иначе 422: первая попытка заняла бы право до закрытия переписки, и исправленный адрес сохранить было бы нельзя. Действию, записывающему значение из переписки (поле CRM без шаблона — input_type ai_text или ai_dropdown; заметка с input_type=ai_text; переменная с value_source=MODEL; поле школы из ai_fields с вариантами options), повтор рекомендован, но не обязателен: частичное извлечение занимает право, и названное позже без allow_repeat_in_conversation=true не запишется. В getcourseCreateDealConfig для GETCOURSE_CREATE_DEAL можно передать reuse_open_invoice=true: переиспользуется только открытый счёт с продуктом из предложения шага; нового заказа нет. Срок давности счёта: по умолчанию не старше 14 суток; open_invoice_age=ANY_AGE — без срока, WITHIN_MAX_AGE — 14 суток. Отсутствующий ключ получает 14 суток, в том числе у перенесённых шагов; ключ умолчания при сохранении удаляется. Количество открытых счетов считается в пределах выбранного срока. ru/en/es/id/uz используют подпись поля и двух вариантов на языке пользователя. Упорядоченный список уникальных ответственных сотрудников своего подключения amoCRM. Пропуск ключа сохраняет прежний пул цепочки; [] или null снимают. При полной замене действий передай прочитанный пул явно. Ссылки — UUID из каталога операторов CRM, а не номера пользователей. Голосовые шаги: канон stepType=VOICE_INITIATE_OUTBOUND_CALL / VOICE_TRANSFER_CALL и config. Старые initiateOutboundCall/initiateOutboundCallConfig и transferCall/transferCallConfig принимаются как ввод. Конфликты и непустой чужой конфиг отклоняются до HTTP; снимается только служебное эхо верхнего уровня, вложенные поля сохраняются. Редактирование не выполняет звонок или перевод. При replace_actions=true явно сохраняй обе оси SILENT_MODE: config.silence_bot и config.silence_followups. Пропущенная ось получает true, а не прежнее значение. Для старого конверта — silenceBot/silenceFollowUps.",
+      "description": "Create trigger, patch trigger metadata, or replace its full action set (replace_actions=true) for an agent. Without replace_actions existing actions are not bulk-replaced; webhook, operator, silent AI, CRM, calendar, outbound and follow-up actions require explicit_confirmation. В ответе вместо самих шагов и условий приходит их количество (actionsCount / activationsCount): эхо повторяло отправленное целиком и уносило контекст на каждой правке, а правят их десятками подряд. Текущий состав читается через besales_platform_context_get. Включённое действие, сохраняющее почту, названную клиентом (шаг SAVE_CONTACT_INFO с полем email ровно {{slots.email}}), записывается только с allow_repeat_in_conversation=true, иначе 422: первая попытка заняла бы право до закрытия переписки, и исправленный адрес сохранить было бы нельзя. Действию, записывающему значение из переписки (поле CRM без шаблона — input_type ai_text или ai_dropdown; заметка с input_type=ai_text; переменная с value_source=MODEL; поле школы из ai_fields с вариантами options), повтор рекомендован, но не обязателен: частичное извлечение занимает право, и названное позже без allow_repeat_in_conversation=true не запишется. В getcourseCreateDealConfig для GETCOURSE_CREATE_DEAL можно передать reuse_open_invoice=true: переиспользуется только открытый счёт с продуктом из предложения шага; нового заказа нет. Срок давности счёта: по умолчанию не старше 14 суток; open_invoice_age=ANY_AGE — без срока, WITHIN_MAX_AGE — 14 суток. Отсутствующий ключ получает 14 суток, в том числе у перенесённых шагов; ключ умолчания при сохранении удаляется. Количество открытых счетов считается в пределах выбранного срока. ru/en/es/id/uz используют подпись поля и двух вариантов на языке пользователя. Упорядоченный список уникальных ответственных сотрудников своего подключения amoCRM. Пропуск ключа сохраняет прежний пул цепочки; [] или null снимают. При полной замене действий передай прочитанный пул явно. Ссылки — UUID из каталога операторов CRM, а не номера пользователей. Голосовые шаги: канон stepType=VOICE_INITIATE_OUTBOUND_CALL / VOICE_TRANSFER_CALL и config. Старые initiateOutboundCall/initiateOutboundCallConfig и transferCall/transferCallConfig принимаются как ввод. Конфликты и непустой чужой конфиг отклоняются до HTTP; снимается только служебное эхо верхнего уровня, вложенные поля сохраняются. Редактирование не выполняет звонок или перевод. При replace_actions=true явно сохраняй обе оси SILENT_MODE: config.silence_bot и config.silence_followups. Пропущенная ось получает true, а не прежнее значение. Для старого конверта — silenceBot/silenceFollowUps. Для автоматического запуска по событию передай trigger вместо scope и строкового condition верхнего уровня. NEW_CONVERSATION — начало новой переписки; CONTACT_MESSAGE — сообщение клиента; OPERATOR_REPLY — ответ живого оператора; AGENT_REPLY — после ответа бота клиенту, пустой или молчаливый ход события не даёт. Шаги событийного триггера статичные: без arguments, {{args.*}} и полей «заполняет ИИ» — автозапуск не получает значений ИИ. Для шагов с оператором или отправкой требуется explicit_confirmation=true. Горизонт allow_repeat_in_conversation — ПЕРЕПИСКА. В trigger.condition можно использовать conversation.lastActionFailureCode, если сервер его знает.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -4089,38 +4089,127 @@
                   "additionalProperties": true
                 },
                 "callOperatorConfig": {
-                  "type": "object",
-                  "properties": {
-                    "taskText": {
-                      "anyOf": [
-                        {
-                          "maxLength": 500,
-                          "type": "string"
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "taskText": {
+                          "anyOf": [
+                            {
+                              "maxLength": 500,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Свой текст задачи в CRM, до 500 знаков (кодовых точек Unicode); составной эмодзи может занимать несколько знаков (🇷🇺 — два). Передаётся буквально, без подстановки переменных. Пустой или пробельный текст включает штатный. Не передавай поле, чтобы сохранить прежний текст; null очищает его; строка заменяет."
                         },
-                        {
-                          "type": "null"
+                        "taskDueHours": {
+                          "anyOf": [
+                            {
+                              "maximum": 720,
+                              "minimum": 1,
+                              "type": "integer"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Срок задачи в CRM: целое число от 1 до 720 часов от момента передачи оператору. При запасном пути и повторе срок не сдвигается. Не передавай поле, чтобы сохранить прежний срок; null очищает его; число заменяет. Без своего срока amoCRM — момент передачи, Bitrix24 — через 24 часа."
                         }
-                      ],
-                      "description": "Свой текст задачи в CRM, до 500 знаков (кодовых точек Unicode); составной эмодзи может занимать несколько знаков (🇷🇺 — два). Передаётся буквально, без подстановки переменных. Пустой или пробельный текст включает штатный. Не передавай поле, чтобы сохранить прежний текст; null очищает его; строка заменяет."
+                      },
+                      "additionalProperties": {}
                     },
-                    "taskDueHours": {
-                      "anyOf": [
-                        {
-                          "maximum": 720,
-                          "minimum": 1,
-                          "type": "integer"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "description": "Срок задачи в CRM: целое число от 1 до 720 часов от момента передачи оператору. При запасном пути и повторе срок не сдвигается. Не передавай поле, чтобы сохранить прежний срок; null очищает его; число заменяет. Без своего срока amoCRM — момент передачи, Bitrix24 — через 24 часа."
+                    {
+                      "type": "null"
                     }
-                  },
-                  "additionalProperties": {}
+                  ]
                 },
                 "config": {
-                  "type": "object",
+                  "anyOf": [
+                    {},
+                    {
+                      "type": "object",
+                      "properties": {
+                        "task_text": {},
+                        "task_due_hours": {},
+                        "assign_responsible_operator_ids": {
+                          "anyOf": [
+                            {},
+                            {
+                              "description": "Упорядоченный список уникальных ответственных сотрудников своего подключения amoCRM. Пропуск ключа сохраняет прежний пул цепочки; [] или null снимают. При полной замене действий передай прочитанный пул явно. Ссылки — UUID из каталога операторов CRM, а не номера пользователей.",
+                              "anyOf": [
+                                {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string",
+                                    "format": "uuid",
+                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+                                  }
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "uniqueItems": true
+                            }
+                          ]
+                        },
+                        "assignResponsibleOperatorIds": {
+                          "anyOf": [
+                            {},
+                            {
+                              "description": "Упорядоченный список уникальных ответственных сотрудников своего подключения amoCRM. Пропуск ключа сохраняет прежний пул цепочки; [] или null снимают. При полной замене действий передай прочитанный пул явно. Прежняя форма: положительные целые номера пользователей amoCRM; API преобразует их в ссылки каталога.",
+                              "anyOf": [
+                                {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "integer",
+                                    "exclusiveMinimum": 0,
+                                    "maximum": 9007199254740991
+                                  }
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "uniqueItems": true
+                            }
+                          ]
+                        },
+                        "extra": {
+                          "anyOf": [
+                            {},
+                            {
+                              "type": "object",
+                              "properties": {
+                                "assignResponsibleOperatorIds": {
+                                  "description": "Упорядоченный список уникальных ответственных сотрудников своего подключения amoCRM. Пропуск ключа сохраняет прежний пул цепочки; [] или null снимают. При полной замене действий передай прочитанный пул явно. Прежняя форма: положительные целые номера пользователей amoCRM; API преобразует их в ссылки каталога.",
+                                  "anyOf": [
+                                    {
+                                      "type": "array",
+                                      "items": {
+                                        "type": "integer",
+                                        "exclusiveMinimum": 0,
+                                        "maximum": 9007199254740991
+                                      }
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ],
+                                  "uniqueItems": true
+                                }
+                              },
+                              "additionalProperties": false
+                            }
+                          ]
+                        }
+                      },
+                      "additionalProperties": {}
+                    }
+                  ],
                   "properties": {
                     "task_text": {
                       "anyOf": [
@@ -4210,12 +4299,10 @@
                       },
                       "additionalProperties": false
                     }
-                  },
-                  "additionalProperties": {}
+                  }
                 },
                 "type": {
-                  "type": "string",
-                  "description": "Совместимое имя типа действия."
+                  "type": "string"
                 },
                 "crmMoveStage": {
                   "type": "object",
@@ -4891,6 +4978,58 @@
           "run_once_per_contact": {
             "description": "Прежняя однократность: true переводится в allow_repeat_in_conversation=false. После закрытия переписки право возвращается; повтор в CRM возможен. Не смешивайте с новым именем.",
             "type": "boolean"
+          },
+          "trigger": {
+            "type": "object",
+            "properties": {
+              "event": {
+                "type": "string",
+                "enum": [
+                  "NEW_CONVERSATION",
+                  "CONTACT_MESSAGE",
+                  "OPERATOR_REPLY",
+                  "AGENT_REPLY"
+                ]
+              },
+              "condition": {
+                "type": "object",
+                "properties": {
+                  "schema_version": {
+                    "type": "number",
+                    "const": 1
+                  },
+                  "combinator": {
+                    "type": "string",
+                    "enum": [
+                      "AND",
+                      "OR"
+                    ]
+                  },
+                  "rules": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {},
+                      "additionalProperties": {}
+                    }
+                  },
+                  "preset": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "schema_version",
+                  "combinator",
+                  "rules"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "event"
+            ],
+            "additionalProperties": false,
+            "description": "Для автоматического запуска по событию передай trigger вместо scope и строкового condition верхнего уровня. NEW_CONVERSATION — начало новой переписки; CONTACT_MESSAGE — сообщение клиента; OPERATOR_REPLY — ответ живого оператора; AGENT_REPLY — после ответа бота клиенту, пустой или молчаливый ход события не даёт. Шаги событийного триггера статичные: без arguments, {{args.*}} и полей «заполняет ИИ» — автозапуск не получает значений ИИ. Для шагов с оператором или отправкой требуется explicit_confirmation=true. Горизонт allow_repeat_in_conversation — ПЕРЕПИСКА. В trigger.condition можно использовать conversation.lastActionFailureCode, если сервер его знает."
           }
         }
       }
@@ -8492,7 +8631,7 @@
           "continuation": {
             "type": "boolean",
             "const": true,
-            "description": "Явное продолжение по contacts; только literal true, отсутствие сохраняет обычный режим. Сначала preview с теми же текстом, сегментом, продуктом и каналами, затем подтверждённый start."
+            "description": "Только по явной просьбе человека продолжить обращение по файлу contacts. Сначала preview с теми же текстом, сегментом, продуктом и каналами, затем подтверждённый start. Не выбирать автоматически по alreadyWelcomed."
           }
         }
       }
@@ -8642,12 +8781,12 @@
           "continuation": {
             "type": "boolean",
             "const": true,
-            "description": "Явное продолжение по contacts; только literal true, отсутствие сохраняет обычный режим. Сначала preview с теми же текстом, сегментом, продуктом и каналами, затем подтверждённый start."
+            "description": "Только по явной просьбе человека продолжить обращение по файлу contacts. Сначала preview с теми же текстом, сегментом, продуктом и каналами, затем подтверждённый start. Не выбирать автоматически по alreadyWelcomed."
           },
           "idempotency_key": {
             "type": "string",
             "format": "uuid",
-            "description": "UUID намерения. Сохрани до отправки вместе с подтверждёнными параметрами; повтор того же запуска использует тот же ключ. Передаётся заголовком Idempotency-Key. Отсутствие сохраняет прежний вызов без ключа."
+            "description": "UUID намерения: сохрани до отправки с подтверждёнными файлом и текстом. Повтор того же запуска — с тем же ключом; новый подтверждённый запуск — с новым. Передаётся заголовком Idempotency-Key."
           }
         }
       }
@@ -11003,6 +11142,45 @@
         }
       }
     },
+    {
+      "name": "besales_crm_bitrix24_deal_tab_get",
+      "description": "Состояние CRM-регистрации вкладки AI Агенты в сделке Bitrix24: NOT_ATTEMPTED, BOUND или FAILED с безопасной reason и checkedAt. BOUND — последнее наблюдение placement.get, не проверка браузера. Scope: read:crm.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "crm_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "crm_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_crm_bitrix24_deal_tab_register",
+      "description": "Повторить регистрацию вкладки AI Агенты без переустановки приложения. Адрес берётся из окружения сервера, токен и домен — из сохранённого подключения. Нужны CRM_MANAGE и write:crm. HTTP 200 с FAILED не означает успех; 409 BITRIX24_DEAL_TAB_BUSY означает, что нужно повторить позже.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "crm_id",
+          "acknowledge_external_side_effect"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "crm_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "acknowledge_external_side_effect": {
+            "type": "boolean",
+            "const": true
+          }
+        }
+      }
+    },
     {
       "name": "besales_crm_pipeline_list",
       "description": "Список v2 CRM pipelines со статусами; перед чтением выполняется best-effort sync, include_deleted поддерживается. Scope: read:crm. Ответ: data + cursor. Непустой cursor означает, что показан НЕ весь перечень воронок; вызов без limit/cursor при неполной выдаче вернёт ошибку — недостающая воронка = молча суженный охват задачи.",
@@ -12856,7 +13034,7 @@
           "outreach": {
             "type": "string",
             "const": "true",
-            "description": "Только сохранённый факт начала холодного обращения, не подтверждение доставки; старая история может быть неполной. Дата outreachInitiatedAt — ISO либо null."
+            "description": "Люди с сохранённым фактом начала холодного обращения; это допуск к отправке, а не подтверждение доставки. outreachInitiatedAt — ISO-момент либо null; старая история может быть неполной."
           }
         }
       }
@@ -13291,6 +13469,41 @@
         ]
       }
     },
+    {
+      "name": "besales_dialogue_reprocess_last_inbound",
+      "description": "Заново ответить ботом на последнее сообщение клиента в одном или нескольких диалогах (1–50). Новой строки входящего в переписке нет; клиент получит настоящее сообщение. Применяй после сбоя, когда клиент ещё не видел ответа. Не применяй, если ответ уже доставлен, бот заглушён или ход идёт: сервер откажет. Нужно явное «да» человека и explicit_confirmation=true. Только администратор с управлением каналом; область run:conversation-reprocess входит в mcp:*. Запросы последовательные, 429 останавливает пакет. При неизвестном исходе сначала найди квитанцию/статус и проверь переписку, не повторяй отправку автоматически. ENQUEUED означает очередь, а не доставку.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Рабочая область; без поля используется выбранное подключение."
+          },
+          "conversation_ids": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 50,
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "format": "uuid"
+            },
+            "description": "Идентификаторы диалогов без дублей, в порядке обработки."
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Только после явного «да» человека: каждый клиент получит настоящее сообщение бота."
+          }
+        },
+        "required": [
+          "conversation_ids",
+          "explicit_confirmation"
+        ],
+        "additionalProperties": false
+      }
+    },
     {
       "name": "besales_broadcast_analytics_get",
       "description": "Отчёты страницы аналитики рассылок: выбор отчёта полем report (16 значений). Scope: read:analytics. Персональные отчёты recipients, recipients+notSent (recipient_metric=notSent), deals, action_failures, indirect_payments, recent_leads, payment_candidates, registration_intake требуют дополнительно read:conversations: ответ несёт имена и идентификаторы людей, номера заказов или ссылки на карточки. Агрегатные отчёты summary, cohorts, skip_reasons, response_windows, insights, data_quality, segments_catalog, funnel_products, payment_candidates_summary доступны с read:analytics. Для report=response_windows в conversionCycles поле cut различает overall (серверный итог), product и segment; пустой ключ в разрезе не является итогом. Строку «Итого» берите только по cut=overall, медианы строк не складывайте. registration_intake — сверка регистраций: состояние, всего/вошли/не вошли, группы, исход приёма и приветствия, воронка, момент, номера заказов, ссылка на живой контакт. Один канал, ограниченный период, view=period; фильтр funnel допустим. Поздние записи могут появиться позже; недошедший заказ без решения при двух каналах одной воронки виден обоим. Отчёт registration_intake также возвращает персональные данные клиентов воркспейса: имя, контакт и номера заказов. У регистраций применяется только view=period; entry/cohort отвергаются. Валютный фильтр currency: ISO 4217 или UNKNOWN. Точные десятичные строки сохраняются без округления; moneyTotalsByCurrency показывает раздельные итоги по валютам, currencyAssumed отмечает предположение. Для segments_catalog, funnel_products, payment_candidates и payment_candidates_summary валютный фильтр недоступен. Список и сводка оплат поддерживают platform_id, funnel, остальные общие измерения и include_archived. Период оплат передаётся как periodMode: без mode/days всё время; mode=days без days — 30 дней. mode=range принимает открытый диапазон: только from, только to или обе границы; если заданы обе, to не раньше from. Параметры должны поддерживаться выбранным report; payment_candidates: page_size не больше 100. payment_view можно сочетать с payment_status/payment_eligibility: API отдаёт приоритет view.",
@@ -18151,6 +18364,357 @@
           }
         ]
       }
+    },
+    {
+      "name": "besales_platform_telegram_personal_restriction_check",
+      "description": "Проверить ограничения всех номеров канала (all:true) или выбранного списка (account_ids, 1–100). Требует manage:channels. Номер обращается только к системному боту @SpamBot; людям сообщения не отправляются, подтверждение не требуется. Ответ по каждому номеру: исход постановки и taskId принятой задачи. QUEUED означает очередь, не итог проверки. Используй стабильный idempotency_key. При неизвестном исходе сначала прочитай задачу или доступность номеров; новый ключ автоматически не создавай.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "idempotency_key"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "account_ids": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 100,
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
+            }
+          },
+          "all": {
+            "type": "boolean",
+            "const": true
+          },
+          "idempotency_key": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "pattern": "^[!-~]+$"
+          }
+        },
+        "oneOf": [
+          {
+            "required": [
+              "account_ids"
+            ],
+            "not": {
+              "required": [
+                "all"
+              ]
+            }
+          },
+          {
+            "required": [
+              "all"
+            ],
+            "not": {
+              "required": [
+                "account_ids"
+              ]
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_restriction_appeal",
+      "description": "Подать апелляцию об ограничениях от всех номеров канала (all:true) или выбранного списка (account_ids, 1–100). Требует manage:channels. text необязателен: по умолчанию система подбирает английский текст из набора разных апелляций со спинтаксом (18 шаблонов, 144 раскрытия), отдельно для каждого номера. Свой text — 1–500 знаков после удаления пробелов по краям. Выбор сохраняется для повтора с тем же ключом; ответ содержит appealTemplateId, без текста. Жалоба в @SpamBot подаётся вручную, не чаще раза в сутки на номер; необратима — перед вызовом покажи человеку номер и свой text, если он задан (без text система подберёт английский шаблон сама), и получи явное согласие (explicit_confirmation: true). Автоматическая подача сейчас выключена. Только после явного согласия человека передай explicit_confirmation:true: каждый выбранный номер отправит текст системному боту @SpamBot от своего имени; отменить отправку нельзя. Не чаще раза в UTC-сутки на номер. Ответ по каждому номеру: QUEUED/taskId, FAILED или SKIPPED с причиной (нет ограничений либо суточный предел). При неизвестном исходе сначала прочитай задачу или доступность номеров; новый ключ автоматически не создавай, сохраняй ключ и аргументы прежнего намерения.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "idempotency_key",
+          "explicit_confirmation"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "account_ids": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 100,
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
+            }
+          },
+          "all": {
+            "type": "boolean",
+            "const": true
+          },
+          "idempotency_key": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "pattern": "^[!-~]+$"
+          },
+          "text": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 500,
+            "pattern": "\\S",
+            "description": "Необязательный текст: 1–500 знаков после удаления пробелов по краям. Без text система подбирает разные английские апелляции для каждого номера."
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Явное согласие человека на необратимую отправку апелляции от номера."
+          }
+        },
+        "oneOf": [
+          {
+            "required": [
+              "account_ids"
+            ],
+            "not": {
+              "required": [
+                "all"
+              ]
+            }
+          },
+          {
+            "required": [
+              "all"
+            ],
+            "not": {
+              "required": [
+                "account_ids"
+              ]
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_operational_task_get",
+      "description": "Прочитать состояние проверки ограничений или апелляции по task_id. Требует read:channels. Возвращает состояние задачи и restrictionStatus — текущий статус ограничений номера, прочитанный после задачи; это не исторический снимок её исхода. Успешное выполнение не означает отсутствие ограничений, более поздние действия могли изменить номер. null означает недоступный статус номера. Ничего не отправляет.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "task_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "task_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_accounts",
+      "description": "Прочитать таблицу личных номеров Telegram канала. Требует read:channels. Фильтры search, status, page, limit; summary — сводка до отбора, pagination — листание, truncated — неполное чтение. campaign и состояние строки показывают участие и ступень лесенки; warmup.active/reason/label/until/optedOut — отдельная пометка прогрева, он не блокирует рассылку. restriction — ограничение, последняя проверка и жалоба; autoAppealNotBefore — только время из ответа, автоматическая подача сейчас выключена. Лесенка 3, 4, 5, 6, 7 с первого дня рассылки; прогрев идёт параллельно 5 дней и включается сам при подключении номера, если его не выключить вручную.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "search": {
+            "type": "string",
+            "maxLength": 200
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "BANNED",
+              "CONNECTED",
+              "CONNECTING",
+              "DISCONNECTED",
+              "ERROR",
+              "NEEDS_CODE",
+              "NEEDS_PASSWORD",
+              "PENDING_VERIFICATION",
+              "SESSION_UPLOADED"
+            ]
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_warmup",
+      "description": "Прочитать настройки и аналитику прогрева личных номеров Telegram. Требует read:channels. Сообщения прогрева идут только между своими номерами. Лесенка 3, 4, 5, 6, 7 с первого дня рассылки; прогрев идёт параллельно 5 дней и включается сам при подключении номера, если его не выключить вручную.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_warmup_update",
+      "description": "Частично изменить настройки прогрева личных номеров Telegram. Требует manage:channels. Передавай только изменяемые поля; пропуск сохраняет прежнее значение. Подтверждение не требуется: сообщения прогрева идут только между своими номерами. Лесенка 3, 4, 5, 6, 7 с первого дня рассылки; прогрев идёт параллельно 5 дней и включается сам при подключении номера, если его не выключить вручную.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "enabled": {
+            "type": "boolean"
+          },
+          "images_enabled": {
+            "type": "boolean"
+          },
+          "messages_per_day": {
+            "type": "integer"
+          },
+          "time_variation_minutes": {
+            "type": "integer"
+          },
+          "response_delay_min_minutes": {
+            "type": "integer"
+          },
+          "response_delay_max_minutes": {
+            "type": "integer"
+          },
+          "image_chance_percent": {
+            "type": "integer"
+          },
+          "posts_to_react": {
+            "type": "integer"
+          },
+          "max_accounts_per_channel_reaction": {
+            "type": "integer"
+          },
+          "pairing_hour_utc": {
+            "type": "integer"
+          },
+          "hourly_interval_hours": {
+            "type": "number"
+          },
+          "reaction_types": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 100
+          },
+          "reaction_hours_utc": {
+            "type": "array",
+            "items": {
+              "type": "integer"
+            },
+            "maxItems": 24
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_account_warmup",
+      "description": "Включить или выключить прогрев одного личного номера Telegram. Требует manage:channels. is_warming_up:false означает выход номера из автоматического прогрева до ручного включения; true снимает ручной отказ. Подтверждение не требуется: сообщения только между своими номерами. Лесенка 3, 4, 5, 6, 7 с первого дня рассылки; прогрев идёт параллельно 5 дней и включается сам при подключении номера, если его не выключить вручную.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "account_id",
+          "is_warming_up"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "account_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "is_warming_up": {
+            "type": "boolean"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_ramp",
+      "description": "Прочитать, включена ли лесенка новых личных номеров Telegram в рабочей области. Требует read:channels. Возвращает только этот флаг. Лесенка 3, 4, 5, 6, 7 с первого дня рассылки; прогрев идёт параллельно 5 дней и включается сам при подключении номера, если его не выключить вручную.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
     }
   ],
   "resources": [
@@ -18390,16 +18954,16 @@
     }
   ],
   "summary": {
-    "total_tools": 292,
+    "total_tools": 303,
     "tools_by_category": {
       "workspace_and_help": 18,
       "agent_configuration": 15,
       "prompt_and_testing": 40,
       "icp": 11,
       "knowledge_and_content": 52,
-      "crm_and_data_sources": 30,
-      "channels_and_credentials": 16,
-      "dialogues_and_contacts": 33,
+      "crm_and_data_sources": 32,
+      "channels_and_credentials": 24,
+      "dialogues_and_contacts": 34,
       "automation": 5,
       "outbound_and_analytics": 72
     },