IngiaAnza kipindi cha majaribio bila malipo
Meta Tech Provider

Otomatiki ya hali ya oda kwenye WhatsApp

Otomatiki ya hali ya oda kwenye WhatsApp hujibu swali la "oda yangu iko wapi?" kwa data ya moja kwa moja kutoka mfumo wa duka lenyewe. Hatua ya neno hunasa swali, webhook hutuma ujumbe na nambari ya simu ya mteja kwa backend ya duka, na backend hurudisha hali kama jibu. Masasisho ya usafirishaji ambayo duka hutuma kwanza hutoka kama violezo vya huduma (utility) vilivyoidhinishwa.

easyCoexistence huunganisha nambari ya WhatsApp Business ambayo duka lako tayari linatumia kwenye programu kwenda Cloud API ya Meta kupitia Coexistence.

20 seconds

Muda ambao backend ya duka ina kujibu kabla hatua ya webhook kushindwa, na utatumiwa barua pepe.

contact.wa_id

Nambari ya WhatsApp ya mteja katika tarakimu za kimataifa, inayotumwa pamoja na ujumbe ili backend itafute oda kwa nambari ya simu.

4,096 characters

Jibu refu zaidi linalotumwa kama maandishi moja ya WhatsApp; chochote kirefu zaidi hukatwa.

Utility

Kategoria ya Meta ya uthibitisho wa oda na taarifa za usafirishaji: si ya matangazo na mahususi kwa oda ya mteja.

Mixed content

Meta huchukulia kiolezo kinachounganisha sasisho la oda na promosheni kama tangazo.

20 msg/s

Kasi ya juu ya Meta kwa nambari ya Coexistence, kikomo cha kundi kubwa la masasisho ya usafirishaji.

Jibu la otomatiki la hali ya oda linafanyaje kazi?

Hali iko kwenye mfumo wa duka lako, kwa hiyo kazi ya otomatiki ni kupeleka swali huko na kurudisha jibu. Otomatiki ya neno hunasa maswali ya oda, hatua yake ya Call my webhook huyatuma kwa backend yako, na jibu la backend hutoka kutoka nambari yako ya WhatsApp Business. easyCoexistence haishiki data ya oda: kumbukumbu za utekelezaji huhifadhi ujumbe na jibu kwa siku 30, na duka lako ndilo chanzo kikuu cha ukweli. Utafutaji huo huo unaweza pia kuwa hatua ya Call an API, inayoita API ya duka lako moja kwa moja na kuhifadhi jibu lake la JSON kwa hatua zinazofuata.

1Customer asks"Where is my order #1042?" to your number
2Has keywordorder, pedido, tracking or # starts the automation
3Call my webhookSigned POST with the message and the customer's number
4Your store backendFinds the order and returns {"reply": "..."}
5Reply sentWithin 20 seconds, and visible in the app's chat

Ni ujumbe gani unapaswa kuanzisha utafutaji?

Maswali ya oda ni rahisi kuyatambua kwa maneno yake, kwa hiyo otomatiki ya neno inafaa. Anza kutoka Send to my system na ubadilishe kichocheo chake kuwa Has keyword kwa Contains, au anza kutoka Keyword reply na ubadilishe hatua yake kuwa Call my webhook. Ongeza maneno ya kila lugha unayouza nayo, hadi 30. Maswali mengine hupita kwenda kwenye otomatiki zako nyingine, kama wakala kwenye Every message, kwa sababu otomatiki za maneno hukaguliwa kwanza na ujumbe mmoja hujibiwa na otomatiki moja tu.

  • Kiingereza: order, tracking, delivery, shipped, where is my.
  • Kireno: pedido, rastreio, rastreamento, entrega, encomenda.
  • Kihispania: envío, envio, seguimiento, paquete (pedido na entrega tayari zimeorodheshwa).
  • Alama: # hunasa nambari za oda zilizoandikwa kama #1042.

Backend ya duka hupokea nini, na lazima irudishe nini?

POST ya JSON iliyotiwa saini kwenye X-EC-Signature kwa Signing secret ya otomatiki. Sehemu muhimu kwa utafutaji ni contact.wa_id, nambari ya WhatsApp ya mteja katika tarakimu za kimataifa bila ishara ya plus, na message.text, ambapo nambari ya oda inaweza kuonekana. Tafuta oda za hivi karibuni za simu hiyo, au toa nambari kutoka kwenye maandishi, kisha jibu kwa HTTP 200 na JSON yenye sehemu ya reply inayoshikilia maandishi ya kutuma. Iweke rahisi na fupi: hadi herufi 4,096 hutumwa kama ujumbe mmoja, na vichwa vya markdown au viungo huonekana kama alama ghafi.

Request and response of the order lookup
Request (trimmed):
{
  "event": "automation.step",
  "dry_run": false,
  "contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
  "message": { "type": "text", "text": "Hi, where is my order #1042?" },
  "history": [ … up to 10 recent messages, oldest first … ]
}

Response, HTTP 200, within 20 seconds:
{ "reply": "Hi Ana! Order #1042 left our warehouse today and should arrive by Friday. Tracking: https://track.example/1042" }

Backend inapaswa kusema nini ikishindwa kupata oda?

Kitu chenye manufaa katika kila kesi. Ujumbe mmoja hujibiwa na otomatiki moja tu, na hatua iliyowekwa baada ya webhook ingeendeshwa pia baada ya jibu lililofanikiwa, kwa hiyo backend ndiyo inayomiliki pia maandishi ya akiba (kwa hatua ya Call an API badala yake, hatua ya Split into paths inaweza kugawanya njia kulingana na jibu):

  • Oda imepatikana: hali, tarehe inayotarajiwa na kiungo cha ufuatiliaji.
  • Hakuna oda ya simu hii: omba nambari ya oda, au barua pepe iliyotumika wakati wa malipo.
  • Oda kadhaa zilizo wazi: zorodhesha kwa ufupi na uulize ipi.
  • Kifurushi kilichopotea au kilichoharibika: sema mtu atajibu kwenye mazungumzo haya, kisha tuma arifa kwa timu yako.
  • Jaribio, na dry_run true: rudisha jibu la mfano na usibadilishe chochote.
  • Backend imezimwa au ni polepole kuliko sekunde 20: hatua inashindwa, hakuna kinachotumwa, na barua pepe inakujulisha ili ujibu mwenyewe.

Unatumaje masasisho ya usafirishaji kabla mteja hajauliza?

Masasisho ya kawaida ni ujumbe ambao biashara yako huanzisha, kwa hiyo hutoka kama violezo vilivyoidhinishwa, vinavyotumwa na mfumo wa duka lako kupitia Cloud API oda inapobadilisha hali. Viunde kwenye kategoria ya utility, ile ambayo Meta hutumia kwa uthibitisho wa oda na taarifa za usafirishaji; punguzo au pendekezo la bidhaa katika kiolezo hicho hicho hukifanya cha matangazo. AI yako inaweza kuandaa na kuwasilisha violezo kwa create_template, ikitumia {{1}} kwa jina na {{2}} kwa nambari ya oda pamoja na thamani za mfano, na kukagua idhini kwa get_template_status. Kisha duka huita endpoint ya kutuma kutoka get_api_credentials kwenye matukio yake ya oda, au hutuma kwenye URL ya otomatiki yenye kichocheo Your system calls a URL (mfano wa Updates from your system), ambayo hutuma kiolezo pamoja na maelezo ya oda kutoka {{vars.webhook.*}}; kurasa za Shopify na WooCommerce zinaonyesha jinsi ya kuunganisha hilo. Meta hutoza ujumbe wa kiolezo kwa kila ujumbe, kwa kategoria na nchi, kwenye Akaunti yako ya WhatsApp Business.

Nini hutokea mteja anapojibu masasisho ya usafirishaji?

Jibu lake hufungua dirisha jipya la huduma kwa wateja la saa 24, na otomatiki zako zinalishughulikia kama ujumbe mwingine wowote unaoingia: jibu la neno, utafutaji wa oda au msaidizi wa AI. Jambo moja ni la muhimu. Mteja ambaye mazungumzo yake hayana historia ya hivi karibuni huhesabiwa kama anaandika kwa mara ya kwanza, kwa hiyo First message inaweza kumkaribisha mtu anayejibu arifa yako ya usafirishaji tu; andika ukaribisho ili uonekane vizuri hata baada ya sasisho. Kwenye nambari ya Coexistence, kiolezo ulichotuma duka kipo kwenye mazungumzo ya programu, kwa hiyo timu huona muktadha kabla ya kuingilia.

Jinsi ya kuisanidi

  1. Expose an order lookupAdd an HTTPS endpoint, or an n8n workflow, that verifies X-EC-Signature, finds orders by contact.wa_id or the number in message.text and returns {"reply": "..."}.
  2. Create the automation, switched OffStart from Send to my system, change the trigger to Has keyword, add your order words, paste the URL into Webhook URL, set the switch to Off and click Save.
  3. Copy the Signing secretSelect the Call my webhook step of the saved automation and copy Signing secret into your endpoint's configuration.
  4. Test with Run testClick Test and send "where is my order #1042?" in Try it. Your endpoint receives dry_run true and the sample contact 15550000000.
  5. Switch it On, then add shipping templatesSwitch the automation On and save, then create utility templates for confirmed, shipped and delivered orders, sent by your store.

Makosa ya kawaida

  • Kurudisha hali chini ya jina tofauti la sehemu. Ni string ya kiwango cha juu tu iitwayo reply ndiyo inayotumwa; kingine chochote hurekodiwa kama 'hakuna jibu' na mteja hasikii kitu.
  • Kulinganisha contact.wa_id na nambari zilizoandikwa wakati wa malipo kama zilivyo. wa_id ina msimbo wa nchi na haina plus, nafasi wala vistari; linganisha tarakimu pekee.
  • Kuongeza hatua ya Reply with text baada ya webhook kama akiba. Nayo pia huendeshwa baada ya jibu lililofanikiwa, kwa hiyo mteja hupokea ujumbe mbili; rudisha maandishi ya akiba kutoka kwenye backend.
  • Kuweka kuponi kwenye kiolezo cha usafirishaji. Meta huchukulia maudhui mchanganyiko kama matangazo na inaweza kubadilisha kategoria au kukataa; weka ofa kwenye violezo tofauti vya matangazo.
Kufanya hili ukitumia EasyCoexistence

Hatua yake ya Call my webhook hupeleka maswali ya oda kwa backend yako na kurudisha jibu, ikiwa na sahihi, kikomo cha sekunde 20 na barua pepe ya kushindwa, nayo get_api_credentials humpa duka lako kile kinachohitajika kutuma violezo vya usafirishaji. Otomatiki hazigharimu chochote zaidi. Kuanzia US$ 9 hadi US$ 0.75 kwa kila nambari kwa mwezi, kadri unavyoongeza nambari, na siku 3 za kwanza bila malipo.

Maswali yanayoulizwa mara kwa mara

Je, hatua ya AI inaweza kujibu maswali ya oda badala ya neno la kichocheo?

Ndiyo. Wakala wa AI mwenye zana maalum, yaani URL yenye vigezo kama nambari ya oda na vichwa vya hiari, anaweza kutafuta oda mwenyewe, au modeli inaweza kuwa nyuma ya webhook, kwa mfano nodi ya AI Agent ya n8n yenye zana ya utafutaji wa oda inayorudisha maandishi yake kama reply. Hatua ya Reply with AI peke yake husoma maelekezo yake na mazungumzo tu, kwa hiyo haina data ya oda ya moja kwa moja.

Nini kitatokea mteja akituma oda kama picha au ujumbe wa sauti?

Picha hufika kama [image] ikifuatiwa na maelezo yake, kwa hiyo neno la kichocheo hulingana tu kama maelezo yana neno hilo, ingawa wakala wa AI anaweza kuangalia picha hiyo kwa ufunguo wako. Ujumbe wa sauti huandikwa kwa maneno kwa ufunguo wako wa OpenAI au OpenRouter na huhifadhiwa kama [voice message] ikifuatiwa na maneno hayo, ambayo neno la kichocheo linaweza kulinganisha; bila ufunguo kama huo unabaki [voice message]. Muulize AI au jibu lililowekwa aombe nambari ya oda kwa maandishi.

Je, otomatiki inaweza kutuma ankara au lebo ya usafirishaji kama PDF?

Ndiyo, kutoka kwenye backend yako: tuma hati kupitia Cloud API kwa kutumia vitambulisho vya nambari, ndani ya saa 24 tangu ujumbe wa mwisho wa mteja, kisha rudisha jibu fupi linalosema faili liko njiani. Jibu la webhook lenyewe hubeba maandishi pekee. Faili isiyobadilika, kama orodha ya bei, inaweza kutumwa kutoka hatua ya Send a picture or file.

Inaweza kushughulikia maswali mangapi ya oda kwa wakati mmoja?

Uendeshaji ni huru, kwa hiyo wateja kadhaa wanaweza kuuliza kwa wakati mmoja. easyCoexistence hupanga utumaji hadi 10 kwa sekunde kwa kila nambari, chini ya kikomo cha Meta cha 20 kwa sekunde kwa Coexistence, na backend yako inahitaji tu kujibu POST ndani ya sekunde 20.

Endelea kusoma

Uko tayari kuanza?

Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.

Anza kipindi cha majaribio bila malipo

Imethibitishwa kwenye