Обработка входящих сообщений WhatsApp

​

Что это такое

​

Перед началом работы

• Настройте эндпоинт Webhook для whatsapp.inbound_message.received.
• Проверяйте заголовок YCloud-Signature перед обработкой событий.
• Сохраняйте входящее сообщение id.
• Подключите бизнес-номер телефона, на который поступило сообщение.

​

Как это работает

1. Получите и аутентифицируйте событие Webhook.
2. Выполните дедупликацию события по событию id.
3. Извлеките входящее сообщение id и его содержимое.
4. При необходимости отметьте сообщение как прочитанное.
5. Отображайте индикатор набора текста только тогда, когда подготавливается ответ.
6. Отправьте ответ с помощью WhatsApp Messages API.

​

Запрос

​

Отметить сообщение как прочитанное

curl --request POST \
  https://api.ycloud.com/v2/whatsapp/inboundMessages/INBOUND_MESSAGE_ID/markAsRead \
  --header "X-API-Key: $YCLOUD_API_KEY"

​

Показать индикатор набора текста

curl --request POST \
  https://api.ycloud.com/v2/whatsapp/inboundMessages/INBOUND_MESSAGE_ID/typing \
  --header "X-API-Key: $YCLOUD_API_KEY"

​

Ответ

HTTP/1.1 200 OK

​

Рекомендации по обработке

• Подтверждайте получение Webhook до запуска медленной обработки ИИ или бизнес-логики.
• Сохраняйте порядок сообщений в диалоге, если этого требует ваш сценарий использования.
• Обрабатывайте каждый поддерживаемый входящий type явным образом и сохраняйте неподдерживаемые полезные нагрузки для анализа.
• Используйте контекст сообщения при ответе на конкретное входящее сообщение.

​

Ограничения и устранение неполадок

• Не отображайте индикатор набора текста, если ответ не планируется к отправке.
• В пути действия используйте ID входящего сообщения, а не ID события Webhook.
• Обеспечьте идемпотентность обработки Webhook, так как доставка может повторяться.
• Если действие завершилось сбоем, логируйте YCloud requestId, не сохраняя в логах содержимое сообщений или учетные данные.