Glossario dell'automazione WhatsApp: trigger, step, presa in carico, finestra di 24 ore e altro
L'automazione WhatsApp ha un proprio lessico. Un trigger decide cosa avvia un'automazione: un messaggio, un tag o una chiamata webhook, gli step decidono cosa viene inviato in risposta, la presa in carico la sospende quando una persona risponde dal telefono, e la finestra di 24 ore stabilisce quando possono partire risposte diverse dai template. Template, opt-in, stati delle esecuzioni, motivi di salto e webhook firmati completano il quadro, e ogni termine qui occupa una riga.
easyCoexistence collega il tuo numero WhatsApp Business alla Cloud API di Meta tramite Coexistence ed esegue su di esso le automazioni con il lessico sopra: quattro criteri di selezione, 19 tipi di step, presa in carico quando rispondi dal telefono e un registro delle esecuzioni di 30 giorni con i motivi di salto.
Modi in cui un'automazione WhatsApp può selezionare i messaggi in arrivo: Ogni messaggio, Contiene parola chiave, Primo messaggio e Fuori orario.
Tipi di step su un numero, da Rispondi con testo e Invia un template a Fai una domanda, Dividi in percorsi e L'agente risponde.
Numero massimo di step che una riga di un'automazione può contenere, 60 in tutto, con diramazioni annidate fino a 4 livelli.
Finestra di servizio clienti di Meta: i messaggi diversi dai template sono consentiti solo entro 24 ore dall'ultimo messaggio del cliente.
Categorie di template di Meta: marketing, utility e autenticazione.
Motivi di salto che un'esecuzione può mostrare, da una risposta recente dal tuo telefono a una chiave AI che ha smesso di funzionare.
Quali termini descrivono la connessione alla base delle automazioni?
Le automazioni girano su un numero collegato all'API di Meta, mentre resta nell'app WhatsApp Business. Questi sei termini descrivono quella connessione e dove vanno i messaggi in arrivo del numero:
- Coexistence: l'onboarding di Meta che collega un numero già presente nell'app WhatsApp Business alla Cloud API, così app e software condividono numero e chat.
- Cloud API: l'API ospitata di Meta per inviare e ricevere messaggi WhatsApp Business; la via ufficiale per il software.
- Modalità in entrata: dove vanno i messaggi in arrivo di un numero, indicata nella sua pagina sotto Dove vanno i messaggi in arrivo come Tramite easyCoexistence o Direttamente al tuo sistema.
- Tramite easyCoexistence (gestita): Meta consegna a easyCoexistence, le automazioni e Conversazioni possono usare i messaggi e un Forward URL opzionale riceve una copia firmata.
- Direttamente al tuo sistema (diretta): Meta invia i messaggi del numero direttamente al tuo webhook, e le automazioni sono disattivate.
- Forward URL: il tuo endpoint HTTPS che riceve ogni modifica in arrivo di un numero gestito, firmata con X-EC-Signature.
Quali sono gli elementi base di un'automazione?
Un'automazione è un trigger e un flusso di step su un numero. Il trigger indica l'evento e la corrispondenza lo restringe; per priorità, una sola automazione risponde a un dato messaggio. Questi sono i nomi che usa l'editor sotto «Quando arriva un messaggio»:
- Automazione: un trigger e un flusso di al massimo 30 step per ramo, 60 in tutto, su un numero, attivati o disattivati insieme.
- Trigger: l'evento che avvia un'automazione; su un numero WhatsApp, Arriva un messaggio, Un contatto riceve un tag o Il tuo sistema chiama un URL.
- Ogni messaggio: la corrispondenza generica, per qualsiasi cosa scriva il cliente.
- Contiene parola chiave: si avvia quando il messaggio corrisponde a una delle fino a 30 parole chiave; le maiuscole non contano.
- Modalità parola chiave: Contiene (in qualsiasi punto del messaggio), Inizia con (all'inizio) oppure È esattamente (l'intero messaggio).
- Primo messaggio: si avvia su una chat senza cronologia, incluso il primo messaggio di un cliente abituale dopo l'attivazione delle automazioni, oppure dopo circa 30 giorni di silenzio.
- Fuori orario: si avvia mentre sei chiuso, in base a un Fuso orario, Aperto nei giorni e agli orari Da / A in formato 24 ore.
- Priorità: l'ordine che sceglie un'automazione: parola chiave, poi Primo messaggio, poi Fuori orario, poi la corrispondenza generica, dalla più vecchia.
Che cosa significa ciascun tipo di step?
Gli step girano in ordine, dall'alto in basso, dopo il blocco Trigger, e due di essi si diramano: Dividi in percorsi (con regole su testo, campi, tag od orari) e L'AI sceglie il percorso (in base al significato) contengono ciascuno un ramo di step per ogni percorso più un ramo Altrimenti. Un ramo contiene fino a 30 step, 60 in tutto, con diramazioni annidate fino a 4 livelli. Un numero dispone di 19 tipi di step; oltre a quelli qui sotto, l'editor offre Fai una domanda (fino a 3 pulsanti toccabili, attende la risposta e la salva in un campo del contatto), L'agente risponde, Passa a una persona (mette in pausa il bot sulla chat e ti invia un'email), Avvisami, Invia un'immagine o un file, Salva nel contatto, Tag, L'AI salva i dettagli, Chiama un'API, Avvia automazione e Torna a uno step. Questi sono i tipi di step principali e i loro nomi:
- Rispondi con testo: un messaggio fisso di fino a 4.096 caratteri, inviato così come è scritto.
- Variabili: {{
first_name}}, {{name}}, {{message}} e {{phone}}, più {{contact.field}} per un campo salvato del contatto e {{vars.name}} per la risposta di uno step precedente, riempite quando lo step viene eseguito. - Invia un template: invia un template approvato del numero, con variabili posizionali nel corpo; funziona anche fuori dalla finestra di 24 ore.
- Rispondi con AI: il tuo modello, con la tua chiave di Anthropic, OpenAI o OpenRouter, scrive la risposta.
- Istruzioni: il prompt dello step AI, o di un agente, fino a 20.000 caratteri; un agente può attingere anche a file di conoscenza, link e testo.
- Chiama il mio webhook: invia il messaggio e fino a 10 messaggi recenti della chat al tuo URL, e attende una risposta restituita entro 20 secondi.
- Attesa: sospende l'esecuzione da 1 a 1.380 minuti, cioè 23 ore, prima dello step successivo.
- Termina: chiude l'esecuzione; ammesso solo come ultimo step del suo ramo.
Quali regole e limiti hanno un nome proprio?
Alcune parole vengono da Meta e valgono per ogni azienda su WhatsApp; altre sono impostazioni sotto Avanzate nell'editor delle automazioni. Entrambe decidono se una risposta parte, quindi conviene conoscerle per nome:
- Finestra di 24 ore: la finestra di servizio clienti di Meta; i messaggi diversi dai template sono consentiti solo entro 24 ore dall'ultimo messaggio del cliente.
- Template: un formato di messaggio che Meta verifica in anticipo, nelle categorie marketing, utility o autenticazione; serve per scrivere per primi o dopo 24 ore.
- Opt-in: la persona ti ha fornito il suo numero e ha accettato di ricevere i tuoi messaggi, condizione che Meta richiede prima di scrivere per primi.
- Eco: il webhook
smb_message_echoesdi Meta, che segnala un messaggio inviato da te dall'app o da un dispositivo collegato. - Presa in carico: la pausa dopo che rispondi dal telefono o da Conversazioni, impostata in «Pausa su una chat dopo la mia risposta (ore)», 4 per impostazione predefinita, da 0 a 168.
- Limite di risposte AI: «Risposte AI per chat all'ora, al massimo», 10 per impostazione predefinita, da 1 a 60.
- Token: le unità che i provider AI fatturano; «Risposta più lunga (token)» limita una risposta, 600 per impostazione predefinita, da 50 a 2.000.
- Regola dei 14 giorni: Meta disconnette un numero in Coexistence la cui app non viene aperta sul telefono per circa 14 giorni.
Che cosa significano i termini del registro delle esecuzioni?
Ogni volta che un'automazione parte su un messaggio, lascia un'esecuzione nella scheda Esecuzioni, conservata per 30 giorni, con l'output, i tempi e i token di ogni step. Queste parole spiegano ciò che vedi lì:
- Esecuzione: un'esecuzione di un'automazione su un messaggio in arrivo, un tag o una chiamata webhook, oppure su un test.
- Stato dell'esecuzione: In coda, In esecuzione, In attesa (bloccata in uno step Attesa), Completata, Fallita o Saltata.
- Motivo di salto: perché un'esecuzione si è fermata di proposito, per esempio «Hai risposto a questa chat dal telefono di recente».
- Testa o Prova: esegue gli step salvati su un messaggio di esempio; non viene inviato nulla, ma AI e webhook vengono eseguiti davvero.
- In pausa: lo stato di un'automazione la cui chiave AI è stata rifiutata dal provider; riparte quando salvi una chiave funzionante.
- Sostituita: un'esecuzione in attesa annullata perché un nuovo messaggio del cliente ha riavviato la stessa automazione.
Errori comuni
- Confondere «In pausa» con «Disattivata». In pausa significa che la chiave AI ha smesso di funzionare; l'automazione riparte da sola quando salvi una chiave funzionante, mentre Disattivata resta tale finché non la riattivi.
- Trattare il messaggio di assenza dell'app e Fuori orario come se fossero la stessa cosa. Il primo vive nell'app del telefono e il software non lo vede; il secondo è un'automazione lato API.
- Aspettarsi che Primo messaggio si attivi solo per contatti nuovi di zecca. Si attiva su ogni chat senza cronologia salvata, clienti abituali compresi.
Creale tu nell'editor oppure chiedendolo alla tua AI, con la tua chiave. Da US$ 9 a US$ 0,75 per numero al mese, con il prezzo che scende man mano che aggiungi numeri, con i primi 3 giorni di prova gratuita.
Domande frequenti
Qual è la differenza tra un'automazione e un agente AI?
Un'automazione è un trigger con step, anche quando si dirama: ogni percorso è uno che hai disegnato tu. Un agente AI decide da solo la prossima azione. Uno step L'agente risponde inserisce uno dei tuoi agenti dentro un'automazione, con le sue istruzioni, la sua conoscenza e strumenti come salvare un campo del contatto o passare la chat a una persona, mentre uno step Rispondi con AI scrive soltanto la risposta. Un agente tutto tuo può stare anche dietro a Chiama il mio webhook o a un Forward URL.
Dove compaiono questi termini nella dashboard?
I criteri di selezione e le modalità parola chiave si trovano nel blocco Trigger dell'editor delle automazioni, e gli step nel menu + tra i blocchi. Presa in carico e limite di risposte AI sono sotto Avanzate, le esecuzioni e i motivi di salto nella scheda Esecuzioni, e la modalità in entrata nella pagina del numero.
Quali di questi termini vengono da Meta?
Coexistence, Cloud API, la finestra di 24 ore, i template e le loro categorie, opt-in, eco e la regola dei 14 giorni sono di Meta. Criteri di selezione, step, presa in carico, stati delle esecuzioni, motivi di salto e X-EC-Signature sono nomi usati nella dashboard e nell'API di easyCoexistence.
Che cosa significa X-EC-Signature?
È l'intestazione che dimostra che una chiamata al webhook o un inoltro arriva da easyCoexistence: t=<unix seconds>,v1=<HMAC-SHA256 di «<t>.<body>»> calcolato con un segreto che solo tu conosci. Il tuo server lo ricalcola e lo confronta prima di fidarsi della richiesta.
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 gratuitaVerificato il