WooCommerce වෙතින් WhatsApp ඇණවුම් යාවත්කාලීන යවන්න
ඇණවුම් සිදුවීම් සඳහා WooCommerce webhook එකක් සාදා, එය receiver එකකට යොමු කරන්න. receiver එක n8n workflow එකක් හෝ කුඩා PHP route එකක් විය හැක. receiver එක WooCommerce හි signature එක සත්‍යාපනය කරයි, ගනුදෙනුකරු WhatsApp පණිවිඩවලට එකඟ වූ බව පරීක්ෂා කරයි, පසුව සම්බන්ධ කළ අංකයේ phone number id සහ token එක භාවිතයෙන් Cloud API හරහා අනුමත template එකක් යවයි.
අඛණ්ඩ delivery අසාර්ථක වීම් පහකට වඩා සිදු වූ විට WooCommerce විසින් webhook එක අක්‍රිය කරයි.
Header එකේ ඇත්තේ webhook එකේ secret එකෙන් සාදන ලද payload එකේ base64 කේතනය කළ HMAC-SHA256 අගයයි.
ගනුදෙනුකරු සේවා කවුළුවෙන් පිටත, කලින් අනුමත කළ template පණිවිඩ පමණක් යැවිය හැක.
WooCommerce ඇණවුමක් WhatsApp පණිවිඩයක් ක්‍රියාත්මක කරන්නේ කෙසේද?
WooCommerce webhook එකක් සහ receiver එකක් හරහා. WooCommerce හි Settings, Advanced, Webhooks වෙත ගොස්, order created හෝ order updated වැනි ඇණවුම් topic එකක්, delivery URL එකක් සහ secret එකක් සහිත webhook එකක් එක් කරන්න. එවිට එම සිදුවීම සිදු වන සෑම විටම WooCommerce විසින් ඇණවුම JSON ලෙස එම URL එකට යවයි.
Payload එක ස්ථිර ස්වරූපයක් ගන්නා නිසා එය Cloud API වෙත සෘජුවම යොමු කළ නොහැක. අතරමැද receiver එකක් අවශ්‍ය වේ: n8n Webhook node එකක්, වෙළඳසැලේම PHP හි route එකක්, හෝ ඕනෑම කුඩා සේවාවක්. එය ඇණවුම කියවා, ගනුදෙනුකරුගේ දුරකථන අංකය සහ පණිවිඩයට අවශ්‍ය විස්තර තෝරාගෙන, සම්බන්ධ කළ අංකය සඳහා Cloud API හි messages endpoint එකට HTTPS request එකක් යවයි. එහිදී අංකයේ access token එක bearer token එකක් ලෙස භාවිත කරයි.
order.updated topic එක එක් status එකකට සීමා නොවන නිසා, receiver එක ඇණවුමේ status field එක කියවා, අවශ්‍ය සෑම මාරුවකටම එක් වරක් පමණක් යැවිය යුතුය. WooCommerce පෙරනිමියෙන් wp-cron හරහා පසුබිමේ delivery කරන නිසා, පණිවිඩය ඇණවුමට පසුව කෙටි පමාවකින් පැමිණිය හැක.
request එක වෙළඳසැලෙන් පැමිණි බව receiver එක දැනගන්නේ කෙසේද?
WooCommerce හි signature එකෙන්. සෑම delivery එකකම X-WC-Webhook-Signature header එකක් ඇත. එය webhook එකේ ඔබ සැකසූ secret එකෙන් raw payload එක මත ගණනය කළ base64 කේතනය කළ HMAC-SHA256 අගයකි. receiver එක ලැබුණු body එක මත එම hash එකම ගණනය කර සසඳයි, ගැළපෙන්නේ නැති ඕනෑම දෙයක් ප්‍රතික්ෂේප කරයි.
මෙය වෙළඳසැලේම secret එක නිසා, ලැබෙන WhatsApp පණිවිඩ මත Meta ගේ signature එක මෙන් නොව, මෙය වලංගු කළ හැක. constant time එකකින් සසඳන්න, සහ framework එකක් parse කිරීමට පෙර raw body එක hash කරන්න, මන්ද නැවත කේතනය කළ JSON වෙනස් hash එකක් ජනනය කරයි.
2xx ප්‍රතිචාරයක් ඉක්මනින් දෙන්න. 2xx, 301 හෝ 302 නොවන ඕනෑම ප්‍රතිචාරයක් WooCommerce අසාර්ථක ලෙස ගණන් ගන්නා අතර, අඛණ්ඩව පහකට වඩා අසාර්ථක වූ විට webhook එක අක්‍රිය කරයි. deploy එකක් නිසා බිඳ වැටුණු හෝ පිළිතුරු දීමට පෙර Meta එනතුරු බලා සිටීම නිසා මන්දගාමී වූ receiver එකක්, කිසිවෙකු නොදැනම වෙළඳසැලේ පණිවිඩ නවත්වා දැමිය හැක.
වෙළඳසැලට යැවිය හැක්කේ කුමක්ද, කවදාද?
වෙළඳසැල පළමුව ලියන සෑම අවස්ථාවකම අනුමත template එකක්. Meta ගේ පැය 24 ක ගනුදෙනුකරු සේවා කවුළුව විවෘත වන්නේ ගනුදෙනුකරු අංකයට පණිවිඩයක් එවූ විට පමණි. එබැවින් ඇණවුම තහවුරු කිරීමක් හෝ බෙදාහැරීමේ යාවත්කාලීනයක් ව්‍යාපාරය විසින් ආරම්භ කරන ඒවා වන අතර නිදහස් පෙළ ප්‍රතික්ෂේප වේ. සෑම යාවත්කාලීනයක් සඳහාම utility template එකක් සාදා, අනුමතය එනතුරු රැඳී සිට, නම සහ භාෂාව අනුව ඇණවුම් අංකය සහ අනෙක් විස්තර parameters ලෙස යවන්න.
Meta විසින් opt-in ද අවශ්‍ය කරයි: ගනුදෙනුකරු තම අංකය ලබා දී, මෙම ව්‍යාපාරයෙන් WhatsApp හරහා පණිවිඩ ලැබීමට එකඟ වී ඇත. ඇණවුම මත සුරැකි checkout checkbox එකක් එහි සරලම වාර්තාවයි, receiver එක යැවීමට පෙර එය පරීක්ෂා කළ යුතුය.
ගනුදෙනුකරු පිළිතුරු දුන් පසු, සංවාදය සාමාන්‍ය Coexistence වේ. පිළිතුර වෙළඳසැලේ දුරකථනයේ WhatsApp Business යෙදුමේ පෙනේ, කවුළුව නිදහස් පෙළ සඳහා විවෘත වේ, කණ්ඩායම සෑම විටම මෙන් යෙදුමෙන් පිළිතුරු දෙයි.
සාමාන්‍ය වැරදි
- WooCommerce වෙත ප්‍රතිචාර දීමට පෙර Cloud API call එක කිරීම. මන්දගාමී හෝ අසාර්ථක යැවීමක් webhook එකට එරෙහිව ගණන් ගැනේ, අසාර්ථක වීම් පහකට වඩා වූ විට එය අක්‍රිය වේ.
- raw body එක වෙනුවට parse කළ JSON hash කිරීම. signature එක කිසිවිටෙක නොගැළපෙන අතර සෑම සත්‍ය delivery එකක්ම ප්‍රතික්ෂේප වේ.
- සෑම order.updated delivery එකකටම යැවීම. topic එක එක් status එකකට සීමා නොවන නිසා, දැනටමත් පණිවිඩය යැවූ මාරුව සටහන් නොකළහොත් ගනුදෙනුකරුවන්ට අනුපිටපත් ලැබේ.
easycoexistence.com හිදී වෙළඳසැලේ අංකය සම්බන්ධ කර, එහි phone number id සහ token එක dashboard එකෙන් receiver එකට ලබා දෙන්න. සම්බන්ධ කළ සෑම අංකයකටම මසකට US$ 9 සිට, අංක එකතු කරන විට US$ 1 දක්වා අඩු වේ, පළමු දින 3 නොමිලේ trial කාලය සමඟ.
නිතර අසන ප්‍රශ්න
මේ සඳහා WordPress plugin එකක් අවශ්යද?
නැත. WooCommerce හි ගොඩනඟා ඇති webhook සහ receiver එකක් ප්රමාණවත් වන අතර, receiver එක එම PHP යෙදුමේම route එකක් විය හැක.
ඇණවුම් පණිවිඩ සඳහා ගෙවන්නේ කවුද?
Meta විසින් පණිවිඩ ගාස්තුව ව්යාපාරයේම WhatsApp Business Account එකට සෘජුවම බිල් කරයි, EasyCoexistence කිසිවිටෙක එයට අමතර ගාස්තුවක් එකතු නොකරයි.
කණ්ඩායමට තවමත් දුරකථනය භාවිතා කළ හැකිද?
ඔව්. Coexistence මගින් වෙළඳසැලේ අංකයේ WhatsApp Business යෙදුම දිගටම ක්‍රියා කරයි, වෙළඳසැල යැවූ template එක සංවාදයේ පෙනේ.
webhook එකක් අක්‍රිය වී ඇත්නම් කුමක් කළ යුතුද?
receiver එක නිවැරදි කර, WooCommerce හි webhook එකේ status එක නැවත active ලෙස සකසන්න. එය අක්‍රිය කාලය තුළ සෑදූ ඇණවුම් සඳහා පණිවිඩයක් ක්‍රියාත්මක නොවීය.
තවදුරටත් කියවන්න
ආරම්භ කිරීමට සූදානම්ද?
WhatsApp Coexistence මිනිත්තු කිහිපයකින් සකසන්න, මාස ගණනකින් නොව. යෙදුම දුරකථනයේ දිගටම ක්‍රියා කරයි.
නොමිලේ trial කාලය ආරම්භ කරන්නසත්යාපනය කළේ