WhatsApp Business kullanıcı adlarının programatik yönetimi

POST /api/v1/check uç noktasını kullanarak senkron WhatsApp kayıt, profil fotoğrafı ve işletme hesabı kontrollerini CRM iş akışlarına entegre etmeye yönelik teknik bir rehber.

Programatik WhatsApp kimlik eşleme, kayıt durumunu, profil fotoğrafı bulunurluğunu ve işletme hesabı türlerini doğrulamak için belgelenmiş POST /api/v1/check uç noktasının kullanılmasını kapsar. Ekipler, E.164 biçimli numaraları uygun service_type yüküyle gönderdiğinde senkron JSON verilerini aynı HTTP yanıtında alır. Bu hesap varlığı sinyali CRM kayıtlarını zenginleştirmeye yardımcı olur, potansiyel müşteri listesi temizliğini destekler ve otomatik yönlendirme iş akışlarına yön verir; böylece operasyon ekipleri asenkron yoklamaya veya webhook'lara dayanmadan kişileri segmentlere ayırmak için gereken bağlamı elde eder.

Programatik WhatsApp kontrollerinin rolü

WhatsApp hesap varlığı sinyallerini iş operasyonlarına entegre etmek, ekiplerin daha temiz veritabanları tutmasına yardımcı olur ve daha verimli iletişim iş akışlarını destekler. Kuruluşlar kayıt formları, potansiyel müşteri kazanma kampanyaları veya müşteri destek portalları aracılığıyla telefon numaraları topladığında, bu numaralar genellikle mesajlaşma platformundaki varlıklarına dair bağlamdan yoksundur. Operasyon ekipleri, iletişime başlamadan önce bu numaraları programatik olarak kontrol ederek kişi listelerini etkin platform kaydına göre segmentlere ayırabilir. Bu süreç, hangi kayıtların bir WhatsApp hesabıyla ilişkili olduğunu ve hangilerinin olmadığını belirleyerek potansiyel müşteri listesi temizliğini destekler. Ayrıca otomatik yönlendirme kararlarına da yön verir. Bu programatik yaklaşım veri doğruluğunun korunmasına yardımcı olur ve ekiplere iletişim kanallarını etkili biçimde yapılandırmak için gereken bağlamı sağlar.

WhatsApp kimlik sinyallerini anlamak

Platform, tek bir uç nokta üzerinden üç ayrı hizmet türü sunar ve geliştiricilerin iş akışları için gereken ayrıntı düzeyini talep etmesine olanak tanır. Her hizmet türü, JSON yanıtında hangi alanların döndürüleceğini ve hangi bakiye maliyetinin uygulanacağını belirler.

• Kayıt Kontrolü (ws): Bu temel kontroldür. Gönderilen E.164 numarasını değerlendirir ve bir registered alanı döndürerek standart WhatsApp platformunda basit bir hesap varlığı sinyali sağlar.
• Profil Fotoğrafı Kontrolü (ws_avatar): Bu kontrol temel kayıt durumunu içerir ve profil zenginleştirme verileri ekler. Profil fotoğrafının mevcut olup olmadığını gösteren boolean bir avatar alanı ve URL yoksa boş olan bir avatar_url dizesi döndürür.
• İşletme Hesabı Kontrolü (ws_business): B2B segmentasyonu için tasarlanan bu kontrol, temel kayıt durumunun yanında boolean bir business alanı döndürür. Bu özel sinyal, ekiplerin kişinin bir WhatsApp Business hesabı kullanıp kullanmadığını belirlemesine yardımcı olur.

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.

Senkron API iş akışlarını uygulamak

Teknik entegrasyon, basit ve senkron bir istek sözleşmesine dayanır. Sonuçlar senkron olduğundan istekle aynı HTTP yanıtında döndürülür. Bir CRM bir kaydı bellekte tutabilir, API çağrısını yapabilir ve döndürülen sinyali iş akışına hemen uygulayabilir. Belgelenmiş istek sözleşmesi, POST /api/v1/check uç noktasına bir istek gönderilmesini 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 iki alan içermelidir:

• service_type: ws, ws_avatar veya ws_business değerini alan bir dize.
• identifier: E.164 standardına göre biçimlendirilmiş telefon numarası.

Bu entegrasyonu desteklemek için platform paneli kapsamlı yönetim araçları sunar. Geliştirme ve operasyon ekipleri API anahtarlarını yönetebilir, bakiyelerini izleyebilir, kontrol geçmişini inceleyebilir ve ürün düzeyinde raporlamaya erişebilir. Panel ayrıca API kullanımını ve iş akışı hacmini izlemeye yardımcı olmak için son kontrolleri, bakiye harcama metriklerini ve hesap etkinliğini gösterir.

Veri bütünlüğü ve yönlendirme için en iyi uygulamalar

Programatik kontrolleri bir üretim ortamına entegre ederken verinin neyi temsil ettiğine dair doğru beklentiler belirlemek kritik önem taşır. Kayıtlı sonucu, tam kontrol anında mevcut olan WhatsApp durum alanlarını bildirir. Yalnızca bir hesap varlığı sinyali işlevi görür. Çevrimiçi durumu, son görülme zaman damgalarını, mesaj geçmişini veya kişi onayını doğrulamaz. Başarısız, zaman aşımına uğrayan ve belirlenemeyen kontrollerin ücreti tahsil edilmez. Güncel faturalandırma ayrıntıları için fiyatlandırma sayfasına bakın.

SSS

Kayıt kontrolü ile işletme hesabı kontrolü arasındaki fark nedir?

Standart bir kayıt kontrolü (ws hizmet türüyle), gönderilen E.164 numarasının WhatsApp'ta kayıtlı olup olmadığını gösteren bir hesap varlığı sinyali döndürür. İşletme hesabı kontrolü (ws_business hizmet türüyle) aynı kayıt durumunu döndürür ancak buna hesabın WhatsApp Business kullanıp kullanmadığını gösteren boolean bir business alanı ekler.

WhatsApp kontrolleri için webhook kurmam gerekir mi?

Hayır. Tüm kontroller senkrondur. Sonuçlar ilk istekle aynı HTTP yanıtında döndürülür; bu da uygulamanızda webhook yapılandırma veya asenkron yoklama mantığı uygulama ihtiyacını ortadan kaldırır.

API için telefon numaraları hangi biçimde olmalıdır?

Gönderilen tüm telefon numaraları E.164 uluslararası telefon numaralandırma planı standardına göre biçimlendirilmelidir.

Kayıtlı durumu, kullanıcıya mesaj gönderebileceğim anlamına mı gelir?

Kayıtlı sonucu yalnızca kontrol anında mevcut olan bir hesap varlığı sinyalidir. Canlı çevrimiçi durumu, mesaj geçmişini, kişi onayını veya numaranın bir mesajı başarıyla alıp alamayacağını bildirmez.

Başarısız veya belirlenemeyen kontroller nasıl faturalandırılır?

Başarısız, zaman aşımına uğrayan ve belirlenemeyen kontrollerin ücreti tahsil edilmez. Güncel faturalandırma ayrıntıları için fiyatlandırma sayfasına bakın.