Документация

Мессенджеры (WhatsApp, Telegram, Mattermost)

Подключение pipeline к WhatsApp Cloud API, Telegram Bot API или Mattermost.

Мессенджеры

betool интегрирует три наиболее востребованные профессиональные платформы мессенджеров. Каждая следует одной модели: модуль *_inbound для приёма и модуль *_outbound для отправки.

WhatsApp Business

Предварительные требования

  • Аккаунт Meta Business.
  • Одобренный номер WhatsApp Business.
  • Приложение Cloud API, настроенное с webhook.

Настройка

  1. Администрирование → WhatsApp → Аккаунты — подключите ваше приложение Meta с его App Secret и Phone Number ID.
  2. На стороне Meta добавьте URL webhook, предоставленный betool (https://platform.betool.ai/entries/whatsapp/<id>), и скопируйте сгенерированный Verify Token.
  3. Сопоставьте номер с pipeline.

Особенности

  • Одобренные шаблоны обязательны для инициации переписки (вне 24-часового окна). Вы управляете шаблонами на стороне Meta; betool ссылается на них по имени.
  • Поддерживаемые медиафайлы: изображения, аудио, видео, документы. Обрабатываются стандартными узлами file_transform.

Telegram

Предварительные требования

Бот, созданный через @BotFather (API-токен).

Настройка

  1. Администрирование → Telegram → Боты — вставьте токен; betool настраивает webhook автоматически.
  2. Сопоставьте бота с pipeline.

Особенности

  • Бота можно добавить в группы или использовать в личных переписках.
  • Нет ограничительных квот, как в WhatsApp, — идеально подходит для внутренних ассистентов или операционных уведомлений.

Mattermost

Предварительные требования

  • Экземпляр Mattermost (облачный или self-hosted).
  • Исходящий webhook на стороне Mattermost.

Настройка

  1. Администрирование → Mattermost → Подключения — создайте подключение и скопируйте URL, предоставленный betool.
  2. На стороне Mattermost создайте исходящий webhook, указывающий на этот URL.
  3. Опционально: создайте входящий webhook в Mattermost, чтобы betool мог публиковать ответы.

Особенности

  • Цепочки сохраняются — ответы агента остаются в цепочке исходного вопроса.
  • Приватные каналы / личные сообщения — выберите область действия при настройке.

Выбор между тремя

Сценарий использованияРекомендация
Внешняя клиентская поддержка потребителейWhatsApp
Внутренний командный ассистентTelegram или Mattermost (в зависимости от того, что уже развёрнуто)
Бот операций IT / DevOpsMattermost
Мультиканальное присутствиеВы можете подключить один и тот же pipeline к нескольким каналам одновременно