Referință pentru automatizările WhatsApp: declanșatoare, pași, variabile și limite
Automatizările easyCoexistence de pe un număr WhatsApp pornesc de la un mesaj care sosește, de la un contact care primește o etichetă sau de la un apel din sistemul dumneavoastră. Un mesaj are patru potriviri: Fiecare mesaj, Are cuvânt cheie, Primul mesaj și În afara programului. Urmează pașii, până la 30 pe o linie și 60 în total, cu ramificații, întrebări și agenți AI. Un mesaj primește cel mult o automatizare, iar regulile cu cuvinte cheie au prioritate.
Pași pe o linie, 60 în total, ramificații imbricate pe 4 niveluri; Oprește și Înapoi la un pas pot încheia doar o linie.
Per automatizare, până la 100 de caractere pentru fiecare; oricare dintre ele este suficient, iar literele mari și mici nu contează.
Caractere permise în Instrucțiunile pasului Răspunde cu AI, ale cărui răspunsuri sunt limitate între 50 și 2.000 de token-uri.
Cel mai lung pas Așteaptă, 23 de ore, astfel încât următorul pas de text să rămână în fereastra de 24 de ore a Meta.
Timpul în care webhook-ul trebuie să răspundă înainte ca Apelează webhook-ul meu să eșueze; un câmp reply din răspuns ajunge la client.
Retenția rulărilor, cu fiecare mesaj de pornire și răspuns; textul mesajelor dispare după retenția aleasă (30, 90 sau 365 de zile, implicit 90).
Ce declanșatoare și potriviri poate folosi o automatizare WhatsApp?
Declanșatorul principal, „Un mesaj sosește” (message_received), pornește atunci când un client scrie pe număr: text, fotografii, video, documente, audio, autocolante, locații, carduri de contact, răspunsuri la butoane și liste, precum și comenzi. O notă vocală este transcrisă cu cheia dumneavoastră OpenAI sau OpenRouter și stocată ca „[voice message]” urmat de cuvinte, pe care un cuvânt cheie le poate potrivi; fără o astfel de cheie rămâne „[voice message]”. Reacțiile, stările și notificările de sistem nu pornesc niciodată o rulare, iar conversațiile de grup nu ajung la API pe un număr Coexistence. Alte două declanșatoare nu pornesc de la un mesaj. „Un contact primește o etichetă” (tag_added) pornește de fiecare dată când un contact care poate fi contactat pe număr primește eticheta pe care o numiți, dintr-un flux, de la un agent AI, de la dumneavoastră în Conversații sau prin update_contact. „Sistemul dumneavoastră apelează un URL” (webhook_received) pornește atunci când propriul sistem trimite prin POST un JSON cu un număr de telefon la URL-ul automatizării, cu secretul automatizării ca Bearer token, pentru o comandă nouă sau o rezervare; corpul, până la 20 KB, este disponibil ca {{vars.webhook.*}}. În ambele, {{message}} este gol, iar o persoană care nu a scris în ultimele 24 de ore poate primi doar un send_template. Nu există declanșator programat. La declanșatorul de mesaj, „În afara programului” tratează zilele bifate sub „Deschis în” ca deschise între „De la” și „Până la”, într-un fus orar IANA, cum ar fi America/Sao_Paulo; o oră „Până la” anterioară orei „De la” înseamnă un program de noapte (22:00 până la 06:00), iar o zi nebifată este considerată închisă toată ziua. În API, hours primește timezone, days (1 = luni până la 7 = duminică, adică zilele deschise) și start și end. „Primul mesaj” pornește atunci când easyCoexistence creează o înregistrare pentru conversație: primul mesaj al unui client de la activarea unei automatizări pe număr, inclusiv pentru clienții vechi, sau primul mesaj după 30 de zile de liniște. O conversație deschisă din telefon este deja considerată văzută.
Cum funcționează modurile de potrivire a cuvintelor cheie?
Sub „Unde trebuie să fie cuvântul”, Conține („Oriunde în mesaj”) este implicit, Începe cu este „La început”, iar Este exact este „Întregul mesaj”; în API, keywordMode este contains, starts_with sau exact. Potrivirea elimină spațiile din jurul mesajului și ignoră literele mari, dar nu ignoră diacriticele sau semnele de punctuație, iar Conține se potrivește și în interiorul cuvintelor mai lungi. Caseta „Testează-l” de sub Cuvinte cheie răspunde „Rulează: se potrivește” cu cuvântul cheie sau „Nu rulează: niciun cuvânt cheie nu se potrivește”, pentru orice exemplu introdus.
| 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? |
Ce face fiecare pas și ce câmpuri primește?
Pașii rulează de sus în jos, până la 30 pe o linie și 60 într-o automatizare, ramificațiile incluse, iar cel puțin unul trebuie să facă altceva decât Așteaptă, Oprește, Împarte în căi, AI alege calea și Înapoi la un pas. Un pas cu ramificații conține o linie de pași pentru fiecare cale plus o linie Altfel, iar ramificațiile se pot imbrica pe 4 niveluri. În meniul „Alege un pas” fiecare are un nume și o linie scurtă, citate mai jos pentru cei șase pași de bază. Pune o întrebare (ask) trimite Mesajul său cu până la 10 butoane, dintre care 3 apar ca butoane pe care se poate apăsa, iar celelalte sunt listate și se răspunde prin număr, așteaptă până la 1.380 de minute răspunsul și îl salvează într-un câmp de contact ca text, email, număr, telefon sau unul dintre butoane; un răspuns greșit primește din nou întrebarea de până la 3 ori. Răspunsul agentului (agent) predă mesajul unuia dintre agenții dumneavoastră AI, Trimite o imagine sau un fișier (send_file) trimite o imagine sau un PDF din fișierele dumneavoastră, iar Predă unei persoane (handoff) pune botul în pauză pe acea conversație pentru 1 până la 168 de ore, implicit 24, și vă trimite un email. Împarte în căi (condition) și AI alege calea (ai_decide) ramifică după reguli sau după sens. AI salvează detalii (ai_extract), Salvează în contact (set_field) și Etichetează (tag) scriu câmpuri de contact și etichete, iar Apelează un API (http_request) apelează orice API HTTPS și păstrează răspunsul său JSON ca {{vars.<name>...}}. Pornește automatizarea (start_automation) rulează o altă automatizare pentru aceeași persoană, cel mult 3 niveluri adâncime, Înapoi la un pas (goto) sare la un id de pas pentru a repeta în buclă, iar Anunță-mă (notify_owner) vă trimite un email, cel mult 20 pe oră pentru fiecare automatizare. Dacă un pas eșuează, pașii următori sunt omiși, iar rularea se termină cu Eșuată. Apelează webhook-ul meu trimite JSON prin POST cu event „automation.step”, dry_run, run_id, numărul, contactul (wa_id, name), mesajul (id, type, text, at) și până la 10 mesaje recente ale conversației, semnate în X-EC-Signature ca t=<unix>,v1=<HMAC-SHA256 al „<t>.<body>”> cu „Semnătura secretă” a pasului. URL-ul trebuie să fie public, cu HTTPS, iar redirecționările nu sunt urmate.
Ce variabile pot completa pașii?
Patru sunt completate din mesajul care a pornit rularea, scrise între acolade duble; {{contact.<field>}} adaugă un câmp de contact (și contact.name și contact.phone), iar {{vars.<path>}} ceea ce au salvat pașii anteriori, cum ar fi răspunsul unui pas Apelează un API. Funcționează în Mesajul pasului Răspunde cu text, în variabilele corpului unui template, în Instrucțiunile pasului Răspunde cu AI și în textul altor pași, cum ar fi Pune o întrebare; în variabilele unui template, cipurile „Inserează:” le adaugă. O valoare necunoscută, cum ar fi un profil fără nume, devine goală. Trimiterile de template transportă doar variabile din corp, după poziție, astfel încât un template cu variabile numite, cu imagine sau variabilă în antet ori cu un buton care conține variabilă nu poate fi ales încă, iar o variabilă lăsată goală face ca Meta să refuze trimiterea.
- {{
first_name}}: primul cuvânt din numele de profil WhatsApp al clientului („Prenume”). - {{name}}: numele complet din profil („Nume complet”).
- {{message}}: textul mesajului sau substituentul său, precum „[image]”, plus legenda („Mesajul lor”).
- {{phone}}: numărul clientului, cu cifre internaționale fără plus, cum ar fi 5511999998888 („Telefonul lor”).
- Într-un test, clientul este „Client de test”, iar telefonul este 15550000000.
Care sunt setările și valorile implicite?
Două setări sunt sub „Avansate”, butonul de lângă comutatorul Pornit din editor, iar pasul AI are încă două proprii. Un câmp omis primește valoarea implicită, atât în editor, cât și prin create_automation. Timeout-urile sunt fixe, nu setabile: un răspuns AI are 45 de secunde, iar un webhook 20 de secunde. Numele unei automatizări poate avea până la 120 de caractere. Un agent AI are propriile setări: mesajele anterioare pe care le citește, de la 0 la 40 (implicit 20), cel mai lung răspuns de la 100 la 4.000 de tokeni (implicit 800), până la 10 apeluri de instrumente per răspuns (implicit 5) și orele de predare către o persoană, de la 1 la 168 (implicit 24).
Ce automatizare răspunde când mai multe se potrivesc?
Cel mult una, aleasă într-o ordine fixă: mai întâi Are cuvânt cheie, apoi Primul mesaj, apoi În afara programului, apoi Fiecare mesaj, iar în cadrul aceluiași tip, cea mai veche automatizare întâi. Concurează doar automatizările Pornite și care nu sunt în pauză, astfel că, atunci când regula de cuvânt cheie este Oprită sau întreruptă de o cheie AI refuzată, răspunde în schimb regula generală. Două consecințe surprind pe mulți. Un client nou care scrie noaptea primește automatizarea Primul mesaj, nu pe cea În afara programului, pentru că Primul mesaj are rang mai mare. Iar un mesaj la care răspunde o automatizare cu cuvânt cheie nu ajunge niciodată la un agent AI sau la un pas Răspunde cu AI pe Fiecare mesaj, deci puneți agentul sau pasul AI în automatizarea cu cuvânt cheie dacă le doriți pe amândouă. Un mesaj care răspunde unui pas Pune o întrebare deschis aparține acelei întrebări, iar nicio altă automatizare nu pornește pe baza lui. Automatizările cu etichetă și cele cu webhook pornesc de la propriile evenimente și nu participă la această ordine.
Ce protecții sunt integrate?
Motorul le aplică fără nicio setare, iar motivele omiterii din fila Rulări le numesc atunci când opresc o rulare:
- Un mesaj livrat de două ori de Meta pornește o singură rulare: duplicatele sunt eliminate după ID-ul mesajului.
- Reacțiile, stările, trimiterile proprii ale automatizării și ecourile trimiterilor din aplicație nu pornesc niciodată o rulare.
- Răspunde cu text, Pune o întrebare, Trimite o imagine sau un fișier, Răspunde cu AI, răspunsul unui agent și răspunsul unui webhook necesită ca ultimul mesaj al clientului să aibă sub 24 de ore; Trimite un template nu.
- Un răspuns scris în aplicația WhatsApp Business pune automatizarea în pauză pe acea conversație, iar o rulare aflată în așteptare acolo își sare pașii rămași.
- Un mesaj nou care pornește aceeași automatizare pe o conversație înlocuiește rularea încă în așteptare într-un pas Așteaptă; un mesaj care răspunde unei întrebări deschise merge în schimb la acea întrebare.
- Trimiterile de pe un număr sunt distanțate de cel puțin 100 ms, sub limita Meta de 20 pe secundă pentru numerele Coexistence.
- Un pas eșuat trimite un e-mail, cel mult o dată la fiecare 6 ore pentru fiecare automatizare; o cheie AI refuzată pune în pauză automatizările care folosesc acel furnizor și trimite un singur e-mail.
Ce primește instrumentul create_automation?
Conectorul MCP are nouăsprezece instrumente pentru automatizări și ceea ce folosesc acestea. Opt sunt pentru automatizări: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs și get_automation_run. Opt sunt pentru agenți și fișiere: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge și test_agent. Trei sunt pentru persoane: list_conversations, get_conversation și update_contact. create_automation primește connection_id (din list_numbers), name, enabled, trigger, steps și settings, în snake_case, cum ar fi keyword_mode și max_tokens; camelCase este acceptat și el. Obiectele de pas sunt reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} și wait {minutes}, apoi 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 păstrează câmpurile lăsate necompletate, iar steps, dacă este trimis, înlocuiește întreaga listă. Erorile numesc câmpul, de exemplu „trigger.keywords: Add at least one keyword”, „steps.2: Stop must be the last step of its line” sau „steps.0: save your openai API key on the Automations page first”. Cheile AI nu trec niciodată prin MCP. În exemplu, Așteptarea de 1 minut permite unui client care trimite mai multe rânduri deodată să primească un singur răspuns.
{
"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 }
}Greșeli frecvente
- Folosirea unui cuvânt cheie scurt cu Conține. „bun” se potrivește și cu „bunica” și „bunătate”, deci automatizarea răspunde la mesaje pentru care nu a fost gândită; folosiți Este exact sau un cuvânt cheie mai lung.
- Trecerea doar a variantei cu diacritice. Potrivirea ignoră literele mari, dar nu și diacriticele, deci „preț” nu prinde clienții care scriu „pret”; adăugați ambele variante.
- Presupunerea că Primul mesaj ocolește clienții obișnuiți. Se activează pentru orice client a cărui conversație easyCoexistence nu a mai văzut-o de 30 de zile, așa că clienții vechi primesc mesajul de bun venit la primul mesaj după ce îl porniți.
- Alegerea unui template care cere o imagine în antet sau un buton pentru copierea codului. Automatizările completează doar variabilele din corp, deci editorul îl listează, dar nu vă lasă să îl alegeți; setat prin MCP, trimiterea este refuzată de Meta, iar rularea eșuează.
easyCoexistence rulează aceste automatizări pe numărul WhatsApp Business pe care îl folosiți deja în aplicație, prin Cloud API de la Meta și Coexistence. Creați-le în editor, la Automatizări, Automatizare nouă, sau lăsați ChatGPT ori Claude să apeleze create_automation și test_automation prin conectorul MCP, care are peste 30 de instrumente. De la US$ 9 până la US$ 0.75 pe număr pe lună, scăzând pe măsură ce adăugați numere, cu o perioadă de probă gratuită de 3 zile.
Întrebări frecvente
Poate o automatizare să ramifice în funcție de ce spune clientul?
Da. Împarte în căi (condition) ramifică după textul mesajului, un câmp de contact, o etichetă, un răspuns API anterior sau programul dumneavoastră de lucru, iar AI alege calea (ai_decide) alege după sens, în orice limbă, pe propriul model. Fiecare cale conține propria linie de pași, iar o linie Altfel preia restul. Puteți lăsa decizia și în seama n8n ori a propriului backend prin Apelează webhook-ul meu, care poate returna un alt {"reply": "..."} pentru fiecare caz.
Există o limită pentru automatizări sau rulări?
Nu există plafon pentru rulări și nicio taxă suplimentară pentru ele, iar numărul de automatizări pe număr nu este limitat. Limitele care se aplică sunt pe conversație: răspunsurile AI pe oră, regula Meta de 24 de ore pentru text și pauza care urmează după un răspuns din telefon.
Pot muta sau copia o automatizare pe alt număr?
Mutați-o schimbând Conexiunea din editor sau cu update_automation și un connection_id nou; rulările încă în așteptare pe vechiul număr se termină ca înlocuite. Pentru a copia una, cereți AI-ului să o citească cu list_automations și să creeze același declanșator și aceiași pași pe celălalt număr.
Ce se întâmplă cu rulările în așteptare când editez o automatizare?
Continuă. O rulare oprită pe un Așteaptă reia la următorul număr de pas al automatizării așa cum este salvată în momentul în care rularea se trezește, astfel că o editare poate schimba ce trimite. Pentru a le opri, treceți automatizarea pe Oprită: atunci se termină Omisă, cu motivul „Automatizarea este oprită”.
Continuați să citiți
Gata să începeți?
Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.
Începeți perioada de probă gratuităVerificat la