Webhook za simu za WhatsApp: matukio ya Calling API, na simu kwenye nambari ya Coexistence
Field calls huripoti matukio ya WhatsApp Business Calling API: kuunganisha kwa jibu la SDP au ofa ya SDP, hali za simu RINGING, ACCEPTED na REJECTED, kukamilisha kwa COMPLETED au FAILED pamoja na muda wa simu, na call_recording_available au call_transcription_available. Mwongozo wa Coexistence wa Meta unaorodhesha simu za sauti na video kama zisizobadilika kwenye programu ya WhatsApp Business na zisizosaidiwa kwenye Cloud API, kwa hiyo simu hizo zinabaki kwenye simu yako.
easyCoexistence inaunganisha nambari yako ya programu ya WhatsApp Business na Cloud API ya Meta kupitia Coexistence, ili AI yako na otomatiki zijibu ujumbe na kutuma violezo vya ujumbe huku simu zikiendelea kuita kwenye programu ya simu yako.
Simu za sauti na video kwenye Cloud API kwa nambari iliyounganishwa kwa programu ya WhatsApp Business; kwenye programu zinabaki bila mabadiliko.
Kiwango cha chini cha ujumbe wa kila siku, kwa wapokeaji wa kipekee, ambacho nambari inahitaji kabla ya kutumia Calling API.
Muda ambao rekodi na nakala za simu zinabaki tayari kupakuliwa baada ya webhook yake kuwasilishwa.
Kiambishi cha vitambulisho vya simu, thamani inayounganisha webhook za connect, hali na terminate za simu moja.
Ruhusa ambayo programu inahitaji ili kupokea webhook za simu, sawa na ile ya ujumbe.
Field ya webhook ya calls inaripoti nini?
Kila kinachompata simu iliyopigwa au kupokelewa kupitia Calling API, kwenye field moja yenye tukio kwa kila hatua. Simu inayoanzishwa na biashara huzalisha tukio la connect, masasisho ya hali na tukio la terminate. Simu zinazoshughulikiwa kupitia SIP huripoti call_created badala ya connect, bila kikao cha SDP. Tukio moja linalohusiana lipo mahali pengine: mteja anapojibu ombi la ruhusa ya simu, jibu hufika kwenye field ya messages kama ujumbe wa aina ya interactive wa call_permission_reply.
Webhook ya simu inaonekanaje?
Muundo ule ule wa webhook zote za WhatsApp, na orodha ya calls chini ya value na field ikiwekwa calls. direction inasema BUSINESS_INITIATED au USER_INITIATED, from na to zina nambari za simu, to_user_id ni BSUID ya mteja, na nambari yoyote inaweza kukosekana kwa mteja anayetumia jina la mtumiaji. metadata.phone_number_id inatambulisha nambari yako, kama kwenye field nyingine yoyote. Hiki ni mfano wa Call Connect wa Meta, pamoja na vishikilia nafasi kama Meta inavyovichapisha:
{
"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"
}
]
}
]
}Tukio la terminate linaongeza sehemu gani?
terminate ndilo tukio ambalo mifumo mingi huhifadhi, kwa sababu hufunga simu. Sehemu zake, kwa mujibu wa marejeo ya Meta:
- status: COMPLETED simu ilipomalizika bila hitilafu zisizotarajiwa, ikiwemo simu ambazo hazikujibiwa; FAILED simu iliposhindwa kuunganishwa au ilipokatika.
start_time,end_timena duration kwa sekunde: zipo tu pale mtu wa upande mwingine alipopokea.- errors: code, message, href na
error_data.details kwenye simu ya FAILED. biz_opaque_callback_data: kamba yako mwenyewe ya kufuatilia, pale ulipoipitisha wakati wa kuanzisha au kupokea simu.
Je, webhook za simu zinafanya kazi kwenye nambari ya Coexistence?
Mwongozo wa Coexistence wa Meta unajibu hili kwenye jedwali lake la vipengele: simu za sauti na video hazibadiliki kwenye programu ya WhatsApp Business na hazisaidiwi kwenye Cloud API kwa nambari iliyounganishwa kwa njia hii. Sharti la Calling API lenyewe linasema hivyo hivyo kutoka upande mwingine: nambari ya biashara lazima itumike kwenye Cloud API, si kwenye programu ya WhatsApp Business. Kwa hiyo kwenye nambari ya Coexistence wateja wanaendelea kupiga kama kawaida, simu inaita kwenye programu ya simu yako, na field ya calls haina chochote cha kuripoti. Biashara inayohitaji simu kwenye programu yake huitumia nambari kwenye Cloud API pekee.
Matukio ya simu moja yanakaaje pamoja?
Kwa kitambulisho cha simu, ambacho huanza na wacid na hujirudia kwenye kila tukio la simu hiyo. Simu inayoanzishwa na biashara huripoti connect pamoja na jibu la SDP, hali RINGING kisha ACCEPTED au REJECTED, na mwisho terminate. Simu inayoanzishwa na mtumiaji huripoti connect pamoja na ofa ya SDP ambayo mfumo wako unapaswa kujibu, kisha terminate. Matukio ya rekodi na nakala, yanapowezeshwa, huja baada ya terminate. Hifadhi matukio kwa id pamoja na event, kwa sababu marudio hurudia matukio na mpangilio wa kufika haujahakikishwa. Orodha kamili ya masharti ya Calling API iko kwenye ukurasa kuhusu simu kwenye nambari ya Coexistence.
AI yako inaweza kufanya nini kuhusu simu kwenye nambari ya Coexistence?
Inafanya kazi kwenye mazungumzo, huku simu zikibaki kwa mtu aliye na simu. easyCoexistence haijiandikishi kwenye field ya calls na haina zana za simu; kiunganishi chake na otomatiki zinahusu ujumbe na violezo vya ujumbe. Kwa vitendo hilo linamaanisha kwamba jibu la AI linaweza kumwambia mteja wakati mtu anapatikana kuzungumza na nambari ya kupigia, otomatiki ya neno muhimu inaweza kujibu neno "simu" kwa taarifa hiyo, na mmiliki anapokea simu kwenye programu ya WhatsApp Business kama kawaida.
Makosa ya kawaida
- Kujisajili kwa calls kwa nambari ya Coexistence na kusubiri matukio. Meta inaorodhesha kupiga simu kama kisichosaidiwa kwenye Cloud API kwa nambari hizi.
- Kutarajia start_time na duration kwenye kila terminate. Zinaonekana tu simu ilipopokelewa; simu ambayo haikujibiwa bado inaishia COMPLETED.
- Kutafuta majibu ya ruhusa kwenye field ya calls. Yanafika kwenye messages, kama call_permission_reply ya aina ya interactive.
- Kuacha rekodi na nakala kwa Meta. Zote mbili zinaweza kupakuliwa kwa siku 7 baada ya webhook yake, kisha zinapotea.
Kila nambari inafuatiliwa saa 24 kwa siku, siku 7 kwa wiki, ikiwemo kanuni ya siku 14 inayokata nambari ambayo programu yake haijafunguliwa. Kuanzia US$ 9 hadi US$ 0.75 kwa kila nambari kwa mwezi, bei inashuka kadri unavyoongeza nambari, pamoja na siku 3 za kwanza bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, wateja wanapoteza kitufe cha kupiga simu nambari inapounganishwa na API kupitia Coexistence?
Mwongozo wa Coexistence wa Meta unaorodhesha simu za sauti na video kama zisizobadilika kwenye programu ya WhatsApp Business. Wateja wanapiga nambari ile ile, na mmiliki anapokea kwenye programu ya simu yake.
Je, Calling API inatozwa kama ujumbe?
Hapana. Ukurasa wa bei wa Meta unasema Calling API ina bei tofauti na unaelekeza kwenye hati tofauti ya bei ya simu, kwa hiyo malipo ya simu hayaonekani kwenye kitu cha pricing cha hali za ujumbe.
Je, simu ya Calling API inaweza kurekodiwa au kunakiliwa?
Ndiyo, pale rekodi au nakala inapowezeshwa. Baada ya simu, Meta hutuma call_recording_available pamoja na media id ya sauti, au call_transcription_available pamoja na id ya hati ya JSON, kwa kawaida ndani ya dakika moja.
Je, webhook ya simu inaweza kwenda kwenye endpoint tofauti na ile ya programu?
Ndiyo. calls ni mojawapo ya field ambazo Meta inaruhusu Akaunti ya WhatsApp Business au nambari ya simu kuelekezwa kwenye URL mbadala ya callback, pamoja na messages na field za Coexistence.
Endelea kusoma
Uko tayari kuanza?
Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.
Anza kipindi cha majaribio bila malipoImethibitishwa kwenye