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 එකේ නාදවීම දිගටම කරයි.
WhatsApp Business app සමඟ සම්බන්ධ කළ අංකයක Cloud API හි හඬ සහ වීඩියෝ ඇමතුම්; app හි ඒවා වෙනස් නොවේ.
Calling API භාවිත කිරීමට අංකයකට පෙර අවශ්ය අවම දෛනික messaging limit, අනන්ය ලබන්නන් ගණනින්.
ඇමතුම් පටිගත කිරීම් සහ පිටපත් ඒවායේ webhook ලැබුණු පසු බාගත කළ හැකි කාලය.
ඇමතුම් id හි prefix, එක ඇමතුමක connect, status සහ terminate webhook එකට බැඳෙන අගය.
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 පණිවිඩයක් ලෙස පැමිණේ.
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 ප්රකාශ කරන ආකාරයෙන්:
{
"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ක් බාගත කළ හැකිය, ඉන්පසු ඒවා නැති වේ.
සෑම අංකයක් ම 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 Coexistence මිනිත්තු කිහිපයකින් සකසන්න, මාස ගණනකින් නොව. යෙදුම දුරකථනයේ දිගටම ක්රියා කරයි.
නොමිලේ trial කාලය ආරම්භ කරන්නසත්යාපනය කළේ