AccediInizia la prova gratuita
Meta Tech Provider

Riferimento delle automazioni WhatsApp: trigger, passi, variabili e limiti

Le automazioni di easyCoexistence su un numero WhatsApp partono da un messaggio in arrivo, da un contatto che riceve un tag o da una chiamata del tuo sistema. Un messaggio ha quattro corrispondenze: Ogni messaggio, Contiene parola chiave, Primo messaggio e Fuori orario. Seguono i passi, fino a 30 in una linea e 60 in tutto, con rami, domande e agenti AI. Un messaggio attiva al massimo una automazione, prima le regole con parola chiave.

30 steps

Passi in una linea, 60 in tutto, rami annidati fino a 4 livelli; Fermati e Torna a un passo possono solo chiudere una linea.

30 keywords

Per automazione, fino a 100 caratteri per parola chiave; ne basta una, e le maiuscole non contano.

20,000

Caratteri consentiti nelle Istruzioni di un passo Rispondi con AI, le cui risposte sono limitate da 50 a 2.000 token.

1,380 min

Attesa singola più lunga: 23 ore, così il passo di testo successivo cade ancora entro la finestra di 24 ore di Meta.

20 seconds

Tempo di risposta del webhook prima che Chiama il mio webhook fallisca; un campo reply nella risposta viene inviato al cliente.

30 days

Conservazione delle esecuzioni, con ciascun messaggio iniziale e la risposta; il testo dei messaggi scade dopo la conservazione che scegli (30, 90 o 365 giorni, 90 per impostazione predefinita).

Quali trigger e corrispondenze può usare un'automazione WhatsApp?

Il trigger principale, «Arriva un messaggio» (message_received), si attiva quando un cliente scrive al numero: testo, foto, video, documenti, audio, sticker, posizioni, biglietti da visita, risposte a pulsanti ed elenchi, e ordini. Una nota vocale viene trascritta con la tua chiave OpenAI o OpenRouter e salvata come "[voice message]" seguito dalle parole, che una parola chiave può riconoscere; senza una chiave di questo tipo resta "[voice message]". Reazioni, stati e avvisi di sistema non avviano mai un'esecuzione, e le chat di gruppo non arrivano all'API su un numero Coexistence. Altri due trigger non partono da un messaggio. «Un contatto riceve un tag» (tag_added) si attiva ogni volta che un contatto raggiungibile sul numero riceve il tag che indichi, da un flusso, da un agente AI, da te in Conversazioni o con update_contact. «Il tuo sistema chiama un URL» (webhook_received) si attiva quando il tuo sistema invia una POST JSON con un numero di telefono all'URL dell'automazione, con il segreto dell'automazione come Bearer token, per un nuovo ordine o una prenotazione; il corpo, fino a 20 KB, è disponibile come {{vars.webhook.*}}. In entrambi, {{message}} è vuoto e una persona che non ha scritto nelle ultime 24 ore può ricevere solo un send_template. Non esiste un trigger a orario. Sul trigger del messaggio, «Fuori orario» considera aperti i giorni selezionati sotto «Aperto nei giorni», tra Da e A, in un fuso orario IANA come America/Sao_Paulo; un A precedente a Da indica un turno notturno (dalle 22:00 alle 06:00), e un giorno non selezionato vale come chiuso tutto il giorno. Nell'API, hours usa timezone, days (1 = lunedì fino a 7 = domenica, i giorni in cui sei aperto), e start ed end. «Primo messaggio» si attiva quando easyCoexistence crea un record per la chat: il primo messaggio di un cliente da quando un'automazione è stata attivata sul numero, anche per i clienti di lunga data, oppure il primo dopo 30 giorni di silenzio. Una chat che hai aperto dal telefono risulta già vista.

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.

Come funzionano le modalità di corrispondenza con parola chiave?

Sotto «Dove deve trovarsi la parola», Contiene («Ovunque nel messaggio») è il predefinito, Inizia con è «All'inizio» e È esatta è «Il messaggio intero»; nell'API, keywordMode vale contains, starts_with o exact. La corrispondenza ignora gli spazi attorno al messaggio e non distingue le maiuscole, ma non ignora accenti o punteggiatura, e Contiene trova la parola anche dentro parole più lunghe. La casella «Prova» sotto Parole chiave risponde «Esegue: corrisponde» con la parola chiave, oppure «Non esegue: nessuna parola chiave corrisponde», per qualsiasi esempio tu digiti.

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?

Cosa fa ogni passo e quali campi richiede?

I passi vengono eseguiti dall'alto verso il basso, fino a 30 in una linea e 60 in un'automazione, rami compresi, e almeno uno deve fare qualcosa oltre ad Attendi, Fermati, Dividi in percorsi, L'AI sceglie il percorso e Torna a un passo. Un passo con rami contiene una linea di passi per ogni percorso più una linea Altrimenti, e i rami si annidano fino a 4 livelli. Nel menu «Scegli un passo» ognuno mostra un nome e una breve descrizione, entrambi citati sotto per i sei passi di base. Fai una domanda (ask) invia il suo Messaggio con fino a 10 pulsanti, di cui 3 appaiono come pulsanti toccabili e gli altri sono elencati e si risponde con il numero, attende fino a 1.380 minuti la risposta e la salva in un campo del contatto come testo, email, numero, telefono o uno dei pulsanti; una risposta sbagliata fa ripetere la domanda fino a 3 volte. Risposte dell'agente (agent) passa il messaggio a uno dei tuoi agenti AI, Invia un'immagine o un file (send_file) invia un'immagine o un PDF dai tuoi file, e Passa a una persona (handoff) mette in pausa il bot su quella chat per 1-168 ore, 24 per impostazione predefinita, e ti invia un'email. Dividi in percorsi (condition) e L'AI sceglie il percorso (ai_decide) creano rami per regole o per significato. L'AI salva i dettagli (ai_extract), Salva nel contatto (set_field) e Tag (tag) scrivono campi e tag del contatto, e Chiama un'API (http_request) chiama qualsiasi API HTTPS e conserva la sua risposta JSON come {{vars.<name>...}}. Avvia automazione (start_automation) esegue un'altra automazione per la stessa persona, al massimo 3 livelli, Torna a un passo (goto) salta all'id di un passo per ripetere in ciclo, e Avvisami (notify_owner) ti invia un'email, al massimo 20 all'ora per automazione. Se un passo fallisce, i passi successivi vengono saltati e l'esecuzione termina come Non riuscita. Chiama il mio webhook invia una POST JSON con event "automation.step", dry_run, run_id, il numero, il contatto (wa_id, name), il messaggio (id, type, text, at) e fino a 10 messaggi recenti della chat, firmata in X-EC-Signature come t=<unix>,v1=<HMAC-SHA256 di "<t>.<body>"> con la «Chiave di firma» del passo. Il suo URL deve essere HTTPS pubblico, e i reindirizzamenti non vengono seguiti.

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.

Quali variabili possono compilare i passi?

Quattro vengono compilate dal messaggio che ha avviato l'esecuzione, scritte tra doppie graffe; {{contact.<field>}} aggiunge un campo del contatto (anche contact.name e contact.phone) e {{vars.<path>}} ciò che i passi precedenti hanno salvato, come la risposta di un passo Chiama un'API. Funzionano nel Messaggio di Rispondi con testo, nelle variabili del corpo di un template, nelle Istruzioni di Rispondi con AI e nel testo di altri passi come Fai una domanda; nelle variabili di un template, i pulsanti «Inserisci:» le aggiungono. Un valore sconosciuto, come un profilo senza nome, diventa vuoto. Gli invii di template portano solo variabili del corpo, per posizione, quindi un template con variabili con nome, un'immagine o una variabile nell'intestazione, o un pulsante con una variabile non possono ancora essere scelti, e una variabile lasciata vuota fa rifiutare l'invio da Meta.

  • {{first_name}}: la prima parola del nome del profilo WhatsApp del cliente («Nome»).
  • {{name}}: il nome completo del profilo («Nome completo»).
  • {{message}}: il testo del messaggio, oppure il suo segnaposto come «[image]» più la didascalia («Il loro messaggio»).
  • {{phone}}: il numero del cliente in cifre internazionali senza il più, come 5511999998888 («Il loro numero»).
  • In un test, il cliente è «Cliente di prova» e il numero è 15550000000.

Quali sono le impostazioni e i valori predefiniti?

Due impostazioni si trovano sotto «Avanzate», il pulsante accanto all'interruttore Attiva nell'editor, e il passo AI ne ha due propri. Un campo lasciato vuoto assume il valore predefinito, sia nell'editor sia tramite create_automation. I timeout sono fissi invece che impostabili: una risposta AI ha 45 secondi e un webhook 20 secondi. Il nome di un'automazione può contenere fino a 120 caratteri. Un agente AI ha le proprie impostazioni: messaggi precedenti che legge, da 0 a 40 (predefinito 20), risposta più lunga da 100 a 4.000 token (predefinito 800), fino a 10 chiamate a strumenti per risposta (predefinito 5) e ore di passaggio a una persona, da 1 a 168 (predefinito 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.

Quale automazione risponde quando più corrispondono?

Al massimo una, scelta in un ordine fisso: prima Contiene parola chiave, poi Primo messaggio, poi Fuori orario, poi Ogni messaggio, e tra automazioni dello stesso tipo prima la più vecchia. Competono solo le automazioni Attive e non in pausa, quindi quando la regola con parola chiave è Disattivata, o in pausa per una chiave AI rifiutata, risponde invece quella generica. Due conseguenze sorprendono le persone. Un nuovo cliente che scrive di notte riceve l'automazione Primo messaggio, non quella Fuori orario, perché Primo messaggio ha precedenza. E un messaggio a cui risponde un'automazione con parola chiave non raggiunge mai un agente AI né un passo Rispondi con AI su Ogni messaggio, quindi inserisci l'agente o il passo AI nell'automazione con parola chiave se li vuoi entrambi. Un messaggio che risponde a un passo Fai una domanda aperto appartiene a quella domanda, e nessun'altra automazione parte da esso. Le automazioni con tag e webhook partono dai propri eventi e non partecipano a questo ordine.

Quali protezioni sono integrate?

Il runner le applica senza alcuna impostazione, e i motivi di salto nella scheda Esecuzioni le indicano quando fermano un'esecuzione:

  • Un messaggio che Meta consegna due volte avvia una sola esecuzione: i duplicati vengono scartati in base all'id del messaggio.
  • Reazioni, stati, gli invii della stessa automazione e i tuoi echi dall'app non avviano mai un'esecuzione.
  • Rispondi con testo, Fai una domanda, Invia un'immagine o un file, Rispondi con AI, la risposta di un agente e la risposta di un webhook richiedono che l'ultimo messaggio del cliente abbia meno di 24 ore; Invia un template no.
  • Una risposta che digiti nell'app WhatsApp Business mette in pausa l'automazione su quella chat, e un'esecuzione in attesa lì salta i passi rimanenti.
  • Un messaggio più recente che avvia la stessa automazione su una chat sostituisce l'esecuzione ancora in attesa in un passo Attendi; un messaggio che risponde a una domanda aperta va invece a quella domanda.
  • Gli invii da un numero sono distanziati di almeno 100 ms, sotto il limite di 20 al secondo di Meta per i numeri Coexistence.
  • Un passo fallito ti invia un'email, al massimo una volta ogni 6 ore per automazione; una chiave AI rifiutata mette in pausa le automazioni che usano quel provider e invia una sola email.

Cosa accetta lo strumento create_automation?

Il connettore MCP ha diciannove strumenti per le automazioni e per ciò che usano. Otto sono per le automazioni: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs e get_automation_run. Otto sono per agenti e file: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge e test_agent. Tre sono per le persone: list_conversations, get_conversation e update_contact. create_automation accetta connection_id (da list_numbers), name, enabled, trigger, steps e settings, in snake_case come keyword_mode e max_tokens; è accettato anche il camelCase. Gli oggetti passo sono reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} e wait {minutes}, poi 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} e stop. update_automation mantiene i campi che lasci fuori, e steps, se fornito, sostituisce l'intera lista. Gli errori indicano il campo, come "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". Le chiavi AI non passano mai attraverso MCP. Nell'esempio, l'attesa di 1 minuto fa sì che un cliente che invia più righe insieme riceva una sola risposta.

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

Errori comuni

  • Usare una parola chiave di due lettere con Contiene. «no» compare anche in «nome» e «notte», quindi l'automazione risponde a messaggi per cui non era pensata; usa È esatta, oppure una parola chiave più lunga.
  • Elencare solo la grafia con accento. La corrispondenza non distingue le maiuscole ma distingue gli accenti, quindi «città» non trova chi scrive «citta»; aggiungi entrambe.
  • Aspettarsi che Primo messaggio escluda i clienti abituali. Si attiva per qualsiasi cliente la cui chat easyCoexistence non ha visto da 30 giorni, quindi i clienti di lunga data ricevono il benvenuto al primo messaggio dopo che lo attivi.
  • Scegliere un template che richiede un'immagine nell'intestazione o un pulsante per copiare il codice. Le automazioni compilano solo le variabili del corpo, quindi l'editor lo elenca ma non ti permette di sceglierlo, e impostato via MCP l'invio viene rifiutato da Meta e l'esecuzione fallisce.
Farlo con EasyCoexistence

easyCoexistence esegue queste automazioni sul numero WhatsApp Business che continui a usare nell'app, tramite Cloud API di Meta e Coexistence. Creale nell'editor sotto Automazioni, Nuova automazione, oppure lascia che ChatGPT o Claude chiamino create_automation e test_automation tramite il connettore MCP, che ha più di 30 strumenti. Da US$ 9 a US$ 0,75 per numero al mese, in calo man mano che aggiungi numeri, con i primi 3 giorni di prova gratuita.

Domande frequenti

Un'automazione può ramificarsi in base a ciò che dice il cliente?

Sì. Dividi in percorsi (condition) crea rami in base al testo del messaggio, a un campo del contatto, a un tag, a una risposta API precedente o ai tuoi orari di apertura, e L'AI sceglie il percorso (ai_decide) sceglie in base al significato, in qualsiasi lingua, con il tuo modello. Ogni percorso contiene la propria linea di passi, e una linea Altrimenti raccoglie tutto il resto. Puoi anche affidare la decisione a n8n o al tuo backend con Chiama il mio webhook, che può restituire un diverso {"reply": "..."} per ogni caso.

Ci sono limiti alle automazioni o alle esecuzioni?

Non c'è un tetto alle esecuzioni né un costo extra per esse, e non c'è un limite al numero di automazioni per numero. I limiti che si applicano sono per chat: risposte AI all'ora, la regola delle 24 ore di Meta per il testo e la pausa dopo che rispondi dal telefono.

Posso spostare o copiare un'automazione su un altro numero?

Spostala cambiando la sua Connessione nell'editor, oppure con update_automation e un nuovo connection_id; le esecuzioni ancora in attesa sul vecchio numero terminano come «superseded». Per copiarla, chiedi alla tua AI di leggerla con list_automations e di creare gli stessi trigger e passi sull'altro numero.

Cosa succede alle esecuzioni in attesa quando modifico un'automazione?

Proseguono. Un'esecuzione ferma su un'Attesa riprende dal numero di passo successivo dell'automazione così come è salvata quando l'esecuzione si risveglia, quindi una modifica può cambiare cosa invia. Per fermarle, disattiva l'automazione: terminano come Saltate con «Automation is off».

Continua a leggere

Pronto per iniziare?

Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.

Inizia la prova gratuita

Verificato il