Вебхук smb_message_echoes
smb_message_echoes передаёт сообщения, отправленные вашей командой из WhatsApp Business. Поле есть только у номеров Coexistence, потому что только с ними сотрудник отправляет сообщения с телефона, а программа одновременно отправляет их через API.
- Что человек отправил, переданное программе
- Только для номеров Coexistence
- Если игнорировать, клиент получит два ответа
В течение 7 дней ничего не списывается. Отмена в любое время.
Поле сообщает вашей системе об исходящем сообщении человека.
Всего полей пути сообщений два: это поле и messages.
Эквивалент для номера, подключённого без Coexistence.
Зачем вообще нужно это поле?
Потому что Coexistence создаёт ситуацию, для которой API изначально не проектировался: один номер используют два отправителя.
В обычном номере Cloud API отправитель только один, это программа, поэтому передавать нечего. В номере Coexistence команда всё ещё отвечает с телефона. Без такого события программа не видела бы примерно половину каждого диалога.
Вебхук решает эту проблему. Когда кто-то вводит ответ в приложении WhatsApp Business, он приходит на ваш эндпоинт как событие. Структура такая же, как у входящего сообщения, но событие помечено как исходящее от компании.
Что произойдёт, если его игнорировать?
Клиент получит два ответа, и это будет выглядеть небрежно.
Обычно клиент пишет в восемь утра, сотрудник отвечает с телефона в течение минуты, а автоматизация, не увидевшая этот ответ, через три минуты отправляет ответ на тот же вопрос. Для клиента это выглядит так, будто компания не знает, что уже сказала.
Обрабатывать событие несложно. Сохраняйте вебхук в диалоге так же, как входящее сообщение, и проверяйте недавнюю активность перед отправкой. Проблема незаметна при тестировании, потому что в тестовом диалоге человек обычно не отвечает.
Распространённые ошибки
- Считать вебхуки лишним шумом и отбрасывать их. Это единственный сигнал, что человек уже ответил.
- Считать, что поле есть у каждого номера. Оно относится только к Coexistence.
- Тестировать без участия человека. Именно тогда проблема не возникает.
EasyCoexistence передаёт оба поля пути сообщений, это поле и messages, напрямую от Meta на ваш эндпоинт. Ни одно из них не проходит через нас.
Часто задаваемые вопросы
Вебхуки содержат медиафайлы?
Они сообщают, что было отправлено, включая ссылки на медиафайлы, в той же структуре, что и входящие сообщения.
Есть ли это поле у обычного номера Cloud API?
Нет. Без Coexistence никто не отправляет сообщения из приложения, поэтому передавать нечего.
Можно ли отключить это поле?
Оно входит в путь сообщений. Если направить этот путь на ваш эндпоинт, поле будет передаваться. Игнорировать его в коде можно, но это приведёт к последствиям.
Это что-нибудь стоит?
Нет. Это событие вебхука, а не отправка сообщения.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодВ течение 7 дней ничего не списывается. Отмена в любое время.Проверено по состоянию на