CSV'deki Telefon Numaraları Toplu Olarak Nasıl Doğrulanır konulu WA Lookup iş akışı görseli
Bu WA Lookup makalesinde ele alınan iş akışına görsel bir genel bakış.

Telefon numaralarından oluşan bir CSV'yi E.164 formatında nasıl hazırlayacağınızı ve anında hesap varlığı sinyalleri için WA Lookup'ın gerçek zamanlı tekli ve çoklu uç noktalarından nasıl geçireceğinizi öğrenin.

WA Lookup, WhatsApp hesap varlığını gerçek zamanlı olarak doğrular: E.164 formatındaki bir numarayı POST /api/v1/check uç noktasına veya en fazla 100 numarayı eşzamanlı çoklu uç nokta POST /api/v1/batch-check'e gönderirsiniz ve tamamlanan sonuç aynı HTTP yanıtında döner. Bir CSV bu istekler için yalnızca bir kaynaktır: sütunu standartlaştırın, bir hizmet türü seçin ve tanımlayıcıları çoklu uç nokta üzerinden her seferinde en fazla 100 adet olacak şekilde gönderin. Tek bir gerçek zamanlı isteğin çok ötesindeki bir dosyanın tamamı da asenkron toplu görev olarak yüklenebilir.

Verilerinizi Doğrulamaya Hazırlama

Herhangi bir API isteği başlatmadan önce CSV dosyanızın doğru biçimlendirilmesi gerekir. WA Lookup, gönderilen tüm telefon numaralarının E.164 formatını kullanmasını şart koşar. Bu uluslararası telefon numaralandırma planı, her numaranın benzersiz ve açık olmasını öngörür; numara genellikle artı işaretiyle başlar, ardından ülke kodu ve abone numarası gelir. CSV sütununuzu bu formata göre standartlaştırmak, API çağrısı sırasındaki hataları azaltır ve iş akışı girdisinin doğru işlenmesini destekler.

Doğru WhatsApp Kontrol Türünü Seçme

WA Lookup, eşzamanlı tekli kontroller ve eşzamanlı çoklu kontroller için aynı üç hizmet türünü sunar. İş akışınızın gerektirdiği hesap varlığı sinyaline uyan türü seçin.

Hizmet Türü Kapsam ve Döndürülen Sinyaller
ws Standart platform kayıt durumunu döndürür (registered boolean).
ws_avatar Kaydı kontrol eder ve profil zenginleştirme ekler (avatar boolean ve kullanılabilir URL olmadığında boş olan avatar_url dizesi).
ws_business Kaydı kontrol eder ve WhatsApp Business hesaplarını belirler (business boolean).

service_type parametresi, hangi alanların döndürüleceğini ve hangi bakiye maliyetinin uygulanacağını belirler.

Doğrulama İş Akışınızı Yürütme

Bir CSV için, biçimlendirilmiş en fazla 100 tanımlayıcıyı tek seferde işlemek üzere eşzamanlı çoklu uç nokta POST /api/v1/batch-check'i, tek bir tanımlayıcı için ise POST /api/v1/check uç noktasını kullanın. Her ikisi de sonuçları, görev gönderimi, yoklama veya indirme adımı olmadan, isteği başlatan HTTP yanıtında döndürür. Tamamlanmış bir WhatsApp kontrolünde döndürülen data; service_type, identifier ve registered alanlarını içerir; ws_avatar ayrıca avatar ve avatar_url alanlarını, ws_business ise business alanını içerir. Dahili kayıt, işlem, durum ve faturalandırma alanları döndürülmez.

Maliyetleri ve Sonuçları Yönetme

Ekipler WA Lookup panelini API anahtarlarını yönetmek, kontrol geçmişini incelemek ve bakiye ile ürün düzeyindeki kullanımı izlemek için kullanabilir. Çoklu istek API üzerinden eşzamanlı olarak çalışır; panel ise hesap ve kullanım görünürlüğü sağlar. Yeni hesaplar, daha büyük CSV dosyalarını işlemeden önce kayıt, avatar ve işletme hesabı kontrollerini denemek için 100 ücretsiz kontrol talep etmek üzere destek ekibiyle de iletişime geçebilir.

SSS

ws, ws_avatar ve ws_business arasındaki fark nedir?

ws hizmet türü standart platform kayıt durumunu döndürür. ws_avatar türü, avatar mevcudiyetini ve kullanılabilir bir URL olmadığında boş olan bir avatar URL alanını ekler. ws_business türü kaydı kontrol eder ve numaranın bir WhatsApp Business hesabıyla ilişkili olup olmadığını belirler.

Tek bir istekte birden fazla numarayı kontrol edebilir miyim?

Evet. Eşzamanlı çoklu uç nokta POST /api/v1/batch-check en fazla 100 tanımlayıcı kabul eder ve tamamlanan sonuçları, görev gönderimi, yoklama veya indirme adımı olmadan, aynı HTTP yanıtında döndürür. Bunun çok ötesindeki bir listenin tamamı için asenkron bir toplu görev de mevcuttur (gönderirken numaraların ait olduğu ülkeyi seçersiniz ve liste esas olarak o tek ülkeye ait olmalıdır); ancak eşzamanlı uç noktalar kontrol yapmanın birincil yolu olmaya devam eder.

Başarısız kontroller bakiyemden düşülür mü?

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

Kaynaklar