Документация/Навыки и интеграции

Куда уходит результат: Telegram, MAX, почта, свой API

Обновлено 7 ноября 2026 г.

Назначение — это адрес, куда отправляется результат вызова навыка. Подключённые адреса общие на организацию: один и тот же Telegram-чат можно использовать в разных навыках и у разных агентов, подключив его один раз.

Добавляются на странице навыка, блок «Отправка результатов» → «+ Добавить». Слева список типов, справа — уже подключённые адреса этого типа (нажмите на адрес, и он привяжется к навыку) или кнопка подключить новый.

Здесь — простые назначения. amoCRM, EnvyCRM, Битрикс24, Roistat и обратный звонок описаны в отдельных статьях раздела.

Telegram-чат

Уведомление приходит в личный чат или группу от нашего служебного бота.

  1. Выберите «Telegram» → «Подключить новый Telegram-чат».
  2. Кабинет покажет код вида /connect XXXX-XX.
  3. Добавьте бота @EnvyboxAgentBot в нужную группу (или откройте с ним личный чат) и отправьте туда этот код.
  4. Чат подключится сам, бот напишет в него «Готово! Чат подключен». Название назначения берётся из названия чата, его можно поменять.

Код действует сутки. Окно можно закрыть: если отправить код клиенту или коллеге, чат подключится, когда они пришлют код боту, — кабинет для этого открывать не нужно. Пока код не использован, окно подключения у этого навыка показывает тот же код. Код одноразовый; у каждого сотрудника он свой. Если код истёк, бот ответит «Код устарел, запросите новый» — получите в окне новый.

В окне «Настроить» дополнительно можно включить «Добавить кнопку открытия диалога» — под уведомлением появится кнопка, ведущая прямо в этот диалог в кабинете.

MAX

То же самое, что Telegram, только в мессенджере MAX: код /connect отправляется нашему служебному боту MAX.

Почта

Письмо на указанный адрес. Адрес нужно подтвердить: введите его, нажмите «Отправить код», введите код из письма. Подтверждённый адрес больше подтверждать не нужно — им можно пользоваться в любых навыках. У письма есть тема и текст, оба настраиваются.

Свой API

Если у вас есть собственная система с приёмом данных по HTTP, результат можно слать прямо в неё.

  • Адрес, метод (POST, PUT или PATCH) и заголовки — например, заголовок с секретным ключом. Значение заголовка после сохранения скрывается.
  • Тело запроса — либо «Форма» (поле → значение, по строке на параметр), либо сырой JSON-шаблон, куда подставляются значения.
  • «Дополнительно проверять тело ответа» — можно указать, какое поле ответа и с каким значением считать успехом; иначе успехом считается любой ответ со статусом 2xx.
  • Справа — живой предпросмотр запроса и кнопка «Проверить отправку»: запрос уходит по вашему адресу прямо из окна настройки, ответ показывается как есть.

Адреса внутренних сетей и локальные адреса не принимаются — только публичные.

Проверить отправку

У Telegram, MAX и почты кнопка «Проверить отправку» — в окне «Настроить»: уйдёт тестовое сообщение с примерными значениями параметров. Так можно убедиться, что всё подключено, не дожидаясь настоящего клиента.

Отправка идёт в фоне

Когда агент вызывает навык, он сразу говорит клиенту, что данные приняты, а отправка выполняется в фоне с повторами при сбоях. Состояние каждой отправки видно в «Диалогах» на плашке вызова навыка: «В очереди», «Отправлено» или «Ошибка». Подробнее — в статье «Если отправка не удалась».