Toplu Telefon Doğrulama API İş Akışı Nasıl Planlanır

Eşzamanlı toplu uç noktalar, E.164 formatı ve WhatsApp hesap varlığı sinyallerini kullanarak toplu telefon doğrulama API iş akışı planlamaya yönelik teknik bir rehber.

Verimli bir toplu telefon doğrulama API iş akışı planlamak; istemci isteklerini eşzamanlı toplu uç noktalar etrafında yapılandırmayı, E.164 numara formatını zorunlu kılmayı ve hesap varlığı sinyallerini doğru şekilde ayrıştırmayı gerektirir. WA Lookup ile sistemler tek bir eşzamanlı HTTP isteğinde en fazla 100 tanımlayıcı gönderir ve doğrulama çıktılarını doğrudan isteği başlatan yanıtın içinde alır. İstekler görev yoklaması, webhook'lar veya arka plan kuyruk gecikmeleri olmadan eşzamanlı yürütüldüğünden, istemci uygulamaların sonraki yönlendirme ve müşteri segmentasyonuna bilgi sağlamak için eşzamanlılığı, zaman aşımlarını ve toplu düzeydeki başarı ya da başarısızlığı gerçek zamanlı olarak ele alması gerekir.

Eşzamanlı Toplu Mimariyi Anlamak

Otomatik bir doğrulama hattı tasarlamak, verilerin dahili hizmetleriniz ile doğrulama uç noktası arasında nasıl hareket ettiğini kavramakla başlar. Birçok kurumsal sistem; arka plan işçi kuyrukları, durum yoklaması veya webhook dinleyicileri içeren asenkron toplu işleme bekler. WA Lookup ise hem tekli kontroller hem de toplu işlemler için eşzamanlı bir istek-yanıt modeli uygular. Bu modelde istemci uygulamanız bir HTTP POST isteği başlatır ve tamamlanmış doğrulama verilerini doğrudan yanıt gövdesinde alır. Toplu uç nokta, tek bir yükte en fazla 100 telefon numarası kabul eder. İşleme istek sürerken gerçekleşir; tüm koleksiyon için sonuç döndürülür ya da toplu istek bir bütün olarak başarısız olur. Bu da iş kimliklerini takip etme, geçici iş durumlarını bir veritabanında saklama veya webhook dinleyici altyapısını yönetme gibi operasyonel yükleri ortadan kaldırır. Yanıtlar eşzamanlı döndüğü için mühendislik ekiplerinin uygulama HTTP istemcilerini uygun şekilde yapılandırması gerekir. İstek zaman aşımı ayarları, en fazla 100 tanımlayıcının değerlendirilmesi için gereken süreyi karşılamalıdır. Ekipler, keyfi dakika başı kotalara dayalı hız sınırlama katmanları uygulamak yerine, istemci tarafı bağlantı havuzlarını resmi API dokümantasyonunda ayrıntılı olarak açıklanan kullanıcı başına eşzamanlılık denetimleri ve zaman aşımı politikaları etrafında tasarlamalıdır.

Telefon Numaralarını Hazırlama ve Normalleştirme

Dayanıklı bir doğrulama hattı, kayıtlar ağ katmanına ulaşmadan önce istemci tarafında sıkı bir veri hijyeni gerektirir. Doğrulama API'si, gönderilen her telefon numarasının uluslararası E.164 standardına uymasını şart koşar. Biçimlendirilmemiş, yerel formatta veya hatalı numaralar göndermek doğrulama hatalarına ya da belirlenemeyen sonuçlara yol açar. E.164 formatı, telefon numaralarını baştaki artı işaretini, ülke arama kodunu ve ulusal abone numarasını içeren; boşluk, tire, parantez veya şehirlerarası sıfırı gibi önekler barındırmayan tek bir dizeye standartlaştırır. İstemci hatları normalleştirmeyi otomatik bir ön işleme adımı olarak yürütmelidir:

1. Noktalama işaretleri, boşluklar ve biçimlendirme sembolleri gibi sayısal olmayan karakterleri kaldırın.
2. Hedeflenen ülke kodunu ülke meta verilerine veya kullanıcı giriş alanlarına göre belirleyin.
3. Yurt içi aramalarda sıkça kullanılan baştaki sıfırlar gibi yerel önekleri kaldırın.
4. Başa uluslararası ülke arama kodunu ve artı işaretini ekleyin.
5. Toplu gruplara ayırmadan önce dize uzunluğunu standart ülke spesifikasyonlarına göre doğrulayın.

Normalleştirme tamamlandıktan sonra kayıtlarınızı, yük başına en fazla 100 tanımlayıcı içeren ayrı toplu gruplara bölün. Grupları bu üst sınırda veya altında tutmak, toplu uç nokta sözleşmesiyle uyumluluğu garanti eder.

Uygun Kontrol Yeteneğini Seçme

Doğrulama iş akışları, operasyonel kişi listesi temizliğinden zenginleştirilmiş satış yönlendirmesine kadar farklı iş işlevlerine hizmet eder. WA Lookup, service_type parametresi aracılığıyla üç farklı kontrol yeteneği sunarak ekiplerin yalnızca iş akışları için gerekli veri noktalarını talep etmesine olanak tanır:

Doğru yeteneği seçmek, sistemlerin yük işleme maliyetini en aza indirmesine yardımcı olur. Ekiplerin yalnızca bir tanımlayıcının WhatsApp'ta kayıtlı olup olmadığını bilmesi gereken yüksek hacimli filtrelemede standart ws kontrolü verimli bir erişilebilirlik göstergesi sağlar. Potansiyel müşteri kalitesine veya ticari sınıflandırmaya öncelik veren CRM iş akışlarında ise ws_business, hesabın resmi bir WhatsApp Business varlığı olarak faaliyet gösterip göstermediğini belirleyerek değerli bir yönlendirme bağlamı sunar.

API Yanıtlarını ve Hata Durumlarını Ele Alma

Sağlam bir entegrasyon, yanıt yüklerinin deterministik biçimde ayrıştırılmasını ve dayanıklı hata yönetimini gerektirir. Tamamlanan istekler code, msg ve data alanlarından oluşan standart bir JSON zarfı döndürür. Tamamlanan kontrollerde data nesnesi service_type, identifier ve boolean bir registered değeri içerir. Çıktı nesnelerini ayrıştırırken sistemlerin durum gösterimlerini hassas şekilde ele alması gerekir:

• Başarılı Belirlemeler: Tamamlanan bir kontrol registered: true veya registered: false sağlar. ws_avatar kullanıldığında yanıt ayrıca avatar boolean değerini ve avatar_url alanını (boş bir dize olabilir) içerir. ws_business kullanıldığında business boolean değerini içerir.
• Belirlenemeyen Sonuçlar: Bir tanımlayıcı kontrol anında kesin olarak belirlenemezse API, null değerli tamamlanmış bir sonuç nesnesi yerine sıfır olmayan bir iş kodu döndürür. İstemci uygulamalar, data özelliklerini ayrıştırmaya çalışmadan önce en üst düzeydeki code alanını incelemelidir.
• Faturalandırma ve İadeler: Faturalandırma kontrol başına yapılır. Bir kontrol başarısız olduğunda veya belirlenemeyen bir durumla sonuçlandığında platform, ilgili bakiyeyi otomatik olarak hesaba iade eder. Sonraki hizmetler yalnızca belgelenmiş genel yanıt alanlarına dayanmalıdır.

Hesap Varlığı Sinyallerini İş Mantığına Dönüştürme

Toplu doğrulama iş akışının son aşaması, doğrulanmış kayıtları dahili yönlendirme sistemlerine, CRM sistemlerine veya iletişim gönderim motorlarına aktarmayı kapsar. Veri bütünlüğünü korumak için ekiplerin bir platform kayıt sinyalinin neyi temsil ettiğini doğru yorumlaması gerekir. Bu sinyal, tanımlayıcının platformda kayıtlı olduğunu doğrular. Kuruluşlar kayıt sonuçlarını mevcut operasyonel verilerin yanında karar destek girdileri olarak kullanmalıdır. Örneğin pazarlama ve destek platformları, erişilebilirlik sinyallerini kullanarak kayıtlı numaralara mesajları WhatsApp üzerinden yönlendirebilir, kayıtlı olmayan kişileri ise SMS veya e-posta gibi alternatif iletişim kanallarına yönlendirebilir. Bu doğrulanmış sinyalleri sürece dahil etmek, ekiplerin operasyonel kaynakları optimize etmesine, başarısız mesaj gönderim girişimlerini azaltmasına ve düzenli kişi depoları sürdürmesine yardımcı olur.

SSS

Toplu doğrulama API'si asenkron kuyrukları veya webhook'ları destekliyor mu?

Hayır. Doğrulama API'si eşzamanlı bir istek-yanıt mimarisiyle çalışır. İster tek bir tanımlayıcıyı ister en fazla 100 numaralık bir grubu kontrol etsin, her istek eksiksiz sonucunu isteği başlatan HTTP yanıtında döndürür. Görev gönderim belirteçleri, yoklama döngüleri, webhook geri çağrıları veya indirilebilir dosya dışa aktarımları kullanmaz.

Bir gruptaki tanımlayıcı işlenemezse ne olur?

Eşzamanlı toplu uç nokta, gönderimleri atomik bir birim olarak işler: grubun tamamını döndürür ya da bir bütün olarak başarısız olur. Tek tek kontroller belirlenemediğinde API, eksik bir sonuç nesnesi yerine sıfır olmayan bir iş kodu döndürür; belirlenemeyen veya başarısız kontroller otomatik olarak iade edilir.

Sistemler tek numaralı ve toplu kontroller için aynı kimlik bilgilerini kullanabilir mi?

Evet. İstemci sistemler hem tek numaralı istekleri hem de toplu istekleri aynı X-API-Key başlığıyla doğrular. Ortak hesap bakiyeleri, eşzamanlılık denetimleri ve raporlama panelleri tüm doğrulama yöntemleri için geçerlidir.

Daha Fazla Bilgi

İş akışınızdaki bir sonraki adıma uygun ürün bilgisini seçin.

• Ürün dokümantasyonunu görüntüleyin →
• Ekiple görüşün →