Зарегистрируйте в панели HTTPS-эндпоинт вашей системы для получения ответов.
Вебхуки статуса
Получайте в своей системе статусы сообщений WhatsApp.
Настройте URL для приёма стандартизированных событий создания, доставки, чтения и ошибок и просматривайте историю доставок через API независимо от выбранного подключения.
Поток
WPP Marketing уведомляет вашу систему при изменении статуса.
Вебхуки статуса полезны для аудита, сверки, внутренних панелей, поддержки и правил в вашей системе.
Webhook сообщает о результате сообщения; это не запрос на отправку. Используйте Messaging API для отправки сообщений и Events API для запуска автоматизаций с поддерживаемыми коммерческими событиями.
Включайте только те статусы, которые должен обрабатывать ваша система, чтобы избежать операционного шума.
Создание, доставка, чтение или ошибка нормализуются одинаково независимо от выбранного соединения.
Ваш endpoint обрабатывает payload, а история доставок становится доступна в панели управления и через GET /webhooks.
Доступные события и проверка доставок.
Все четыре события используют один и тот же контракт на любом подключении, и API позволяет запрашивать результат каждой попытки доставки.
POST
MESSAGE_CREATED
Сообщение было создано в потоке и получило идентификатор для отслеживания.
Criação
POST
MESSAGE_DELIVERED
Сообщение было доставлено получателю после получения подтверждения от канала.
Entrega
POST
MESSAGE_READ
Сообщение прочитано, когда доступно подтверждение прочтения.
Leitura
POST
MESSAGE_ERROR
При отправке, проверке или обработке сообщения произошла ошибка.
Erro
GET
/webhooks
Просмотр истории доставок со статусом, попытками, HTTP‑ответом и пагинацией. Требуется scope webhooks:read.
Logs
Лучшие практики
Подготовьте ваш endpoint к приему повторяющихся и приходящих вне порядка событий.
Webhooks — это передачи между системами. Ваш бэкенд должен быстро отвечать, сохранять логи и обрабатывать идемпотентно.
Зарегистрируйте публичный HTTPS URL и включите события в панели. Текущий контракт не отправляет HMAC-подпись; настройте соответствующую защиту и валидацию для получателя, не предполагая наличие несуществующей подписи.
Ответьте с HTTP 2xx в течение 15 секунд и обрабатывайте длительные задачи во внутренней очереди. Перенаправления не отслеживаются.
Используйте идентификатор события, также отправляемый в Webhook-Id, чтобы избежать дублирующей обработки и принимать события вне порядка. Webhook-Attempt указывает номер попытки. Регистрируются и отправляются только включённые события.
Просматривайте HTTP-попытки и ответы на GET /webhooks с правом webhooks:read. Завершенные, доставленные или окончательно неудачные записи хранятся в течение 30 дней. Защищайте персональные данные и содержание сообщений в собственных логах.
Сбои соединения, таймауты и ответы 408, 425, 429 или 5xx могут вызвать до семи попыток в сумме, с интервалами 1, 5 и 15 минут, а также 1, 6 и 24 часа. Заголовок Retry-After учитывается до 24 часов. Другие ошибки 4xx прекращают доставку.
Webhook'и статуса — это ответы от WPP Marketing. Для отправки коммерческих событий магазина используйте Events API.
Хотите отслеживать доставки и ошибки в вашей системе?
Настройте URL в панели, выберите статусы и отслеживайте доставки в отчете по вебхукам.