WhatsApp Lookup API: Gerçek Zamanlı Kayıt Kontrolleri Açıklandı

WhatsApp lookup API'nin senkron gerçek zamanlı kayıt kontrollerini, yanıt ayrıştırmayı ve temiz iletişim hatları için yüksek hacimli iş akışlarını nasıl yönettiğini öğrenin.

WA Lookup API, bir telefon numarasının sorgu anında WhatsApp'ta kayıtlı olup olmadığını doğrulamak için senkron gerçek zamanlı doğrulama sağlar. Özel REST uç noktalarını sorgulayarak, ekipler başlatan HTTP yanıtı içinde anında hesap varlığı sinyalleri alırlar. Bu mimari, tek numaralı kontrolleri ve senkron çoklu istekleri destekleyerek kuruluşların yönlendirme kuyruklarını temizlemelerine, teslimat iş akışlarını korumalarına ve tahsis edilmemiş numaralara mesaj göndermekten kaçınmalarına yardımcı olur.

WhatsApp Kayıt Sinyallerini Anlamak

Bir kayıt kontrolü, belirli bir tanımlayıcının kontrol anında platformda bir hesabı olup olmadığını değerlendirir. Bu platform varlığı sinyali, iletişimi başlatmadan önce teknik erişilebilirlik bağlamı sağlar.

Telefon numaraları, ITU-T Recommendation E.164 belgesinde açıklanan ve ülke kodlarını zorunlu kılan ve uzunluğu 15 haneyle sınırlayan uluslararası kamu telekomünikasyon formatına uymalıdır. Numaraları E.164 yapısında değerlendirmek, giriş verilerini uluslararası sistemler genelinde standartlaştırır.

Operasyonel açıdan, kayıt verileri kimlik, hat sahipliği veya alıcı onayı oluşturmaktan ziyade kitle yönlendirmesini bilgilendirir. Ticari erişim sağlayan kuruluşlar, WhatsApp Business Messaging Policy ile uyumlu olmak için ayrı opt-in onay kayıtları tutmalıdır. Hesap varlığı kontrollerini GDPR Article 5 (Regulation (EU) 2016/679) kapsamındaki veri minimizasyonu gereklilikleriyle uyumlu hale getirmek, sistemlerin yalnızca teslimat iş akışları için gerekli olan teknik erişilebilirlik göstergelerini işlemesini sağlar.

Senkron Gerçek Zamanlı Doğrulama İş Akışları

WhatsApp lookup API, anında ve satır içi karar hatları için tasarlanmış senkron uç noktalar sunar. Bu uç noktalar senkron çalıştığından, başlatan HTTP isteği, ikincil bir yoklama döngüsüne gerek kalmadan doğrulama özniteliklerini doğrudan yanıt yükünde alır.

Tek Numaralı Kontrol

Kayıt formları veya tekil müşteri girişleri gibi işlemsel olaylar için entegrasyon, X-API-Key kimlik doğrulama başlığını kullanarak POST /api/v1/check isteğinde bulunur. İstek, bir E.164 telefon dizisi gönderir ve hedef hizmet türünü seçer.

Senkron Çoklu Kontrol

İş akışları daha küçük kuyrukların aynı anda doğrulanmasını gerektirdiğinde, POST /api/v1/batch-check tek bir çağrıda 100 adede kadar telefon numarasını kabul eder. Uç nokta, tüm grubu senkron olarak değerlendirir ve birleştirilmiş sonuç kümesini başlatan yanıtta döndürür.

İstek hacmini yöneten geliştiriciler, platform kapasiteyi sabit dakika başı istek tavanları yerine eşzamanlılık kontrolleriyle yönettiğinden, kullanıcı başına eşzamanlılık ve zaman aşımı parametreleri için resmi belgeleri incelemelidir.

Gerçek Zamanlı Hizmet Kontrol Türlerinin Karşılaştırılması

Lookup API, farklı risk ve zenginleştirme gereksinimlerini desteklemek için kayıt sorgularını üç özel gerçek zamanlı hizmet türüne ayırır.

ws seçimi, temel erişilebilirlik göstergesini sağlar. Profil zenginleştirme gerektiren iş akışları için ws_avatar, erişilebilir olduğunda profil fotoğrafı kullanılabilirliğini ve barındırılan görsel bağlantısını ekler. ws_business seçeneği, kayıtlı telefonun WhatsApp Business platformunda çalışıp çalışmadığını tanımlayarak tüketici ve ticari hesaplar arasında segmentasyonu destekler.

Durum Kodlarını ve Bakiye Tüketimini Yorumlama

Genel API yanıtları, tamamlanmış kontrolleri code, msg ve data içeren standart zarf alanlarını kullanarak biçimlendirir. Karar verilmiş sonuçları hizmet hatalarından doğru bir şekilde ayrıştırmak, güvenilir veri hatları için kritiktir.

Tamamlanmış bir kontrol, data.registered değeri true veya false olarak ayarlanmış bir başarı yanıt kodu üretir. Hem karar verilmiş true hem de karar verilmiş false kayıtları, tamamlanmış aramaları temsil eder ve bakiyeyi buna göre tüketir.

Belirlenemeyen bir durum veya yukarı yönlü hizmet kesintisi, registered=false değeri yerine sıfır olmayan bir iş kodu döndürür. Aşağı yönlü sistemler, sıfır olmayan kodları tahsis edilmemiş telefon numaraları olarak ele almak yerine yeniden deneme mantığı için izole etmelidir. Kayıtlı kullanıcılar, geliştirme ortamlarında yanıt işlemeyi doğrulamak için 100 ücretsiz kontrol almak üzere destek ekibiyle iletişime geçebilirler.

Liste İşleme İçin Asenkron Toplu İşler

Senkron uç noktalar canlı müşteri etkileşimlerini yönetirken, büyük veri geçişleri asenkron bir iş akışı gerektirir. Dosya tabanlı doğrulama için ekipler, veri kümelerini göndermek için POST /api/v1/bulk-tasks ve işleme ilerlemesini izlemek için GET /api/v1/bulk-tasks/{id} uç noktalarını kullanır.

Toplu iş dosyaları, satır başına bir telefon numarası içeren TXT veya CSV belgeleri olarak gönderilmelidir. Dosya tek bir ülke hedefine odaklanmalıdır, çünkü hedef ülke dışındaki numaraların %10 veya daha fazlasını içeren listeler ön kontrol reddini tetikler. Ürün bazlı dosya limitleri geçerlidir ve ekipler güncel dosya boyutlandırma kuralları için resmi belgelere başvurmalıdır.

Bölgesel kapsam da iş akışları arasında farklılık gösterir. Gerçek zamanlı tek numaralı kontroller, daha düşük hacimlerde Çin ana karası (+86), Hong Kong (+852) ve Makao (+853) numaralarını desteklerken, asenkron toplu dosya işleri bu hedefleri hariç tutar. Tayvan kapsamı tüm işleme modlarında doğrulanmamış durumdadır.

SSS

Gerçek zamanlı senkron kontroller, asenkron toplu işlerden nasıl farklıdır?

Gerçek zamanlı kontroller, numaraları doğrudan POST /api/v1/check veya POST /api/v1/batch-check uç noktalarına gönderir ve sonuçları aynı HTTP yanıtında anında iletir. Asenkron toplu işler, POST /api/v1/bulk-tasks aracılığıyla biçimlendirilmiş dosyaları kabul eder, önce bir görev kimliği döndürür ve işleme tamamlandığında indirilebilir bir sonuç CSV'si oluşturur.

API, belirlenemeyen kontroller için ücretlendirmeyi nasıl yönetir?

Hem kayıtlı hem de kayıtlı olmayan tamamlanmış değerlendirmeler standart kontrol kullanımına tabidir. Buna karşılık, belirlenemeyen veya hizmet hatası içeren bir sonuç, false değeri yerine sıfır olmayan bir durum kodu döndürür ve başarısız kontroller bakiyeyi tüketmez.

Daha Fazla Bilgi Edinin

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

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