BotHelp: ИИ-агент для заявок из мессенджеров

BotHelp — платформа чат-ботов и рассылок с REST API: Telegram, VK, MAX, WhatsApp Business API и сайт. Агент нужен клиентскому сервису, который тонет в заявках из разных каналов и не успевает их регистрировать.

Агент — программа, которая делает дело целиком, а не отвечает на вопрос. Вы ставите задачу словами, он сам решает, где взять данные и что сделать с результатом. Три признака: работает в ваших сервисах, доводит до результата и работает без вас. От чат-бота отличается финалом: бот вернёт текст и закончит, агент вернётся, когда заявка зарегистрирована.

Коннектор — описание подключения Agenova к BotHelp: где взять ключ, как проверить связь, какие данные доступны. Здесь ключ лежит в настройках кабинета, раздел «Интеграции»: из client_id и client_secret по запросу выдаётся токен. Это не плагин и не доработка вашего бота. Пароль не хранится в тексте задачи: агент работает только с выданным доступом.

Платформа ботов и рассылок в мессенджерах: Telegram, VK, MAX, WhatsApp Business API, Instagram, Facebook, Viber и виджет на сайте. Внутри визуальный конструктор, шаги с условиями и формулами, метки, глобальные переменные, статистика ботов, массовые действия с подписчиками и роли сотрудников. Данные — подписчики, диалоги, поля, рассылки и их статистика. API отдаёт JSON и передаёт ключ в заголовке запроса, кроссдоменные вызовы запрещены.

### Входящая корреспонденция: регистрация и резолюция

Агент забирает из BotHelp новые диалоги и заявки: текст, канал, метки, поля подписчика, время. Проверяет, нет ли дубля, определяет тему по словам и полям и готовит резолюцию — кому, что сделать, в какой срок. Обращению присваивается номер, в кабинет возвращается карточка с итогом.

### Заявки из почты, форм и мессенджеров

Агент сводит в один поток сообщения мессенджеров, заявки из формы и письма. Он приводит их к общему набору полей, отсекает дубли по телефону и тексту и отправляет в BotHelp через шаг «Внешний запрос» или webhook.

### Сводки по обращениям: день и месяц

Агент собирает срез за день или месяц: сколько пришло, из каких каналов, что закрыто, что без ответа. Число заявок в BotHelp он сверяет с вашей таблицей и показывает расхождение. Сводка приходит в чат или файлом, с датой среза и разбивкой по темам.

Спорная заявка, ответ клиенту в сложном случае и правка сценария бота — за человеком. Агент готовит черновик и резолюцию, отправку подтверждает сотрудник.

В кабинете BotHelp откройте настройки и раздел «Интеграции»: там client_id и client_secret, из них запросом получается токен. Он идёт в заголовке и живёт час, дальше агент запрашивает новый. Лимит — от десяти до двадцати пяти запросов в секунду в зависимости от метода, поэтому агент ходит с сервера.

Не запускает рассылку без вашей команды и не правит сценарий бота. Не подменяет оператора в живом диалоге. Не обещает роста конверсии: показывает, что было и что стало.

Что такое агент, если коротко? Программа, которая доводит дело до конца: сама берёт данные в BotHelp, проверяет их и отдаёт результат — зарегистрированное обращение, сводку, список. От чат-бота отличается тем, что возвращается с готовым делом.

Что такое коннектор? Подключение к BotHelp: где взять client_id и client_secret, как проверить токен, что агенту разрешено читать. Не доработка платформы; доступ отзывается в любой момент.

Почему токен живёт только час? Так устроен API: токен выдаётся на час. Это не помеха — агент обновляет его сам, а секрет остаётся в кабинете Agenova и в переписку не попадает.