WhatsApp webhook za pozive: događaji Calling API i pozivi na Coexistence broju
Polje calls javlja događaje koje šalje WhatsApp Business Calling API: uspostavu sa SDP odgovorom ili ponudom, statuse poziva RINGING, ACCEPTED i REJECTED, završetak sa COMPLETED ili FAILED i trajanjem te call_recording_available ili call_transcription_available. Metin vodič za Coexistence navodi da su glasovni i video pozivi u aplikaciji WhatsApp Business nepromijenjeni i da ih Cloud API ne podržava, pa pozivi ostaju na telefonu.
easyCoexistence povezuje vaš broj iz aplikacije WhatsApp Business s Cloud API preko Coexistence, pa vaša AI i automatizacije odgovaraju na poruke i šalju predloške, dok pozivi i dalje zvone u aplikaciji na vašem telefonu.
Glasovni i video pozivi putem Cloud API za broj povezan s aplikacijom WhatsApp Business; u aplikaciji su nepromijenjeni.
Minimalni dnevni limit za poruke, izražen u jedinstvenim primateljima, koji broj mora imati prije nego što može koristiti Calling API.
Koliko dugo snimke i transkripti poziva ostaju dostupni za preuzimanje nakon što se njihov webhook isporuči.
Prefiks ID-eva poziva, vrijednost koja povezuje webhookove uspostave, statusa i završetka jednog poziva.
Dozvola koju aplikacija mora imati za primanje webhookova za pozive, jednaka onoj za poruke.
Što polje calls javlja?
Sve što se događa pozivu upućenom ili primljenom putem Calling API, kao jedno polje s događajem za svaku fazu. Poziv koji pokrene tvrtka donosi događaj connect, ažuriranja statusa i događaj terminate. Pozivi obrađeni putem SIP-a donose call_created umjesto connect, bez SDP sesije. Jedan srodni događaj nalazi se drugdje: kada korisnik odgovori na zahtjev za dozvolu poziva, odgovor stiže na polju messages kao interaktivna poruka tipa call_permission_reply.
Kako izgleda webhook poziva?
Isti omotač kao kod svakog WhatsApp webhooka, s nizom calls unutar value i poljem field postavljenim na calls. direction označava BUSINESS_INITIATED ili USER_INITIATED, from i to nose telefonske brojeve, to_user_id BSUID kupca, a bilo koji broj može nedostajati za kupca koji koristi korisničko ime. metadata.phone_number_id označava vaš broj, kao i na svakom drugom polju. Ovo je Metin primjer Call Connect, s oznakama mjesta onako kako ih Meta ispisuje:
{
"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"
}
]
}
]
}Koja polja dodaje događaj terminate?
terminate je događaj koji većina sustava pohranjuje, jer zatvara poziv. Njegova polja, prema Metinoj referenci:
- status: COMPLETED kada je poziv završio bez neočekivanih pogrešaka, uključujući neodgovorene pozive; FAILED kada se nije uspostavio ili je prekinut.
start_time,end_timei duration u sekundama: prisutni samo kada je druga strana podignula poziv.- errors: code, message, href i
error_data.details kod poziva sa statusom FAILED. biz_opaque_callback_data: vaš vlastiti niz za praćenje, ako ste ga proslijedili pri pokretanju ili prihvaćanju poziva.
Rade li webhookovi za pozive na Coexistence broju?
Metin vodič za Coexistence odgovara na to u tablici značajki: glasovni i video pozivi ostaju bez promjene u aplikaciji WhatsApp Business, a za broj povezan na taj način nisu podržani na Cloud API. Preduvjeti za Calling API to potvrđuju i s druge strane: poslovni broj mora biti u uporabi s Cloud API, a ne s aplikacijom WhatsApp Business. Zato na Coexistence broju kupci i dalje zovu kao prije, poziv zvoni u aplikaciji na telefonu, a polje calls nema što javiti. Tvrtka kojoj trebaju pozivi u softveru koristi broj samo na Cloud API.
Kako se događaji jednog poziva povezuju?
Preko ID-a poziva, koji počinje s wacid i ponavlja se na svakom događaju tog poziva. Poziv koji pokrene tvrtka donosi connect sa SDP odgovorom, statuse RINGING, zatim ACCEPTED ili REJECTED, i na kraju terminate. Poziv koji pokrene korisnik donosi connect sa SDP ponudom, na koju vaš sustav mora odgovoriti, a zatim terminate. Događaji snimke i transkripta, kada su uključeni, dolaze nakon terminate. Događaje pohranjujte prema kombinaciji id i event, jer se događaji ponovno šalju, a redoslijed dolaska nije zajamčen. Cijeli popis preduvjeta za Calling API nalazi se na stranici o pozivima na Coexistence broju.
Što vaš AI asistent može učiniti s pozivima na Coexistence broju?
Raditi u chatu, dok pozive i dalje preuzima osoba na telefonu. easyCoexistence nije pretplaćen na polje calls i nema alate za pozive; njegov konektor i automatizacije pokrivaju poruke i predloške. U praksi to znači da AI odgovor može kupcu reći kada je netko dostupan za razgovor i na koji broj nazvati, automatizacija može na riječ „poziv” ili „telefon” odgovoriti tim podacima, a vlasnik prima poziv u aplikaciji WhatsApp Business kao i prije.
Uobičajene pogreške
- Pretplata na calls za Coexistence broj i čekanje događaja. Meta navodi da pozivi nisu podržani na Cloud API za te brojeve.
- Očekivanje da će start_time i duration biti na svakom terminate događaju. Pojavljuju se samo kada je poziv prihvaćen; neodgovoreni poziv i dalje završava kao COMPLETED.
- Traženje odgovora na dozvolu na polju calls. Stižu na messages, kao interaktivna poruka call_permission_reply.
- Oslanjanje na to da Meta čuva snimke i transkripte. Oboje se može preuzeti 7 dana nakon webhooka, a zatim nestaje.
Svaki broj nadzire se 24/7, uključujući pravilo od 14 dana koje odspaja broj čija se aplikacija ne otvara. Od US$ 9 do US$ 0,75 po broju mjesečno, uz pad cijene kako dodajete brojeve, a prva 3 dana su besplatna.
Često postavljana pitanja
Gube li kupci mogućnost poziva kada se broj poveže s API-jem preko Coexistence?
Metin vodič za Coexistence navodi glasovne i video pozive kao nepromijenjene u aplikaciji WhatsApp Business. Kupci zovu isti broj, a vlasnik odgovara u aplikaciji na telefonu.
Ima li Calling API cijenu kao i poruke?
Ne. Metina stranica o cijenama navodi da Calling API ima drugačije cijene i upućuje na zaseban dokument o cijenama poziva, pa se naplate poziva ne pojavljuju u objektu pricing u statusima poruka.
Može li se poziv putem Calling API snimiti ili transkribirati?
Da, kada je snimanje ili transkripcija uključena. Nakon poziva Meta šalje call_recording_available s ID-em audio medija ili call_transcription_available s ID-em JSON dokumenta, obično unutar minute.
Može li webhook poziva ići na drugi endpoint od onoga koji koristi aplikacija?
Da. calls je jedno od polja koja Meta omogućuje usmjeriti na alternativni URL za povratne pozive, uz messages i polja vezana uz Coexistence.
Nastavite čitati
Spremni za početak?
Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.
Započnite besplatno probno razdobljeProvjereno na