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