Запуск потока Typebot в WhatsApp через Coexistence

Какие поля Typebot берут значения из подключённого номера?

Мастер настройки WhatsApp в Typebot, на вкладке Share бота, запрашивает четыре значения: app secret, System User Token, WhatsApp Business Account ID и Phone number ID.

Три из них берутся прямо из подключения. Панель управления показывает идентификатор WABA, идентификатор номера и токен доступа для номера, а инструмент get_api_credentials возвращает те же значения, если их для вас получает ассистент. Вставьте их в соответствующие поля.

App secret нужно оставить пустым. Typebot использует его для одной задачи при входящем трафике: проверяет заголовок X-Hub-Signature-256, который Meta добавляет к каждой доставке. Для номера, подключённого через Tech Provider, Meta подписывает доставки секретом приложения провайдера, и этот секрет никому не передаётся. Поэтому любое значение, которое вы введёте, приведёт к тому, что Typebot отклонит каждое настоящее сообщение. Если поле пустое, Typebot пропускает проверку и принимает доставку.

Куда вставить callback URL и verify token из Typebot?

В адрес вебхука для номера, а не в панель управления приложения Meta.

Мастер Typebot предлагает вставить Callback URL и Verify Token в настройки WhatsApp вашего собственного приложения Meta. При Coexistence через EasyCoexistence вашего приложения здесь нет: Meta направляет события номера на тот адрес, который задан в подключении. Поэтому скопируйте оба значения на последнем шаге Typebot и укажите их как адрес назначения: в панели управления или через set_webhook_destination.

Затем Meta отправляет в Typebot проверочный GET, Typebot отвечает на challenge, и с этого момента каждое сообщение на номер доходит до бота. Verify token в Typebot одноразовый: он удаляется из базы данных Typebot сразу после успешной проверки. Если позже вы захотите задать адрес заново, сначала снова пройдите мастер и сгенерируйте новый токен.

Как бот работает с окном в 24 часа?

Typebot отвечает людям, которые написали ему сами, поэтому почти все сообщения остаются внутри окна обслуживания клиентов. Meta открывает окно на 24 часа каждый раз, когда клиент пишет, и внутри него можно отправлять сообщения любого сервисного типа без шаблона. Бот, который только отвечает, это простой случай.

Сложности возникают в потоке, который ждёт. Блок Wait или сессия, которая возобновляется после того, как клиент молчал больше суток, попытается отправить свободный текст вне окна, и Meta отклонит его с ошибкой 131047. Тайм-аут истечения сессии в Typebot (по умолчанию 4 часа, настраивается до 48) определяет, когда вернувшийся клиент начнёт новый чат, но не то, примет ли Meta сообщение.

Поскольку используется Coexistence, команда по-прежнему видит все диалоги в приложении WhatsApp Business и может вмешаться с телефона, когда боту отвечать не нужно.

Распространённые ошибки

• Вставить в Typebot секрет приложения Meta. Доставки подписаны секретом Tech Provider, поэтому Typebot отклоняет каждое сообщение как сообщение с недействительной подписью.
• Использовать старый verify token Typebot. Он удаляется после одной успешной проверки, поэтому для повторной настройки адреса нужен новый токен из мастера.
• Делиться callback URL. При отключённой проверке подписи запрос пропускает знание адреса, поэтому относитесь к нему как к паролю.

Часто задаваемые вопросы

Читайте дальше