Реакции на сообщения: отправка и получение эмодзи
Реакция добавляет один эмодзи к существующему сообщению. Для отправки укажите идентификатор сообщения и эмодзи, а для удаления отправьте ту же реакцию с пустой строкой в поле emoji вместо вызова удаления.
Сколько реакций один отправитель может одновременно оставить на одном сообщении.
Стоимость реакции. Она не открывает тарифицируемый диалог.
Какая ошибка возвращается при реакции вне окна обслуживания клиентов (24 часа).
Отправка реакции
Сообщение типа reaction содержит идентификатор сообщения, на которое отвечает реакция, и один эмодзи. Отправка второй реакции на то же сообщение заменяет первую, а не добавляет её, поскольку отправитель может оставить только одну реакцию на сообщение.
Идентификатор сообщения должен быть виден вашему номеру: это входящее сообщение от клиента или сообщение, которое вы ему отправили.
Удаление реакции
Именно здесь многие ошибаются. Вызова удаления нет. Отправьте то же сообщение с реакцией, указав пустую строку в поле emoji, и реакция будет удалена.
Обработчик, ожидающий событие удаления, будет ждать бесконечно. Приходит реакция с пустым emoji. По структуре она совпадает с новой реакцией, поэтому удаление нужно определить по значению поля.
Получение реакций
Входящие реакции приходят через вебхук messages как сообщение типа reaction. В нём указаны идентификатор сообщения, к которому относится реакция, и эмодзи.
- Подпишитесь на поле messages. Отдельного поля reactions нет.
- Пустой emoji означает, что клиент удалил свою реакцию.
- Указанный идентификатор сообщения относится к сообщению, которое вы ранее отправили или получили.
- Реакции не открывают заново окно обслуживания клиентов (24 часа).
Окно всё равно действует
Реакция является сообщением, поэтому для её отправки должно быть открыто окно обслуживания клиентов (24 часа). Реакция на сообщение клиента трёхдневной давности возвращает ошибку 131047, как и обычное текстовое сообщение.
Полученная от клиента реакция открывает окно заново, поскольку любое входящее сообщение делает это. Это важно для автоматизаций: отметка «палец вверх» под вашим последним сообщением означает, что теперь можно свободно ответить.
Распространённые ошибки
- Поиск эндпоинта delete. Удаление выполняется тем же вызовом с пустым emoji.
- Считать пустой emoji некорректным. Так передаётся удаление реакции.
- Отправка реакции вне окна обслуживания клиентов (24 часа). Она завершается ошибкой, как и любое другое сообщение.
EasyCoexistence доставляет события реакций на ваш эндпоинт через тот же вебхук, что и остальные сообщения. Удалённая реакция приходит в вашу систему с пустым emoji.
Часто задаваемые вопросы
Как удалить реакцию?
Отправьте то же сообщение с реакцией и пустой строкой в поле emoji. Вызова удаления нет.
Реакции платные?
Нет. Они не открывают тарифицируемый диалог.
Можно реагировать на любое сообщение?
Только на сообщения, отправленные или полученные вашим номером, и только в течение окна обслуживания клиентов (24 часа).
Реакция клиента открывает окно заново?
Да. Любое входящее сообщение от клиента делает это, включая реакцию.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на