Gerçek Zamanlı WhatsApp Numara Kontrolleri için CSV veya TXT Listesi Nasıl Hazırlanır

Gerçek zamanlı WhatsApp kontrolleri için telefon numaralarından oluşan bir CSV veya TXT listesini hazırlamaya yönelik pratik bir iş akışı rehberi: E.164 formatı, hizmet türü seçimi ve eşzamanlı tekli ve çoklu uç noktalardan hesap varlığı sinyallerinin alınması.

WA Lookup, WhatsApp hesap varlığını gerçek zamanlı olarak kontrol eder: tek bir numarayı eşzamanlı kontrol uç noktasına veya en fazla 100 numarayı eşzamanlı çoklu uç nokta POST /api/v1/batch-check'e gönderirsiniz; tamamlanan sonuçlar, beklenecek bir iş olmadan, isteği başlatan HTTP yanıtında döner. Bir CSV veya TXT listesini bu yolla işlemek için her tanımlayıcıyı kesinlikle E.164 uluslararası numaralandırma standardına göre biçimlendirin, sayısal olmayan karakterleri ve yerel önekleri kaldırın ve iş akışınızın ihtiyaç duyduğu hizmet türünü seçin: temel kayıt durumu için ws, avatar mevcudiyetini de eklemek için ws_avatar veya WhatsApp Business hesaplarını belirlemek için ws_business. Tek bir gerçek zamanlı isteğin çok ötesindeki bir dosyanın tamamı da asenkron toplu görev olarak yüklenebilir (yükleyin, bekleyin, indirin).

WhatsApp Doğrulama Sinyallerini Anlamak

Gerçek zamanlı kontroller için bir CSV veya TXT listesi hazırlarken ilk adım, iş akışınızı hangi hesap varlığı sinyalinin desteklediğini belirlemektir. WA Lookup, tamamına aynı eşzamanlı uç noktalar üzerinden erişilen üç farklı hizmet türü sunar. service_type parametresi, yanıtta hangi alanların döndürüleceğini belirler.

Temel Kayıt Kontrolü (ws)

ws hizmet türü, gönderilen bir telefon numarasının şu anda WhatsApp'ta kayıtlı olup olmadığını doğrular. Bu kontrol bir registered alanı döndürerek net bir hesap varlığı sinyali sağlar. CSV veya TXT dosyanızdaki hangi numaraların kontrol anında bir WhatsApp hesabıyla ilişkili olduğuna dair dahili kararlarınıza bilgi sağlar.

Avatar Zenginleştirme Kontrolü (ws_avatar)

ws_avatar hizmet türü, temel kayıt kontrolünü içerir ve profil zenginleştirme yetenekleri ekler. registered durumuna ek olarak bu kontrol, avatar mevcudiyetini gösteren boolean bir avatar değeri ve bir avatar_url dizesi döndürür. Kullanılabilir bir URL olmadığında URL alanı boştur. Bu ek bağlam, kullanıcı profillerini incelerken diğer kontrollerin yanında girdilerden biri olabilir.

İşletme Hesabı Kontrolü (ws_business)

ws_business hizmet türü WhatsApp kaydını kontrol eder ve hesabın WhatsApp Business kullanıp kullanmadığını belirler. Boolean bir business değeri döndürür. Bu sinyal, standart hesapları işletme profillerinden ayırarak ekiplerin listelerini segmentlere ayırmasına ve daha özelleştirilmiş iş akışı yönlendirmesi yapmasına yardımcı olur.

Veri Dosyanızı Hazırlama

Bir CSV veya TXT listesini gerçek zamanlı kontrollerden geçirmenin en kritik şartı doğru veri biçimlendirmesidir. WA Lookup, tüm numaraların E.164 formatında gönderilmesini gerektirir. E.164, her cihaza küresel olarak benzersiz bir tanımlayıcı atayan uluslararası bir telefon numaralandırma planıdır. CSV veya TXT dosyanızı hazırlamak için:

1. Ülke Kodunu Ekleyin: Her numara uygun uluslararası ülke koduyla başlamalıdır.
2. Biçimlendirme Karakterlerini Kaldırın: Listenizdeki boşlukları, tireleri, parantezleri ve diğer tüm sayısal olmayan karakterleri temizleyin.
3. Baştaki Sıfırları Atın: Uluslararası arama kodunun parçası olmayan yerel şehirlerarası öneklerini (genellikle baştaki sıfır) kaldırın.

Örneğin ABD'deki bir numara, ülke koduyla (ör. 1) başlayan kesintisiz bir rakam dizisi olarak biçimlendirilmelidir. Listenizin tamamının E.164 standardına uyduğunu doğrulamak, eşzamanlı kontrol sürecinde biçimlendirme hatalarını önlemeye yardımcı olur. Gönderilen her numara için doğru hesap varlığı sinyallerini almak açısından temiz, standartlaştırılmış bir girdi dosyası şarttır.

Listenizi Doğrulama için Gönderme

CSV veya TXT listeniz doğru biçimlendirildikten sonra tanımlayıcıları WA Lookup platformuna gönderebilirsiniz. Birincil yol eşzamanlıdır: sonuçlar daha sonra iletilmek yerine istekle aynı HTTP yanıtında döndürülür. Hizmeti entegre eden teknik ekipler, tek bir tanımlayıcı için POST /api/v1/check uç noktasını veya en fazla 100 tanımlayıcı için eşzamanlı çoklu uç nokta POST /api/v1/batch-check'i kullanmalıdır. Her iki istek de bir X-API-Key başlığı ve bir Content-Type: application/json başlığı gerektirir. Tekli kontrol gövdesi service_type ve identifier alanlarını, çoklu gövde ise service_type ve identifiers alanlarını içerir. API dokümantasyonundaki eşzamanlılık yönergelerine uyun. Tek bir gerçek zamanlı isteğin çok ötesindeki bir CSV veya TXT dosyasının tamamı da asenkron toplu görev olarak yüklenebilir; gönderirken numaraların ait olduğu ülkeyi seçersiniz ve liste esas olarak o tek ülkeye ait olmalıdır. 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.

Sonuçlarınızı Yorumlama

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. registered sonucu, kontrolün yapıldığı andaki mevcut WhatsApp durum alanlarını bildirir. Bu hesap varlığı sinyalinin sınırlarını anlamak önemlidir. Ayrıca doğrulama süreci canlı çevrimiçi durumu, mesaj geçmişini veya iletişim onayını bildirmez. Numaraya başarıyla ulaşılıp ulaşılamayacağını veya mesajların teslim edilip edilmeyeceğini de göstermez. Sinyal yalnızca dahili veritabanınızı platform kaydı hakkında bilgilendirir; bu, CRM'inizi düzenlerken veya kayıtları yönlendirirken diğer kontrollerin yanında girdilerden biri olabilir.

SSS

Telefon numaraları için gerekli format nedir?

Tüm telefon numaraları kesinlikle E.164 formatında gönderilmelidir. Bu uluslararası numaralandırma planı, ülke kodunu ve tüm sayısal olmayan karakterlerin, boşlukların ve yerel baştaki sıfırların kaldırılmasını gerektirir.

Bir liste genelinde WhatsApp Business durumunu kontrol edebilir miyim?

Evet, ws_business hizmet türünü seçerek hem temel kayıt durumunu hem de hesabın WhatsApp Business kullanıp kullanmadığını kontrol edebilirsiniz. Bu, tekli kontrolde de eşzamanlı çoklu istekte de işletme hesabı varlığını gösteren özel bir boolean değer döndürür.

Bir kontrol başarısız olursa ne olur?

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.

Doğrulama sonuçları asenkron olarak mı iletilir?

Birincil yolda hayır. Eşzamanlı tekli ve çoklu uç noktalar, tamamlanan sonucu istekle aynı HTTP yanıtında döndürür. Büyük bir listenin tamamı için ek seçenek olarak asenkron bir toplu görev (yükleyin, bekleyin, indirin) de mevcuttur; ancak günlük kontroller için doğru tercih eşzamanlı uç noktalardır.