WA Lookup entegrasyonu: Otomatik CRM veri hijyeni ve hesap sınıflandırması

CRM veri hijyeni için WhatsApp hesap varlığını doğrulamak, profil fotoğrafı ayrıntılarını almak ve işletme hesaplarını sınıflandırmak üzere senkron WA Lookup API'yi nasıl entegre edeceğinizi öğrenin.

WA Lookup API, CRM sistemlerinin WhatsApp hesap varlığını senkron olarak doğrulamasını sağlar. Geliştiriciler, /api/v1/check uç noktasına E.164 biçimli bir telefon numarasıyla POST isteği göndererek kayıt durumunu, profil fotoğrafı bulunurluğunu veya işletme hesabı sınıflandırmasını aynı HTTP yanıtında alabilir. Bu veriler, asenkron işleme, yoklama veya webhook gerektirmeden WhatsApp'a bağlı geçerli kayıtları belirleyerek CRM hijyenini korumaya yardımcı olur.

WA Lookup API mimarisini anlamak

Hesap varlığı sinyallerini bir CRM'e entegre etmek, anlık veri yönlendirmesini ve karar vermeyi destekleyen bir mimari gerektirir. WA Lookup API tek ve senkron bir uç nokta etrafında tasarlanmıştır: POST /api/v1/check. Bir CRM sistemi veya veri operasyonları platformu istek gönderdiğinde API kontrolü işler ve sonuçları aynı HTTP yanıtında iletir. Bu senkron mimari; webhook yapılandırmak, geri çağrı URL'lerini yönetmek veya yoklama mantığı uygulamak gibi asenkron işlemeye bağlı mühendislik yükünü ortadan kaldırır. Geliştiriciler API'yi, potansiyel müşteri toplama formları veya gerçek zamanlı veri temizleme hatları gibi senkron iş akışlarına doğrudan entegre edebilir. Tamamlanmış bir WhatsApp kontrolü için döndürülen data; service_type, identifier ve registered alanlarını içerir; ws_avatar ayrıca avatar ve avatar_url, ws_business ise business alanını içerir. Dahili kayıt, işlem, durum ve faturalandırma alanları döndürülmez.

WhatsApp hesap türlerini sınıflandırmak

Farklı CRM veri hijyeni gereksinimlerini desteklemek için gerçek zamanlı API üç ayrı hizmet türü sunar. Üçü de aynı senkron uç noktayı kullanır; yanıtta hangi alanların döndürüleceğini ve işleme hangi bakiye maliyetinin uygulanacağını service_type parametresi belirler.

Hizmet türlerinin karşılaştırması

WhatsApp Checker (ws) temel hizmet türüdür. Yalnızca gönderilen bir telefon numarasının WhatsApp'ta kayıtlı olup olmadığını teyit etmek için kullanılır ve yalnızca registered alanını döndürür. Genellikle temel liste temizliği ve hangi CRM kişilerinin WhatsApp hesabı olduğunu belirlemek için kullanılır. WhatsApp Avatar Checker (ws_avatar) temel kontrolü profil zenginleştirme yetenekleriyle genişletir. Kayıt durumuna ek olarak, profil fotoğrafı ayarlanıp ayarlanmadığını gösteren boolean bir avatar alanı ve bir avatar_url dizesi döndürür. URL yoksa URL alanı boştur. Bu sinyal, ekiplerin bir kişi profilinin ne kadar eksiksiz olduğunu incelemesine yardımcı olabilir. WhatsApp Business Checker (ws_business) B2B CRM segmentasyonu için tasarlanmıştır. WhatsApp kaydını kontrol eder ve hesabın WhatsApp Business kullanıp kullanmadığını gösteren boolean bir business alanı döndürür. Bu, veri operasyonları yöneticilerinin veritabanlarındaki kişisel hesapları işletme hesaplarından ayırmasını sağlar.

Teknik uygulama ve veri hijyeni

API'yi bir CRM'e veya veri hattına entegre etmek, belgelenmiş istek sözleşmesine uymayı gerektirir. API, isteğin kimliğini doğrulamak ve başarıyla işlemek için bir JSON yükü ve belirli başlıklar bekler. Belgelenmiş istek sözleşmesi /api/v1/check adresine bir POST isteği gerektirir. İstek iki başlık içermelidir: kimlik doğrulama anahtarınızı içeren X-API-Key ve Content-Type: application/json. JSON gövdesi tam olarak iki alan içermelidir:

1. service_type: ws, ws_avatar veya ws_business değerini alan bir dize.
2. identifier: Kontrol edilecek telefon numarası.

Kritik olarak, gönderilen tüm telefon numaraları E.164 uluslararası telefon numaralandırma planına göre biçimlendirilmelidir. Örneğin ABD merkezli bir numara +17253100591 olarak gönderilmelidir. E.164 biçiminin kullanılmaması ayrıştırma hatalarına veya belirlenemeyen kontrollere yol açabilir. Standart bir JSON gövdesi şöyle görünür: {"service_type": "ws_business", "identifier": "+17253100591"} CRM girdilerini E.164'e standartlaştırıp bu senkron kontrolden geçiren geliştiriciler; geçersiz numaraları otomatik olarak işaretleyebilir, işletme kullanıcılarını segmentlere ayırabilir ve yüksek bir veri hijyeni standardını koruyabilir. Yanıt anında geldiğinden bu kontroller doğrudan veri giriş formlarına entegre edilebilir ve veritabanına yalnızca doğrulanmış hesap varlığı sinyallerinin kaydedilmesi sağlanır.

Panel raporlaması ve hesap yönetimi

API kullanımının yönetimi ve veri hijyeni operasyonlarının izlenmesi platform paneli üzerinden yapılır. Panel, CRM yöneticileri ve geliştiriciler için entegrasyonlarının performansını takip etmeye ve kimlik doğrulamayı yönetmeye yönelik kapsamlı araçlar sunar. Panel tam API anahtarı yönetimini destekler ve ekiplerin anahtarları güvenli biçimde yenilemesine olanak tanır. Operasyonel gözetim için güncel hesap bakiyesi, ayrıntılı kontrol geçmişi ve ürün düzeyinde raporlama konusunda görünürlük sağlar. Yöneticiler, API'nin farklı CRM iş akışlarında nasıl kullanıldığını anlamak için son kontrolleri inceleyebilir, bakiye harcamasını izleyebilir ve hesap etkinliğini analiz edebilir. Tamamlanmış bir WhatsApp kontrolü için döndürülen data; service_type, identifier ve registered alanlarını içerir; ws_avatar ayrıca avatar ve avatar_url, ws_business ise business alanını içerir. Dahili kayıt, işlem, durum ve faturalandırma alanları döndürülmez.

SSS

WA Lookup API senkron mu yoksa asenkron mu?

WA Lookup API tamamen senkrondur. POST /api/v1/check uç noktasına bir istek gönderildiğinde sonuçlar, istekle aynı HTTP yanıtında döndürülür.

Bu API bir kullanıcının şu anda çevrimiçi olup olmadığını doğrulayabilir mi?

Hayır. Kayıtlı sonucu, kontrol anında mevcut olan WhatsApp durum alanlarını bildirir. Yalnızca bir hesap varlığı sinyali işlevi görür; canlı çevrimiçi durumu, mesaj geçmişini, kişi onayını veya numarayla şu anda iletişim kurulup kurulamayacağını bildirmez.

ws, ws_avatar ve ws_business hizmet türleri arasındaki fark nedir?

Üç hizmet türü de aynı senkron uç noktayı kullanır ancak farklı alanlar döndürür. ws hizmet türü temel WhatsApp kaydını teyit eder. ws_avatar hizmet türü kayıt durumunun yanında boolean bir avatar alanı ve URL yoksa boş olan bir profil fotoğrafı URL alanı döndürür. ws_business hizmet türü kayıt durumunu ve hesabın WhatsApp Business kullanıp kullanmadığını gösteren bir boolean döndürür.