Prijavite seZapočnite besplatni probni period
Meta Tech Provider

Referenca za WhatsApp automatizacije: okidači, koraci, promenljive i limiti

easyCoexistence automatizacije na WhatsApp broju kreću od poruke koja stiže, kontakta koji dobije oznaku ili poziva iz vašeg sistema. Poruka ima četiri podudaranja: „Svaka poruka”, „Sadrži ključnu reč”, „Prva poruka” i „Van radnog vremena”. Zatim idu koraci, do 30 u jednoj liniji i 60 ukupno, sa grananjima, pitanjima i AI agentima. Jedna poruka dobija najviše jednu automatizaciju, a pravila za ključne reči imaju prednost.

30 steps

Koraci u jednoj liniji, ukupno 60, grananja ugnežđena do 4 nivoa; Stop i Vrati se na korak mogu samo da završe liniju.

30 keywords

Po automatizaciji, do 100 znakova za svaku; dovoljna je bilo koja, a velika i mala slova nisu bitna.

20,000

Broj znakova dozvoljen u uputstvima koraka „Odgovori uz AI”, čiji su odgovori ograničeni na 50 do 2.000 tokena.

1,380 min

Najduži pojedinačni korak „Čekaj” traje 23 sata, pa sledeći tekstualni korak i dalje pada u Metin prozor od 24 sata.

20 seconds

Vreme koje vaš webhook ima za odgovor pre nego što „Pozovi moj webhook” ne uspe; polje reply u odgovoru šalje se klijentu.

30 days

Čuvanje pokretanja, uz svaku početnu poruku i odgovor; tekst poruka briše se posle izabranog perioda čuvanja (30, 90 ili 365 dana, podrazumevano 90).

Koje okidače i uslove može da koristi WhatsApp automatizacija?

Glavni okidač, „Stiže poruka” (message_received), pokreće se kada klijent piše na broj: tekst, fotografije, video, dokumenti, audio, nalepnice, lokacije, kontakt kartice, odgovori dugmadi i liste, kao i porudžbine. Glasovna poruka se prepisuje pomoću vašeg OpenAI ili OpenRouter ključa i čuva kao „[glasovna poruka]” a zatim reči, koje ključna reč može da pogodi; bez takvog ključa ostaje „[glasovna poruka]”. Reakcije, statusi i sistemska obaveštenja nikada ne pokreću izvršavanje, a grupni razgovori ne stižu u API na Coexistence broju. Dva dodatna okidača ne počinju od poruke. „Kontakt dobija oznaku” (tag_added) pokreće se svaki put kada kontakt dostupan na broju dobije oznaku koju navedete, iz toka, od AI agenta, od vas u Razgovorima ili preko update_contact. „Vaš sistem poziva URL” (webhook_received) pokreće se kada vaš sistem pošalje metodom POST JSON sa brojem telefona na URL automatizacije, sa tajnim ključem automatizacije kao Bearer tokenom, za novu porudžbinu ili rezervaciju; telo, do 20 KB, dostupno je kao {{vars.webhook.*}}. U oba slučaja {{message}} je prazno, a osoba koja nije pisala u poslednjih 24 sata može da dobije samo send_template. Nema okidača po rasporedu. Kod okidača za poruku, Van radnog vremena tretira dane označene pod „Otvoreno u” kao otvorene između Od i Do, u IANA vremenskoj zoni, na primer America/Sao_Paulo; Do ranije od Od znači smenu preko ponoći (22:00 do 06:00), a dan koji nije označen važi kao zatvoren ceo dan. U API-ju, hours sadrži timezone, days (1 = ponedeljak do 7 = nedelja, dani kada ste otvoreni) i start i end. Prva poruka se aktivira kada easyCoexistence otvori zapis za razgovor: prva poruka klijenta otkad je automatizacija uključena za broj, uključujući dugogodišnje klijente, ili prva poruka posle 30 dana tišine. Razgovor koji ste otvorili sa 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 režimi ključnih reči uparuju poruke?

Pod „Gde reč mora da bude”, Sadrži („Bilo gde u poruci”) je podrazumevano, Počinje sa je „Na početku”, a Tačno je „Cela poruka”; u API-ju, keywordMode je contains, starts_with ili exact. Uparivanje skida razmake oko poruke i ne razlikuje velika slova, ali ne zanemaruje dijakritičke znake ni interpunkciju, a Sadrži uparuje i unutar dužih reči. Polje „Probaj” ispod „Ključne reči” odgovara „Pokreće se: poklapa se” sa ključnom rečju ili „Ne pokreće se: nijedna ključna reč se ne poklapa” za bilo koji uzorak koji ukucate.

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?

Šta radi svaki korak i koja polja prima?

Koraci se izvršavaju odozgo nadole, do 30 u nizu i 60 u automatizaciji, uključujući grane, a bar jedan mora da radi nešto osim „Čekaj”, „Zaustavi”, „Podeli na putanje”, „AI bira putanju” i „Vrati se na korak”. Korak sa granama sadrži niz koraka za svaku putanju plus niz „U suprotnom”, a grane se ugnežđuju do 4 nivoa. U meniju „Izaberi korak” svaki ima naziv i kratak opis, oba su navedena ispod za šest osnovnih koraka. „Postavi pitanje” (ask) šalje svoju Poruku sa do 10 dugmadi, od kojih se 3 prikazuju kao dugmad koja može da se dodirne, a ostala se navode i odgovara se brojem, čeka odgovor do 1380 minuta i čuva ga u polju kontakta kao tekst, email, broj, telefon ili jedno od dugmadi; pogrešan odgovor dobija isto pitanje ponovo do 3 puta. „Odgovara agent” (agent) predaje poruku jednom od vaših AI agenata, „Pošalji sliku ili fajl” (send_file) šalje sliku ili PDF iz vaših fajlova, a „Prepusti osobi” (handoff) pauzira bota na tom razgovoru od 1 do 168 sati, podrazumevano 24, i šalje vam email. „Podeli na putanje” (condition) i „AI bira putanju” (ai_decide) granaju po pravilima ili po značenju. „AI beleži detalje” (ai_extract), „Sačuvaj u kontakt” (set_field) i „Oznaka” (tag) upisuju polja i oznake kontakta, 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 nivoa duboko, „Vrati se na korak” (goto) skače na id koraka radi ponavljanja, a „Obavesti me” (notify_owner) šalje vam email, najviše 20 na sat po automatizaciji. Ako korak ne uspe, sledeći koraci se preskaču, a pokretanje se završava kao „Neuspelo”. „Pozovi moj webhook” šalje JSON metodom POST sa event „automation.step”, dry_run, run_id, brojem, kontaktom (wa_id, name), porukom (id, type, text, at) i do 10 nedavnih poruka razgovora, potpisano u X-EC-Signature kao t=<unix>,v1=<HMAC-SHA256 od „<t>.<body>”> sa „Tajnim ključem za potpis” koraka. Njegov URL mora biti javan HTTPS, a preusmerenja se ne prate.

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 promenljive mogu koraci da popune?

Četiri se popunjavaju iz poruke kojom je pokretanje počelo, pišu se u dvostrukim vitičastim zagradama; {{contact.<field>}} dodaje polje kontakta (takođe contact.name i contact.phone), a {{vars.<path>}} ono što su raniji koraci sačuvali, na primer odgovor koraka „Pozovi API”. Rade u Poruci koraka „Odgovori tekstom”, u promenljivama tela šablona, u Uputstvima koraka „Odgovori uz AI” i u tekstu drugih koraka, kao što je „Postavi pitanje”; u promenljivama šablona, čipovi „Umetni:” ih dodaju. Vrednost koja nije poznata, kao profil bez imena, postaje prazna. Slanje šablona nosi samo promenljive tela, po položaju, pa šablon sa imenovanim promenljivama, slikom ili promenljivom u zaglavlju, ili dugmetom sa promenljivom za sada ne može da se izabere, a promenljiva koja ostane prazna čini da Meta odbije slanje.

  • {{first_name}}: prva reč iz WhatsApp imena klijenta („Ime”).
  • {{name}}: puno ime sa profila („Puno ime”).
  • {{message}}: tekst poruke ili njena oznaka, kao „[image]”, uz natpis („Njihova poruka”).
  • {{phone}}: broj klijenta kao međunarodne cifre bez znaka plus, na primer 5511999998888 („Njihov telefon”).
  • U probi, klijent je „Test klijent”, a telefon je 15550000000.

Koja su podešavanja i podrazumevane vrednosti?

Dva podešavanja nalaze se pod „Napredno”, dugmetom pored prekidača „Uključeno” u uređivaču, a korak AI ima još dva svoja. Polje koje se izostavi uzima podrazumevanu vrednost, i u uređivaču i kroz create_automation. Vremenska ograničenja su fiksna, a ne podesiva: odgovor AI dobija 45 sekundi, a webhook 20 sekundi. Naziv automatizacije može da ima do 120 znakova. AI agent ima sopstvena podešavanja: ranije poruke koje čita, 0 do 40 (podrazumevano 20), najduži odgovor 100 do 4000 tokena (podrazumevano 800), do 10 poziva alata po odgovoru (podrazumevano 5) i sati prepuštanja osobi, 1 do 168 (podrazumevano 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 kada se poklapa više njih?

Najviše jedna, izabrana po fiksnom redosledu: prvo Sadrži ključnu reč, zatim Prva poruka, pa Van radnog vremena, pa Svaka poruka, a među istom vrstom najstarija automatizacija prva. Učestvuju samo automatizacije koje su Uključene i nisu pauzirane, pa kada je pravilo za ključnu reč Isključeno ili pauzirano zbog odbijenog AI ključa, odgovara opšta automatizacija. Dve posledice iznenađuju ljude. Novi klijent koji piše noću dobija automatizaciju Prva poruka, a ne Van radnog vremena, jer Prva poruka ima viši prioritet. A poruka na koju odgovara automatizacija sa ključnom rečju nikada ne stiže do AI agenta ni do koraka „Odgovori uz AI” u automatizaciji Svaka poruka, pa stavite agenta ili AI korak unutar automatizacije sa ključnom rečju ako želite oboje. Poruka koja odgovara na otvoren korak „Postavi pitanje” pripada tom pitanju i nijedna druga automatizacija ne počinje na njoj. Automatizacije sa oznakom i webhook-om počinju od sopstvenih događaja i ne učestvuju u ovom redosledu.

Koje zaštite su ugrađene?

Izvršilac ih primenjuje bez ikakvog podešavanja, a razlozi preskakanja na kartici Pokretanja ih navode kada zaustave izvršavanje:

  • Poruka koju Meta isporuči dva puta pokreće jedno izvršavanje: duplikati se odbacuju po ID-ju poruke.
  • Reakcije, statusi, sopstvena slanja automatizacije i vaše eho poruke iz aplikacije nikada ne pokreću izvršavanje.
  • Odgovor tekstom, Postavljanje pitanja, Slanje slike ili fajla, Odgovor uz AI, odgovor agenta i odgovor webhook-a traže da poslednja poruka klijenta bude mlađa od 24 sata; Slanje šablona ne traži.
  • Odgovor koji otkucate u WhatsApp Business aplikaciji pauzira automatizaciju na tom razgovoru, a izvršavanje koje tamo čeka preskače preostale korake.
  • Novija poruka koja pokreće istu automatizaciju na razgovoru zamenjuje izvršavanje koje još čeka u koraku „Čekaj”; poruka koja odgovara na otvoreno pitanje ide tom pitanju.
  • Slanja sa jednog broja razmaknuta su najmanje 100 ms, ispod Metinih 20 u sekundi za Coexistence brojeve.
  • Neuspeli korak šalje vam e-poruku, najviše jednom po automatizaciji na svakih 6 sati; odbijeni AI ključ pauzira automatizacije koje koriste tog provajdera i šalje jednu e-poruku.

Šta uzima alat create_automation?

MCP konektor ima devetnaest alata za automatizacije i ono što koriste. Osam je za automatizacije: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs i get_automation_run. Osam je za agente i fajlove: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge i test_agent. Tri su za ljude: 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; prihvata se i camelCase. 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, kada se navede, zamenjuje celu listu. Greške navode polje, na primer „trigger.keywords: Add at least one keyword”, „steps.2: Stop must be the last step of its line” ili „steps.0: save your openai API key on the Automations page first”. AI ključevi nikada ne prolaze kroz MCP. U primeru, čekanje od 1 minut omogućava da klijent koji pošalje više redova odjednom 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 }
}

Česte greške

  • Korišćenje dvoslovne ključne reči uz Sadrži. „oi” se poklapa i sa „noite” i sa „boi”, pa automatizacija odgovara na poruke za koje nije bila namenjena; koristite Tačno je ili dužu ključnu reč.
  • Navođenje samo sa dijakritikom. Uparivanje ne razlikuje velika slova, ali razlikuje dijakritike, pa „preço” promašuje klijente koji ukucaju „preco”; dodajte oba.
  • Očekivanje da Prva poruka preskače stalne klijente. Aktivira se za svakog klijenta čiji razgovor easyCoexistence nije video 30 dana, pa dugogodišnji klijenti dobiju poruku dobrodošlice na prvu poruku posle uključivanja.
  • Izbor šablona koji traži sliku u zaglavlju ili dugme za kopiranje koda. Automatizacije popunjavaju samo promenljive tela, pa uređivač ga prikazuje ali ne dozvoljava izbor, a kada se postavi kroz MCP, Meta odbija slanje i pokretanje ne uspeva.
Ovo radite uz EasyCoexistence

easyCoexistence pokreće ove automatizacije na WhatsApp Business broju koji i dalje koristite u aplikaciji, preko Metinog Cloud API-ja i Coexistence. Napravite ih u uređivaču pod Automatizacije, Nova automatizacija, ili neka ChatGPT ili Claude pozove create_automation i test_automation preko MCP konektora, koji ima više od 30 alata. US$ 9 do US$ 0.75 po broju mesečno, uz pad kako dodajete brojeve, sa prva 3 dana besplatno.

Često postavljana pitanja

Može li automatizacija da se grana prema tome šta klijent kaže?

Da. „Podeli na putanje” (condition) grana po tekstu poruke, polju kontakta, oznaci, ranijem odgovoru API-ja ili vašem radnom vremenu, a „AI bira putanju” (ai_decide) bira po značenju, na bilo kom jeziku, na vašem sopstvenom modelu. Svaka putanja ima svoj niz koraka, a niz „U suprotnom” hvata ostalo. Odluku možete i da prepustite n8n-u ili vašem backend-u preko Pozovi moj webhook, koji može da vrati drugačiji {"reply": "..."} za svaki slučaj.

Postoji li ograničenje broja automatizacija ili pokretanja?

Nema ograničenja broja pokretanja i nema dodatne naplate za njih, niti ograničenja koliko automatizacija broj može da ima. Ograničenja koja važe su po razgovoru: AI odgovori po satu, Metino pravilo od 24 sata za tekst i pauza posle odgovora sa telefona.

Mogu li da premestim ili kopiram automatizaciju na drugi broj?

Premestite je promenom polja Veza u uređivaču ili preko update_automation i novog connection_id; pokretanja koja još čekaju na starom broju završavaju se kao „Zamenjeno”. Da biste kopirali, zamolite AI da pročita automatizaciju preko list_automations i napravi isti okidač i korake na drugom broju.

Šta se dešava sa čekajućim pokretanjima kada izmenim automatizaciju?

Nastavljaju. Pokretanje zaustavljeno na koraku „Čekaj” nastavlja na sledeći broj koraka automatizacije onako kako je sačuvana kada se pokretanje probudi, pa izmena može da promeni šta se šalje. Da biste ih zaustavili, isključite automatizaciju: tada se završe kao „Preskočeno” sa „Automatizacija je isključena”.

Nastavite sa čitanjem

Spremni da počnete?

Podesite WhatsApp Coexistence za nekoliko minuta, a ne meseci. Aplikacija nastavlja da radi na telefonu.

Započnite besplatni probni period

Provereno na