Документация/Функции и интеграции

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

Обновлено 23 сентября 2026 г.

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

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

Telegram-чат

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

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

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

MAX

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

Почта

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

Свой API

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

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

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

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

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

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

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