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