Mag-log inMagsimula ng Libreng Trial
Meta Tech Provider

Sanggunian sa WhatsApp automation: mga trigger, step, variable at limit

Ang automations ng easyCoexistence sa isang WhatsApp number ay nagsisimula sa mensaheng dumarating, sa contact na nakakakuha ng tag, o sa tawag mula sa sistema ninyo. May apat na match ang mensahe: Every message, Has keyword, First message at After hours. Sumusunod ang mga step, hanggang 30 sa isang linya at 60 sa kabuuan, na may mga branch, tanong at AI agent. Hanggang isang automation lang ang tumutugon sa bawat mensahe, at nauuna ang keyword rules.

30 steps

Mga step sa isang linya, 60 sa kabuuan, mga branch na nakapugad nang 4 na antas; ang Stop at Go back to a step ay maaari lamang magtapos ng isang linya.

30 keywords

Bawat automation, hanggang 100 characters ang bawat isa; sapat na ang kahit isa, at hindi mahalaga ang malalaking letra.

20,000

Mga characters na pinapayagan sa Instructions ng Reply with AI step, na ang mga sagot ay limitado sa 50 hanggang 2,000 tokens.

1,380 min

Pinakamahabang Wait step ay 23 oras, kaya nananatili pa rin sa loob ng 24-hour window ng Meta ang susunod na text step.

20 seconds

Oras na dapat sumagot ang iyong webhook bago pumalya ang Call my webhook; ang reply field sa sagot ay ipinapadala sa customer.

30 days

Retention ng mga run, kasama ang bawat mensaheng nagsimula at ang reply; nabubura ang text ng mensahe pagkatapos ng retention na pipiliin ninyo (30, 90 o 365 araw, 90 bilang default).

Anong mga trigger at match ang magagamit ng WhatsApp automation?

Ang pangunahing trigger, ang "A message arrives" (message_received), ay tumatakbo kapag may sumulat sa numero: text, larawan, video, dokumento, audio, sticker, lokasyon, contact card, button at list reply, at order. Ang voice note ay isinusulat bilang text gamit ang inyong OpenAI o OpenRouter key at itinatago bilang "[voice message]" na sinusundan ng mga salita, na maaaring tumugma sa isang keyword; kung walang ganoong key, nananatili itong "[voice message]". Hindi nagsisimula ng run ang reactions, status, at system notice, at hindi umaabot sa API ang group chat sa isang Coexistence number. Dalawa pang trigger ang hindi nagsisimula sa mensahe. Ang "A contact gets a tag" (tag_added) ay tumatakbo tuwing may contact na maaabot sa numero na nakakuha ng tag na pinangalanan ninyo, mula sa isang flow, isang AI agent, kayo sa Conversations o update_contact. Ang "Your system calls a URL" (webhook_received) ay tumatakbo kapag nag-POST ang sarili ninyong system ng JSON na may phone number sa URL ng automation, gamit ang secret ng automation bilang Bearer token, para sa bagong order o booking; ang body, hanggang 20 KB, ay magagamit bilang {{vars.webhook.*}}. Sa pareho, walang laman ang {{message}} at ang taong hindi sumulat sa nakalipas na 24 na oras ay makakakuha lang ng send_template. Walang schedule trigger. Sa message trigger, sa After hours, bukas ang mga araw na naka-tick sa ilalim ng "Open on" sa pagitan ng From at To, sa IANA timezone tulad ng America/Sao_Paulo; kapag mas maaga ang To kaysa From, ito ay overnight shift (22:00 hanggang 06:00), at ang araw na hindi naka-tick ay sarado buong araw. Sa API, tumatanggap ang hours ng timezone, days (1 = Lunes hanggang 7 = Linggo, ang mga araw na bukas ang negosyo), at start at end. Nagsisimula ang First message kapag gumawa ang easyCoexistence ng record para sa chat: ang unang mensahe ng customer mula nang ma-switch on ang automation sa numero, kasama ang matagal nang customer, o ang unang mensahe pagkatapos ng 30 araw na tahimik. Ang chat na binuksan sa telepono ay itinuturing nang nakita na.

Every message (any)Runs on whatever the customer writes, when no more specific automation matched.
Has keyword (keyword)Runs when the message holds one of up to 30 keywords, in one of three modes.
First message (first_message)Runs on a chat easyCoexistence has not seen, or after 30 days without a message from that customer.
After hours (outside_hours)Runs while you are closed: Timezone, Open on days, and From and To in 24-hour HH:MM.

Paano gumagana ang mga keyword mode sa pagtutugma?

Sa ilalim ng "Where the word has to be", ang Contains ("Anywhere in the message") ang default, ang Starts with ay "At the start", at ang Is exactly ay "The whole message"; sa API, ang keywordMode ay contains, starts_with o exact. Tinatanggal ng pagtutugma ang espasyo sa paligid ng mensahe at hindi pinapansin ang malalaking letra, pero hindi nito pinapansin ang accents o punctuation, at tumutugma rin ang Contains sa loob ng mas mahabang salita. Ang "Test it" box sa ilalim ng Keywords ay sumasagot ng "Runs: it matches" kasama ang keyword, o "Does not run: no keyword matches", para sa anumang sample na ilagay sa kahon.

MatchesDoes not match
Contains "price"What is the price? · PRICES pleaseHow much is it?
Contains "oi"Oi! · Boa noite (inside noite)Olá
Starts with "menu"Menu pleaseCan I see the menu?
Is exactly "menu"Menu · menu with spaces around itmenu? · the menu
Contains "preço"Qual o preço?Qual o preco?

Ano ang ginagawa ng bawat step, at anong field ang kailangan nito?

Tumatakbo ang mga step mula taas pababa, hanggang 30 sa isang linya at 60 sa isang automation, kasama ang mga branch, at kahit isa ay dapat gumawa ng iba bukod sa Wait, Stop, Split into paths, AI picks the path at Go back to a step. Ang step na may branch ay may isang linya ng mga step para sa bawat path at isang Otherwise na linya, at hanggang 4 na antas ang lalim ng mga nested branch. Sa "Choose a step" menu, may pangalan at maikling linya ang bawat isa, parehong nakasipi sa ibaba para sa anim na basic na step. Ang Ask a question (ask) ay nagpapadala ng Message nito na may hanggang 10 button, kung saan 3 ang lumalabas bilang tappable na button at ang iba ay nakalista at sinasagot sa pamamagitan ng numero, naghihintay ng hanggang 1,380 minuto para sa sagot at sine-save ito sa isang contact field bilang text, email, number, phone o isa sa mga button; ang maling sagot ay babalikan ng tanong hanggang 3 beses. Ang Agent answers (agent) ay ipinapasa ang mensahe sa isa sa inyong AI agents, ang Send a picture or file (send_file) ay nagpapadala ng larawan o PDF mula sa inyong mga file, at ang Hand to a person (handoff) ay ipinapahinto ang bot sa chat na iyon sa loob ng 1 hanggang 168 oras, 24 bilang default, at nag-e-email sa inyo. Ang Split into paths (condition) at AI picks the path (ai_decide) ay nagbabranch ayon sa mga tuntunin o ayon sa kahulugan. Ang AI saves details (ai_extract), Save to contact (set_field) at Tag (tag) ay nagsusulat ng mga contact field at tag, at ang Call an API (http_request) ay tumatawag sa anumang HTTPS API at itinatago ang JSON na sagot nito bilang {{vars.<name>...}}. Ang Start automation (start_automation) ay nagpapatakbo ng ibang automation para sa parehong tao, hanggang 3 antas ang lalim, ang Go back to a step (goto) ay tumatalon sa isang step id para mag-loop, at ang Notify me (notify_owner) ay nag-e-email sa inyo, hanggang 20 bawat oras bawat automation. Kapag pumalya ang isang step, lalaktawan ang mga kasunod nito at magtatapos ang run bilang Failed. Ang Call my webhook ay nagpo-POST ng JSON na may event "automation.step", dry_run, run_id, ang numero, ang contact (wa_id, name), ang mensahe (id, type, text, at) at hanggang 10 kamakailang mensahe ng chat, naka-sign sa X-EC-Signature bilang t=<unix>,v1=<HMAC-SHA256 ng "<t>.<body>"> gamit ang "Signing secret" ng step. Dapat public HTTPS ang URL nito, at hindi sinusundan ang redirects.

Reply with text (reply_text)"Send a fixed message": a Message of up to 4,096 characters, with variables.
Send a template (send_template)"Send an approved template": Template name, Language code, up to 20 body variables by position.
Reply with AI (ai_reply)"Your AI writes the reply": Provider, Model, Instructions, Earlier messages it reads, Longest reply (tokens).
Call my webhook (call_webhook)"Hand off to n8n or your backend": a Webhook URL; {"reply": "..."} returned within 20 seconds is sent.
Wait (wait)"Pause before the next step": 1 to 1,380 Minutes; your reply from the phone skips the rest.
Stop (stop)"End the automation": allowed only as the last step of its line.

Anong mga variable ang mapupunan ng mga step?

Apat ang pinupunan mula sa mensaheng nagsimula ng run, nakasulat sa double braces; idinadagdag ng {{contact.<field>}} ang isang contact field (pati contact.name at contact.phone) at ng {{vars.<path>}} ang mga na-save ng naunang mga step, gaya ng sagot ng isang Call an API step. Gumagana ang mga ito sa Message ng Reply with text, sa body variables ng template, sa Instructions ng Reply with AI, at sa text ng iba pang step gaya ng Ask a question; sa variables ng template, idinadagdag ng mga chip na "Insert:" ang mga ito. Ang value na hindi alam, gaya ng profile na walang pangalan, ay nagiging walang laman. Ang template send ay may body variables lang, ayon sa posisyon, kaya hindi pa mapipili ang template na may named variables, header picture o header variable, o button na may variable, at ang variable na walang laman ay tinatanggihan ng Meta sa send.

  • {{first_name}}: ang unang salita ng pangalan sa WhatsApp profile ng customer ("First name").
  • {{name}}: ang buong pangalan sa profile ("Full name").
  • {{message}}: ang teksto ng mensahe, o ang placeholder nito gaya ng "[image]" kasama ang caption ("Their message").
  • {{phone}}: numero ng customer bilang international digits na walang plus, gaya ng 5511999998888 ("Their phone").
  • Sa test, "Test customer" ang customer at 15550000000 ang phone.

Ano ang mga setting at ang kanilang default?

Dalawang setting ang nasa ilalim ng "Advanced", ang button sa tabi ng On switch sa editor, at ang AI step ay may dalawa pang sarili. Ang field na hindi nilagyan ay kukuha ng default nito, sa editor man o sa create_automation. Naka-fix ang timeout at hindi itinatakda: 45 segundo ang AI reply at 20 segundo ang webhook. Hanggang 120 characters ang pangalan ng automation. Ang AI agent ay may sarili nitong mga setting: ang mga naunang mensaheng binabasa nito, 0 hanggang 40 (default 20), ang pinakamahabang sagot na 100 hanggang 4,000 tokens (default 800), hanggang 10 tool call bawat sagot (default 5) at mga oras ng hand-off, 1 hanggang 168 (default 24).

Pause on a chat after I answer it (hours)takeoverHours, 0 to 168, default 4. 0 turns the pause off; a reply still ends a waiting step.
AI replies per chat per hour, at mostaiMaxPerHour, 1 to 60, default 10, counted per chat in a one-hour window.
Earlier messages it readshistory, 0 to 20, default 10, from the messages kept for that chat.
Longest reply (tokens)maxTokens, 50 to 2,000, default 600. An answer that reaches it stops there.
The On and Off switchenabled, default true: a new automation saves On, in the editor and through create_automation.
Try itSamples of up to 2,000 characters, 60 tests per hour in the dashboard.

Aling automation ang sumasagot kapag marami ang tumutugma?

Isa lang ang pinipili, ayon sa nakapirming pagkakasunod: Has keyword muna, saka First message, saka After hours, saka Every message, at ang pinakamatandang automation muna sa loob ng parehong uri. Tanging mga automation na On at hindi naka-pause ang nagkakompetensya, kaya kapag Off ang keyword rule, o naka-pause dahil sa tinanggihang AI key, ang catch-all ang sumasagot. Dalawang bagay ang nakakagulat sa mga tao. Ang bagong customer na sumulat sa gabi ay makakakuha ng First message automation, hindi After hours, dahil mas mataas ang ranggo ng First message. At ang mensaheng sinasagot ng keyword automation ay hindi na umaabot sa isang AI agent o sa Reply with AI step sa Every message, kaya ilagay ang agent o ang AI step sa loob ng keyword automation kapag gusto ang pareho. Ang mensaheng sumasagot sa isang bukas na Ask a question step ay pag-aari ng tanong na iyon, at walang ibang automation na magsisimula rito. Ang mga automation na tag at webhook ay nagsisimula sa sarili nilang mga event at hindi kasali sa pagkakasunod na ito.

Anong guard ang nakabuilt-in?

Ipinapatupad ng runner ang mga ito nang walang anumang setting, at ang mga dahilan ng paglaktaw sa Runs tab ay pinangalanan ang mga ito kapag hinihinto nila ang run:

  • Ang mensaheng dalawang beses ipinadala ng Meta ay nagsisimula ng isang run lang: tinatanggal ang mga duplicate ayon sa message id.
  • Hindi nagsisimula ng run ang reactions, status, ang sarili nitong ipinadala ng automation, at ang echo mula sa app.
  • Ang Reply with text, Ask a question, Send a picture or file, Reply with AI, sagot ng isang agent, at reply ng webhook ay nangangailangan na wala pang 24 na oras ang huling mensahe ng customer; hindi ito kailangan ng Send a template.
  • Ang reply na itina-type sa WhatsApp Business app ay nag-pause ng automation sa chat na iyon, at ang run na naghihintay doon ay lalaktawan ang natitirang step.
  • Ang mas bagong mensaheng nagsisimula ng parehong automation sa isang chat ay pumapalit sa run na naghihintay pa sa isang Wait step; ang mensaheng sumasagot sa isang bukas na tanong ay napupunta na lang sa tanong na iyon.
  • Ang pagpapadala mula sa isang numero ay may agwat na hindi bababa sa 100 ms, sa ilalim ng 20 kada segundo ng Meta para sa Coexistence numbers.
  • Kapag pumalya ang isang step, magpapadala ito ng email sa inyo, hanggang isang beses lang kada automation kada 6 na oras; kapag tinanggihan ang AI key, ipi-pause ang mga automation na gumagamit ng provider na iyon at magpapadala ng isang email.

Ano ang tinatanggap ng create_automation tool?

Ang MCP connector ay may labinsiyam na tool para sa automations at sa mga ginagamit nila. Walo ang para sa automations: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs at get_automation_run. Walo ang para sa agents at files: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge at test_agent. Tatlo ang para sa mga tao: list_conversations, get_conversation at update_contact. Tinatanggap ng create_automation ang connection_id (mula sa list_numbers), name, enabled, trigger, steps at settings, sa snake_case gaya ng keyword_mode at max_tokens; tinatanggap din ang camelCase. Ang mga step object ay reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} at wait {minutes}, saka 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} at stop. Pinananatili ng update_automation ang mga field na hindi nilagyan, at kapag ibinigay ang steps, papalitan nito ang buong listahan. Ang mga error ay tumutukoy sa field, gaya ng "trigger.keywords: Add at least one keyword", "steps.2: Stop must be the last step of its line" o "steps.0: save your openai API key on the Automations page first". Hindi dumadaan sa MCP ang AI keys. Sa halimbawa, pinapayagan ng 1-minutong Wait ang customer na nagpadala ng ilang linya nang sabay na makakuha ng isang sagot.

create_automation arguments: an after-hours AI assistant, saved Off to test first
{
  "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 }
}

Mga karaniwang pagkakamali

  • Paggamit ng dalawang letrang keyword sa Contains. Ang "oi" ay tumutugma rin sa "noite" at "boi", kaya sumasagot ang automation sa mga mensaheng hindi naman para dito; gamitin ang Is exactly, o mas mahabang keyword.
  • Pagsulat lang ng may accent na baybay. Hindi pinapansin ng pagtutugma ang malalaking letra pero hindi ang accents, kaya hindi tumatama ang "preço" sa mga customer na nagta-type ng "preco"; isama ang pareho.
  • Pag-asang lalaktawan ng First message ang mga regular. Tumatakbo ito para sa sinumang customer na hindi nakita ng easyCoexistence sa loob ng 30 araw, kaya ang matagal nang customer ay makakakuha ng pagbati sa unang mensahe nila pagkatapos ma-switch on ito.
  • Pagpili ng template na nangangailangan ng header picture o copy-code button. Body variables lang ang pinupunan ng automations, kaya nakalista ito sa editor pero hindi ito mapipili, at kapag itinakda sa MCP, tinatanggihan ng Meta ang send at pumapalya ang run.
Ginagawa ito gamit ang EasyCoexistence

Pinapatakbo ng easyCoexistence ang mga automation na ito sa WhatsApp Business number na patuloy ninyong ginagamit sa app, sa pamamagitan ng Meta Cloud API at Coexistence. Buuin ang mga ito sa editor sa ilalim ng Automations, New automation, o hayaan ang ChatGPT o Claude na tawagan ang create_automation at test_automation sa pamamagitan ng MCP connector, na may higit sa 30 tools. Mula US$ 9 hanggang US$ 0.75 kada naka-connect na numero kada buwan, bumababa habang nagdadagdag ng numero, na may 3 araw na free trial.

Mga madalas itanong

Puwede bang mag-branch ang automation depende sa sinasabi ng customer?

Oo. Ang Split into paths (condition) ay nagbabranch ayon sa text ng mensahe, isang contact field, isang tag, isang naunang sagot ng API o inyong oras ng pagbubukas, at ang AI picks the path (ai_decide) ay pumipili ayon sa kahulugan, sa anumang wika, gamit ang sarili ninyong model. Bawat path ay may sariling linya ng mga step, at ang Otherwise na linya ang sumasalo sa iba pa. Puwede rin ninyong ipaubaya ang desisyon sa n8n o sa backend ninyo sa pamamagitan ng Call my webhook, na puwedeng magbalik ng ibang {"reply": "..."} para sa bawat kaso.

May limit ba sa automation o run?

Walang limit sa run at walang dagdag na singil para dito, at walang limit sa dami ng automation ang isang numero. Ang mga limit na umiiral ay kada chat: AI reply kada oras, 24-hour rule ng Meta para sa text, at ang pag-pause pagkatapos ninyong sumagot mula sa telepono.

Puwede bang ilipat o kopyahin ang automation sa ibang numero?

Ilipat ito sa pamamagitan ng pagpalit ng Connection nito sa editor, o gamit ang update_automation at bagong connection_id; ang mga run na naghihintay pa sa lumang numero ay magtatapos bilang superseded. Para kopyahin, hilingin sa AI na basahin ito gamit ang list_automations at gawin ang parehong trigger at step sa kabilang numero.

Ano ang mangyayari sa mga naghihintay na run kapag in-edit ang automation?

Patuloy ang mga ito. Ang run na nakahinto sa Wait ay magpapatuloy sa susunod na step number ng automation gaya ng pagkaka-save nito sa oras ng paggising ng run, kaya maaaring magbago ang ipinapadala ng edit. Para ihinto sila, i-switch Off ang automation: magtatapos sila bilang Skipped na may "Automation is off".

Magpatuloy sa pagbabasa

Handa na po ba kayong magsimula?

I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.

Magsimula ng Libreng Trial

Na-verify noong