Зарегистрируйте в панели HTTPS-эндпоинт вашей системы для получения ответов.
Вебхуки статуса
Получайте в своей системе статусы сообщений WhatsApp.
Настройте URL для получения событий очереди, создания, доставки, прочтения, ошибки, номер не найден, истечение срока и выхода.
Поток
WPP Marketing уведомляет вашу систему при изменении статуса.
Вебхуки статуса полезны для аудита, сверки, внутренних панелей, поддержки и правил в вашей системе.
Включайте только те статусы, которые должен обрабатывать ваша система, чтобы избежать операционного шума.
В операции обнаружены доставка, прочтение, ошибка, истечение срока, неверный номер или выход из аккаунта.
Эндпоинт обрабатывает payload, фиксирует событие в логе и обновляет собственную панель или внутреннее правило.
Доступные события возврата.
Эти статусы помогают вашей системе понять, что произошло после того, как сообщение попало в поток WhatsApp.
POST
QUEUE
Сообщение помещено в очередь обработки.
Fila
POST
MESSAGE_CREATED
Сообщение было создано в потоке и получило идентификатор для отслеживания.
Criação
POST
MESSAGE_DELIVERED
Сообщение было доставлено получателю после получения подтверждения от канала.
Entrega
POST
MESSAGE_READ
Сообщение прочитано, когда доступно подтверждение прочтения.
Leitura
POST
MESSAGE_ERROR
При отправке, проверке или обработке сообщения произошла ошибка.
Erro
POST
LOGOUT
Подключение WhatsApp прекращено и может потребовать действий со стороны операционной команды.
Conexão
Лучшие практики
Подготовьте ваш endpoint к приему повторяющихся и приходящих вне порядка событий.
Webhooks — это передачи между системами. Ваш бэкенд должен быстро отвечать, сохранять логи и обрабатывать идемпотентно.
Используйте защищённый, публичный и стабильный URL для приема событий обратного вызова.
Отвечайте HTTP 200 или 204 после получения события и обрабатывайте долгие задачи во внутренней очереди.
Используйте идентификаторы сообщений и событий, чтобы избежать дублирования при повторной доставке.
Регистрируйте payload, дату, HTTP-статус и результат обработки для аудита.
Используйте события ошибки, «номер не найден» и выход, чтобы оповещать службу поддержки или операционный отдел.
Webhook'и статуса — это ответы от WPP Marketing. Для отправки коммерческих событий магазина используйте Events API.
Хотите отслеживать доставки и ошибки в вашей системе?
Настройте URL вебхука в панели и выберите, какие статусы должны возвращаться в ваше приложение.