WA Lookup

Bir WhatsApp kontrolü sırasında ne olur?

WA Lookup her seferinde bir numarayı kontrol eder: numarayı E.164 biçiminde gönderin ve bir service_type (ürünü seçen parametre) seçin; sonuç aynı HTTP yanıtında döner. Başarılı bir yanıtta registered=true numaranın WhatsApp'ta kayıtlı olduğu, registered=false ise kayıtlı olmadığı anlamına gelir. Diğer tüm sonuçlar bir hata kodu olarak döndürülür ve kontrol iade edilir.

Bir kontrolü tamamlayın

Bu bölüm gerçek zamanlı kontrolleri ele alır: SaaS paneli ve senkron REST uç noktaları tek bir kontrol hizmetini ve tek bir yanıt anlamını paylaşır. Çok büyük listeler için asenkron bir toplu seçenek vardır; bu sayfanın sonunda ele alınmıştır.

  1. 1

    Bir numara gönderin

    Kontrol etmeniz gereken numarayı API belgelerinde istenen biçimde gönderin.

  2. 2

    Bir ürün seçin

    Kayıt için ws, ws_avatar profil fotoğrafı alanlarını ekler, ws_business Business hesabı alanlarını ekler. Aktif günler için asenkron toplu kontrolde buna karşılık gelen bir ürün vardır.

  3. 3

    Sonucu okuyun

    registered alanını aynı yanıtta okuyun. Güncel bir duruma ihtiyacınız olduğunda yeni bir kontrol çalıştırın.

Hangi numara biçimini göndermelisiniz

WA Lookup, kontrol başına E.164 biçiminde yazılmış bir numara kabul eder: bir artı işareti, ülke kodu, ardından boşluk veya noktalama işareti olmadan abone numarası — örneğin +17253100591. Bu, WhatsApp uygulamasının dahili olarak sakladığı biçimle aynıdır; bu nedenle bu biçimdeki bir numara tam olarak bir hesaba karşılık gelir. Ülke kodu olmayan bir numara güvenilir şekilde kontrol edilemez: aynı rakamlar birçok ülkede mevcuttur.

  • Her zaman ülke kodunu ekleyin; kendi hesabınızın ülkesine güvenmeyin.
  • Boşlukları, tireleri, parantezleri ve ulusal arama için kullanılan baştaki sıfırları kaldırın — yalnızca + işaretini ve rakamları bırakın.
  • Yanlış biçimdeki numaralar herhangi bir ücret alınmadan önce reddedilir; reddedilen bir biçim "kayıtlı değil" sonucu değildir.

registered ne anlama gelir?

registered, bir WhatsApp kontrolünün yanıtıdır. Yalnızca başarılı bir yanıtta görünür ve bir boolean değerdir: true, numaranın istek anında WhatsApp'ta kayıtlı olduğu, false ise kayıtlı olmadığı anlamına gelir. Diğer her şey — zaman aşımı, belirlenemeyen sonuç, geçersiz numara — bunun yerine bir hata kodu olarak döner ve WA Lookup bu kontrolü otomatik olarak iade eder. Dolayısıyla eksik bir registered alanı asla "kayıtlı değil" anlamına gelmez; kontrolün bir sonuç üretmediği anlamına gelir. Değer, sorduğunuz anı yansıtır: hesaplar sürekli oluşturulur ve silinir; bu nedenle eski bir sonucu haftalarca önbellekte tutmak yerine, ona göre hareket etmeden önce kontrolü yenileyin.

  • registered=true kayıtlı anlamına gelir.
  • registered=false kayıtlı değil anlamına gelir.
  • Diğer sonuçları API yanıt koduna göre ele alın; registered değerini kendiniz çıkarsamayın.

İhtiyaca göre bir ürün seçin

Sorunuzu yanıtlayan en küçük gerçek zamanlı ürünü seçin; alan tanımlarının tamamı API belgelerinde yer alır.

  • ws kayıt durumunu döndürür.
  • ws_avatar ayrıca profil fotoğrafı alanlarını döndürür; profil fotoğrafı mevcut olmadığında avatar_url boş bir dizedir.
  • ws_business ayrıca Business hesabı alanlarını döndürür.

Sonucu kapsamı içinde kullanın

Bir kontrol, istek anındaki durumu yansıtır. Kimlik doğrulaması veya birisiyle iletişime geçme izni değildir.

  • Numaranın sahibinin kim olduğunu, şu anda çevrimiçi olup olmadığını veya herhangi bir mesaj içeriğini doğrulamaz; toplu etkinlik ürünü canlı çevrimiçi durumu değil, son etkinlikten bu yana geçen gün sayısını döndürür.
  • Kayıtlı sonucu, numarayla iletişime geçmek için onay oluşturmaz.
  • İş kararı güncel bir durum gerektirdiğinde yeni bir kontrol çalıştırın.

Çok büyük listeler: asenkron seçenek

Paneldeki çoklu kontrol ve API çoklu uç noktası çoğu listeyi karşılar. Yalnızca bir liste bu sınırları çok aştığında, dosyanın tamamını tek bir asenkron toplu görev olarak göndermek mantıklıdır — listenin ait olduğu ülkeyi siz seçersiniz ve liste esas olarak o tek ülkeye ait olmalıdır.

  • Toplu kontrol sayfasından veya API üzerinden, her satırda bir E.164 numarası bulunan bir .txt veya .csv dosyası yükleyin.
  • Gönderirken numaraların ait olduğu ülkeyi seçin; liste esas olarak o tek ülkeye ait olmalıdır. Başka yerlerden çok fazla numara olması, görevin dosya hazırlanırken başarısız olmasına neden olur — kontrole gönderilmez ve tamamı iade edilir.
  • Gönderimde geçerli satırlar için bakiye ayrılır, yalnızca sonuç döndüren numaralar için ücretlendirilirsiniz ve fark iade edilir.
  • Görev arka planda çalışır; tamamlandığında sonuç dosyasını indirin. Başarısız bir görevin tamamı iade edilir.

İlgili standartlar