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.
Koraci u jednom nizu, 60 ukupno, grananja ugniježđena do 4 razine; Zaustavi i Vrati se na korak mogu samo završiti niz.
Po automatizaciji do 100 znakova po ključnoj riječi; dovoljna je bilo koja, a velika i mala slova nisu bitna.
Znakovi dopušteni u Uputama koraka Odgovori uz AI, čiji su odgovori ograničeni na 50 do 2.000 tokena.
Najdulji pojedinačni korak Čekaj iznosi 23 sata, pa sljedeći tekstualni korak i dalje ostaje unutar Metinog 24-satnog prozora.
Vrijeme koje vaš webhook ima za odgovor prije nego što Pozovi moj webhook zakaže; polje reply u odgovoru šalje se kupcu.
Č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.
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.
| 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? |
Š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.
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).
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.
{
"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.
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 razdobljeProvjereno na