Webhook'ların ötesinde: Senkron WhatsApp numara doğrulaması

WhatsApp hesap varlığı sinyallerini gerçek zamanlı olarak almak için karmaşık olay güdümlü webhook mimarilerini senkron bir REST API ile değiştirin.

Numara doğrulama için bir WhatsApp çağrı webhook entegrasyonunu değerlendirirken, WhatsApp hesap durumunu kontrol etmek amacıyla karmaşık olay güdümlü bir altyapı kurmanız gerekmez. Senkron bir REST API kullanarak E.164 biçimli bir telefon numarası gönderebilir ve kayıt, profil fotoğrafı veya işletme hesabı durumunu tam olarak aynı HTTP yanıtında alabilirsiniz. Bu senkron yaklaşım yoklama, asenkron durum yönetimi veya özel webhook dinleyicileri ihtiyacını ortadan kaldırır ve CRM zenginleştirme ya da yönlendirme iş akışlarınıza yön verecek verileri anında sağlar.

Olay güdümlü doğrulamanın karmaşıklığı

Olay güdümlü mimariler mesajlaşma platformlarında yaygındır; ancak basit numara doğrulaması için bir WhatsApp çağrı webhook entegrasyonuna dayanmak ciddi bir ek yük getirir. Webhook'lar; gelen yükleri dinlemek, olayları işlemek ve kaynak sunucuya alındı onayı vermek için özel bir altyapı gerektirir. Geliştirme ekipleri için bu; herkese açık uç noktaları sürdürmek, asenkron durumu yönetmek ve olası teslimat yeniden denemelerini ya da yük ayrıştırma hatalarını ele almak anlamına gelir. Amaç yalnızca bir kaydı yönlendirmeden önce bir hesap varlığı sinyalini teyit etmek olduğunda, olay güdümlü modeller çoğu zaman gereksiz gecikme ve bakım yükü getirir. Ekipler, bir numaranın kayıtlı olup olmadığını teyit etmek için asenkron bir geri çağrıyı beklemek yerine ihtiyaç duydukları durumu tam olarak talep edip hemen alarak mimarilerini sadeleştirebilir.

Senkron yaklaşımın avantajı

Senkron bir API modeli, webhook dinleyicilerini yönetmeye göre daha verimli bir alternatif sunar. WA Lookup'ta sonuçlar senkrondur; yani doğrulama verileri ilk istekle aynı HTTP yanıtında döndürülür. Bu model webhook uç noktalarına, sürekli yoklamaya veya asenkron durum yönetimine olan ihtiyacı tamamen ortadan kaldırır. WA Lookup doğrulama kontrollerini tek bir senkron uç noktada toplar. Geliştiriciler talep edilen hizmet türünü değiştirerek, ağ mimarilerini değiştirmeden farklı düzeylerde hesap varlığı sinyalleri alabilir. Platform bu tek uç nokta üzerinden üç ayrı kontrolü destekler:

• ws: Gönderilen bir telefon numarasının WhatsApp'ta kayıtlı olup olmadığını teyit eder.
• ws_avatar: WhatsApp kaydını kontrol eder, profil fotoğrafı bulunurluğunu ve URL yoksa boş olan bir avatar_url alanını ekler.
• ws_business: WhatsApp kaydını kontrol eder ve hesabın WhatsApp Business kullanıp kullanmadığını belirtir.

İstek ve yanıt tek bir bağlantı içinde gerçekleştiğinden ekipler, bu kontrolleri harici olayları beklemeden doğrudan sıralı veri hatlarına veya potansiyel müşteri puanlama mantığına entegre edebilir.

WhatsApp doğrulamasını REST API ile uygulamak

Senkron bir kontrolü entegre etmek, karmaşık bir olay dinleyicisi yerine basit bir HTTP isteği gerektirir. API rehberi, /api/v1/check uç noktasına bir POST isteğini tanımlar. Kimlik doğrulama, bir X-API-Key başlığı eklenerek sağlanır. Belgelenmiş istek sözleşmesi iki alan içeren bir JSON gövdesi gerektirir: bir service_type değeri (ws, ws_avatar veya ws_business) ve bir identifier. Tanımlayıcı, E.164 biçiminde gönderilen bir telefon numarası olmalıdır (örneğin +17253100591). Tamamlanmış bir WhatsApp kontrolü için döndürülen data; service_type, identifier ve registered alanlarını içerir; ws_avatar ayrıca avatar ve avatar_url, ws_business ise business alanını içerir. Dahili kayıt, işlem, durum ve faturalandırma alanları döndürülmez. Süregelen yönetimi desteklemek için WA Lookup paneli; API anahtarı yönetimi, bakiye takibi, kontrol geçmişi, ürün düzeyinde raporlama, son kontroller, bakiye harcaması ve hesap etkinliği araçları sunar.

Veri zenginleştirme ve yönlendirme için en iyi uygulamalar

Doğrulama verilerini daha geniş bir iş akışı içinde bağlama oturtmak, ekiplerin iletişim önceliklerini belirlemesine ve kayıtları verimli biçimde yönetmesine yardımcı olur. Kayıt durumunu kontrol etmek için senkron bir API kullanmak, iletişim kampanyaları başlatmadan önce potansiyel müşteri listelerini temizlemeye yönelik diğer kontrollerin yanında bir girdi olabilir. CRM kayıtlarını zenginleştirirken ekipler, dahili yönlendirme kurallarına yön vermek için ws_avatar veya ws_business hizmet türlerini kullanabilir. Örneğin bir WhatsApp Business hesabının belirlenmesi, kaydı bir B2B satış kuyruğuna yönlendirebilirken bir profil fotoğrafı URL'si müşteri destek ekiplerine ek bağlam sağlayabilir. Bir hesap varlığı sinyalinin sınırlarını anlamak önemlidir. registered sonucu, tam kontrol anında mevcut olan WhatsApp durum alanlarını bildirir. Canlı çevrimiçi durumu, mesaj geçmişini, kişi onayını veya numarayla iletişim kurulup kurulamayacağını bildirmez. Sinyal yalnızca platform varlığına dayalı dahili inceleme ve yönlendirme kararlarını destekler. Başarısız, zaman aşımına uğrayan ve belirlenemeyen kontrollerin ücreti tahsil edilmez. Güncel faturalandırma ayrıntıları için fiyatlandırma sayfasına bakın.

SSS

WA Lookup API'yi kullanmak için bir webhook kurmam gerekir mi?

Hayır. WA Lookup sonuçları senkrondur; yani isteğinizle aynı HTTP yanıtında döndürülür. Doğrulama verilerini almak için webhook uç noktaları, olay dinleyicileri veya yoklama mekanizmaları yapılandırmanız gerekmez.

ws, ws_avatar ve ws_business hizmet türleri arasındaki fark nedir?

Üçü de aynı senkron uç noktayı kullanır ancak farklı alanlar döndürür. ws hizmet türü yalnızca kayıt durumunu döndürür. ws_avatar türü boolean bir avatar alanı ve URL yoksa boş olan bir avatar_url alanı ekler. ws_business türü, hesabın WhatsApp Business kullanıp kullanmadığını gösteren bir boolean ekler.

Başarısız veya belirlenemeyen kontroller faturalandırma modelinde nasıl ele alınır?

Başarısız, zaman aşımına uğrayan ve belirlenemeyen kontrollerin ücreti tahsil edilmez. Güncel faturalandırma ayrıntıları için fiyatlandırma sayfasına bakın.

'Kayıtlı' durumu, kullanıcıyla iletişim kurmak için onayım olduğu anlamına mı gelir?

Hayır. Kayıtlı sonucu yalnızca kontrol anındaki bir hesap varlığı sinyali sağlar. Kişi onayını, çevrimiçi durumu, mesaj geçmişini veya numarayla iletişim kurulup kurulamayacağını kontrol etmez.