WhatsApp webhook za pozive: događaji Calling API-ja i pozivi na Coexistence broju
Polje calls webhooka prijavljuje događaje WhatsApp Business Calling API-ja: connect sa SDP odgovorom ili ponudom, statuse poziva RINGING, ACCEPTED i REJECTED, terminate sa COMPLETED ili FAILED i trajanjem, te call_recording_available ili call_transcription_available. Vodič za Coexistence kompanije Meta navodi da su glasovni i video pozivi nepromenjeni u aplikaciji WhatsApp Business i da nisu podržani na Cloud API-ju, pa ovi pozivi ostaju na telefonu.
easyCoexistence povezuje vaš broj iz aplikacije WhatsApp Business sa Cloud API-jem kompanije Meta preko Coexistence, pa vaš AI i automatizacije odgovaraju na poruke i šalju šablone, dok pozivi i dalje zvone u aplikaciji na vašem telefonu.
Glasovni i video pozivi na Cloud API-ju za broj priključen preko aplikacije WhatsApp Business; u aplikaciji su nepromenjeni.
Minimalni dnevni limit za slanje poruka, izražen u jedinstvenim primaocima, koji broj mora da ima pre nego što može da koristi Calling API.
Koliko dugo snimci i transkripti poziva ostaju dostupni za preuzimanje nakon isporuke njihovog webhooka.
Prefiks ID-jeva poziva, vrednost koja povezuje događaje connect, status i terminate jednog poziva.
Dozvola koju aplikacija mora imati da bi primala webhookove poziva, ista kao za poruke.
Šta prijavljuje polje calls webhooka?
Sve što se dogodi pozivu upućenom ili primljenom preko Calling API-ja, kao jedno polje sa po jednim događajem za svaku fazu. Poziv koji pokreće firma daje događaj connect, ažuriranja statusa i događaj terminate. Pozivi obrađeni preko SIP-a prijavljuju call_created umesto connect, bez SDP sesije. Jedan srodni događaj nalazi se drugde: kada korisnik odgovori na zahtev za dozvolu poziva, odgovor stiže na polju messages kao interaktivna poruka tipa call_permission_reply.
Kako izgleda calls webhook?
Isti omotač kao kod svakog WhatsApp webhooka, sa nizom calls pod value i field postavljenim na calls. direction označava BUSINESS_INITIATED ili USER_INITIATED, from i to nose telefonske brojeve, to_user_id nosi BSUID kupca, a bilo koji od brojeva može da nedostaje za kupca koji koristi korisničko ime. metadata.phone_number_id identifikuje vaš broj, kao i na svakom drugom polju. Ovo je primer Call Connect iz dokumentacije kompanije Meta, sa zamenskim vrednostima 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 sistema čuva, jer zatvara poziv. Njegova polja, prema referenci kompanije Meta:
- status: COMPLETED kada se poziv završio bez neočekivanih grešaka, uključujući i neodgovorene pozive; FAILED kada nije uspostavljen ili je prekinut.
start_time,end_timei duration u sekundama: prisutni samo kada je druga strana podigla.- errors: code, message, href i
error_data.details kod poziva sa statusom FAILED. biz_opaque_callback_data: vaš sopstveni niz za praćenje, kada ste ga prosledili pri pokretanju ili prihvatanju poziva.
Da li calls webhook radi na Coexistence broju?
Vodič za Coexistence kompanije Meta odgovara na to u tabeli funkcija: glasovni i video pozivi ostaju nepromenjeni u aplikaciji WhatsApp Business, a za broj priključen na ovaj način nisu podržani na Cloud API-ju. Preduslovi samog Calling API-ja govore isto sa druge strane: broj firme mora biti u upotrebi sa Cloud API-jem, a ne u aplikaciji WhatsApp Business. Dakle, na Coexistence broju kupci i dalje zovu kao ranije, poziv zvoni u aplikaciji na telefonu, a polje calls nema šta da prijavi. Firma kojoj su potrebni pozivi u softveru koristi broj samo na Cloud API-ju.
Kako se događaji jednog poziva uklapaju?
Preko ID-ja poziva, koji počinje sa wacid i ponavlja se na svakom događaju tog poziva. Poziv koji pokreće firma prijavljuje connect sa SDP odgovorom, statuse RINGING, pa ACCEPTED ili REJECTED, i na kraju terminate. Poziv koji pokreće korisnik prijavljuje connect sa SDP ponudom koju vaš sistem treba da prihvati, zatim terminate. Događaji snimka i transkripta, kada su uključeni, dolaze posle terminate. Sačuvane događaje vodite po kombinaciji id i event, jer ponovni pokušaji šalju iste događaje ponovo, a redosled dolaska nije zagarantovan. Kompletna lista preduslova Calling API-ja nalazi se na stranici o pozivima na Coexistence broju.
Šta vaš AI može da uradi povodom poziva na Coexistence broju?
Radi u razgovorima, dok pozive ostavlja osobi na telefonu. easyCoexistence se ne pretplaćuje na polje calls i nema alate za pozive; njegov konektor i automatizacije pokrivaju poruke i šablone. U praksi to znači da AI odgovor može kupcu reći kada je neko dostupan za razgovor i na koji broj da zove, automatizacija po ključnoj reči može odgovoriti na „poziv“ ili „telefon“ tom informacijom, a vlasnik poziv prima u aplikaciji WhatsApp Business kao i ranije.
Česte greške
- Pretplata na calls za Coexistence broj i očekivanje događaja. Meta navodi pozivanje kao nepodržano na Cloud API-ju za ove brojeve.
- Očekivanje da start_time i duration postoje u svakom terminate događaju. Pojavljuju se samo kada je poziv odgovoren; neodgovoreni poziv i dalje završava sa COMPLETED.
- Traženje odgovora na dozvolu na polju calls. Stižu na messages, kao interaktivna poruka call_permission_reply.
- Ostavljanje snimaka i transkripata kod kompanije Meta. Oba se mogu preuzeti 7 dana nakon webhooka, posle čega nestaju.
Svaki broj se prati 24/7, uključujući pravilo od 14 dana koje isključuje broj čija se aplikacija ne otvara. Od US$ 9 do US$ 0,75 po broju mesečno, uz smanjenje kako dodajete brojeve, uz besplatni probni period od 3 dana.
Često postavljana pitanja
Da li kupci gube dugme za poziv kada se broj poveže sa API-jem preko Coexistence?
Vodič za Coexistence kompanije Meta navodi glasovne i video pozive kao nepromenjene u aplikaciji WhatsApp Business. Kupci zovu isti broj, a vlasnik odgovara u aplikaciji na telefonu.
Da li se Calling API naplaćuje kao poruke?
Ne. Stranica o cenama kompanije Meta navodi da Calling API ima drugačije cene i upućuje na poseban dokument o cenama poziva, zato se naplata poziva ne pojavljuje u objektu pricing u statusima poruka.
Da li se poziv preko Calling API-ja može snimiti ili transkribovati?
Da, kada su snimanje ili transkripcija uključeni. Posle poziva, Meta šalje call_recording_available sa ID-jem audio medija ili call_transcription_available sa ID-jem JSON dokumenta, obično u roku od minut.
Da li webhook poziva može da ide na drugi endpoint od onog u aplikaciji?
Da. calls je jedno od polja koje Meta dozvoljava da WhatsApp Business Account ili broj telefona usmeri na alternativni URL za povratni poziv, uz messages i polja Coexistence.
Nastavite sa čitanjem
Spremni da počnete?
Podesite WhatsApp Coexistence za nekoliko minuta, a ne meseci. Aplikacija nastavlja da radi na telefonu.
Započnite besplatni probni periodProvereno na