Gerçek zamanlı WhatsApp kayıt kontrolü senkron bir iş akışına nasıl yerleşir?

Bu ürün için “gerçek zamanlı” ne anlama gelir?

Gerçek zamanlı, kayıt kararının bir arka plan işi, webhook veya sonraki bir dışa aktarım yerine aynı HTTP isteğinde döndürülmesi demektir.

Çağıran taraf normalize edilmiş tek bir telefon numarası gönderir ve yanıtı bekler. Kontrol tamamlandığında data.registered, numaranın istek anında WhatsApp'ta kayıtlı olup olmadığını bildirir. Çağıran taraf, başka bir uç noktayı yoklamadan sonucu hemen kullanabilir.

Bu, dar kapsamlı bir ürün sözleşmesidir. WA Lookup kayıt durumunu kontrol eder; numaranın arkasındaki kişiyi tanımlamaz, hesap etkinliğini izlemez veya bir mesajlaşma hizmeti işletmez. Bu kapsamı açık tutmak, döndürülen alanın doğru kullanılmasını kolaylaştırır.

Senkron kontroller neden faydalıdır?

Senkron bir sonuç, bir sonraki yazılım adımı güncel bir kayıt yanıtına bağlı olduğunda faydalıdır. Uygulamanın numarayı sınıflandırabilmesi için bir iş oluşturması, bir yoklama belirteci saklaması veya bir geri çağrıyı beklemesi gerekmez.

Tipik entegrasyonlar arasında tek bir numarayı kontrol eden dahili bir form, talep üzerine bir kaydı doğrulayan bir destek aracı veya bir arka uç çalışanı yer alır. Küçük listeler için senkron toplu uç nokta en fazla 100 E.164 tanımlayıcı kabul eder ve tamamlanmış toplu işlemi başlatan yanıtta döndürür. İstemciler yine de kendi eşzamanlılıklarını kontrol etmelidir.

Temel mimari fayda belirleyiciliktir: tamamlanmış bir yanıt tek bir boolean kayıt kararı içerir. API hataları ve belirlenemeyen kontroller, registered alanına yeni değerler eklemek yerine dıştaki code, msg ve data zarfını kullanır.

Adım adım istek yolu

1. Telefon numarasını normalize edin — İyi bilinen bir ülke arama kodunu ve ulusal numarayı E.164 biçimine dönüştürün. Eksik ülke bağlamını tahmin etmeyin.
2. Tek bir kontrol gönderin — Kimlik doğrulamalı kontrol uç noktasını normalize edilmiş numara ve service_type=ws ile çağırın.
3. Tamamlanmış sonucu okuyun — code=0 olduğunda data.registered değerini kullanın; API sıfırdan farklı bir iş kodu döndürdüğünde bu değeri boş bırakın.
4. Gözlem zamanını saklayın — Kayıt belirli bir andaki sonuçtur, bu yüzden ne zaman kontrol edildiğini kaydedin.
5. Sonuç olmayan durumları ayrı işleyin — Geçersiz bir istek veya geçici bir hata, false kayıt değeri değil, düzeltme veya yeniden deneme gerektirir.

Sonucu anlamını kaybetmeden modelleyin

valid gibi genel bir alandan kaçının. Bu alan, hatalı biçimlendirilmiş bir girdiyi kayıtlı değil olarak tamamlanan geçerli bir numaradan ayıramaz. Küçük ve açık bir kayıt daha güvenlidir:

HTTP hataları bu kayıt için ek değerler değildir. Bir uygulama bunları günlüğe kaydediyorsa, döndürülen HTTP durumunu ve API code değerini kayıt gözlemlerinden ayrı saklamalıdır.

Pratik bir entegrasyon kuralı

Yalnızca dıştaki yanıtta code=0 olduğunda data.registered değerine göre dallanın.

Bu tek kural en yaygın yorumlama hatasını önler: bir zaman aşımını, reddedilen bir isteği veya hatalı biçimlendirilmiş bir numarayı, WhatsApp numarayı kayıtlı değil olarak bildirmiş gibi değerlendirmek. Kararın daha sonraki bir zamanda güncel olması gerekiyorsa, yeni bir senkron kontrol yapın ve eski zaman damgasını sessizce değiştirmek yerine bunu yeni bir gözlem olarak kaydedin.