WhatsApp kayıt sorgulaması nasıl yapılır?

İşletme ve teknik ekipler için WA Lookup platformunu kullanarak senkron WhatsApp kayıt kontrolleri yapmaya yönelik, tek numara ve toplu iş akışlarını kapsayan pratik bir rehber.

WhatsApp kayıt sorgulaması, belirli bir telefon numarasının şu anda bir WhatsApp hesabıyla ilişkili olup olmadığını teyit eden senkron bir kontroldür. Kuruluşlar WA Lookup platformunu kullanarak tek numaralar veya küçük toplu işlemler için gerçek zamanlı hesap varlığı sinyalleri alabilir. Bu kontroller, dahili inceleme iş akışlarına yön verecek verileri anında sağlar ve ekiplerin güncel platform kaydına göre kitleleri segmentlere ayırmasına ve iletişimi önceliklendirmesine yardımcı olur.

WhatsApp kayıt sinyallerini anlamak

Kuruluşlar kişi listelerini işlerken WhatsApp kayıt sinyali, kontrolün yapıldığı tam andaki hesap varlığının net bir göstergesini sağlar. Bu sinyal, gönderilen bir E.164 telefon numarasının platformda kayıtlı olduğunu teyit eder. WA Lookup platformu bu verileri senkron olarak döndürür ve ekiplerin sonucu doğrudan operasyonel iş akışlarına entegre etmesini sağlar. Bu sinyalin iş süreçleri içindeki kapsamını doğru belirlemek önemlidir. Kayıt sonucu yalnızca hesap varlığını bildirir. Sinyali diğer kontrollerin yanında bir girdi olarak değerlendiren ekipler, belirli bir kişinin erişilebilirliğini olduğundan fazla tahmin etmeden iletişim stratejilerini daha iyi düzenleyebilir.

Tek numara sorgulaması yapmak

Ekipler, WA Lookup senkron REST API'sini kullanarak tek tek telefon numaralarını doğrulayabilir. Belgelenmiş istek sözleşmesi bir POST /api/v1/check isteği gönderilmesini gerektirir. Bu istek, kimlik doğrulama için bir X-API-Key başlığı ve hedef E.164 telefon numarası ile bir service_type alanını içeren bir JSON yükü içermelidir. Mimari tamamen senkron olduğundan API, tamamlanmış sonucu başlatan HTTP yanıtında döndürür. Tamamlanmış bir kontrol için dış yanıt zarfı code, msg ve data alanlarını içerir. Bir kontrol hakkında karar verilemezse API, tamamlanmış bir sonuç nesnesi yerine sıfırdan farklı bir iş kodu döndürür.

Standart kayıt kontrolü

ws hizmet türünü kullanmak temel veri nesnesini döndürür. Bu nesne service_type, identifier ve hesap varlığını gösteren boolean bir registered alanını içerir.

Profil fotoğrafı zenginleştirme kontrolü

ws_avatar hizmet türünü seçmek standart kayıt kontrolünü gerçekleştirir ve yanıta avatar ile avatar_url alanlarını ekler. avatar_url, hesabın yapılandırmasına bağlı olarak boş bir dize olarak dönebilir.

İşletme profili kontrolü

ws_business hizmet türü standart kaydı kontrol eder ve hesabın WhatsApp Business kullanıp kullanmadığını belirtmek için boolean bir business alanı ekler.

Toplu sorgulamaları işlemek

Daha yüksek işlem hacmi gerektiren iş akışları için WA Lookup senkron bir toplu uç noktayı destekler. Kuruluşlar tek bir istekte en fazla 100 tanımlayıcı gönderebilir. Bu yetenek, tek numara kontrolüyle aynı gerçek zamanlı yanıt modelini korurken verimlilik için tasarlanmıştır. Toplu uç nokta gönderilen E.164 numaralarını işler ve sonuç kümesinin tamamını tek bir yanıtta döndürür ya da bütün olarak başarısız olur. Bu, karmaşık asenkron mimarilere olan ihtiyacı ortadan kaldırır. Ekiplerin verilerini almak için görev gönderme kuyrukları, yoklama mekanizmaları veya geri çağrı webhook'ları uygulaması gerekmez. Senkron tasarım, toplu sonuçların sonraki yönlendirme veya segmentasyon için hemen kullanılabilir olmasını sağlar.

Sonuçlara panel veya API üzerinden erişmek

Kuruluşlar WA Lookup ile bir SaaS web paneli üzerinden veya REST API aracılığıyla programatik olarak etkileşim kurabilir. Her iki erişim yöntemi de aynı senkron sonuç semantiğini ve aynı hesap bakiyesini paylaşır. Web paneli; API anahtarlarını yönetmek, hesap bakiyesini görüntülemek ve kontrol geçmişini analiz etmek için görsel bir arayüz sunar. Ekipler ürün düzeyinde raporlamaya erişebilir, son kontrolleri inceleyebilir, bakiye harcamasını izleyebilir ve 7 günlük kullanım eğilimlerini gözlemleyebilir. Programatik erişim için API dokümantasyonu, kullanıcı başına eşzamanlılık ve zaman aşımı kontrollerini açıklar. Faturalandırma kontrol başına ödeme modeliyle işler; başarısız veya belirlenemeyen kontroller otomatik olarak iade edilir.

MCP uyumlu yapay zekâ istemcileriyle entegrasyon

WA Lookup, standart REST API erişimine ek olarak resmî bir Model Context Protocol (MCP) Sunucusu sunar. Bu sunucuya web sitesinin /mcp yolunda Streamable HTTP ve JSON-RPC üzerinden erişilebilir. Claude Code veya Claude Desktop gibi MCP uyumlu yapay zekâ istemcilerinin kontrol araçlarıyla doğrudan etkileşim kurmasını sağlar. MCP entegrasyonu müşterinin mevcut API anahtarını kullanır ve ürünleri, bakiyeyi, eşzamanlılık limitlerini ve faturalandırmayı REST API ile birebir paylaşır. Yapay zekâ asistanına belirli araçlar sunar: mevcut ürünleri listelemek, tek bir E.164 numarasını kontrol etmek, en fazla 100 numaralık küçük bir toplu işlemi senkron olarak kontrol etmek ve hesap bakiyesini sorgulamak. Standart API gibi MCP çağrıları da gerçek zamanlı ve senkrondur; asenkron görevler veya indirilebilir dosyalar oluşturmadan hesap varlığı sinyalleri döndürür.

SSS

'Kayıtlı' durumu ne anlama gelir?

Kayıtlı sonucu, gönderilen E.164 telefon numarasının kontrol anında bir WhatsApp hesabıyla ilişkili olduğunu gösterir. Dahili iş akışlarına yön vermek için bir hesap varlığı sinyali işlevi görür.

Kuruluşlar birden fazla numarayı aynı anda kontrol edebilir mi?

Evet. WA Lookup, tek bir istekte en fazla 100 tanımlayıcı kabul eden senkron bir toplu uç nokta sunar. Toplu işlemin tamamı işlenir ve aynı HTTP yanıtında döndürülür.

Ekipler test için hesap kredisine nasıl erişebilir?

Yeni hesaplar, hizmeti denemek ve senkron API ya da panel özelliklerini değerlendirmek için kullanılabilecek 100 ücretsiz kontrol almak üzere destek ekibiyle iletişime geçebilir.

API için dakika başına istek limitleri var mı?

Herkese açık API dokümantasyonu, katı bir dakika başına istek hızı limiti yerine kullanıcı başına eşzamanlılık ve zaman aşımı kontrollerini açıklar. Ekipler geçerli davranış ve eşzamanlılık yönergeleri için güncel API dokümantasyonuna başvurmalıdır.