Зарегистрируйте в панели HTTPS-эндпоинт вашей системы для получения ответов.
Вебхуки статуса
Получайте в своей системе статусы сообщений WhatsApp.
Настройте URL для приёма стандартизированных событий создания, доставки, чтения и ошибок и просматривайте историю доставок через API независимо от выбранного подключения.
Поток
WPP Marketing уведомляет вашу систему при изменении статуса.
Вебхуки статуса полезны для аудита, сверки, внутренних панелей, поддержки и правил в вашей системе.
Включайте только те статусы, которые должен обрабатывать ваша система, чтобы избежать операционного шума.
Создание, доставка, чтение или ошибка нормализуются одинаково независимо от выбранного соединения.
Ваш 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 — это передачи между системами. Ваш бэкенд должен быстро отвечать, сохранять логи и обрабатывать идемпотентно.
Используйте защищённый, публичный и стабильный URL для приема событий обратного вызова.
Отвечайте HTTP 200 или 204 после получения события и обрабатывайте долгие задачи во внутренней очереди.
Используйте идентификаторы сообщений и событий, чтобы избежать дублирования при повторной доставке.
Регистрируйте payload, дату, HTTP-статус и результат обработки для аудита.
Используйте MESSAGE_ERROR, чтобы уведомлять службу поддержки или операционный отдел о сбоях, возвращаемых любым подключением.
Webhook'и статуса — это ответы от WPP Marketing. Для отправки коммерческих событий магазина используйте Events API.
Хотите отслеживать доставки и ошибки в вашей системе?
Настройте URL в панели, выберите статусы и отслеживайте доставки в отчете по вебхукам.