messages webhook එක
messages යනු ඔබේ අංකයට පාරිභෝගිකයෙකු යවන සියල්ල රැගෙන යන field එකයි: text, media, replies, reactions සහ interactive responses. routed Coexistence අංකයකදී එය Meta වෙතින් සෘජුවම ඔබේ endpoint එකට යන අතර provider කෙනෙකු හරහා නොයයි.
පාරිභෝගිකයන්ගෙන් ලැබෙන පණිවිඩ රැගෙන යන webhook field එක.
නැවත උත්සාහයන් වෙන්කර හඳුනාගැනීමට භාවිත කරන message id හි prefix එක.
කිසිදු processing එකකට පෙර Meta ඉක්මනින් අපේක්ෂා කරන status එක.
payload එකේ රැගෙන යන්නේ මොනවාද
එක් delivery එකක messages එකක් හෝ කිහිපයක් තිබිය හැක. සෑම එකකම sender, id සහ type ඇත. වෙනත් keys තිබේද යන්න type එක තීරණය කරයි.
- sender ගේ phone number එක සහ ඔවුන් ලියූ අංකයේ phone number id එක.
- wamid message id එක, එය මත deduplication ගොඩනගයි.
- unix timestamp එක.
- type එක: text, image, audio, video, document, sticker, location, contacts, reaction, button හෝ interactive.
- media types සඳහා bytes නොව fetch කිරීමට media id එකක්.
routed number එකකදී එය අප වෙත නොඑන්නේ ඇයි
override මඟින් මෙම field එක smb_message_echoes සමඟ ඔබ නම් කරන ඕනෑම destination එකකට යවන නිසාය.
Meta මඟින් WhatsApp Business Account එකක webhooks ලබාදෙන ස්ථානය app එකකට override කිරීමට ඉඩ දෙයි. අපි එම override එක ඔබේ URL එකට සකසන නිසා message path එක අපගේ infrastructure එකෙන් සම්පූර්ණයෙන් ඉවත් වේ. delivery එක අප වෙත කිසිදා නොපැමිණෙන බැවින් අපගේ පැත්තේ copy එකක්, queue එකක් හෝ retention එකක් නැත.
destination එකක් සකසා නොමැති විට මෙම events අපගේ default callback වෙත fallback වන අතර handler එක ඒවා persist නොකර drop කරයි. storage ගැන කරන ප්‍රකාශයක් සහ code path එකක් අතර වෙනස එයයි: conversation content යාමට ස්ථානයක් නැත.
නිවැරදිව පිළිගන්නේ කෙසේද
වැඩ කිරීමට පෙර, පසුව නොව, 200 ආපසු ලබා දෙන්න.
මන්දගාමී response එකක් failure එකක් ලෙස Meta සලකන අතර නැවත උත්සාහ කරයි. එබැවින් inline ලෙස process කරන handler එකකට එකම message එක එක් වරකට වඩා පෙනේ. වහාම ප්‍රතිචාර දී payload එක queue එකකට හෝ background task එකකට දමා request එකෙන් පිටත වැඩ සිදුවීමට ඉඩ දෙන්න.
serverless පරිසරයක මෙය විකල්පයක් නොවේ. ප්‍රතිචාර දීමෙන් පසුත් වැඩ කරන function එකක් එම මොහොතේම freeze විය හැක. එබැවින් පිළිගැනීම සහ processing එක සැබෑවටම වෙන වෙනම තිබිය යුතුය.
deduplication කිරීම
wamid මත සෑම විටම එය කරන්න, මන්ද retries සාමාන්‍ය දෙයක් මිස විශේෂ අවස්ථාවක් නොවන බැවිනි.
ඔබේ පැත්තේ දෝෂයකට සම්බන්ධ නොවන හේතු නිසා එකම message එක දෙවරක් පැමිණිය හැක: මන්දගාමී response එකක්, network timeout එකක් හෝ delivery අතරතුර deploy එකක් සිදුවීම. දැක ඇති ids ගබඩා කර නැවත පැමිණෙන ඒවා මඟහැරීම පේළි කිහිපයක වැඩකි. පාරිභෝගිකයෙකුට එක් වරක් පිළිතුරු දීමත් දෙවරක් පිළිතුරු දීමත් අතර වෙනස එයයි.
Coexistence අංකයකදී මෙය වඩා වැදගත්ය, මන්ද smb_message_echoes එම path එකෙන්ම පැමිණේ. සෑම event එකක්ම අලුත් එකක් ලෙස සලකන handler එකක් දැනටමත් මිනිසෙකු පිළිතුරු දී ඇති සංවාදයකට උඩින් නැවත පිළිතුරු දෙනු ඇත.
සාමාන්‍ය වැරදි
- 200 ආපසු ලබාදීමට පෙර processing කිරීම. Meta මන්දගාමී response එකකට නැවත උත්සාහ කරන නිසා message එක දෙවරක් handle වේ.
- deduplication මඟහැරීම. Retries සැලසුමේ කොටසක් මිස edge case එකක් නොවේ.
- payload එකේ media bytes ඇතැයි බලාපොරොත්තු වීම. එහි fetch කිරීමට media id එකක් ඇත.
EasyCoexistence මෙම field එක Meta වෙතින් සෘජුවම ඔබේ endpoint එකට route කරයි. monitoring සඳහා අවශ්‍ය operational events පමණක් තබන නිසා conversation content අපගේ storage වෙත යාමට කිසිදු path එකක් නැත.
නිතර අසන ප්‍රශ්න
EasyCoexistence මගේ පාරිභෝගිකයන්ගේ messages දකිනවාද?
නැත. override මඟින් මෙම field එක ඔබේ endpoint එකට යවයි. අපගේ fallback callback වෙත පැමිණෙන ඕනෑම දෙයක් persist නොකර drop කරයි.
එක් request එකක messages කිහිපයක් පැමිණිය හැකිද?
ඔව්. එක් delivery එකක එකකට වඩා තිබිය හැකි බැවින් handlers පළමුවැන්න පමණක් කියවීම වෙනුවට සියල්ල iterate කළ යුතුය.
media ලබාගන්නේ කෙසේද?
payload එකේ media id එකක් ඇත. අංකයේ access token එක භාවිත කර එය සමඟ URL එක fetch කර පසුව download කරන්න.
smb_message_echoes යනු කුමක්ද?
ඔබේ කණ්ඩායම WhatsApp Business app එකෙන් යවන දේ රැගෙන යන companion field එකයි. එය පවතින්නේ Coexistence අංකවල පමණි.
තවදුරටත් කියවන්න
ආරම්භ කිරීමට සූදානම්ද?
WhatsApp Coexistence මිනිත්තු කිහිපයකින් සකසන්න, මාස ගණනකින් නොව. යෙදුම දුරකථනයේ දිගටම ක්‍රියා කරයි.
නොමිලේ trial කාලය ආරම්භ කරන්නසත්යාපනය කළේ