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

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

WhatsApp Business

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

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

Настройка

1. Параметры → Сервисы → WhatsApp, вкладка Accounts — подключите ваше приложение 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 ссылается на них по имени.
• Поддерживаемые медиафайлы: изображения, аудио, видео, документы. Документы PDF и Excel затем могут быть обработаны узлом file_transform.

WhatsApp через Green API (Beta)

Для номера WhatsApp без аккаунта Meta Business betool также подключается к Green API (ваш собственный экземпляр, BYO): приёмник greenapi_inbound запускает pipeline при каждом полученном сообщении (медиафайлы копируются в betool), узел greenapi_outbound отправляет текст или файл с подписью. betool сам устанавливает webhook в Green API.

• Это не официальный API WhatsApp: Green API эмулирует WhatsApp Web. WhatsApp может заблокировать номер без возможности обжалования. Для клиентского использования в больших объёмах предпочитайте Cloud API, описанный выше.
• Нет шаблонов и 24-часового окна; группы доступны.
• Успешная отправка доказывает, что сообщение поставлено в очередь, а не что оно доставлено.
• Отправка выполняется только через узел (exactly-once): ни один tool не позволяет агенту отправлять сообщения самостоятельно.

Messenger

Приёмник messenger_inbound запускает pipeline при каждом сообщении, полученном на вашей странице Facebook; узел messenger_outbound отвечает. Свободные ответы возможны только в течение 24 часов после последнего сообщения пользователя (правило Meta). Подробности и подключение: Meta.

Telegram

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

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

Настройка

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

Особенности

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

Mattermost

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

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

Настройка

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

Особенности

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

Выбор