Зарегистрируйте в панели HTTPS-эндпоинт вашей системы для получения ответов.
Получайте в своей системе статусы сообщений WhatsApp.
Настройте URL для приёма стандартизированных событий создания, доставки, чтения и ошибок и просматривайте историю доставок через API независимо от выбранного подключения.
WPP Marketing уведомляет вашу систему при изменении статуса.
Вебхуки статуса полезны для аудита, сверки, внутренних панелей, поддержки и правил в вашей системе.
Включайте только те статусы, которые должен обрабатывать ваша система, чтобы избежать операционного шума.
Создание, доставка, чтение или ошибка нормализуются одинаково независимо от выбранного соединения.
Ваш endpoint обрабатывает payload, а история доставок становится доступна в панели управления и через GET /webhooks.
Доступные события и проверка доставок.
Все четыре события используют один и тот же контракт на любом подключении, и API позволяет запрашивать результат каждой попытки доставки.
Сообщение было создано в потоке и получило идентификатор для отслеживания.
CriaçãoСообщение было доставлено получателю после получения подтверждения от канала.
EntregaСообщение прочитано, когда доступно подтверждение прочтения.
LeituraПри отправке, проверке или обработке сообщения произошла ошибка.
ErroПросмотр истории доставок со статусом, попытками, HTTP‑ответом и пагинацией. Требуется scope webhooks:read.
LogsПодготовьте ваш endpoint к приему повторяющихся и приходящих вне порядка событий.
Webhooks — это передачи между системами. Ваш бэкенд должен быстро отвечать, сохранять логи и обрабатывать идемпотентно.
Используйте защищённый, публичный и стабильный URL для приема событий обратного вызова.
Отвечайте HTTP 200 или 204 после получения события и обрабатывайте долгие задачи во внутренней очереди.
Используйте идентификаторы сообщений и событий, чтобы избежать дублирования при повторной доставке.
Регистрируйте payload, дату, HTTP-статус и результат обработки для аудита.
Используйте MESSAGE_ERROR, чтобы уведомлять службу поддержки или операционный отдел о сбоях, возвращаемых любым подключением.
Webhook'и статуса — это ответы от WPP Marketing. Для отправки коммерческих событий магазина используйте Events API.
Хотите отслеживать доставки и ошибки в вашей системе?
Настройте URL в панели, выберите статусы и отслеживайте доставки в отчете по вебхукам.