WhatsApp Profil Fotoğrafı API: Numaraya Göre Profil Fotoğrafı Uygunluğunu Kontrol Etme

Kimlik beyanı içermeyen, profil fotoğrafı uygunluğuna yönelik geliştirici odaklı bir iş akışı.

Bir WhatsApp profil fotoğrafı API araması genellikle gönderilen bir numaranın görünür bir profil resmine sahip olup olmadığını sorgular. WA Lookup’ın WhatsApp Profil Fotoğrafı Kontrolü, belgelenmiş gerçek zamanlı kontrol uç noktasını kullanır ve aynı yanıt içerisinde hem kayıt durumunu hem de profil fotoğrafı uygunluğunu döndürür. Profil resmi sinyali, tarihli bir iş akışı girdisi olarak yararlıdır ancak numaranın arkasındaki kişiyi doğrulamaz.

Doğru profil resmi sorusuyla başlayın

Bir iletişim verisi geliştiricisi, yetkili bir CRM kaydının kullanılabilir bir WhatsApp profil resmine sahip olup olmadığını bilmek isteyebilir. Bu, bir kimlik belgesi almaktan, kişiyle kimlik doğrulaması yapmaktan veya özel hesap içeriğini okumaktan farklıdır. Hedef alanı buna göre tanımlayın: “doğrulanmış kişi” yerine “kontrol edildiğinde profil fotoğrafı mevcut”. Bu ayrım, sonuca taşıdığından daha fazla anlam yüklemeden sonucun faydalı olmasını sağlar.

WA Lookup API reference belgesi, WhatsApp Profil Fotoğrafı Kontrolü'nü seçmeli bir gerçek zamanlı hizmet olarak tanımlar. Ayrıca gönderilen numaranın kayıt durumunu da kontrol eder. Belgelenmiş profil fotoğrafı sinyali, resmin uygunluğunu gösterir; ancak URL boş olabilir. Boş bir URL için belgelenmemiş arka uç mekanizmalarından bir neden türetmeyin. Eksik bir resim, kayıt durumu hakkında ayrı bir hüküm olarak değil, bir resim uygunluğu gözlemi olarak ele alınmalıdır.

Entegrasyondan önce, kullanım durumunun tek seferlik bir panel incelemesine mi yoksa kontrollü bir CRM sürecinde bir API adımına mı ihtiyaç duyduğuna karar verin. Panel, bir operatörün önce bireysel bir numarayı incelemesine olanak tanır. Arka uç entegrasyonu ise ekip, tekrarlanabilir ve yetkili bir veri girişi veya inceleme etkinliğine sahip olduğunda ve sonuçların kaynağını net bir şekilde koruyabildiğinde faydalı hale gelir.

Belgelenmiş gerçek zamanlı API sözleşmesini kullanın

Tek bir numara için belgelenmiş yöntem POST /api/v1/check şeklindedir. service_type ile ws_avatar seçeneğini belirleyin ve phone alanında E.164 formatında bir telefon numarası sağlayın. REST API, X-API-Key ile kimlik doğrulaması yapar. Sonuç, gecikme süresi hakkında bir vaatten ziyade bir istek akışı gerçeği olarak aynı yanıt içerisinde döner. Anahtarı sunucu tarafında tutun ve dağıtımdan önce tam istek ve yanıt sözleşmesi için current API documentation sayfasına başvurun.

API çoklu uç noktası olan POST /api/v1/batch-check, 100 numaraya kadar olan küçük grupların eşzamanlı olarak işlenmesini sağlar. Bu, eşzamansız toplu dosya görevinden farklıdır; çoklu sonuç, başlatılan istekle birlikte döndürülür. Paneldeki Gerçek Zamanlı Toplu Kontrol sekmesi, operatör tarafından yürütülen kontroller için yapıştırılan numaraları kabul eder. Bir ekip, seçimi yalnızca bir web sayfasının veya API'nin mevcut olup olmasına göre değil, işlemin sorumluluğunun kimde olduğuna ve sonuçların kaynak kayıtlarla nasıl mutabık kalındığına göre yapmalıdır.

Gerçek zamanlı profil fotoğrafı kontrolü için bir geri arama (callback), yoklama döngüsü (polling loop), indirilebilir dosya veya görev tanımlayıcı icat etmeyin. Bu kavramlar, ayrı eşzamansız dosya iş akışlarına aittir. Benzer şekilde, bir entegrasyon, her iki kontrol de aynı uç nokta üzerinden erişilebilir olduğu için profil fotoğrafı sonucunun WhatsApp Business Hesabı Kontrolü ile aynı anlama geldiğini varsaymamalıdır.

Sonuçları CRM alanlarıyla dikkatlice eşleştirin

Geliştirici; orijinal CRM kayıt kimliğini, normalleştirilmiş gönderilen numarayı, seçilen hizmeti, kontrol tarihini ve ilgili gözlemleri saklayabilir. Bu eşleme alanları, müşteri tarafından kontrol edilen bir tasarım önerisidir. WA Lookup, bu seçmeli kontrol için kayıt durumunu, profil fotoğrafı uygunluğunu ve bir profil fotoğrafı URL'sini belgeler. URL boş olabilir; boş bir URL, tahmin edilen bir resimle değiştirilmemeli veya hiçbir hesabın bulunmadığına dair kanıt olarak sunulmamalıdır.

En güvenli veri modeli üç durumu birbirinden ayırır: tamamlanmış bir hesap varlığı sonucu, uygun olduğunda eşlik eden profil fotoğrafı gözlemi ve karara bağlanamayan bir kontrol. Üçüncü durum operasyonel incelemeye gönderilmelidir. WA Lookup'ın genel API referansı, karara bağlanamamış bir sonucu, tamamlanmış bir "Kayıtlı değil" sonucundan ayırır. Bu durumları tek bir "yanlış" değerinde birleştiren bir CRM içe aktarımı, anlam kaybına yol açar ve gelecekteki segmentasyon süreçlerini bozabilir.

Kuruluş bir resim URL'sini saklamayı seçerse, bunu kimlerin görüntüleyebileceğine, ne zaman yenilenmesi gerektiğine ve alt sistemlerin buna gerçekten ihtiyacı olup olmadığına dahili olarak karar verin. Bunlar, kontrolün otomatik yeteneklerinden ziyade yerel veri yönetişimi kararlarıdır. Gözlem zamanını saklayın, böylece daha sonraki bir analist bunun kalıcı bir profil özelliği değil, bir anlık görüntü olduğunu görebilir.

Sinyali dar bir iş akışında kullanın

Bir profil fotoğrafı sinyali, bir ekibin CRM'inde zaten bulunan kişiler için manuel bir profil verisi incelemesi düzenlemesine yardımcı olabilir. Bu sinyal; güvenilirlik, yasal kimlik, iletişim izni veya yanıt verme olasılığı için bir vekil olarak kullanılmamalıdır. WhatsApp’ın hesap kaydı kılavuzu, telefon sahibi kaydının ayrı bir süreç olduğunu açıkça belirtmektedir. API gözlemi, liste sahibi için bu süreci gerçekleştirmez.

Pratik bir inceleme sırası; kaynak numarayı ve ülkeyi kontrol etmek, kontrolün tamamlandığını doğrulamak, kayıt ve profil fotoğrafı gözlemlerini doğru CRM kaydıyla ilişkilendirmek ve belirsiz sonuçları inceleme için bekletmektir. Birden fazla kaynak kayıt aynı numarayı paylaşıyorsa, profilin belirli bir kişiye ait olduğunu varsaymak yerine ekibin kendi mutabakat kuralını kullanın. Amaç profil fotoğrafı uygunluğundan işletme hesabı türüne kayarsa, özel olarak adlandırılan WhatsApp Business Hesabı Kontrolü'nü çalıştırın; bir resmin varlığından veya tarzından işletme durumunu çıkarmayın.

Bu ayrım, geliştiricinin asıl sorusunu yanıtlar: entegrasyon, bir kaynak kayıtla birleştirilebilen tarihli ve kapsamlı bir gözlem üretir. Değer, profil fotoğrafını desteklenmeyen bir kimlik veya erişim iddiasına dönüştürmekten değil, kontrolün anlamını sistemler genelinde korumaktan gelir.

SSS

Geliştiriciler tek bir numara için profil fotoğrafını nasıl kontrol edebilir?

Hizmet türünü ve E.164 numarasını seçerek, gerçek zamanlı tek numaralı uç nokta üzerinden belgelenmiş WhatsApp Profil Fotoğrafı Kontrolü'nü kullanın. Tam istek detayları için güncel API referansını okuyun.

Profil fotoğrafı URL'si boş olabilir mi?

Evet. Belgelenmiş URL boş olabilir; ekip, URL'nin neden kullanılamadığını tahmin etmek yerine ayrı kayıt ve profil fotoğrafı gözlemlerini saklamalıdır.

Ekipler tek bir eşzamanlı istekte birkaç numarayı kontrol edebilir mi?

Evet. API çoklu uç noktası, belgelenmiş küçük grup isteğini destekler ve sonucunu başlatan yanıt içerisinde döndürür.

Daha Fazla Bilgi

İş akışınızın bir sonraki adımıyla uyumlu ürün bilgilerini seçin.

• Ürün belgelerini görüntüleyin →
• Ekiple görüşün →