පුරනය වන්නනොමිලේ trial කාලය ආරම්භ කරන්න
Meta Tech Provider

WhatsApp calls webhook එක: Calling API සිදුවීම්, සහ Coexistence අංකයක ඇමතුම්

calls webhook field එක WhatsApp Business Calling API සිදුවීම් වාර්තා කරයි: SDP answer හෝ offer සමඟ සම්බන්ධ වීම, RINGING, ACCEPTED සහ REJECTED ඇමතුම් තත්ත්ව, COMPLETED හෝ FAILED සහ කාලය සමඟ අවසන් වීම, සහ call_recording_available හෝ call_transcription_available. Meta හි Coexistence මාර්ගෝපදේශයේ WhatsApp Business app හි හඬ සහ වීඩියෝ ඇමතුම් වෙනස් නොවන ලෙසත්, Cloud API හි සහාය නොදක්වන ලෙසත් ලැයිස්තු කර ඇත, එබැවින් ඒ ඇමතුම් දුරකථනය මත පවතී.

easyCoexistence ඔබේ WhatsApp Business app අංකය Coexistence හරහා Meta හි Cloud API ට සම්බන්ධ කරයි, ඔබේ AI සහ automations පණිවිඩවලට පිළිතුරු දෙන අතර templates යවයි, ඇමතුම් ඔබේ දුරකථනයේ app එකේ නාදවීම දිගටම කරයි.

Not supported

WhatsApp Business app සමඟ සම්බන්ධ කළ අංකයක Cloud API හි හඬ සහ වීඩියෝ ඇමතුම්; app හි ඒවා වෙනස් නොවේ.

2,000

Calling API භාවිත කිරීමට අංකයකට පෙර අවශ්‍ය අවම දෛනික messaging limit, අනන්‍ය ලබන්නන් ගණනින්.

7 days

ඇමතුම් පටිගත කිරීම් සහ පිටපත් ඒවායේ webhook ලැබුණු පසු බාගත කළ හැකි කාලය.

wacid

ඇමතුම් id හි prefix, එක ඇමතුමක connect, status සහ terminate webhook එකට බැඳෙන අගය.

whatsapp_business_messaging

calls webhook ලබා ගැනීමට app එකට අවශ්‍ය අවසරය, messages සඳහා ඇති අවසරයට සමාන.

calls webhook field එක කුමක් වාර්තා කරයි?

Calling API හරහා සිදු කළ හෝ ලැබුණු ඇමතුමකට සිදුවන සියල්ල, එක field එකක, එක් අදියරකට එක සිදුවීමක් ලෙස. ව්‍යාපාරය ආරම්භ කළ ඇමතුමක් connect සිදුවීමක්, තත්ත්ව යාවත්කාලීන සහ terminate සිදුවීමක් නිපදවයි. SIP හරහා සේවය වූ ඇමතුම් connect වෙනුවට call_created වාර්තා කරන අතර SDP session එකක් නොමැත. ඊට අදාළ එක සිදුවීමක් වෙනත් තැනක පවතී: ගනුදෙනුකරු call permission ඉල්ලීමකට පිළිතුරු දුන් විට, පිළිතුර messages field එකට call_permission_reply වර්ගයේ interactive පණිවිඩයක් ලෙස පැමිණේ.

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.

calls webhook එකක් කෙසේ පෙනේද?

සෑම WhatsApp webhook එකේ ම envelope එකම, value යටතේ calls array එකක් සහ field අගය calls ලෙස. direction හි BUSINESS_INITIATED හෝ USER_INITIATED ය, from සහ to දුරකථන අංක දරයි, to_user_id ගනුදෙනුකරුගේ BSUID වේ, පරිශීලක නාමයක් භාවිත කරන ගනුදෙනුකරුවකුට කුමන අංකයක් හෝ නොතිබිය හැක. metadata.phone_number_id ඔබේ අංකය හඳුනාගනී, ඕනෑම අනෙක් field එකක මෙන්. මෙය Meta හි Call Connect උදාහරණයයි, ස්ථාන දරන අගයන් Meta ප්‍රකාශ කරන ආකාරයෙන්:

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"
        }
      ]
    }
  ]
}

terminate event එක කුමන fields එකතු කරයි?

terminate යනු බොහෝ පද්ධති ගබඩා කරන සිදුවීම ය, මන්ද එය ඇමතුම වසා දමයි. Meta හි reference අනුව එහි fields:

  • status: ඇමතුම අනපේක්ෂිත දෝෂ නොමැතිව අවසන් වූ විට COMPLETED, පිළිතුරු නොලැබුණු ඇමතුම් ද ඇතුළුව; සම්බන්ධ නොවූ හෝ බිඳ වැටුණු විට FAILED.
  • start_time, end_time සහ duration තත්පරවලින්: අනෙක් පාර්ශවය ඇමතුම පිළිගත් විට පමණක් පවතී.
  • errors: code, message, href සහ error_data.details FAILED ඇමතුමක.
  • biz_opaque_callback_data: ඇමතුම ආරම්භ කිරීමේදී හෝ පිළිගැනීමේදී ඔබ ලබා දුන්නේ නම්, ඔබේම ලුහුබැඳීමේ string එක.

Coexistence අංකයක calls webhook වැඩ කරයිද?

Meta හි Coexistence මාර්ගෝපදේශය එය එහි feature වගුවේ පිළිතුරු දෙයි: හඬ සහ වීඩියෝ ඇමතුම් WhatsApp Business app හි වෙනසක් නොදකින අතර, මේ ආකාරයට සම්බන්ධ කළ අංකයක් සඳහා Cloud API හි සහාය නොදක්වයි. Calling API හි තමන්ගේම පූර්ව අවශ්‍යතා අනෙක් පැත්තෙන් එකම දේ කියයි: ව්‍යාපාරික අංකය WhatsApp Business app එකෙන් නොව Cloud API සමඟ භාවිත කළ යුතුය. එබැවින් Coexistence අංකයක ගනුදෙනුකරුවන් පෙර මෙන්ම ඇමතීම දිගටම කරයි, ඇමතුම දුරකථනයේ app එකේ නාද වන අතර, calls field එකට වාර්තා කිරීමට කිසිවක් නැත. මෘදුකාංගයේ ඇමතුම් අවශ්‍ය ව්‍යාපාරයක් Cloud API හි පමණක් අංකයක් භාවිත කරයි.

එක ඇමතුමක සිදුවීම් එකට ගැලපෙන්නේ කෙසේද?

ඇමතුම් id මගින්, එය wacid වලින් ආරම්භ වන අතර එම ඇමතුමේ සෑම සිදුවීමකම නැවත පැමිණේ. ව්‍යාපාරය ආරම්භ කළ ඇමතුමක් SDP answer සහිත connect, RINGING ඉන්පසු ACCEPTED හෝ REJECTED තත්ත්ව, අවසානයේ terminate වාර්තා කරයි. පරිශීලක ආරම්භ කළ ඇමතුමක් ඔබේ stack එකට පිළිතුරු දීමට SDP offer සහිත connect, ඉන්පසු terminate වාර්තා කරයි. පටිගත කිරීම් සහ පිටපත් සිදුවීම්, සක්‍රීය කළ විට, terminate ට පසුව පැමිණේ. ගබඩා කරන සිදුවීම් id සහ event මත යතුරු කරන්න, මන්ද නැවත උත්සාහ කිරීම් ඒවා නැවත ලබා දෙන අතර පැමිණීමේ අනුපිළිවෙල සහතික නොවේ. Calling API පූර්ව අවශ්‍යතා සම්පූර්ණ ලැයිස්තුව Coexistence අංක මත ඇමතුම් පිටුවේ ඇත.

AI ට Coexistence අංකයක ඇමතුම් ගැන කුමක් කළ හැකිද?

චැට් එකේ වැඩ කරයි, ඇමතුම් දුරකථනය ළඟ සිටින පුද්ගලයා සමඟ රැඳේ. easyCoexistence calls field එකට දායක නොවන අතර ඇමතුම් tools නැත; එහි connector සහ automations ආවරණය කරන්නේ පණිවිඩ සහ templates ය. ප්‍රායෝගිකව, AI පිළිතුරක් ගනුදෙනුකරුට කවුරුන් කථා කිරීමට ලබා ගත හැකිද සහ කුමන අංකයට ඇමතිය යුතුද යන්න පැවසිය හැකි අතර, keyword automation එකකට "call" හෝ "phone" ට එම තොරතුරු පිළිතුරු දිය හැකි අතර, හිමිකරු WhatsApp Business app හි ඇමතුම පෙර මෙන් ගන්නා.

සාමාන්‍ය වැරදි

  • Coexistence අංකයක් සඳහා calls දායක වී සිදුවීම් බලා සිටීම. Meta මේ අංක සඳහා Cloud API හි ඇමතීම සහය නොදක්වන ලෙස ලැයිස්තු කරයි.
  • සෑම terminate එකකම start_time සහ duration බලාපොරොත්තු වීම. ඒවා පෙනෙන්නේ ඇමතුමට පිළිතුරු දුන් විට පමණි; පිළිතුරු නොලැබුණු ඇමතුමක් තවමත් COMPLETED ලෙස අවසන් වේ.
  • පිළිතුරු අවසර calls field එකේ සොයීම. ඒවා පැමිණෙන්නේ messages හි, interactive call_permission_reply ලෙස.
  • පටිගත කිරීම් සහ පිටපත් Meta වෙත තැබීම. දෙකම ඒවායේ webhook ලැබීමෙන් දින 7ක් බාගත කළ හැකිය, ඉන්පසු ඒවා නැති වේ.
EasyCoexistence සමඟ මෙය කිරීම

සෑම අංකයක් ම 24/7 නිරීක්ෂණය කරයි, app විවෘත නොකළ අංකයක් විසන්ධි කරන 14-දින රීතිය ද ඇතුළුව. අංකයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, අංක එකතු කරන විට අඩු වේ, පළමු දින 3 නොමිලේ.

නිතර අසන ප්‍රශ්න

Coexistence හරහා අංකයක් API සමඟ සම්බන්ධ කළ විට ගනුදෙනුකරුවන් ඇමතුම් බොත්තම නැති කරගනීද?

Meta හි Coexistence මාර්ගෝපදේශය හඬ සහ වීඩියෝ ඇමතුම් WhatsApp Business app හි වෙනස් නොවන ලෙස ලැයිස්තු කරයි. ගනුදෙනුකරුවන් එම අංකයට ඇමතීම දිගටම කරයි, හිමිකරු දුරකථනයේ app හි පිළිතුරු දෙයි.

Calling API මිල messages මෙන් ද?

නැත. Meta හි මිල ගණන් පිටුව කියන්නේ Calling API හට වෙනස් මිල ගණන් ඇති බවත්, ඒ සඳහා වෙනම calling pricing ලේඛනයට යොමු කරන බවත්ය, එබැවින් ඇමතුම් ගාස්තු message statuses හි pricing object එකේ දිස් නොවේ.

Calling API ඇමතුමක් පටිගත හෝ පිටපත් කළ හැකිද?

ඔව්, පටිගත කිරීම හෝ පිටපත් කිරීම සක්‍රීය කළ විට. ඇමතුම අවසන් වූ පසු, Meta call_recording_available යවයි audio media id සමඟ, හෝ call_transcription_available JSON document id සමඟ, සාමාන්‍යයෙන් මිනිත්තුවක් ඇතුළත.

ඇමතුම් webhook එකක් app එකේ එකට වඩා වෙනස් endpoint එකකට යා හැකිද?

ඔව්. calls යනු Meta විසින් WhatsApp Business Account හෝ phone number එකකට විකල්ප callback URL එකකට යොමු කිරීමට ඉඩ දෙන field වලින් එකකි, messages සහ Coexistence fields සමඟ එකට.

තවදුරටත් කියවන්න

WhatsApp Business ඇමතුම්, Coexistence අංකයක්Coexistence ලැබීමෙන් පසුත් WhatsApp Business යෙදුමේ හඬ සහ වීඩියෝ ඇමතුම් ක්‍රියා කරයි, නමුත් Meta හි Calling API මෙම අංක සඳහා සහාය නොදක්වයි.WhatsApp webhook statuses: sent, delivered, read සහ failedWhatsApp ඔබ යැවූ පණිවිඩයට සිදු වූ දේ වාර්තා කරන ආකාරය: statuses array එක, status අගයන්, fields, wamid සහ Meta හි සත්‍ය payload.Coexistence පසු නවතින WhatsApp විශේෂාංගසම්බන්ධ කළ අංකයක අතුරුදහන් වන පණිවිඩ, එකවරක් බැලීම, සජීවී ස්ථානය සහ විකාශන ලැයිස්තු අක්‍රිය වේ. ප්‍රායෝගික අර්ථය මෙන්න.API එකට සමමුහුර්ත වන සහ නොවන දේසම්බන්ධතා සහ එක්-එක් පණිවිඩ ඉතිහාසය හුවමාරු වේ. සමූහ, නාමාවලිය සහ යෙදුම් මෙවලම් හුවමාරු නොවේ. සම්පූර්ණ ලැයිස්තුව මෙතැන.Coexistence සිට Cloud API පමණක් වෙත අංකයක් මාරු කිරීමWhatsApp Business යෙදුමෙන් අංකයක් ඉවත් කර Cloud API පමණක් භාවිතා කිරීම: පියවරවල අනුපිළිවෙල, Meta පවසන ඉතිහාසය අහිමි වීම සහ වෙනස් වන දේ.WhatsApp webhook retry, අනුපිටපත් සහ පිළිවෙළ: ඒවා හසුරුවන ආකාරයMeta දින 7ක් දක්වා webhooks retry කරන නිසා අනුපිටපත් සාමාන්‍යයි, පිළිවෙළ සහතික නොවේ. Deduplicate කළ යුතු keys, ආරක්ෂිත handler සහ ප්‍රතිචාර ගැන.

ආරම්භ කිරීමට සූදානම්ද?

WhatsApp Coexistence මිනිත්තු කිහිපයකින් සකසන්න, මාස ගණනකින් නොව. යෙදුම දුරකථනයේ දිගටම ක්‍රියා කරයි.

නොමිලේ trial කාලය ආරම්භ කරන්න

සත්‍යාපනය කළේ