WhatsApp webhooks: පණිවිඩ සෘජුවම ඔබගේ server එකට යොමු කිරීම
WhatsApp webhook එකක් යනු ඔබ නම් කරන HTTPS endpoint එකකි. Meta එයට සිදුවීම් යවයි: එන පණිවිඩ, බෙදාහැරීම් status, ගුණාත්මක වෙනස්කම් සහ ගිණුම් යාවත්කාලීන. Coexistence අංකයක ගමනාන්තය ඔබගේම server එකට සකස් කළ හැකි නිසා, සංවාද කිසිඳු provider කෙනෙකු හරහා නොයයි.
- Meta සිදුවීම් ඔබගේ URL එකට සෘජුවම යවයි
- providerගේ platform එක නොව ඔබගේ endpoint එක
- එක් WhatsApp Business ගිණුමකට එක් override එකක්
දින 7ක් කිසිදු ගාස්තුවක් නැත. ඕනෑම වේලාවක අවලංගු කරන්න.
සම්පූර්ණ integration එක: එක් ගිණුමකට එක් HTTPS ගමනාන්තයක්.
messages සහ smb_message_echoes, ඔබ වෙත යොමු කරන පණිවිඩ මාර්ග සිදුවීම්.
ඔබගේ endpoint එක නැවත යැවිය යුතු GET handshake හි Meta යවන අගය.
Meta webhook එකකට ඇත්තටම යවන්නේ මොනවාද?
සිදුවීම් කාණ්ඩ අනුව යවයි. ඒවා අතර වෙනස ඔබගේ architecture එක තීරණය කරයි.
පණිවිඩ මාර්ගය පාරිභෝගිකයන් යවන දේ රැගෙන යයි. Coexistence අංකයකදී, WhatsApp Business යෙදුමෙන් ඔබගේ කණ්ඩායම යවන පණිවිඩවල echo ද එයට ඇතුළත් වේ. මේවා messages සහ smb_message_echoes යන fields වන අතර, සංවාද අන්තර්ගතය ඇත්තේ මේවායේය.
ක්‍රියාකාරී මාර්ගය අනෙක් සියල්ල රැගෙන යයි: සම්බන්ධතා තත්ත්වය වෙනස් වූ විට account_update, quality හෝ throughput වෙනස් වූ විට phone_number_quality_update, account_alerts, account_review_update, business_capability_update සහ phone_number_name_update. මේවායේ සංවාද අන්තර්ගතයක් නැති අතර monitoring ගොඩනගන්නේ මේවා මතය.
පණිවිඩ මාර්ගයට තමන්වම තබන provider කෙනෙකුට පළමු කාණ්ඩය ලැබේ. එසේ නොකරන provider කෙනෙකුට එය නොලැබේ.
Meta endpoint එකක් සත්‍යාපනය කරන්නේ කෙසේද?
කිසිවක් බෙදාහැරීමට පෙර GET request එකක් මඟිනි. මෙය අසාර්ථක වීම setup එක සම්පූර්ණයි ලෙස පෙනුණත් පණිවිඩයක් නොලැබීමට ඇති පොදුම හේතුවයි.
Meta ඔබගේ URL එකට hub.mode, subscribe ලෙසත්, ඔබගේ hub.verify_token සහ hub.challenge අගයත් සමඟ call කරයි. ඔබගේ endpoint එක එම challenge එක raw response body ලෙස ආපසු ලබා දිය යුතුය. එය JSON තුළ ආවරණය නොකළ යුතු අතර කිසිවක් එකතු නොකළ යුතුය. එසේ නොකළහොත් Meta බෙදාහැරීම කිසිදා ආරම්භ නොකරයි, කිසිදු dashboard එකක ඒ බව නොපෙන්වයි.
Endpoint එක HTTPS විය යුතුය. නිහඬ 404 එකක් ලබාදෙන endpoint එකක් හෝ Meta ප්‍රතික්ෂේප කරන authentication layer එකක් පිටුපස ඇති endpoint එකක්, පළමු පණිවිඩය නොලැබෙන තුරු වැඩ කරන setup එකකට සමානව පෙනේ.
ගමනාන්තය ඔබගේම server එකකට යොමු කළ හැකිද?
ඔව්. providerලා අතර වෙනස පෙනෙන්නේ මෙතැනදීය.
දී ඇති WhatsApp Business ගිණුමක webhooks බෙදාහරින ස්ථානය app එකකට override කිරීමට Meta ඉඩ දෙයි. අපි එම override එක ඔබගේ URL එකට සකස් කර, පණිවිඩ මාර්ග සිදුවීම් අපගේ callback එකෙන් ඔබගේ callback එකට මාරු කරමු. dashboard සහ alerting ගොඩනගන්නේ operational events මත බැවින්, ඒවා අපි තබා ගනිමු.
මෙහි ප්‍රතිඵලය අපි ප්‍රකාශ කරන policy එකකට වඩා architecture එකකට සම්බන්ධය. සංවාද අන්තර්ගතය අප වෙත කිසිදා බෙදා නොහරින නිසා, අපගේ පැත්තේ ගබඩා වීමට එයට ස්ථානයක් නැත. override එකක් සකස් නොකළ ගිණුමක් අපගේ default callback වෙත fallback වන අතර handler එක එම සිදුවීම් ගබඩා නොකර ඉවත දමයි.
අංකයක් නැවත සම්බන්ධ වූ විට ගමනාන්තයට සිදුවන්නේ කුමක්ද?
එය ඉවත් වේ. මෙය සැලසුම් කරන අය ඉතා සුළුය.
ගමනාන්තය phone number එකේ property එකක් නොවේ. එය WhatsApp Business ගිණුමට අපගේ app එකේ subscription මත ඇති override එකකි. Metaගේ 14 දින inactivity rule එක නිසා හෝ වෙනත් හේතුවකින් සම්බන්ධතාවයක් ඉවත් කළ විට, එම ගිණුමෙන් app එක uninstall වන අතර override එකද ඒ සමඟ ඉවත් වේ.
නැවත සම්බන්ධ කිරීමෙන් යැවීම සහ monitoring යළි ක්‍රියාත්මක වේ. නමුත් එය ඔබගේ server එකට බෙදාහැරීම යළි සකස් නොකරන අතර කිසිවක් දෝෂයක් වාර්තා නොකරයි. එබැවින් පළමු ඉඟිය වන්නේ කිසිවෙකු පිළිතුරු නොදුන් බව පාරිභෝගිකයෙකු පැවසීමයි. සැබෑ අංකයකට මෙය සිදුවී, එය නිවැරදිව නැවත සම්බන්ධ වී නිහඬ වූ නිසා, සෑම නැවත සම්බන්ධයකදීම අපි override එක යළි යොදමු.
සාමාන්‍ය වැරදි
- සත්‍යාපන GET එකෙන් JSON ආපසු යැවීම. Metaට අවශ්‍ය වන්නේ raw hub.challenge අගය පමණි.
- තාවකාලික හෝ පරීක්ෂණ URL එකක් භාවිත කිරීම. එය සාදන tool එක සවන් දීම නතර කළ පසුවත් Meta එයට බෙදාහරියි.
- නැවත සම්බන්ධ වූ විට ගමනාන්තය පවතිනු ඇතැයි උපකල්පනය කිරීම. එය app subscription එකක පවතින අතර එය සමඟ uninstall වේ.
- Metaගේ request එක ප්‍රතික්ෂේප කරන authentication එකක් පිටුපස endpoint එක තැබීම.
EasyCoexistence ඔබගේ endpoint එකට webhook override එක සකස් කර, call කිරීමට පෙර එය validate කර, ඕනෑම නැවත සම්බන්ධයකින් පසු ස්වයංක්‍රීයව යළි යොදයි. අංකයකට මසකට US$ 9 සිට, විශාල පරිමාවකදී US$ 2 දක්වා අඩුවේ, පළමු දින 7 නොමිලේ.
නිතර අසන ප්‍රශ්න
මගේ පණිවිඩ EasyCoexistence හරහා යනවාද?
නැත. override එකෙන් පණිවිඩ මාර්ග සිදුවීම් Meta වෙතින් ඔබගේ endpoint එකට සෘජුවම යවයි. override එකක් නැති ගිණුමක සිදුවීම් අපගේ callback වෙත fallback වී, ගබඩා නොකර ඉවත දමයි.
මට පසුව ගමනාන්තය වෙනස් කළ හැකිද?
ඔව්, ඕනෑම වේලාවක dashboard එකෙන් හෝ MCP connector එක හරහා කළ හැක. null යැවීමෙන් එය අපගේ default වෙත reset වේ.
Meta බෙදාහරින විට මගේ server එක down නම් කුමක් සිදුවේද?
Meta කාලයක් retries කර පසුව නවතී. පණිවිඩ phone එකේ WhatsApp Business යෙදුමට තවමත් ලැබෙන නිසා, integration එක අසාර්ථක වූවත් ව්‍යාපාරයට කිසිවක් අහිමි නොවේ.
අංක කිහිපයකට එක් webhook එකක් ප්‍රමාණවත්ද?
ඔව්. සෑම අංකයක්ම එකම endpoint එකට යොමු කර, payload එකේ ලැබෙන phone number id අනුව branch කරන්න.
තවදුරටත් කියවන්න
ආරම්භ කිරීමට සූදානම්ද?
WhatsApp Coexistence මිනිත්තු කිහිපයකින් සකසන්න, මාස ගණනකින් නොව. යෙදුම දුරකථනයේ දිගටම ක්‍රියා කරයි.
නොමිලේ trial කාලය ආරම්භ කරන්නදින 7ක් කිසිදු ගාස්තුවක් නැත. ඕනෑම වේලාවක අවලංගු කරන්න.සත්‍යාපනය කළේ