Подключение WhatsApp к Activepieces на номере Coexistence

Как подключить номер Coexistence к Activepieces?

Создайте подключение WhatsApp Business в Activepieces с двумя значениями: токеном доступа и идентификатором WhatsApp Business Account. Оба показаны в панели управления EasyCoexistence для этого подключения, а ассистенту их возвращает get_api_credentials. В инструкции модуля говорится о создании приложения Meta и системного пользователя, потому что там исходят из того, что у вас нет ни того, ни другого. Здесь номер уже подключён, поэтому просто вставьте значения.

Затем создайте сценарий, который начинается с триггера New Incoming Message, задайте в нём токен проверки на ваш выбор и опубликуйте сценарий. Скопируйте URL вебхука триггера в адрес вебхука номера в EasyCoexistence и укажите тот же токен проверки. Meta отправит запрос на проверку, триггер ответит на него, и каждое сообщение на номер будет запускать сценарий.

Почему секрет приложения должен оставаться пустым?

Потому что секрет, которым подписываются эти доставки, вам вставить нельзя. Meta подписывает каждый вебхук секретом того приложения, которому принадлежит подписка. У номера, подключённого через EasyCoexistence, это приложение EasyCoexistence, а его секрет никому не передаётся.

Модуль считает это поле необязательным. Если оставить его пустым, триггеры принимают доставки как есть. Если вписать секрет другого приложения, каждая доставка не пройдёт проверку X-Hub-Signature-256 и будет молча проигнорирована, а это выглядит точно так же, как если бы сообщения вообще не приходили.

От посторонних при проверке защищает токен проверки. Выберите длинное случайное значение и не публикуйте URL триггера: именно по этому адресу запускается ваш сценарий.

Что может делать сценарий после получения сообщения?

Триггер передаёт сценарию упрощённое сообщение: отправителя, имя в профиле, идентификатор сообщения, тип, текст, идентификатор медиа, ответы на кнопки и списки, а также идентификатор принимающего номера телефона. Дальше это обычный сценарий Activepieces с другими модулями: CRM, таблицей или шагом с ИИ.

Ответы отправляются тем же модулем. Send Message отправляет свободный текст, и он доставляется только в течение 24 часов после последнего сообщения клиента. Send Template Message отправляет утверждённый шаблон, и только он доставляется после окончания этого окна. Интерактивные кнопки, списки, медиа, геолокация и реакции представляют собой отдельные действия.

В инструкциях Activepieces отмечено, что Meta принимает один URL обратного вызова на приложение. При адресах для каждого номера ограничение составляет один URL на номер, поэтому сценарий, которому нужно обрабатывать несколько типов событий, лучше разветвлять внутри одного потока.

Попадают ли в сценарий ответы, набранные на телефоне?

До вебхука они доходят, но этот триггер их не видит. На номере Coexistence Meta отправляет эхо каждого ответа, набранного в приложении WhatsApp Business, на тот же адрес в поле smb_message_echoes. Триггер New Incoming Message модуля читает только поле messages и отбрасывает всё остальное.

Если ответы с телефона нужны в сценарии, начните его с универсального модуля Webhook в Activepieces, который принимает любой метод HTTP, и ответьте на проверочный запрос GET шагом Return Response на его синхронном URL. Тело запроса вы тогда разбираете сами, оба поля включены.

В большинстве сценариев проще триггер модуля: он реагирует на клиентов, а ответы команды остаются видны в приложении на телефоне.

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

• Вставить секрет приложения в подключение WhatsApp. Доставки подписаны секретом приложения EasyCoexistence, поэтому все они будут проигнорированы.
• Указать адрес вебхука до публикации сценария. Meta проверяет его сразу, а неопубликованный сценарий ответить не может.
• Ждать, что триггер New Incoming Message увидит ответы, набранные на телефоне. Он читает только поле messages, а не smb_message_echoes.

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

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