Marejeo ya otomatiki za WhatsApp: vichochezi, hatua, vigezo na mipaka
Otomatiki za easyCoexistence kwenye nambari ya WhatsApp huanza kutokana na ujumbe unaofika, mwasiliani anayepata lebo, au simu kutoka kwa mfumo wako. Ujumbe una chaguo nne: Kila ujumbe, Ina neno muhimu, Ujumbe wa kwanza na Nje ya saa za kazi. Kisha kuna hatua, hadi 30 kwa mstari na 60 kwa jumla, zenye matawi, maswali na mawakala wa AI. Ujumbe mmoja hupata otomatiki moja kwa kiwango cha juu, na kanuni za neno muhimu huangaliwa kwanza.
Hatua katika mstari mmoja, 60 kwa jumla, matawi yaliyoingiliana hadi kina cha 4; Simamisha na Rudi kwenye hatua zinaweza kumaliza mstari tu.
Kwa kila otomatiki, hadi herufi 100 kwa kila neno; neno moja linatosha, na herufi kubwa hazijalishi.
Herufi zinazoruhusiwa katika Maelekezo ya hatua ya Jibu kwa AI, ambayo majibu yake yamewekewa kikomo cha tokeni 50 hadi 2,000.
Muda mrefu zaidi wa hatua moja ya Subiri ni saa 23, hivyo hatua ya maandishi inayofuata bado iko ndani ya dirisha la saa 24 la Meta.
Muda ambao webhook yako inapaswa kujibu kabla ya Ita webhook yangu kushindwa; sehemu ya reply katika jibu hutumwa kwa mteja.
Muda wa kuhifadhi utekelezaji, pamoja na kila ujumbe ulioanzisha na jibu; maandishi ya ujumbe hufutwa baada ya muda wa uhifadhi unaochagua (siku 30, 90 au 365, chaguo-msingi 90).
Ni vichochezi na mechi zipi otomatiki ya WhatsApp inaweza kutumia?
Kichochezi kikuu, “Ujumbe unafika” (message_received), huwashwa mteja anapoandika kwa nambari: maandishi, picha, video, hati, sauti, vibandiko, maeneo, kadi za mawasiliano, majibu ya vitufe na orodha, na oda. Ujumbe wa sauti huandikwa kwa maneno kwa ufunguo wako wa OpenAI au OpenRouter na kuhifadhiwa kama “[ujumbe wa sauti]” ikifuatwa na maneno hayo, ambayo neno muhimu linaweza kuyalinganisha; bila ufunguo kama huo unabaki “[ujumbe wa sauti]”. Miitikio, taarifa za hali na arifa za mfumo haziwashi utekelezaji kamwe, na mazungumzo ya vikundi hayafiki kwenye API kwenye nambari ya Coexistence. Vichochezi viwili zaidi haviwashwi na ujumbe. “Mwasiliani anapata lebo” (tag_added) huwashwa kila mara mwasiliani anayefikika kwenye nambari anapopata lebo uliyoitaja, kutoka kwenye mtiririko, wakala wa AI, wewe kwenye Mazungumzo au update_contact. “Mfumo wako unaita URL” (webhook_received) huwashwa mfumo wako mwenyewe unapotuma POST ya JSON yenye nambari ya simu kwa URL ya otomatiki, na siri ya otomatiki kama Bearer token, kwa oda mpya au miadi; mwili, hadi KB 20, unapatikana kama {{vars.webhook.*}}. Kwenye vyote viwili, {{message}} ni tupu na mtu ambaye hajaandika ndani ya saa 24 zilizopita anaweza kupata send_template tu. Hakuna kichochezi cha ratiba. Kwenye kichochezi cha ujumbe, Nje ya saa za kazi huchukulia siku zilizochaguliwa chini ya “Wazi siku” kuwa wazi kati ya Kuanzia na Hadi, kwenye saa za eneo za IANA kama America/Sao_Paulo. Hadi ikiwa ni mapema kuliko Kuanzia ni zamu ya usiku (22:00 hadi 06:00), na siku isiyochaguliwa inahesabiwa kuwa imefungwa siku nzima. Kwenye API, hours huchukua timezone, days (1 = Jumatatu hadi 7 = Jumapili, siku unazokuwa wazi), na start na end. Ujumbe wa kwanza huwashwa easyCoexistence inapoanzisha rekodi ya mazungumzo: ujumbe wa kwanza wa mteja tangu otomatiki iwashwe kwa nambari, ikiwemo wateja wa muda mrefu, au ujumbe wa kwanza baada ya siku 30 za ukimya. Mazungumzo uliyoyafungua kutoka kwenye simu tayari yanahesabiwa kuwa yameonekana.
Hali za neno muhimu zinalinganishwaje?
Chini ya “Neno linapaswa kuwa wapi”, Ina (“Popote kwenye ujumbe”) ndiyo chaguo-msingi, Mwanzoni ndiyo “Mwanzoni”, na Ni sawa kabisa ndiyo “Ujumbe mzima”. Kwenye API, keywordMode ni contains, starts_with au exact. Ulinganishaji hukata nafasi zilizo kando ya ujumbe na haujali herufi kubwa, lakini haupuuzi lafudhi wala alama za uandishi, na Ina pia hulingana ndani ya maneno marefu. Kisanduku cha “Jaribu” chini ya Maneno muhimu hujibu “Inaendeshwa: inalingana” pamoja na neno muhimu, au “Haiendeshwi: hakuna neno muhimu linalolingana” kwa sampuli yoyote unayoandika.
| Matches | Does not match | |
|---|---|---|
| Contains "price" | What is the price? · PRICES please | How much is it? |
| Contains "oi" | Oi! · Boa noite (inside noite) | Olá |
| Starts with "menu" | Menu please | Can I see the menu? |
| Is exactly "menu" | Menu · menu with spaces around it | menu? · the menu |
| Contains "preço" | Qual o preço? | Qual o preco? |
Kila hatua inafanya nini, na inachukua sehemu zipi?
Hatua zinaendeshwa kutoka juu hadi chini, hadi 30 kwenye mstari mmoja na 60 kwenye otomatiki, matawi yakijumuishwa, na angalau moja lazima ifanye kitu kingine isipokuwa Subiri, Simamisha, Gawanya kwenye njia, AI huchagua njia na Rudi kwenye hatua. Hatua ya matawi ina mstari wa hatua kwa kila njia pamoja na mstari wa Vinginevyo, na matawi yanaweza kuwekwa ndani ya mengine hadi ngazi 4. Kwenye menyu ya “Chagua hatua” kila moja huonyesha jina na mstari mfupi, zote mbili zimenukuliwa hapa chini kwa hatua sita za msingi. Uliza swali (ask) hutuma Ujumbe wake pamoja na hadi vitufe 10, ambavyo 3 huonekana kama vitufe vya kubonyeza na vingine huorodheshwa na kujibiwa kwa nambari, husubiri hadi dakika 1,380 kwa jibu na kulihifadhi kwenye sehemu ya mwasiliani kama maandishi, barua pepe, nambari, simu au mojawapo ya vitufe; jibu lisilo sahihi hupata swali tena hadi mara 3. Majibu ya wakala (agent) hukabidhi ujumbe kwa mmoja wa mawakala wako wa AI, Tuma picha au faili (send_file) hutuma picha au PDF kutoka kwenye faili zako, na Mkabidhi mtu (handoff) husimamisha roboti kwenye mazungumzo hayo kwa saa 1 hadi 168, 24 kwa chaguo-msingi, na kukutumia barua pepe. Gawanya kwenye njia (condition) na AI huchagua njia (ai_decide) hugawanya kwa kanuni au kwa maana. AI huhifadhi maelezo (ai_extract), Hifadhi kwa mwasiliani (set_field) na Weka lebo (tag) huandika sehemu za mwasiliani na lebo, na Ita API (http_request) huita API yoyote ya HTTPS na kuweka jibu lake la JSON kama {{vars.<name>...}}. Anzisha otomatiki (start_automation) huendesha otomatiki nyingine kwa mtu yule yule, ngazi 3 kwa kina zaidi, Rudi kwenye hatua (goto) huruka hadi id ya hatua ili kurudia, na Niarifu (notify_owner) hukutumia barua pepe, si zaidi ya 20 kwa saa kwa kila otomatiki. Hatua ikishindwa, hatua zilizo baada yake zinaruka na utekelezaji unaishia Umeshindwa. Ita webhook yangu hutuma POST ya JSON yenye event “automation.step”, dry_run, run_id, nambari, mwasiliani (wa_id, name), ujumbe (id, type, text, at) na hadi ujumbe 10 wa hivi karibuni wa mazungumzo. Imetiwa saini kwenye X-EC-Signature kama t=<unix>,v1=<HMAC-SHA256 ya “<t>.<body>”>, kwa “Siri ya kutia sahihi” ya hatua. URL yake lazima iwe HTTPS ya umma, na uelekezaji upya hauendelezwi.
Ni vigezo vipi hatua zinaweza kujaza?
Vinne vinajazwa kutoka ujumbe uliowasha utekelezaji, vimeandikwa kwenye mabano mara mbili; {{contact.<field>}} huongeza sehemu ya mwasiliani (pia contact.name na contact.phone) na {{vars.<path>}} kile ambacho hatua za awali zilihifadhi, kama jibu la hatua ya Ita API. Vinafanya kazi kwenye Ujumbe wa Jibu kwa maandishi, kwenye vigezo vya mwili wa kiolezo, kwenye Maelekezo ya Jibu kwa AI na kwenye maandishi ya hatua nyingine kama Uliza swali. Kwenye vigezo vya kiolezo, chipsi za “Ingiza:” huviongeza. Thamani isiyojulikana, kama wasifu usio na jina, hubaki tupu. Utumaji wa kiolezo hubeba vigezo vya mwili pekee, kwa nafasi. Kwa hiyo kiolezo chenye vigezo vilivyopewa majina, picha ya kichwa au kigezo cha kichwa, au kitufe chenye kigezo haviwezi kuchaguliwa bado, na kigezo kilichoachwa tupu hufanya Meta ikatae utumaji.
- {{
first_name}}: neno la kwanza la jina la wasifu wa WhatsApp wa mteja (“Jina la kwanza”). - {{name}}: jina kamili la wasifu (“Jina kamili”).
- {{message}}: maandishi ya ujumbe, au kiashiria chake kama “[image]” pamoja na maelezo ya picha (“Ujumbe wao”).
- {{phone}}: nambari ya mteja kama tarakimu za kimataifa bila alama ya plus, kama 5511999998888 (“Simu yao”).
- Katika jaribio, jina la mteja ni “Mteja wa majaribio” na simu ni 15550000000.
Mipangilio ni ipi na chaguo-msingi zake ni zipi?
Mipangilio miwili iko chini ya “Mipangilio ya kina”, kitufe kilicho karibu na swichi ya Washa kwenye kihariri, na hatua ya AI ina mingine miwili yake. Sehemu iliyoachwa hupata chaguo-msingi lake, kwenye kihariri na kupitia create_automation vilevile. Muda wa kusubiri umewekwa kudumu, haubadilishwi: jibu la AI lina sekunde 45 na webhook sekunde 20. Jina la otomatiki linaweza kuwa na herufi hadi 120. Wakala wa AI ana mipangilio yake mwenyewe: ujumbe wa awali anaousoma, 0 hadi 40 (chaguo-msingi 20), jibu refu zaidi tokens 100 hadi 4,000 (chaguo-msingi 800), hadi miito 10 ya zana kwa kila jibu (chaguo-msingi 5) na saa za kukabidhi, 1 hadi 168 (chaguo-msingi 24).
Ni otomatiki ipi hujibu wakati kadhaa zinalingana?
Moja tu, kwa mpangilio uliowekwa: Ina neno muhimu kwanza, kisha Ujumbe wa kwanza, kisha Nje ya saa za kazi, kisha Kila ujumbe. Ndani ya aina moja, otomatiki ya zamani kabisa huangaliwa kwanza. Otomatiki zilizo Washa na zisizosimamishwa tu ndizo zinazoshindana. Kwa hiyo kanuni ya neno muhimu ikiwa Zima, au ikisimamishwa na ufunguo wa AI uliokataliwa, ile inayokamata yote (Kila ujumbe) ndiyo hujibu badala yake. Matokeo mawili yanawashangaza watu. Mteja mpya anayeandika usiku hupata otomatiki ya Ujumbe wa kwanza, si ya Nje ya saa za kazi, kwa sababu Ujumbe wa kwanza una kipaumbele zaidi. Pia, ujumbe ambao otomatiki ya neno muhimu inaujibu haufiki kwa wakala wa AI wala hatua ya Jibu kwa AI kwenye Kila ujumbe, kwa hiyo weka wakala au hatua ya AI ndani ya otomatiki ya neno muhimu unapotaka zote mbili. Ujumbe unaojibu hatua ya Uliza swali iliyo wazi ni wa swali hilo, na hakuna otomatiki nyingine inayoanza kwa ujumbe huo. Otomatiki za lebo na webhook huanza kutoka matukio yao yenyewe na hazishiriki kwenye mpangilio huu.
Ni vilinzi vipi vimejengwa ndani?
Kiendeshi kinatumia vilinzi hivi bila mpangilio wowote, na sababu za kuruka zinazoonyeshwa kwenye kichupo cha Utekelezaji zinavitaja vinaposimamisha utekelezaji:
- Ujumbe ambao Meta inautuma mara mbili huanzisha utekelezaji mmoja: nakala huondolewa kwa kitambulisho cha ujumbe.
- Miitikio, taarifa za hali, utumaji wa otomatiki yenyewe na ujumbe wako unaorudi kutoka kwenye programu hazianzishi utekelezaji kamwe.
- Jibu kwa maandishi, Uliza swali, Tuma picha au faili, Jibu kwa AI, jibu la wakala na jibu la webhook yanahitaji ujumbe wa mwisho wa mteja uwe chini ya saa 24; Tuma kiolezo halihitaji hilo.
- Jibu unalolitunga kwenye programu ya WhatsApp Business husitisha otomatiki kwenye mazungumzo hayo, na utekelezaji unaosubiri hapo huruka hatua zake zilizobaki.
- Ujumbe mpya zaidi unaoanzisha otomatiki hiyo hiyo kwenye mazungumzo hubadilisha utekelezaji unaosubiri kwenye hatua ya Subiri; ujumbe unaojibu swali lililo wazi huenda kwa swali hilo badala yake.
- Utumaji kutoka nambari hutengwa angalau milisekunde 100, chini ya kikomo cha Meta cha 20 kwa sekunde kwa nambari za Coexistence.
- Hatua inaposhindwa hukutumia barua pepe, mara moja tu kwa kila otomatiki kila saa 6. Ufunguo wa AI uliokataliwa husimamisha otomatiki zinazotumia mtoa huduma huyo na kutuma barua pepe moja.
Zana ya create_automation inachukua nini?
Kiunganishi cha MCP kina zana kumi na tisa za otomatiki na vitu zinavyotumia. Nane ni za otomatiki: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs na get_automation_run. Nane ni za mawakala na faili: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge na test_agent. Tatu ni za watu: list_conversations, get_conversation na update_contact. create_automation huchukua connection_id (kutoka list_numbers), name, enabled, trigger, steps na settings, kwa snake_case kama keyword_mode na max_tokens; camelCase pia inakubaliwa. Vitu vya hatua ni reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} na wait {minutes}, kisha ask {text, buttons, save_to, expect, retry_text, wait_minutes}, agent {agent_id, wait_seconds}, send_file {file_id, caption}, condition {paths, otherwise}, ai_decide {provider, model, instructions, paths, otherwise}, ai_extract {provider, model, fields}, set_field {key, value}, tag {action, tag}, http_request {method, url, headers, body, save_as}, start_automation {automation_id}, handoff {hours, note}, notify_owner {text}, goto {to} na stop. update_automation huhifadhi sehemu ulizoziacha, na steps, zikipewa, hubadilisha orodha nzima. Hitilafu hutaja sehemu, kwa mfano "trigger.keywords: Add at least one keyword", "steps.2: Stop must be the last step of its line" au "steps.0: save your openai API key on the Automations page first". Funguo za AI hazipitishwi kupitia MCP kamwe. Katika mfano, Subiri ya dakika 1 humruhusu mteja anayetuma mistari kadhaa kwa mara moja kupata jibu moja.
{
"connection_id": "<connection_id from list_numbers>",
"name": "After-hours assistant",
"enabled": false,
"trigger": {
"type": "message_received",
"match": "outside_hours",
"hours": {
"timezone": "America/Sao_Paulo",
"days": [1, 2, 3, 4, 5, 6],
"start": "08:00",
"end": "18:00"
}
},
"steps": [
{ "type": "wait", "minutes": 1 },
{
"type": "ai_reply",
"provider": "openrouter",
"model": "google/gemini-omni-1.2-flash",
"prompt": "You are the assistant of Ana's Bakery. We are closed and open at 8:00. Answer questions about products; a person confirms orders in the morning.",
"history": 10,
"max_tokens": 600
}
],
"settings": { "takeover_hours": 4, "ai_max_per_hour": 10 }
}Makosa ya kawaida
- Kutumia neno muhimu la herufi mbili kwa Ina. “oi” pia hulingana na “noite” na “boi”, kwa hiyo otomatiki hujibu jumbe ambazo haikukusudiwa kuzijibu. Tumia Ni sawa kabisa, au neno refu zaidi.
- Kuorodhesha tahajia yenye lafudhi pekee. Ulinganishaji haujali herufi kubwa lakini unapuuza lafudhi, kwa hiyo “preço” hukosa wateja wanaoandika “preco”. Ongeza zote mbili.
- Kutarajia Ujumbe wa kwanza kuruka wateja wa kawaida. Huwashwa kwa mteja yeyote ambaye mazungumzo yake easyCoexistence haijayaona kwa siku 30, kwa hiyo wateja wa muda mrefu hupokea ujumbe wa karibu kwenye ujumbe wao wa kwanza baada ya kuiwasha.
- Kuchagua kiolezo kinachohitaji picha ya kichwa au kitufe cha kunakili msimbo. Otomatiki hujaza vigezo vya mwili pekee, kwa hiyo kihariri kinakiorodhesha lakini hakikuruhusu kukichagua. Ukikiweka kupitia MCP, utumaji unakataliwa na Meta na utekelezaji unashindwa.
easyCoexistence huendesha otomatiki hizi kwenye nambari ya WhatsApp Business unayoendelea kutumia kwenye programu, kupitia Cloud API ya Meta na Coexistence. Zijenge kwenye kihariri chini ya Otomatiki, Otomatiki mpya, au ruhusu ChatGPT au Claude waite create_automation na test_automation kupitia kiunganishi cha MCP, chenye zana zaidi ya 30. Kuanzia US$ 9 kwa kila nambari kwa mwezi hadi US$ 0.75, inashuka kadri unavyoongeza nambari, na siku 3 za kwanza bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, otomatiki inaweza kugawanyika kulingana na kile mteja anachosema?
Ndiyo. Gawanya kwenye njia (condition) hugawanya kulingana na maandishi ya ujumbe, sehemu ya mwasiliani, lebo, jibu la awali la API au saa zako za kazi, na AI huchagua njia (ai_decide) huchagua kwa maana, kwa lugha yoyote, kwenye modeli yako mwenyewe. Kila njia ina mstari wake wa hatua, na mstari wa Vinginevyo hukamata zilizobaki. Unaweza pia kukabidhi uamuzi kwa n8n au backend yako kupitia Ita webhook yangu. Webhook hiyo inaweza kurudisha {"reply": "..."} tofauti kwa kila kisa.
Je, kuna kikomo cha otomatiki au utekelezaji?
Hakuna kikomo kwa utekelezaji wala ada ya ziada kwao, na hakuna kikomo kwa idadi ya otomatiki ambazo nambari moja inaweza kuwa nazo. Vikomo vinavyotumika ni kwa kila mazungumzo: majibu ya AI kwa saa, kanuni ya saa 24 ya Meta kwa maandishi, na kusitishwa kwa muda baada ya wewe kujibu kutoka kwenye simu.
Je, naweza kuhamisha au kunakili otomatiki kwenda nambari nyingine?
Ihamishe kwa kubadilisha Muunganisho wake kwenye kihariri, au kwa update_automation na connection_id mpya. Utekelezaji unaosubiri kwenye nambari ya zamani huishia kama umebadilishwa. Ili kunakili, mwambie AI yako aisome kwa list_automations na aunde kichochezi na hatua zile zile kwenye nambari nyingine.
Je, nini kinatokea kwa utekelezaji unaosubiri ninapohariri otomatiki?
Zinaendelea. Utekelezaji uliokaa kwenye Subiri huendelea kwenye hatua inayofuata ya otomatiki kama ilivyohifadhiwa wakati utekelezaji unaamka, kwa hiyo mabadiliko yanaweza kubadilisha kinachotumwa. Ili kuyasimamisha, zima otomatiki: kisha yanaishia Imeruka na “Automation is off”.
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