Prijavite seZapočnite besplatno probno razdoblje
Meta Tech Provider

Referenca za WhatsApp automatizaciju: okidači, koraci, varijable i ograničenja

easyCoexistence automatizacije na WhatsApp broju počinju porukom koja stigne, kontaktom koji dobije oznaku ili pozivom vašeg sustava. Poruka ima četiri podudaranja: Svaka poruka, Sadrži ključnu riječ, Prva poruka i Izvan radnog vremena. Zatim slijede koraci, do 30 u nizu i 60 ukupno, s grananjima, pitanjima i AI agentima. Jedna poruka dobiva najviše jednu automatizaciju, a pravila s ključnim riječima idu prva.

30 steps

Koraci u jednom nizu, 60 ukupno, grananja ugniježđena do 4 razine; Zaustavi i Vrati se na korak mogu samo završiti niz.

30 keywords

Po automatizaciji do 100 znakova po ključnoj riječi; dovoljna je bilo koja, a velika i mala slova nisu bitna.

20,000

Znakovi dopušteni u Uputama koraka Odgovori uz AI, čiji su odgovori ograničeni na 50 do 2.000 tokena.

1,380 min

Najdulji pojedinačni korak Čekaj iznosi 23 sata, pa sljedeći tekstualni korak i dalje ostaje unutar Metinog 24-satnog prozora.

20 seconds

Vrijeme koje vaš webhook ima za odgovor prije nego što Pozovi moj webhook zakaže; polje reply u odgovoru šalje se kupcu.

30 days

Čuvanje izvršavanja, sa svakom početnom porukom i odgovorom; tekst poruka briše se nakon odabranog roka čuvanja (30, 90 ili 365 dana, zadano 90).

Koje okidače i podudaranja može koristiti WhatsApp automatizacija?

Glavni okidač, „Stigla je poruka” (message_received), pokreće se kad kupac piše na broj: tekst, fotografije, video, dokumente, zvučne zapise, naljepnice, lokacije, kontakt kartice, odgovore na gumbe i popise te narudžbe. Glasovna poruka se ispisuje pomoću vašeg OpenAI ili OpenRouter ključa i pohranjuje kao „[glasovna poruka]” iza čega slijede riječi, koje može prepoznati ključna riječ; bez takvog ključa ostaje „[glasovna poruka]”. Reakcije, statusi i sistemske obavijesti nikad ne pokreću izvršavanje, a grupni razgovori ne dolaze do API-ja na Coexistence broju. Dva dodatna okidača ne počinju od poruke. „Kontakt dobiva oznaku” (tag_added) pokreće se svaki put kad kontakt dostupan na broju dobije oznaku koju navedete, iz toka, AI agenta, od vas u Razgovorima ili preko update_contact. „Vaš sustav poziva URL” (webhook_received) pokreće se kad vaš vlastiti sustav pošalje POST s JSON-om i telefonskim brojem na URL automatizacije, s tajnim ključem automatizacije kao Bearer tokenom, za novu narudžbu ili rezervaciju; tijelo, do 20 KB, dostupno je kao {{vars.webhook.*}}. Kod oba je {{message}} prazan, a osoba koja nije pisala u zadnja 24 sata može dobiti samo send_template. Okidača po rasporedu nema. Kod okidača poruke Izvan radnog vremena tretira dane označene pod „Otvoreno u” kao otvorene između Od i Do, u IANA vremenskoj zoni kao što je America/Sao_Paulo; Do ranije od Od znači noćnu smjenu (22:00 do 06:00), a neoznačeni dan vrijedi kao zatvoren cijeli dan. U API-ju hours uzima timezone, days (1 = ponedjeljak do 7 = nedjelja, dani kada ste otvoreni) te start i end. Prva poruka pokreće se kad easyCoexistence otvori zapis za razgovor: prva poruka kupca otkad je automatizacija uključena za broj, uključujući dugogodišnje kupce, ili prva poruka nakon 30 dana tišine. Razgovor koji ste otvorili s telefona već se računa kao viđen.

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.

Kako rade načini podudaranja ključnih riječi?

Pod „Gdje riječ mora biti” Sadrži („Bilo gdje u poruci”) je zadano, Počinje s je „Na početku” i Točno je je „Cijela poruka”; u API-ju je keywordMode contains, starts_with ili exact. Podudaranje uklanja razmake oko poruke i ne razlikuje velika slova, ali ne zanemaruje dijakritike ni interpunkciju, a Sadrži podudara se i unutar duljih riječi. Okvir „Isprobaj” ispod Ključnih riječi odgovara „Pokreće se: podudara se” s ključnom riječi ili „Ne pokreće se: nijedna ključna riječ se ne podudara” za svaki uzorak koji upišete.

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?

Što radi svaki korak i koja polja uzima?

Koraci se izvršavaju odozgo prema dolje, do 30 u jednom nizu i 60 u automatizaciji, uključujući grane, a barem jedan mora raditi nešto osim Čekaj, Zaustavi, Podijeli na putove, AI bira put i Vrati se na korak. Korak s grananjem sadrži niz koraka za svaki put plus niz Inače, a grane se ugnježđuju do 4 razine. U izborniku „Odaberi korak” svaki prikazuje naziv i kratki opis, oba citirana u nastavku za šest osnovnih koraka. Postavi pitanje (ask) šalje svoju Poruku s do 10 gumba, od kojih se 3 prikazuju kao gumbi koje se može dodirnuti, a ostali su navedeni i odgovara se brojem, čeka odgovor do 1380 minuta i sprema ga u polje kontakta kao tekst, e-mail, broj, telefon ili jedan od gumba; na pogrešan odgovor pitanje se ponavlja do 3 puta. Odgovor agenta (agent) predaje poruku jednom od vaših AI agenata, Pošalji sliku ili datoteku (send_file) šalje sliku ili PDF iz vaših datoteka, a Predaj osobi (handoff) pauzira bota na tom razgovoru od 1 do 168 sati, zadano 24, i šalje vam e-mail. Podijeli na putove (condition) i AI bira put (ai_decide) granaju po pravilima ili po značenju. AI sprema podatke (ai_extract), Spremi u kontakt (set_field) i Označi (tag) upisuju polja kontakta i oznake, a Pozovi API (http_request) poziva bilo koji HTTPS API i čuva njegov JSON odgovor kao {{vars.<name>...}}. Pokreni automatizaciju (start_automation) pokreće drugu automatizaciju za istu osobu, najviše 3 razine duboko, Vrati se na korak (goto) skače na id koraka radi petlje, a Obavijesti me (notify_owner) šalje vam e-mail, najviše 20 na sat po automatizaciji. Ako korak ne uspije, preostali koraci se preskaču, a izvršavanje završava kao Neuspjelo. Pozovi moj webhook šalje JSON POST s event „automation.step”, dry_run, run_id, broj, kontakt (wa_id, name), poruku (id, type, text, at) i do 10 nedavnih poruka razgovora, potpisan u zaglavlju X-EC-Signature kao t=<unix>,v1=<HMAC-SHA256 od „<t>.<body>”> s „Tajnim ključem za potpis” koraka. Njegov URL mora biti javni HTTPS, a preusmjeravanja se ne slijede.

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.

Koje varijable mogu koraci popuniti?

Četiri se popunjavaju iz poruke koja je pokrenula izvršavanje, pisane u dvostrukim vitičastim zagradama; {{contact.<field>}} dodaje polje kontakta (također contact.name i contact.phone), a {{vars.<path>}} ono što su spremili raniji koraci, primjerice odgovor koraka Pozovi API. Rade u polju Poruka kod Odgovori tekstom, u varijablama tijela predloška, u Uputama kod Odgovori uz AI i u tekstu drugih koraka kao što je Postavi pitanje; u varijablama predloška čipovi „Umetni:” ih dodaju. Nepoznata vrijednost, primjerice profil bez imena, postaje prazna. Slanje predloška nosi samo varijable tijela, po položaju, pa predložak s imenovanim varijablama, slikom ili varijablom u zaglavlju ili gumbom s varijablom još se ne može odabrati, a prazna varijabla znači da Meta odbija slanje.

  • {{first_name}}: prva riječ imena na WhatsApp profilu kupca („Ime”).
  • {{name}}: puno ime profila („Puno ime”).
  • {{message}}: tekst poruke ili njezina oznaka, npr. „[image]”, plus natpis („Njihova poruka”).
  • {{phone}}: broj kupca kao međunarodne znamenke bez plusa, npr. 5511999998888 („Njihov telefon”).
  • U testu se kupac zove „Testni kupac”, a telefon je 15550000000.

Koje su postavke i njihove zadane vrijednosti?

Dvije postavke nalaze se pod „Napredno”, gumbom pored prekidača Uključeno u uredniku, a korak Odgovori uz AI ima još dvije vlastite. Polje koje izostavite uzima zadanu vrijednost, u uredniku i kroz create_automation podjednako. Vremenska ograničenja su fiksna, a ne postavljiva: AI odgovor dobiva 45 sekundi, a webhook 20 sekundi. Naziv automatizacije može imati do 120 znakova. AI agent ima vlastite postavke: ranije poruke koje čita, 0 do 40 (zadano 20), najdulji odgovor 100 do 4000 tokena (zadano 800), do 10 poziva alata po odgovoru (zadano 5) i sate predaje osobi, 1 do 168 (zadano 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.

Koja automatizacija odgovara kad se podudara više njih?

Najviše jedna, odabrana prema fiksnom redoslijedu: prvo Sadrži ključnu riječ, zatim Prva poruka, zatim Izvan radnog vremena, zatim Svaka poruka, a unutar iste vrste najstarija automatizacija prva. Natječu se samo automatizacije koje su Uključene i nisu pauzirane, pa kad je pravilo ključne riječi isključeno ili pauzirano zbog odbijenog AI ključa, odgovara opća automatizacija. Dvije posljedice iznenađuju ljude. Novi kupac koji piše noću dobiva automatizaciju Prva poruka, a ne Izvan radnog vremena, jer Prva poruka ima viši rang. A poruku na koju odgovara automatizacija ključne riječi ne dobiva AI agent niti korak Odgovori uz AI na Svaka poruka, pa stavite agenta ili AI korak unutar automatizacije ključne riječi ako želite oboje. Poruka koja odgovara na otvoreni korak Postavi pitanje pripada tom pitanju i nijedna druga automatizacija ne počinje na njoj. Automatizacije oznaka i webhooka počinju od vlastitih događaja i ne sudjeluju u ovom redoslijedu.

Koje zaštite su ugrađene?

Izvršitelj ih primjenjuje bez ikakve postavke, a razlozi preskakanja na kartici Pokretanja imenuju ih kad zaustave izvršavanje:

  • Poruka koju Meta isporuči dvaput pokreće jedno izvršavanje: duplikati se odbacuju po ID-u poruke.
  • Reakcije, statusi, vlastita slanja automatizacije i vaši odjeci iz aplikacije nikad ne pokreću izvršavanje.
  • Odgovori tekstom, Postavi pitanje, Pošalji sliku ili datoteku, Odgovori uz AI, odgovor agenta i odgovor webhooka trebaju zadnju poruku kupca mlađu od 24 sata; Pošalji predložak ne.
  • Odgovor koji upišete u aplikaciji WhatsApp Business pauzira automatizaciju na tom razgovoru, a izvršavanje koje čeka tamo preskače preostale korake.
  • Novija poruka koja pokreće istu automatizaciju na razgovoru zamjenjuje izvršavanje koje još čeka u koraku Čekaj; poruka koja odgovara na otvoreno pitanje umjesto toga ide tom pitanju.
  • Slanja s broja razmaknuta su najmanje 100 ms, ispod Metinih 20 u sekundi za Coexistence brojeve.
  • Neuspjeli korak šalje vam e-poštu, najviše jednom po automatizaciji svakih 6 sati; odbijeni AI ključ pauzira automatizacije koje koriste taj pružatelj i šalje jednu e-poštu.

Što uzima alat create_automation?

MCP konektor ima devetnaest alata za automatizacije i ono što one koriste. Osam ih je za automatizacije: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs i get_automation_run. Osam ih je za agente i datoteke: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge i test_agent. Tri su za osobe: list_conversations, get_conversation i update_contact. create_automation uzima connection_id (iz list_numbers), name, enabled, trigger, steps i settings, u snake_case obliku kao keyword_mode i max_tokens; camelCase se također prihvaća. Objekti koraka su reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} i wait {minutes}, zatim 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} i stop. update_automation zadržava polja koja izostavite, a steps, kad su zadani, zamjenjuju cijeli popis. Pogreške imenuju polje, npr. „trigger.keywords: Dodajte barem jednu ključnu riječ”, „steps.2: Zaustavi mora biti posljednji korak svog niza” ili „steps.0: prvo spremite svoj OpenAI API ključ na stranici Automatizacije”. AI ključevi nikad ne putuju kroz MCP. U primjeru korak Čekaj od 1 minute omogućuje kupcu koji pošalje nekoliko redaka odjednom da dobije jedan odgovor.

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 }
}

Uobičajene pogreške

  • Korištenje dvoslovne ključne riječi uz Sadrži. „oi” se podudara i s „noite” i s „boi”, pa automatizacija odgovara na poruke koje nikad nije trebala dobiti; koristite Točno je ili dulju ključnu riječ.
  • Navođenje samo pisanja s dijakritikom. Podudaranje ne razlikuje velika slova, ali razlikuje dijakritike, pa „preço” promašuje kupce koji upišu „preco”; dodajte oba.
  • Očekivanje da Prva poruka preskače redovite kupce. Pokreće se za svakog kupca čiji razgovor easyCoexistence nije vidio 30 dana, pa dugogodišnji kupci dobivaju dobrodošlicu na prvu poruku nakon što je uključite.
  • Odabir predloška koji traži sliku u zaglavlju ili gumb za kopiranje kôda. Automatizacije popunjavaju samo varijable tijela, pa uređivač ga prikazuje, ali ne dopušta odabir; postavljen kroz MCP, Meta odbija slanje i izvršavanje ne uspijeva.
Radite ovo uz EasyCoexistence

easyCoexistence pokreće ove automatizacije na WhatsApp Business broju koji i dalje koristite u aplikaciji, putem Metinog Cloud API-ja u načinu Coexistence. Izradite ih u uredniku pod Automatizacije, Nova automatizacija, ili neka ih ChatGPT ili Claude pozove preko create_automation i test_automation kroz MCP konektor, koji ima više od 30 alata. US$ 9 do US$ 0,75 po broju mjesečno, cijena pada kako dodajete brojeve, uz prva 3 dana besplatno.

Često postavljana pitanja

Može li automatizacija grananje na temelju onoga što kupac kaže?

Da. Podijeli na putove (condition) grana prema tekstu poruke, polju kontakta, oznaci, ranijem odgovoru API-ja ili vašem radnom vremenu, a AI bira put (ai_decide) odlučuje prema značenju, na bilo kojem jeziku, na vašem vlastitom modelu. Svaki put sadrži vlastiti niz koraka, a niz Inače hvata ostalo. Odluku možete prepustiti i n8n-u ili vašem backendu pomoću Pozovi moj webhook, koji može vratiti drugačiji {"reply": "..."} za svaki slučaj.

Postoji li ograničenje broja automatizacija ili izvršavanja?

Nema ograničenja broja izvršavanja i nema dodatne naplate za njih, niti ograničenja koliko automatizacija broj može imati. Primjenjiva ograničenja vrijede po razgovoru: AI odgovori po satu, Metino 24-satno pravilo za tekst i pauza nakon što odgovorite s telefona.

Mogu li premjestiti ili kopirati automatizaciju na drugi broj?

Premjestite je promjenom polja Veza u uredniku ili pomoću update_automation i novog connection_id; izvršavanja koja još čekaju na starom broju završavaju kao zamijenjena. Da biste kopirali jednu, zamolite svoj AI da je pročita pomoću list_automations i izradi isti okidač i korake na drugom broju.

Što se događa s izvršavanjima na čekanju kad uredim automatizaciju?

Nastavljaju. Izvršavanje zaustavljeno na koraku Čekaj nastavlja s sljedećim rednim brojem koraka automatizacije onako kako je spremljena kad se izvršavanje probudi, pa uređivanje može promijeniti što se šalje. Da ih zaustavite, isključite automatizaciju: tada završavaju kao Preskočeno s „Automatizacija je isključena”.

Nastavite čitati

Spremni za početak?

Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.

Započnite besplatno probno razdoblje

Provjereno na