Tuma masasisho ya maagizo ya WooCommerce kupitia WhatsApp
Unda webhook ya WooCommerce kwa matukio ya agizo, inayoelekeza kwa receiver, kama workflow ya n8n au route ndogo ya PHP. Receiver huthibitisha saini ya WooCommerce, hukagua kama mteja alikubali kupokea jumbe za WhatsApp, kisha hutuma template iliyoidhinishwa kupitia Cloud API kwa kutumia phone number id na token ya nambari iliyounganishwa.
WooCommerce huzima webhook baada ya hitilafu zaidi ya tano mfululizo za utumaji.
Header hubeba HMAC-SHA256 ya payload iliyosimbwa kwa base64, iliyotengenezwa kwa secret ya webhook.
Nje ya dirisha la huduma kwa wateja, ni jumbe za template zilizoidhinishwa awali pekee ndizo zinazoweza kutumwa.
Agizo la WooCommerce huchochea vipi ujumbe wa WhatsApp?
Kupitia webhook ya WooCommerce na receiver. Katika WooCommerce, nenda Mipangilio, Advanced, Webhooks, kisha ongeza webhook yenye topic ya agizo, kama order created au order updated, delivery URL, na secret. Kila tukio linapotokea, WooCommerce hutuma agizo kama JSON kwenye URL hiyo.
Payload ni ya kudumu, kwa hiyo haiwezi kuelekezwa moja kwa moja kwenye Cloud API. Receiver huwekwa katikati: node ya Webhook ya n8n, route ndani ya PHP ya duka lako, au seva yoyote ndogo. Husoma agizo, huchagua nambari ya simu ya mteja na maelezo ambayo ujumbe unahitaji, kisha hufanya ombi moja la HTTPS kwenye endpoint ya messages ya Cloud API kwa nambari iliyounganishwa, ikitumia token ya nambari hiyo kama bearer token.
Topic ya order.updated haihusiani na hali moja, kwa hiyo receiver inapaswa kusoma sehemu ya status ya agizo na kutuma mara moja kwa kila mabadiliko yanayohitajika. Kwa chaguo-msingi, WooCommerce hutuma kwa nyuma kupitia wp-cron, kwa hiyo ujumbe unaweza kuchelewa kidogo baada ya agizo.
Receiver inajuaje kwamba ombi limetoka dukani?
Kutoka kwa saini ya WooCommerce. Kila utumaji hubeba header ya X-WC-Webhook-Signature, ambayo ni HMAC-SHA256 iliyosimbwa kwa base64 ya payload ghafi, iliyokokotolewa kwa secret uliyoweka kwenye webhook. Receiver hukokotoa hash ile ile juu ya body iliyopokea na kulinganisha, kisha hukataa chochote kisicholingana.
Hii ni secret ya duka lako mwenyewe, kwa hiyo tofauti na saini ya Meta kwenye jumbe zinazoingia za WhatsApp, inaweza kuthibitishwa. Linganisha kwa constant time, na fanya hash ya body ghafi kabla framework yoyote haijaichanganua, kwa sababu JSON iliyosimbwa upya hutoa hash tofauti.
Jibu haraka kwa 2xx. WooCommerce huhesabu jibu lolote ambalo si 2xx, 301 au 302 kuwa hitilafu, na baada ya hitilafu zaidi ya tano mfululizo huzima webhook. Receiver iliyozimwa kwa sababu ya deploy, au inayochelewa kwa kusubiri Meta kabla ya kujibu, inaweza kuzima jumbe za duka bila mtu yeyote kugundua.
Duka linaweza kutuma nini, na lini?
Template iliyoidhinishwa, kila mara duka linapoanza mazungumzo. Dirisha la huduma kwa wateja la saa 24 la Meta hufunguka tu mteja anapotuma ujumbe kwa nambari hiyo, kwa hiyo uthibitisho wa agizo au taarifa ya usafirishaji huanzishwa na biashara, na maandishi huru hukataliwa. Unda template ya aina utility kwa kila sasisho, subiri idhini, kisha itume kwa jina na lugha, ukiweka nambari ya agizo na maelezo mengine kama parameters.
Meta pia inahitaji ridhaa: mteja alitoa nambari yake na akakubali kupokea jumbe kutoka kwa biashara hii kwenye WhatsApp. Kisanduku cha kuchagua wakati wa checkout, kinachohifadhiwa kwenye agizo, ndicho rekodi rahisi zaidi, na receiver inapaswa kukikagua kabla ya kutuma.
Mteja akijibu, mazungumzo huwa Coexistence ya kawaida. Jibu linaonekana kwenye programu ya WhatsApp Business kwenye simu ya duka, dirisha linakuwa wazi kwa maandishi huru, na timu hujibu kutoka kwenye programu kama ilivyozoea.
Makosa ya kawaida
- Kufanya ombi la Cloud API kabla ya kujibu WooCommerce. Utumaji wa polepole au ulioshindwa huhesabiwa dhidi ya webhook, ambayo huzimwa baada ya hitilafu zaidi ya tano.
- Kufanya hash ya JSON iliyochanganuliwa badala ya body ghafi. Saini haitalingana kamwe na kila utumaji halali utakataliwa.
- Kutuma kwa kila utumaji wa order.updated. Topic hiyo haihusiani na hali moja, kwa hiyo bila kufuatilia ni mabadiliko gani yalishatumiwa ujumbe, wateja hupata jumbe zilizojirudia.
Unganisha nambari ya duka kwenye easycoexistence.com, kisha mpe receiver phone number id na token yake kutoka dashboard. Kuanzia US$ 9 kwa kila nambari kwa mwezi, hadi US$ 1 kadri unavyoongeza nambari, na siku 3 za kwanza ni kipindi cha majaribio bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, ninahitaji plugin ya WordPress kwa hili?
Hapana. Webhook zilizojengewa ndani za WooCommerce na receiver zinatosha, na receiver inaweza kuwa route ndani ya programu ile ile ya PHP.
Nani hulipia jumbe za maagizo?
Meta hutoza ada ya jumbe moja kwa moja kwa biashara kwenye WhatsApp Business Account yake yenyewe, na EasyCoexistence haiweki nyongeza ya bei kamwe.
Je, timu bado inaweza kutumia simu?
Ndiyo. Coexistence huweka programu ya WhatsApp Business ikifanya kazi kwenye nambari ya duka, na template iliyotumwa na duka huonekana kwenye mazungumzo.
Itakuwaje webhook ikizimwa?
Rekebisha receiver, kisha rudisha status ya webhook kuwa active ndani ya WooCommerce. Maagizo yaliyoundwa wakati ilipokuwa imezimwa hayakuchochea ujumbe.
Endelea kusoma
Uko tayari kuanza?
Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.
Anza kipindi cha majaribio bila malipoImethibitishwa kwenye