IngiaAnza kipindi cha majaribio bila malipo
Meta Tech Provider

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.

Not supported

Simu za sauti na video kwenye Cloud API kwa nambari iliyounganishwa kwa programu ya WhatsApp Business; kwenye programu zinabaki bila mabadiliko.

2,000

Kiwango cha chini cha ujumbe wa kila siku, kwa wapokeaji wa kipekee, ambacho nambari inahitaji kabla ya kutumia Calling API.

7 days

Muda ambao rekodi na nakala za simu zinabaki tayari kupakuliwa baada ya webhook yake kuwasilishwa.

wacid

Kiambishi cha vitambulisho vya simu, thamani inayounganisha webhook za connect, hali na terminate za simu moja.

whatsapp_business_messaging

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.

connectThe call is ready to connect; session carries the SDP to apply to your WebRTC stack.
call_createdA SIP call was attempted, business- or user-initiated.
statuses (type call)RINGING, ACCEPTED or REJECTED for a business-initiated call.
terminateThe call ended: status COMPLETED or FAILED, with times and duration when answered.
call_recording_availableA media id for the finished audio recording.
call_transcription_availableA media id for the transcript, a JSON document.

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:

Meta's example: the Call Connect webhook
{
  "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_time na 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.
Kufanya hili ukitumia EasyCoexistence

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 malipo

Imethibitishwa kwenye