Calls webhook sa WhatsApp: Calling API events, at mga tawag sa Coexistence na numero
Iniuulat ng calls field ang mga event ng WhatsApp Business Calling API: connect na may SDP answer o offer, mga call status na RINGING, ACCEPTED at REJECTED, terminate na may COMPLETED o FAILED at ang tagal, at call_recording_available o call_transcription_available. Nakasaad sa gabay ng Meta sa Coexistence na nananatiling pareho ang voice at video call sa WhatsApp Business app at hindi suportado sa Cloud API, kaya nananatili ang mga tawag na iyon sa telepono.
Ikinokonekta ng easyCoexistence ang inyong numero sa WhatsApp Business app sa Cloud API ng Meta sa pamamagitan ng Coexistence, kaya sinasagot ng AI at mga automation ninyo ang mga mensahe at nagpapadala ng template, habang nananatiling tumutunog ang mga tawag sa app sa telepono ninyo.
Voice at video call sa Cloud API para sa numerong na-onboard gamit ang WhatsApp Business app; sa app, pareho ang mga ito.
Pinakamababang araw-araw na limit sa mensahe, sa bilang ng natatanging tatanggap, na kailangan ng numero bago magamit ang Calling API.
Gaano katagal mananatiling ma-download ang mga recording at transcript ng tawag matapos ma-deliver ang kanilang webhook.
Ang prefix ng call id, ang halagang nagdudugtong sa connect, status at terminate webhook ng isang tawag.
Ang permission na kailangan ng app para makatanggap ng calls webhook, pareho sa messages.
Ano ang iniuulat ng calls webhook field?
Lahat ng nangyayari sa tawag na inilagay o tinanggap sa pamamagitan ng Calling API, sa iisang field na may isang event sa bawat yugto. Ang tawag na sinimulan ng negosyo ay gumagawa ng connect event, mga status update, at terminate event. Ang tawag na hinawakan sa SIP ay nag-uulat ng call_created sa halip na connect, nang walang SDP session. May kaugnay na event sa ibang lugar: kapag sinagot ng customer ang hiling sa permission ng tawag, ang sagot ay dumarating sa messages field bilang interactive na mensahe na may type na call_permission_reply.
Ano ang itsura ng calls webhook?
Pareho ang envelope gaya ng lahat ng WhatsApp webhook, na may calls array sa ilalim ng value at field na nakatakda sa calls. Ang direction ay nagsasabing BUSINESS_INITIATED o USER_INITIATED, ang from at to ay naglalaman ng numero ng telepono, ang to_user_id ang BSUID ng customer, at maaaring mawala ang alinman sa dalawang numero para sa customer na gumagamit ng username. Tinutukoy ng metadata.phone_number_id ang inyong numero, gaya ng sa anumang field. Ito ang halimbawa ng Call Connect ng Meta, na may mga placeholder gaya ng nakalimbag ng Meta:
{
"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"
}
]
}
]
}Anong mga field ang idinadagdag ng terminate event?
Ang terminate ang event na karaniwang iniimbak ng mga sistema, dahil isinasara nito ang tawag. Ang mga field nito, ayon sa reference ng Meta:
- status: COMPLETED kapag natapos ang tawag nang walang hindi inaasahang error, kasama ang mga hindi sinagot na tawag; FAILED kapag hindi ito nakakonekta o naputol.
start_time,end_timeat duration sa segundo: nandoon lamang kapag sumagot ang kabilang panig.- errors: code, message, href at
error_data.details sa isang FAILED na tawag. biz_opaque_callback_data: sarili ninyong tracking string, kapag naipasa ninyo ito noong sinimulan o tinanggap ang tawag.
Gumagana ba ang calls webhook sa Coexistence na numero?
Sinasagot ito ng feature table sa gabay ng Meta sa Coexistence: walang pagbabago sa voice at video call sa WhatsApp Business app, at hindi suportado sa Cloud API para sa numerong na-onboard sa ganitong paraan. Ganoon din ang sinasabi ng mga prerequisite ng Calling API mula sa kabilang panig: dapat ginagamit ang numero ng negosyo sa Cloud API, hindi sa WhatsApp Business app. Kaya sa Coexistence na numero, patuloy na tumatawag ang mga customer gaya ng dati, tumutunog ang tawag sa app sa telepono, at walang maiuulat ang calls field. Ang negosyong nangangailangan ng tawag sa software ay gumagamit ng numero sa Cloud API lamang.
Paano nag-uugnay ang mga event ng isang tawag?
Sa pamamagitan ng call id, na nagsisimula sa wacid at inuulit sa bawat event ng tawag na iyon. Ang tawag na sinimulan ng negosyo ay nag-uulat ng connect na may SDP answer, mga status na RINGING at pagkatapos ay ACCEPTED o REJECTED, at sa huli ay terminate. Ang tawag na sinimulan ng user ay nag-uulat ng connect na may SDP offer para sagutin ng inyong stack, at pagkatapos ay terminate. Ang mga event ng recording at transcript, kapag naka-enable, ay dumarating pagkatapos ng terminate. I-store ang mga event gamit ang id at event bilang susi, dahil inuulit ang mga ito ng mga retry at hindi ginagarantiya ang pagkakasunod ng pagdating. Ang buong listahan ng prerequisite ng Calling API ay nasa pahina tungkol sa mga tawag sa Coexistence na numero.
Ano ang magagawa ng inyong AI tungkol sa mga tawag sa Coexistence na numero?
Gumagana sa chat, habang ang mga tawag ay nananatili sa taong nasa telepono. Hindi nagsa-subscribe ang easyCoexistence sa calls field at walang call tool; ang connector at automation nito ay sumasaklaw sa mga mensahe at template. Sa praktika, maaaring sabihin ng AI reply sa customer kung kailan may available na makakausap at aling numero ang tatawagan, maaaring sagutin ng keyword automation ang "tawag" o "telepono" ng impormasyong iyon, at ang may-ari ang sumasagot sa tawag sa WhatsApp Business app gaya ng dati.
Mga karaniwang pagkakamali
- Pag-subscribe sa calls para sa Coexistence na numero at paghihintay ng event. Nakalista ng Meta na hindi suportado sa Cloud API ang calling para sa mga numerong ito.
- Pag-aakalang lalabas ang start_time at duration sa bawat terminate. Lumalabas lamang ang mga ito kapag nasagot ang tawag; ang hindi nasagot na tawag ay nagtatapos pa rin sa COMPLETED.
- Paghahanap ng permission reply sa calls field. Dumarating ang mga ito sa messages, bilang interactive na call_permission_reply.
- Pag-iwan ng recording at transcript sa Meta. Maaaring i-download ang dalawa sa loob ng 7 araw pagkatapos ng webhook nito, pagkatapos ay mawawala na ang mga ito.
Binabantayan ang bawat numero 24/7, kasama ang 14-araw na patakaran na nagdi-disconnect ng numerong hindi nabubuksan ang app. Mula US$ 9 hanggang US$ 0.75 kada numero kada buwan, bumababa habang dumarami ang mga numero, na may free trial na 3 araw.
Mga madalas itanong
Nawawala ba sa mga customer ang call button kapag kumokonekta ang numero sa API sa pamamagitan ng Coexistence?
Nakalista sa gabay ng Meta sa Coexistence na nananatiling pareho ang voice at video call sa WhatsApp Business app. Tatawag pa rin ang mga customer sa parehong numero, at sasagutin ito ng may-ari sa app sa telepono.
Pareho ba ang presyo ng Calling API sa mga mensahe?
Hindi. Sinasabi ng pahina ng presyo ng Meta na iba ang presyo ng Calling API at tumuturo sa hiwalay na dokumento ng presyo sa calling, kaya hindi lumalabas ang singil sa tawag sa pricing object ng mga status ng mensahe.
Maaari bang i-record o i-transcribe ang tawag sa Calling API?
Oo, kapag naka-enable ang recording o transcription. Pagkatapos ng tawag, nagpapadala ang Meta ng call_recording_available na may audio media id o call_transcription_available na may JSON document id, karaniwan sa loob ng isang minuto.
Maaari bang mapunta ang call webhook sa ibang endpoint kaysa sa app?
Oo. Pinapayagan ng Meta ang WhatsApp Business Account o numero ng telepono na ituro ang calls sa alternatibong callback URL, kasama ng messages at ng mga Coexistence field.
Magpatuloy sa pagbabasa
Handa na po ba kayong magsimula?
I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.
Magsimula ng Libreng TrialNa-verify noong