WhatsApp calls webhook'ları: Calling API olayları ve Coexistence numaralarında aramalar
calls webhook alanı WhatsApp Business Calling API olaylarını bildirir: SDP yanıtı veya teklifiyle bağlanma, RINGING, ACCEPTED ve REJECTED çağrı durumları, COMPLETED veya FAILED ile süre bilgisiyle sonlanma ve call_recording_available ya da call_transcription_available. Meta'nın Coexistence rehberine göre sesli ve görüntülü aramalar WhatsApp Business uygulamasında değişmeden kalır ve Cloud API'de desteklenmez; bu nedenle bu aramalar telefonda kalır.
easyCoexistence, WhatsApp Business uygulamasındaki numaranızı Coexistence aracılığıyla Meta'nın Cloud API'sine bağlar; böylece yapay zekânız ve otomasyonlarınız mesajlara yanıt verir ve şablonlar gönderir, aramalar ise telefonunuzdaki uygulamada çalmaya devam eder.
Cloud API'de, WhatsApp Business uygulamasıyla bağlanmış bir numara için sesli ve görüntülü aramalar; uygulamada değişmeden kalır.
Bir numaranın Calling API'yi kullanabilmesi için gereken asgari günlük mesajlaşma limiti (benzersiz alıcı sayısıyla).
Çağrı kayıtlarının ve transkriptlerinin, webhook'u iletildikten sonra indirilebilir kalma süresi.
Çağrı kimliklerinin önekidir; bir çağrının bağlanma, durum ve sonlanma webhook'larını birbirine bağlayan değer.
Çağrı webhook'larını almak için bir uygulamanın sahip olması gereken izin, mesajlarla aynı.
Calls webhook alanı neyi bildirir?
Calling API ile yapılan veya alınan bir çağrıda olan her şey, aşama başına bir olay olacak şekilde tek bir alanda bildirilir. İşletme tarafından başlatılan bir çağrı bağlanma olayı, durum güncellemeleri ve sonlanma olayı üretir. SIP üzerinden işlenen çağrılar connect yerine call_created bildirir ve SDP oturumu içermez. İlgili bir olay başka yerde yer alır: müşteri bir çağrı izni isteğini yanıtladığında, yanıt messages alanına call_permission_reply tipinde etkileşimli bir mesaj olarak gelir.
Bir calls webhook nasıl görünür?
Her WhatsApp webhook'uyla aynı zarf, value altında calls dizisi ve field değeri calls ile. direction değeri BUSINESS_INITIATED veya USER_INITIATED, from ve to telefon numaralarını taşır, to_user_id müşterinin BSUID'sidir ve kullanıcı adı kullanan bir müşteri için her iki numara da eksik olabilir. metadata.phone_number_id, diğer alanlarda olduğu gibi numaranızı tanımlar. Aşağıda Meta'nın Call Connect örneği, yer tutucuları Meta'nın yazdığı gibi:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "16315553601",
"phone_number_id": "<PHONE_NUMBER_ID>"
},
"contacts": [
{
"profile": {
"name": "<CALLEE_NAME>",
"username": "<USERNAME>"
},
"wa_id": "16315553602",
"user_id": "<BSUID>",
"parent_user_id": "<PARENT_BSUID>"
}
],
"calls": [
{
"id": "wacid.ABGGFjFVU2AfAgo6V-Hc5eCgK5Gh",
"to": "16315553601",
"to_user_id": "<BSUID>",
"to_parent_user_id": "<PARENT_BSUID>",
"from": "16315553602",
"event": "connect",
"timestamp": "1671644824",
"direction": "BUSINESS_INITIATED",
"session": {
"sdp_type": "answer",
"sdp": "<<RFC 8866 SDP>>"
}
}
]
},
"field": "calls"
}
]
}
]
}terminate olayı hangi alanları ekler?
terminate, çağrıyı kapattığı için çoğu sistemin sakladığı olaydır. Alanları, Meta'nın referansına göre:
- status: çağrı beklenmedik hata olmadan sona erdiğinde COMPLETED, yanıtlanmayan çağrılar dahil; bağlanamadığında veya koptuğunda FAILED.
start_time,end_timeve duration (saniye cinsinden): yalnızca karşı taraf açtığında mevcuttur.- errors: FAILED bir çağrıda code, message, href ve
error_data.details. biz_opaque_callback_data: çağrıyı başlatırken veya kabul ederken verdiğiniz kendi takip metniniz, varsa.
Coexistence numarasında calls webhook'ları çalışır mı?
Meta'nın Coexistence rehberi bunu özellik tablosunda yanıtlar: bu şekilde bağlanmış bir numara için sesli ve görüntülü aramalar WhatsApp Business uygulamasında değişmez ve Cloud API'de desteklenmez. Calling API'nin kendi önkoşulları da diğer taraftan aynısını söyler: işletme numarası WhatsApp Business uygulamasında değil, Cloud API ile kullanımda olmalıdır. Dolayısıyla bir Coexistence numarasında müşteriler her zamanki gibi arar, çağrı telefonda, WhatsApp Business uygulamasında çalar ve calls alanında bildirilecek bir şey olmaz. Aramaları yazılımda işlemek isteyen bir işletme, numarayı yalnızca Cloud API'de kullanmalıdır.
Bir çağrının olayları birbirleriyle nasıl ilişkilidir?
Çağrı kimliğiyle. Bu kimlik wacid ile başlar ve o çağrının her olayında tekrar eder. İşletme tarafından başlatılan bir çağrı, SDP yanıtıyla bağlanmayı, ardından RINGING ve ACCEPTED ya da REJECTED durumlarını ve son olarak terminate olayını bildirir. Kullanıcı tarafından başlatılan bir çağrı, yanıtlaması için yığınınıza bir SDP teklifiyle bağlanmayı, ardından terminate olayını bildirir. Kayıt ve transkript olayları, etkinleştirildiğinde terminate'den sonra gelir. Olayları id ve event ikilisiyle saklayın, çünkü yeniden denemeler bunları tekrarlar ve varış sırası garanti edilmez. Calling API önkoşullarının tam listesi Coexistence numarasında aramalar sayfasındadır.
Yapay zekânız, Coexistence numarasındaki aramalar için ne yapabilir?
Sohbette çalışabilir; aramalar ise telefondaki kişide kalır. easyCoexistence, calls alanına abone olmaz ve çağrı araçları yoktur; bağlayıcısı ve otomasyonları mesajları ve şablonları kapsar. Pratikte bu şu anlama gelir: bir yapay zekâ yanıtı müşteriye birinin ne zaman konuşabileceğini ve hangi numarayı arayacağını söyleyebilir, bir anahtar kelime otomasyonu “call” veya “phone” yazan kişiye bu bilgiyi yanıtlayabilir ve işletme sahibi aramayı her zamanki gibi WhatsApp Business uygulamasından yanıtlar.
Yaygın hatalar
- Coexistence numarası için calls aboneliği yapıp olay beklemek. Meta, bu numalar için aramayı Cloud API'de desteklenmez olarak listeler.
- Her terminate olayında start_time ve duration değerlerini beklemek. Bunlar yalnızca çağrı yanıtlandığında görünür; yanıtlanmayan bir çağrı yine COMPLETED olarak biter.
- İzin yanıtlarını calls alanında aramak. Bunlar messages alanında, etkileşimli bir call_permission_reply olarak gelir.
- Kayıtları ve transkriptleri Meta'da bırakmak. İkisi de webhook'larından sonra 7 gün indirilebilir; sonra kaybolurlar.
Her numara 7/24 izlenir; uygulaması açılmayan bir numarayı bağlantıdan kesen 14 günlük kural dahil. Numara başına ayda US$ 9'dan US$ 0.75'e, numara ekledikçe düşen fiyatla; ilk 3 gün ücretsiz deneme.
Sık sorulan sorular
Bir numara Coexistence üzerinden API'ye bağlandığında müşteriler arama düğmesini kaybeder mi?
Meta'nın Coexistence rehberi, sesli ve görüntülü aramaları WhatsApp Business uygulamasında değişmemiş olarak listeler. Müşteriler aynı numarayı arar, işletme sahibi de telefonda uygulamadan yanıtlar.
Calling API, mesajlar gibi mi fiyatlandırılır?
Hayır. Meta'nın fiyatlandırma sayfası, Calling API'nin farklı fiyatlandırması olduğunu ve ayrı bir arama fiyatlandırma belgesine işaret ettiğini söyler; bu nedenle arama ücretleri mesaj durumlarının pricing nesnesinde görünmez.
Calling API çağrısı kaydedilebilir veya transkript edilebilir mi?
Evet, kayıt veya transkript etkinleştirildiğinde. Çağrıdan sonra Meta, genellikle bir dakika içinde ses medya kimliğiyle call_recording_available ya da JSON belge kimliğiyle call_transcription_available gönderir.
Bir çağrı webhook'u uygulamanınkinden farklı bir uç noktaya gidebilir mi?
Evet. calls, bir WhatsApp Business Hesabının ya da telefon numarasının messages ve Coexistence alanlarıyla birlikte alternatif bir geri çağırma URL'sine yönlendirebildiği alanlardan biridir.
Okumaya devam edin
Başlamaya hazır mısınız?
WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.
Ücretsiz denemeyi başlatınDoğrulama tarihi