Tuma ujumbe wa oda za WhatsApp kutoka Shopify

Shopify Flow hutumaje ujumbe wa WhatsApp?

Kwa kitendo cha kutuma ombi la HTTP, ambacho hutuma kwa URL yoyote pamoja na headers na body inayoweza kutumia vigezo vya Liquid kutoka kwenye trigger.

Tengeneza workflow kwenye trigger ya kuundwa kwa oda, kisha ongeza kitendo cha kutuma ombi la HTTP. URL ni endpoint ya jumbe ya Cloud API kwa phone number id ya nambari iliyounganishwa. Ongeza header ya Authorization yenye thamani Bearer ikifuatiwa na access token ya nambari hiyo, iliyohifadhiwa kama Flow secret na kurejelewa kama secret variable. Thamani za secret hazionyeshwi kamwe kwenye kiolesura cha Flow na huondolewa kwenye kumbukumbu za uendeshaji, na hapo ndipo token inapostahili kuwa. Body ni ujumbe wa template, ukiwa na nambari ya simu ya mteja kwenye sehemu ya `to` na maelezo ya oda kama vigezo vya template.

Flow huchukulia jibu la 2XX au 3XX kuwa mafanikio. Meta hujibu ombi halali kwa id ya ujumbe, kwa hiyo uendeshaji uliofaulu humaanisha Meta imekubali ujumbe.

{
  "messaging_product": "whatsapp",
  "to": "<customer phone, digits only>",
  "type": "template",
  "template": {
    "name": "order_confirmation",
    "language": { "code": "en" },
    "components": [{
      "type": "body",
      "parameters": [{ "type": "text", "text": "{{order.name}}" }]
    }]
  }
}

Kwa nini ujumbe wa oda lazima uwe template?

Kwa sababu duka ndilo linaloandika kwanza. Dirisha la huduma kwa wateja la saa 24 la Meta hufunguka tu mteja anapoandikia nambari. Uthibitisho wa oda, taarifa ya usafirishaji au ukumbusho wa checkout iliyoachwa hutumwa kabla ya hapo, kwa hiyo maandishi huru hukataliwa na ni template iliyoidhinishwa mapema pekee inayopita.

Tengeneza template mara moja, katika kategoria ya utility kwa masasisho ya oda na usafirishaji, kisha subiri idhini kabla ya kuwasha workflow. Jina na lugha kwenye body lazima vilingane kikamilifu na template iliyoidhinishwa, na idadi ya vigezo lazima ilingane na placeholders zake.

Kuna pia ridhaa. Meta inataka opt-in kabla ya biashara kumtumia mtu ujumbe kwenye WhatsApp: mtu alitoa nambari yake na kukubali kupokea jumbe kutoka kwa biashara hii. Kisanduku cha kuchagua kwenye checkout kinachosema hivyo ndiyo njia ya kawaida ya kuikusanya, na workflow inapaswa kukikagua kabla ya kutuma.

Je, mpango wa duka usipokuwa na kitendo cha kutuma ombi la HTTP?

Tumia webhook ya msimamizi wa Shopify badala yake. Chini ya Mipangilio, Arifa, Webhooks, mfanyabiashara anaweza kuunda webhook kwa tukio kama kuundwa kwa oda, katika JSON, kwenda kwenye URL. Ielekeze kwa receiver: node ya Webhook ya n8n, au route katika PHP, Python au Node. Receiver husoma oda, hukagua ridhaa, na hufanya wito huo huo wa template kwa Cloud API.

Njia yoyote itakayotuma, majibu ni yale yale. Mteja anapojibu ujumbe wa oda, jibu hufika kwenye programu ya WhatsApp Business kwenye simu ya duka, kwa sababu nambari iko kwenye Coexistence, na dirisha la saa 24 sasa liko wazi kwa maandishi huru. Ikiwa webhook ya nambari imewekwa, jibu hufika pia kwenye mfumo wako. Ujumbe wa oda wenyewe huonekana pia kwenye programu, kwa hiyo anayejibu huona mteja anajibu nini.

Makosa ya kawaida

• Kutuma maandishi huru oda inapoundwa. Mteja hajaandika, kwa hiyo Meta huyakataa; lazima iwe template iliyoidhinishwa.
• Kuacha ushughulikiaji wa hitilafu kwenye `Retry` kwa majibu ya 4XX. Flow inaweza kurudia hadi saa 24 ombi ambalo Meta halitalikubali kamwe.
• Kuweka token kwenye header kama maandishi wazi. Ihifadhi kama Flow secret ili isionekane kwenye kiolesura na kumbukumbu.

Maswali yanayoulizwa mara kwa mara

Endelea kusoma