Geri dönüşleri almak için sisteminizin bir HTTPS uç noktasını panoya kaydedin.
Durum webhooks
Sisteminizde WhatsApp mesajlarının durumunu alın.
Oluşturma, teslimat, okuma ve hata için standartlaştırılmış etkinlikleri almak üzere bir URL yapılandırın ve seçilen bağlantıdan bağımsız olarak API üzerinden teslimat geçmişini kontrol edin.
Akış
WPP Marketing, durum değiştiğinde sisteminizi bilgilendirir.
Durum webhook'ları denetim, mutabakat, dahili panolar, destek ve kendi sisteminizdeki kurallar için faydalıdır.
Webhook bir mesajın sonucunu bildirir; bu bir gönderme isteği değildir. Şunu kullanın Messaging API mesaj göndermek ve Events API desteklenen ticari olaylarla otomasyonları tetiklemek için.
Sisteminizin işlemesi gereken durumları etkinleştirin; operasyonel gürültüyü önlemek için yalnızca bunları açın.
Oluşturma, teslim, okuma veya hata, seçilen bağlantıdan bağımsız olarak aynı şekilde normalleştirilir.
Endpoint'iniz payload'ı işler ve teslimat geçmişi panelde ve GET /webhooks üzerinden kullanılabilir hale gelir.
Mevcut etkinlikler ve teslimat sorgulama.
Dört etkinliğin tamamı herhangi bir bağlantıda aynı sözleşmeyi kullanır ve API her teslim denemesinin sonucunu sorgulamaya olanak tanır.
POST
MESSAGE_CREATED
Mesaj akışta oluşturuldu ve izleme için bir kimlik aldı.
Criação
POST
MESSAGE_DELIVERED
Kanal onay döndüğünde mesaj alıcıya teslim edildi.
Entrega
POST
MESSAGE_READ
Okundu bildirimi mevcut olduğunda mesaj okundu.
Leitura
POST
MESSAGE_ERROR
Mesaj gönderme, doğrulama veya işleme sırasında bir hata ile karşılaştı.
Erro
GET
/webhooks
Durum, denemeler, HTTP yanıtı ve sayfalama ile teslim geçmişini görüntüleyin. webhooks:read kapsamı gerektirir.
Logs
En iyi uygulamalar
Endpoint'inizi yinelenen ve sıralama dışı gelen olayları alacak şekilde hazırlayın.
Webhook'ler sistemler arası teslimatlardır. Backend'iniz hızlı yanıt vermeli, log kaydetmeli ve idempotent şekilde işlem yapmalıdır.
Kamuya açık bir HTTPS URL'si kaydedin ve panelde etkinlikleri etkinleştirin. Mevcut sözleşme HMAC imzası göndermiyor; mevcut olmayan bir imzanın varlığını varsaymayarak alıcı için uygun koruma ve doğrulamayı yapılandırın.
15 saniye içinde HTTP 2xx ile yanıt verin ve uzun süren görevleri dahili bir kuyruğa alın. Yönlendirmeler takip edilmez.
Çift işleme önlemek ve sıralama dışı olayları kabul etmek için olay kimliğini kullanın; bu kimlik Webhook-Id içinde de gönderilir. Webhook-Attempt deneme numarasını belirtir. Yalnızca etkinleştirilmiş olaylar kaydedilir ve gönderilir.
webhooks:read ile GET /webhooks üzerinde HTTP denemelerini ve yanıtları görüntüleyin. Tamamlanan, teslim edilen veya kalıcı olarak başarısız kayıtlar 30 gün saklanır. Kendi loglarınızda kişisel verileri ve mesaj içeriğini koruyun.
Bağlantı hataları, zaman aşımı ve 408, 425, 429 veya 5xx yanıtları toplamda en fazla yedi deneme tetikleyebilir; aralıklar 1, 5 ve 15 dakika ile 1, 6 ve 24 saattir. Retry-After 24 saate kadar dikkate alınır. Diğer 4xx hataları teslimatı sonlandırır.
Durum webhook'ları WPP Marketing'ten gelen yanıtlardır. Mağaza ticari etkinliklerini göndermek için Events API'yi kullanın.
Sisteminizdeki teslimatları ve hataları takip etmek ister misiniz?
Panelde bir URL yapılandırın, durumları seçin ve teslimatları webhook raporunda takip edin.