WhatsApp Checker API: Arka Uçtan Kayıt Kontrolü

Arka uç ekiplerinin bir WhatsApp Checker API'yi nasıl çağıracağı, WhatsApp Kayıt Kontrolü, WhatsApp Profil Fotoğrafı Kontrolü ve WhatsApp Business Hesabı Kontrolü arasında nasıl seçim yapacağı ve karara bağlanamayan sonuçları nasıl yöneteceği.

Bir WhatsApp Checker API, sunucunuzdan bir telefon numarası alır ve aynı yanıt içerisinde, kontrol anında bu numarada bir WhatsApp hesabının kayıtlı olup olmadığını döndürür. WA Lookup sisteminde, tek bir numara X-API-Key başlığındaki anahtar ve WhatsApp Kayıt Kontrolü, WhatsApp Profil Fotoğrafı Kontrolü veya WhatsApp Business Hesabı Kontrolü seçeneklerinden birini belirleyen bir service_type ile POST /api/v1/check adresine gönderilir; POST /api/v1/batch-check ise tek bir senkron istekte 100 numaraya kadar işlem yapabilir. Karara bağlanamayan bir kontrol, sıfır olmayan bir iş kodu döndürür; arka uç kodu bunu "kayıtlı değil" yanıtı olarak değil, "daha sonra tekrar dene" şeklinde ele almalıdır.

Bir WhatsApp Checker API arka uca ne sağlar?

Bu sorgu için arama sonuçları çoğunlukla pazar yeri listelemelerinden ve bir telefon parametresi ile doğru veya yanlış yanıtı gösteren API sarmalayıcılarından oluşur. Bunların birçoğu kontrolleri bağlı bir WhatsApp oturumu üzerinden çalıştırır, bu nedenle o telefon çevrimdışı olduğunda API yanıt vermeyi durdurur. Çok azı, yanıtın onu tüketen kod için ne anlama geldiğini veya yanıtın mümkün olmadığı durumların nasıl yönetileceğini açıklar.

Arka uç çalışmaları için yararlı zihinsel model basittir. Bir WhatsApp Checker API, numara başına tek bir soruya yanıt verir: Kontrol çalıştırıldığında bu numarada bir WhatsApp hesabı kayıtlı mıydı? Bu, tek bir platform için bir hesap varlığı sinyalidir. Aşağıdaki durumlar için iyi bir girdidir:

• Başka bir kanaldan önce WhatsApp'ın bir kişi için denenmeye değer olup olmadığına karar vermek;
• Bir CRM veya potansiyel müşteri veritabanındaki telefon alanını temizlemek;
• Bir kayıt veya işe alım inceleme kuyruğuna bağlam eklemek.

Bu, numaranın kime ait olduğu veya kişinin iletişime geçilmesini kabul edip etmediği hakkında bir beyan değildir. Onay kayıtlarınızı ve iletişim geçmişinizi ayrı girdiler olarak tutun ve değerin daha sonra yenilenebilmesi için her kontrolün tarihini saklayın.

Tek bir numara için WhatsApp Checker API nasıl çağrılır?

Tek numaralı çağrı, tek bir yanıt içeren tek bir HTTPS isteğidir. Oluşturulacak bir iş, yoklanacak bir şey veya açığa çıkarılacak bir geri arama URL'si yoktur.

1. E.164 formatına normalleştirin. Numarayı, ITU-T E.164 numaralandırma planına uygun olarak artı işareti, ülke kodu ve ulusal numara ile gönderin. Boşlukları, parantezleri ve ulusal önekleri kaldırın. Yerel olarak 0151 2345 6789 olarak yazılan bir Alman cep telefonu numarası +4915123456789 haline gelir. Google'ın libphonenumber kütüphanesi, ham girdiyi varsayılan bir bölge ile ayrıştırır ve elle yazılmış Regex kurallarından daha güvenlidir.
2. Kontrolü seçin. Sonucun yönlendireceği karara bağlı olarak service_type değerini ws, ws_avatar veya ws_business olarak ayarlayın.
3. Sunucudan kimlik doğrulaması yapın. Anahtarı X-API-Key başlığında gönderin. Anahtarı gizli bir depodan veya ortam yapılandırmasından yükleyin; asla tarayıcı koduna, mobil uygulama paketine veya herkese açık bir depoya yerleştirmeyin.
4. POST /api/v1/check isteğini gönderin. O numara için sonuç, aynı isteğin yanıtında gelir.
5. Sonuca göre dallandırın. Tamamlanmış bir sonuç, seçilen kontrol için yanıtı taşır. Sıfır olmayan bir iş kodu, kontrolün şimdilik karara bağlanamadığı anlamına gelir.

İstek gövdesini ve yanıt ayrıştırmasını güncel WA Lookup API dokümantasyonuna göre oluşturun. Diğer sağlayıcıların örneklerindeki yükler farklıdır ve bunları kopyalamak, entegrasyon hatalarının yaygın bir kaynağıdır.

Kontrol türünü seçme: ws, ws_avatar veya ws_business

service_type değeri, hangi sinyalin geri geleceğine karar verir. Kodunuzun sorduğu soruyu yanıtlayan en dar kapsamlı kontrolü seçin, çünkü tamamlanan her kontrol, yanıtın Kayıtlı veya Kayıtlı değil olmasına bakılmaksızın ücretlendirilir.

ws

WhatsApp Kayıt Kontrolü. Arka uca, gönderilen numarada kontrol anında kayıtlı bir WhatsApp hesabı olup olmadığını bildirir. Kanal kararları, liste temizleme ve kayıt incelemesi için varsayılan budur.

ws_avatar

WhatsApp Profil Fotoğrafı Kontrolü. Kayıt durumunun yanı sıra, bir profil fotoğrafının mevcut olup olmadığını ve varsa buna giden bir bağlantıyı raporlar. Bağlantı boş bir dize olabilir. Bunu, iletişim kaydını zenginleştirmek veya bir insan incelemeciye daha fazla bağlam sağlamak için kullanın. Eksik bir fotoğraf, numaranın kayıtlı olup olmadığı hakkında hiçbir şey söylemez.

ws_business

WhatsApp Business Hesabı Kontrolü. Kayıt durumunun yanı sıra, hesabın WhatsApp Business app veya iş platformu ile oluşturulmuş bir WhatsApp Business hesabı olup olmadığını raporlar. Satış ekipleri bunu, iş hesaplarını standart hesaplardan ayırmak için kullanır. Yalnızca hesap türünü tanımlar ve yasal bir şirket kontrolü değildir.

Toplu kontrol uç noktası ile 100 numaraya kadar kontrol etme

Bir arka uç, gece yapılan bir içe aktarma veya birkaç kişiyi içeren bir form gönderimi gibi bir grup numarayı zaten elinde tuttuğunda, POST /api/v1/batch-check tek bir senkron istekte 100 numaraya kadar gönderim sağlar. Tüm grup, o isteğin yanıtında geri gelir veya isteğin tamamı başarısız olur.

Bu davranış, istemci kodunu şu şekilde şekillendirir:

• Daha büyük listeleri parçalara ayırın. Girdiyi 100 veya daha az kişilik gruplara bölün ve bunları arka arkaya veya işlem sırasında küçük, kontrollü bir sayıyla gönderin.
• Başarısız bir isteği bir birim olarak ele alın. Toplu istek başarısız olursa, o parçayı yeniden deneyin; numaralarını herhangi bir sonuçla işaretlemeyin.
• Yine de numara bazlı sonuçları okuyun. Başarılı bir toplu işlem içinde, her numaranın kendi tamamlanmış veya karara bağlanmamış sonucu vardır, bu nedenle tek numaralı akıştaki dallanma mantığı her giriş için geçerlidir.
• Önce tekilleştirin. Parçalara ayırmadan önce normalleştirme yapmak, genellikle farklı yerel formatlarda yazılmış kopyaları ortaya çıkarır; her numarayı bir kez kontrol etmek harcamaları öngörülebilir tutar.

Toplu uç nokta hala aynı yanıtlı bir akıştır. Uygulama kodu tarafından işlenen on veya birkaç yüz numara için doğru araçtır, çok büyük bir listeye sahip bir dosya için değildir.

Karara bağlanamayan kontrolleri ve istek hatalarını yönetme

En maliyetli entegrasyon hatası, kontrol hiçbir karara ulaşmadığında veritabanına "Kayıtlı değil" yazmaktır. Tamamlanmış bir "Kayıtlı değil" sonucu gerçek bir yanıttır. Sıfır olmayan bir iş kodu ise hiç yanıt değildir.

Pratik bir dallanma modeli:

Yeniden denemeler için üstel geri çekilme (exponential backoff) kullanın ve deneme sayısını sınırlayın, böylece geçici bir sorun tekrarlanan çağrı patlamasına dönüşmez. Karara bağlanmamış numaraları, raporların bunları karara bağlanmış sonuçlardan ayırt etmesini sağlayan "yeniden kontrol bekleniyor" gibi ayrı bir durumda tutun.

Entegrasyonu üretimde çalıştırma

Birkaç çalışma alışkanlığı, bir Checker entegrasyonunun desteklenmesini kolaylaştırır:

• Belgelenmiş kontrollere uyun. Güncel API dokümantasyonu, kullanıcı başına eşzamanlılık ve zaman aşımı kontrollerini tanımlar. Ölçeklendirme yaparken sabit bir dakika başı izin varsaymak yerine, işlemdeki istek sayısını bu kontrollere göre boyutlandırın ve dokümantasyonu tekrar okuyun.
• Hesap bakiyesini izleyin. Tek bir hesap bakiyesi paneli, REST API'yi ve MCP sunucusunu kapsar, bu nedenle büyük bir API işi ve manuel panel kontrolleri aynı havuzdan harcama yapar. Büyük bir işlemden önce paneldeki bakiyeyi kontrol edin.
• Sızdırmadan günlük tutun. İstek sonuçlarını ve hata kodlarını günlüğe kaydedin, ancak genel uygulama günlüklerinde telefon numaralarını maskeleyin ve API anahtarını asla günlüğe kaydetmeyin.
• Anahtarları döndürün. Panel API anahtarlarını yönetir; ifşa olmuş olabileceğini düşünüyorsanız bir anahtarı döndürün ve gizli depoyu tek adımda güncelleyin.
• Bağlamı kaydedin. Hangi kontrolün ne zaman çalıştığını saklayın. Aylar öncesinden gelen bir sonuç, numarayı bugün değil, o zamanki haliyle tanımlar.

WhatsApp'ın kendi Hizmet Şartları, hizmetlerine otomatik veya yetkisiz erişimi kısıtlar; ekiplerin kişisel bir oturumu yöneten betiklerden uzaklaşıp kendi anahtarına sahip barındırılan bir API'ye yönelmesinin bir nedeni de budur.

Dosya görevi ne zaman API'den daha uygundur?

Çok büyük bir liste için asenkron toplu görev daha uygundur: satır başına bir numara olacak şekilde bir TXT veya CSV dosyası yükleyin, işlemenin bitmesini bekleyin ve ardından result.csv dosyasını indirin. Toplu görevler, gönderim için POST /api/v1/bulk-tasks ve ilerlemeyi takip etmek için GET /api/v1/bulk-tasks/{id} kullanır; API dokümantasyonunda açıklandığı gibi ürün bazlı limitler geçerlidir. Dosya esasen tek bir ülkeden numaralar içermelidir ve toplu hizmetler Çin ana karası, Hong Kong veya Makao numaralarını kapsamaz. Toplu bakiye gönderim sırasında rezerve edilir ve kullanılmayan kısım işlemden sonra iade edilir.

Bir kullanıcı eylemine veya küçük bir içe aktarmaya tepki veren çoğu arka uç özelliği için, senkron tekli ve toplu kontrol çağrıları daha basit bir seçenek olmaya devam etmektedir.

SSS

Ekipler, bir WhatsApp Checker API'yi üretime almadan önce nasıl test edebilir?

Şirket telefonları gibi beklenen sonucunu zaten bildiğiniz bir avuç numarayla başlayın ve tek numaralı uç noktayı bir hazırlık (staging) ortamından çağırın. Uygun yeni hesaplar, kayıttan sonra bir kez otomatik olarak 100 ücretsiz kontrol alır; bu genellikle istemci kodundaki Kayıtlı, Kayıtlı değil ve yeniden deneme yollarını test etmek için yeterlidir.

Bir numara karara bağlanamadığında arka uç ne yapmalıdır?

Sonuç alanını boş bırakın, iş kodunu ve zamanı kaydedin ve numarayı gecikmeli bir yeniden deneme kuyruğuna alın. Karara bağlanamamış bir kontrol için "Kayıtlı değil" değeri yazmak, liste verilerini bozar ve daha sonra yanlış kanal kararlarına yol açar.

Toplu kontrol uç noktası, dosya yüklemeden farklı mı çalışır?

Evet. Toplu kontrol uç noktası, aynı isteğin yanıtında 100'e kadar sonuç döndürür. Dosya yükleme, arka planda işlenen asenkron bir toplu görev oluşturur ve ardından bir result.csv indirilir.

Bir CRM entegrasyonu varsayılan olarak hangi kontrol türünü kullanmalıdır?

Kayıt kontrolü (ws), çoğu kanal ve veri kalitesi kararını kapsar. ws_avatar veya ws_business seçeneklerini yalnızca CRM'deki bir alan gerçekten profil fotoğrafı uygunluğunu veya hesap türünü kullanıyorsa ekleyin, çünkü tamamlanan her kontrol ücretlendirilir.

Daha Fazla Bilgi

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

• Ürün dokümantasyonunu görüntüle →
• Ekiple görüşün →