Riferimento dei workflow

Questa pagina elenca tutto ciò che puoi usare in un workflow e spiega esattamente come si comporta. Per imparare a crearne uno passo dopo passo, inizia da Workflow e automazione.

Come viene eseguito un workflow

Un workflow è un insieme di passaggi. Ogni passaggio è una regola: trigger → condizioni → azioni.

Succede qualcosa: un cliente invia un messaggio, viene chiamato un webhook, un follow-up arriva alla scadenza e così via.
Wabot trova i passaggi il cui trigger corrisponde. Per i messaggi devono corrispondere anche il canale e il tipo di messaggio. Vengono controllati solo i passaggi attivi, all’interno di workflow attivi.
Ogni passaggio corrispondente controlla le sue condizioni. Se non ha condizioni, viene sempre eseguito.
Ogni passaggio le cui condizioni sono soddisfatte esegue le sue azioni, dall’alto verso il basso. Non vale la regola “vince la prima corrispondenza”: se due passaggi corrispondono allo stesso messaggio, vengono eseguiti entrambi, senza un ordine garantito. Il pannello Configurazione ti avvisa quando due passaggi partono dallo stesso messaggio.
Se nessun passaggio è stato eseguito per il messaggio di un cliente, risponde il tuo bot IA (se l’IA è attiva per il canale e per il contatto). Se è stato eseguito anche un solo passaggio, anche uno che aggiunge soltanto un tag, il bot IA non risponde a quel messaggio.

Azioni

Le azioni vengono eseguite nell’ordine in cui sono elencate. Se una non riesce, le successive vengono eseguite comunque.
Attendi prima di inviare è in secondi e si conta dal momento in cui è avvenuto il trigger, non dall’azione precedente. Per inviare tre messaggi a un giorno di distanza l’uno dall’altro, usa 0, 86400 e 172800.
I messaggi in attesa vengono conservati in modo sicuro e vengono inviati anche se il server si riavvia. Non vengono annullati se il cliente risponde o se disattivi il passaggio, quindi mantieni brevi le sequenze lunghe.
Solo Invia un modello e Invia un messaggio possono attendere. Tutte le altre azioni vengono eseguite subito.
I messaggi in formato libero (Invia un messaggio) arrivano solo entro 24 ore dall’ultimo messaggio del cliente. Fuori da questa finestra, usa Invia un modello.

Passaggi successivi

Un passaggio collegato da una linea passaggio successivo (la condizione Workflow precedente nell’editor a moduli) viene eseguito solo se il passaggio precedente è già stato eseguito con successo per lo stesso contatto.

Ha comunque bisogno di un proprio trigger, ad esempio il messaggio successivo del cliente o il tocco di un pulsante. Non parte da solo dopo il passaggio precedente.
Non c’è un limite di tempo: il passaggio precedente può essere stato eseguito un’ora o un mese fa.
Una volta sbloccato, il passaggio viene eseguito ogni volta che il suo trigger e le sue condizioni corrispondono.
Se più passaggi portano a esso, devono essere stati eseguiti tutti.
Se il passaggio precedente e quello successivo corrispondono entrambi allo stesso messaggio, possono essere eseguiti entrambi su di esso. Dai al passaggio successivo un trigger diverso, come il tocco di un pulsante.

Esecuzioni e risultati

Esecuzioni mostra, per ogni passaggio, per chi è stato eseguito e il risultato di ogni azione. Un messaggio risulta riuscito non appena viene consegnato a WhatsApp. Se WhatsApp lo rifiuta in seguito (ad esempio fuori dalla finestra di 24 ore), l’errore compare nella chat, non in Esecuzioni.

I passaggi che partono dall’orologio (Nessuna risposta per un po’, Follow-up in scadenza), da Fase della pipeline cambiata o da un’integrazione inviano dal tuo numero WhatsApp predefinito. Nessuna risposta per un po’ usa il numero su cui si trovava la conversazione, se è ancora collegato.

Trigger

Trigger	Viene eseguito quando…	Impostazioni	Fornisce queste variabili
Il cliente invia un messaggio	Un cliente ti invia un messaggio su WhatsApp, Instagram o Messenger	Canale, tipo di messaggio, testo da cercare facoltativo	`senderName`, `senderID` e altre in base al tipo di messaggio (vedi Variabili)
Il messaggio viene consegnato o letto	Un qualsiasi messaggio che hai inviato (da un workflow, una campagna, la posta in arrivo o il bot IA) risulta inviato, consegnato o letto	Nessuna: usa le condizioni Stato e Modello	Nessuna
Avviato manualmente	Lo avvii tu per contatti o gruppi scelti, da Contatti, da un modulo per lead di Meta o da Avvia un altro workflow	Nessuna	Nessuna (vedi Avviato manualmente)
Fase della pipeline cambiata	Una scheda viene aggiunta a una pipeline o passa a un’altra fase	Pipeline, tipo di fase, dalla fase, alla fase	`deal_title`, `stage_name` e altre
Nessuna risposta per un po’	Una conversazione resta in silenzio per il tempo che imposti	Di chi attendere la risposta, quanto a lungo	`waiting_hours`, `waiting_since`
Follow-up in scadenza	Un’attività di follow-up arriva alla scadenza, o è ancora aperta qualche tempo dopo	Quando, quanto in ritardo	`followup_text`, `followup_due_at`, `followup_assignee`, `followup_overdue_hours`
Viene chiamato un webhook	Un altro sistema invia una `POST` con un corpo JSON all’URL del passaggio	L’URL (visibile dopo il primo salvataggio)	I campi del corpo JSON, mappati in Variabili
L’azione webhook riceve una risposta	Un’azione Invia a un webhook o Esegui codice in un altro passaggio riceve una risposta	Aggiungi risposta di esempio per trasformare i campi della risposta in variabili	`response` e ogni campo della risposta
Eventi delle integrazioni (ad es. ordine creato in Shopify, checkout abbandonato)	Un’integrazione collegata segnala l’evento	Nessuna	I campi dell’evento

Il cliente invia un messaggio

Completa la frase Quando un cliente invia su canale un messaggio di tipo tipo di messaggio alla tua attività che tipo di corrispondenza testo.

Canali: WhatsApp, Instagram e Messenger. Per Instagram, scegli anche come è collegato: Login Instagram o Pagina Facebook (la stessa opzione che hai usato quando l’hai collegato).

Tipi di messaggio

Canale	Tipi di messaggio
WhatsApp	Testo, Messaggio da annuncio Click-to-WhatsApp, Pulsanti interattivi di risposta rapida, Messaggio con elenco interattivo, Immagine, Video, Documento, Audio, Flow, Ordine, Pagamento
Instagram	Testo, Risposta rapida, Postback, Commento, Immagine, Video, Documento, Audio
Messenger	Testo, Risposta rapida, Postback, Commento, Opt-in, Coupon, Immagine, Video, Documento, Audio

Tipo di messaggio WhatsApp	Viene eseguito quando il cliente…	Note
Testo	Scrive un messaggio
Messaggio da annuncio Click-to-WhatsApp	Invia il primo messaggio dal tuo annuncio Click-to-WhatsApp	Aggiunge le variabili dell’annuncio. Se nessun passaggio per annunci corrisponde, rispondono i passaggi Testo
Pulsanti interattivi di risposta rapida	Tocca un pulsante di risposta, in un messaggio di un workflow o in un modello	Il confronto avviene sul titolo del pulsante. `button_reply_identifier` contiene ciò che è stato toccato
Messaggio con elenco interattivo	Sceglie una riga da un elenco	Il confronto avviene sul titolo della riga
Immagine, Video, Documento, Audio	Invia quel tipo di file	La didascalia è il testo del messaggio. Per l’audio, il testo è la trascrizione, se il tuo piano la include
Flow	Invia un WhatsApp Flow	Scegli il flow in Seleziona un flow. Ogni campo del modulo diventa una variabile
Ordine	Effettua un ordine dal tuo catalogo	Usa la condizione Importo totale per controllare il valore dell’ordine
Pagamento	Paga (o non riesce a pagare) un ordine dal catalogo	`status` è `success`, `failed` o `pending`. I pagamenti delle richieste di pagamento personalizzate non avviano questo trigger

Sticker, posizioni condivise, contatti condivisi e reazioni non avviano i workflow.

Testo da cercare: contiene, è esattamente, inizia con o non è. Lascialo vuoto per eseguirlo su ogni messaggio di quel tipo. Il confronto distingue tra maiuscole e minuscole (Prezzo non corrisponde a prezzo) e gli spazi contano. Per le risposte tramite pulsante o elenco, il testo è il titolo del pulsante o della riga.

Il messaggio viene consegnato o letto

Viene eseguito per ogni aggiornamento di stato di ogni messaggio che invii, comprese le campagne e i messaggi del passaggio stesso. Aggiungi sempre due condizioni:

Stato: Inviato, Consegnato o Letto.
Modello: il modello a cui stai dando seguito.

Senza di esse il passaggio viene eseguito per ogni messaggio dell’account, e un passaggio che invia un messaggio può riattivarsi da solo.

Fase della pipeline cambiata

Impostazione	Opzioni
Pipeline	La pipeline da monitorare (obbligatoria)
Solo quando la nuova fase è	Aperta, Vinta, Persa (nessuna selezionata = qualsiasi)
Dalla fase	Qualsiasi fase (include le nuove schede) o una fase
Alla fase	Qualsiasi fase o una fase

Un cambio di fase fatto da un workflow avvia altri workflow di pipeline solo per un livello, così due workflow non possono continuare a spostare una scheda avanti e indietro. Richiede che le pipeline siano attive in Impostazioni → Pipeline.

Nessuna risposta per un po’

Impostazione	Opzioni
Avvia quando	Il cliente non ha risposto (dopo qualsiasi messaggio che gli invii, comprese le campagne) o Nessuno ha risposto al cliente (conta qualsiasi risposta del tuo team, del bot IA o di un workflow)
Dopo nessuna risposta per	Da 5 minuti a 30 giorni

Ogni nuovo messaggio fa ripartire l’attesa. Viene eseguito una volta per ogni silenzio: dopo essere stato eseguito per un contatto, non verrà eseguito di nuovo finché l’altra parte non scrive. Poiché anche gli invii di massa avviano l’attesa lato cliente, aggiungi una condizione come Contatto di un gruppo per limitarlo.

Follow-up in scadenza

Impostazione	Opzioni
Avvio	Quando scade, oppure Quando è ancora aperto dopo la scadenza
In ritardo di	Da 5 minuti a 30 giorni (per la seconda opzione)

Viene eseguito una volta per ogni follow-up, per tutti i follow-up dell’account (compresi quelli creati a mano e dai workflow) collegati a un contatto. Nel caso “ancora aperto”, non succede nulla se il follow-up è stato completato in tempo.

Viene chiamato un webhook

Invia una POST con un corpo JSON all’URL. Wabot risponde subito ed esegue il passaggio in background.
Il passaggio viene eseguito solo quando sono attivi sia il suo interruttore sia quello del workflow, e quando le sue condizioni sono soddisfatte. Le condizioni possono usare Variabile e Workflow precedente.
Mappa i campi del corpo in Variabili con percorsi che iniziano con body., ad esempio body.phone per {"phone": "919876543210"}.
Indica alle azioni a chi inviare il messaggio con Variabile del numero di telefono, ad es. {{phone}}. Il numero deve includere il prefisso internazionale. Una variabile chiamata name dà il nome a un nuovo contatto.
Scegli il numero da cui inviare con Seleziona canale, oppure lascialo vuoto per usare il numero predefinito.
Per un’immagine, un documento o un video, inserisci il link pubblico del file in Variabile URL: una variabile come {{invoice}}, un link fisso come https://example.com/brochure.pdf o un link con variabili come https://example.com/invoices/{{order_id}}.pdf.
Passa a un bot IA e Salva dati qui non fanno nulla: non c’è un messaggio del cliente a cui rispondere né un ordine da salvare.
I messaggi in formato libero arrivano solo entro la finestra di 24 ore; per raggiungere un nuovo cliente, invia un modello.

L’azione webhook riceve una risposta

Si avvia dopo che un’azione Invia a un webhook o Esegui codice riceve una risposta. Incolla una risposta di esempio con Aggiungi risposta di esempio: ogni campo diventa una variabile, ad es. {{response}} per l’intera risposta o {{order_id}} per response.order_id. Conta anche una risposta con un codice di errore (4xx o 5xx). Un timeout no.

Condizioni

Le condizioni sono controlli aggiuntivi in Avanzate → Condizioni. Il passaggio viene eseguito solo se sono soddisfatte.

Cosa puoi controllare

Condizione	Controlla	Confronti	Disponibile con
Contenuto del messaggio	Il testo del messaggio, il titolo del pulsante o della riga, o la didascalia	è, non è, contiene, non contiene, inizia con	Il cliente invia un messaggio, Il messaggio viene consegnato o letto
Messaggio con tag	I tag della conversazione sul messaggio	è uno qualsiasi tra, non è nessuno tra	Il cliente invia un messaggio
Contatto di un gruppo	I gruppi del contatto	è uno qualsiasi tra, non è nessuno tra	Il cliente invia un messaggio, Avviato manualmente, Fase della pipeline cambiata, Nessuna risposta per un po’, Follow-up in scadenza
Canale	Il numero, l’account Instagram o la Pagina da cui è arrivato il messaggio	è uno tra, non è nessuno tra	Il cliente invia un messaggio, Il messaggio viene consegnato o letto
Variabile	Una qualsiasi delle variabili del passaggio	è, non è, contiene, non contiene, inizia con, è maggiore di, è minore di	Tutti i trigger tranne Avviato manualmente e Il messaggio viene consegnato o letto
Importo totale	Il totale dell’ordine (prezzo × quantità di ogni articolo)	è, non è, è maggiore di, è minore di	Il cliente invia un messaggio → Ordine
Stato	Lo stato del messaggio: Inviato, Consegnato, Letto	è uno qualsiasi tra, non è nessuno tra	Il messaggio viene consegnato o letto
Modello	Quale modello era il messaggio	è uno qualsiasi tra, non è nessuno tra	Il messaggio viene consegnato o letto
Prompt soddisfatto	Se la conversazione raggiunge un obiettivo che descrivi, verificato dall’IA	è soddisfatta, non è soddisfatta	Il cliente invia un messaggio
Workflow precedente	Se i passaggi precedenti sono stati eseguiti per questo contatto (vedi Passaggi successivi)	è	Tutti i trigger tranne Avviato manualmente

Come funzionano i confronti

Confronto	Vero quando…
è / non è	Il valore è esattamente il testo che hai inserito, oppure no. Distingue tra maiuscole e minuscole, gli spazi contano
contiene / non contiene	Il testo compare in un punto qualsiasi del valore, oppure no. Distingue tra maiuscole e minuscole. Un valore vuoto non contiene nulla
inizia con	Il valore inizia con il testo. Distingue tra maiuscole e minuscole
è uno qualsiasi tra / non è nessuno tra	Vale almeno uno degli elementi scelti, oppure nessuno
è uno tra / non è nessuno tra	(Canale) il messaggio è arrivato su uno dei canali scelti, oppure su nessuno di essi
è maggiore di / è minore di	Entrambi i lati sono numeri e il confronto è vero. Simboli di valuta e separatori delle migliaia vengono ignorati (`₹1,250.50` = 1250.5). Se uno dei due lati non è un numero, è falso
è soddisfatta / non è soddisfatta	L’IA giudica che la conversazione raggiunge l’obiettivo, oppure no. Ogni controllo usa una richiesta all’IA

Gruppi ed E / O

Le regole all’interno di un gruppo sono unite con E (devono essere tutte vere) oppure O (ne basta una). I gruppi si uniscono allo stesso modo. Fino a 6 gruppi per passaggio.
Le unioni si leggono da sinistra a destra: A E B O C significa (A E B) O C. Per combinarle diversamente, usa i gruppi.
Un’unione mancante vale come E.
Una O accanto a una regola Workflow precedente consente al passaggio di essere eseguito senza il passaggio precedente. Mantieni il collegamento unito con E.

Azioni

Azione	Cosa fa	Può attendere?
Invia un modello	Invia un modello WhatsApp approvato al cliente o a un altro numero	Sì
Invia un messaggio	Invia un messaggio in formato libero: testo, media, pulsanti, un elenco, un catalogo, un flow o una richiesta di pagamento (entro la finestra di 24 ore)	Sì
Aggiungi a gruppi o tag	Aggiunge il contatto a gruppi e tag	No
Segna come lead	Contrassegna il contatto come lead, così viene conteggiato nei report sui lead	No
Assegna a un membro del team	Affida la chat a un collega, a rotazione, al meno occupato, oppure rimuove l’assegnazione	No
Crea follow-up	Aggiunge un’attività alla pagina Follow-up	No
Sposta la trattativa in una fase	Sposta la scheda del contatto in una fase, e può crearne una	No
Crea trattativa	Aggiunge una scheda per il contatto a una pipeline	No
Segna la trattativa come vinta o persa	Sposta la scheda nella prima fase vinta o persa della pipeline	No
Cambia il responsabile della trattativa	Affida la scheda a un collega o all’assegnatario della chat	No
Aggiorna il valore della trattativa	Imposta il valore della scheda su un numero o una variabile	No
Passa a un bot IA	Lascia che un bot IA risponda alla conversazione	No
Invia a un webhook	Invia dati all’URL di un altro sistema (REST o GraphQL)	No
Esegui codice	Esegue il tuo JavaScript e ne trasmette il risultato	No
Salva dati	Aggiunge i dati del messaggio all’ordine del cliente	No
Aggiorna un valore di stato	Conserva un valore per contatto o per workflow per i passaggi successivi	No
Ripeti un passaggio	Esegue di nuovo le azioni di un altro passaggio per questo contatto	No
Avvia un altro workflow	Esegue un workflow Manuale per questo contatto	No
Azioni delle integrazioni (ad es. Shopify)	Usano l’integrazione collegata	No

Invia un modello

Impostazione	Cosa fa
Invia a	Il cliente (che ha avviato il passaggio) o Un altro numero (con prefisso internazionale, solo cifre)
Modello	Qualsiasi modello approvato
Attendi prima di inviare	Secondi, dal momento del trigger
Variabili	Compila ogni variabile del modello. Per Nome scegli Nome del cliente, Telefono del cliente o Altro; per Email Email del cliente; per le variabili personalizzate digita il valore, oppure esattamente una variabile come `{{senderName}}`
Media	L’immagine, il video o il documento dell’intestazione, per i modelli che ne hanno uno

Una variabile personalizzata deve essere esattamente una {{variable}}. Il testo intorno, come in Hi {{senderName}}, viene inviato così come è scritto. Le variabili di stato e le risposte dei Flow non si possono usare nei modelli. Un valore mancante non viene controllato prima dell’invio, quindi WhatsApp potrebbe rifiutare il messaggio.

Invia un messaggio

Tipo di messaggio	Cosa imposti	Limiti
Solo testo	Il testo	4096 caratteri
Con media	Un file (immagine, video, documento o audio) e la sua didascalia	Didascalia 1024
Risposta rapida	Intestazione (testo, immagine, video o documento), testo e pulsanti	Fino a 3 pulsanti, 20 caratteri ciascuno
Call to action	Intestazione, testo e un pulsante con un link	Pulsante 20 caratteri
Elenco interattivo	Intestazione, corpo, piè di pagina, sezioni con righe (titolo e descrizione) e l’etichetta del pulsante	Titolo della riga 24, descrizione 72
Catalogo	Un solo prodotto, più prodotti o l’intero catalogo, con un testo	Richiede un catalogo collegato al numero
Flow	Intestazione, corpo, piè di pagina, il flow e il testo del suo pulsante	Pulsante 25 caratteri
Pagamento	Pagamento del catalogo per l’ordine appena effettuato, oppure Pagamento personalizzato con articoli e importi tuoi	Razorpay. I pagamenti personalizzati sono in INR

Instagram e Messenger hanno tipi propri: Solo testo, Con media, Risposta rapida, Modello generico, Modello con pulsanti, Risposta al commento (a un commento) e, su Messenger, anche i modelli Coupon, Ricevuta, Prodotto e Opt-in.

Le variabili funzionano nel testo e nella didascalia. Se una variabile usata lì manca o è vuota (o 0), il messaggio non viene inviato e l’esecuzione risulta non riuscita. Intestazioni, piè di pagina, pulsanti e righe dell’elenco vengono inviati così come sono scritti.

Invia a un webhook

Impostazione	Cosa fa
Tipo di API	REST o GraphQL
URL	Dove inviare. Può contenere `{{variables}}`
Metodo	POST o GET (GET non invia un corpo)
Header	Coppie chiave e valore. `{{name}}` in un header indica un valore di stato
Inserisci i dati come	Parametri del corpo, Parametri di query o Parametri di percorso (REST)
Payload / Query GraphQL e Variabili	Il JSON da inviare. Le `{{variables}}` al suo interno vengono compilate; quelle sconosciute vengono inviate così come sono scritte

La richiesta va in timeout dopo 15 secondi. Per usare la risposta, avvia un altro passaggio con L’azione webhook riceve una risposta.

Azioni del team

Assegna a un membro del team

Impostazione	Opzioni
Come scegliere	Un collega specifico, A rotazione (a turno), Meno occupato (meno chat in attesa di risposta), Rimuovi assegnazione
Collega/Colleghi	Uno, oppure due o più per la rotazione e il meno occupato
Solo se la chat non è ancora assegnata	Lascia stare le chat che hanno già qualcuno
Mantieni attive le risposte del bot IA	Disattivato: l’assegnazione disattiva il bot IA per quella chat

Crea follow-up

Impostazione	Opzioni
Follow-up	Cosa fare, fino a 160 caratteri. Può usare `{{name}}` (il nome del contatto) e le variabili del trigger
Scadenza tra	Da 0 a 365 minuti, ore o giorni
Per	L’assegnatario della chat (o il proprietario dell’account), Un collega specifico o Nessuno
Collegalo alla scheda aperta della pipeline del contatto, se esiste	Mostra il follow-up anche sulla scheda

Segna come lead non ha impostazioni.

Azioni della pipeline

Richiedono tutte una Pipeline. Quando il passaggio è stato avviato da Fase della pipeline cambiata, modificano quella scheda. Altrimenti modificano la scheda aperta del contatto aggiornata più di recente in quella pipeline, e non fanno nulla se non ce n’è una.

Azione	Impostazioni
Sposta la trattativa in una fase	Sposta nella fase; Creane una in questa fase se il contatto non ha schede aperte (con un prodotto e una quantità facoltativi)
Crea trattativa	Fase (predefinita: la prima fase aperta), Titolo (può usare variabili; vuoto = nome del contatto ed etichetta della scheda), Valore, Responsabile, prodotto e quantità, Salta se il contatto ha già una scheda aperta in questa pipeline (attivo per impostazione predefinita)
Segna la trattativa come vinta o persa	Vinta o Persa
Cambia il responsabile della trattativa	Un collega specifico o L’assegnatario della chat
Aggiorna il valore della trattativa	Un numero o una variabile, ad es. `{{order_total}}`. `₹1,250.50` viene letto come 1250.5

Passa a un bot IA

Impostazione	Cosa fa
Seleziona bot IA	Il bot che subentra
Tempo di inattività e Unità di tempo	Per quanto tempo il cliente può restare in silenzio prima che il bot restituisca la conversazione
Numero di solleciti di risposta	Quante risposte prima che il bot chieda se il cliente è soddisfatto
Messaggio di uscita	Inviato quando trascorre il tempo di inattività, con i pulsanti Sì e No

Il bot risponde subito al messaggio attuale, se l’IA è attiva per il canale e per il contatto e il messaggio contiene testo. Finché non trascorre il tempo di inattività o il cliente non tocca Sì, i suoi messaggi che non corrispondono a un altro passaggio vanno a questo bot.

Dati e controllo del workflow

Azione	Impostazioni e comportamento
Esegui codice	Il tuo JavaScript. Al suo interno si possono usare le variabili del passaggio, ad es. `{{senderName}}` o un campo del webhook come `{{order_id}}`. Il suo risultato avvia qualsiasi passaggio L’azione webhook riceve una risposta collegato
Salva dati	Ordini: aggiunge i dati del messaggio in arrivo (come un indirizzo da un Flow) all’ordine del cliente
Aggiorna un valore di stato	Seleziona una variabile di stato e Valore (una delle variabili del passaggio). Un valore vuoto non riesce
Ripeti un passaggio	Esegue di nuovo le azioni del passaggio scelto per questo contatto, senza controllarne le condizioni. Non far puntare un passaggio a se stesso
Avvia un altro workflow	Esegue il workflow Manuale che scegli per questo contatto, dal numero che scegli

Variabili

Scrivi una variabile come {{name}}. La sezione Variabili di un passaggio elenca quelle che puoi usare, con un pulsante di copia.

Variabili integrate

Variabile	Valore	Aggiunta da
`senderName`	Il nome del profilo WhatsApp del cliente	Il cliente invia un messaggio, L’azione webhook riceve una risposta
`senderID`	Il numero di telefono del cliente	Come sopra
`button_reply_identifier`	Il pulsante che è stato toccato	Pulsanti interattivi di risposta rapida
`ad_headline`, `ad_body`, `ad_source_url`, `ad_source_id`, `ad_source_type`, `ctwa_clid`	I dettagli dell’annuncio su cui il cliente ha fatto clic	Messaggio da annuncio Click-to-WhatsApp
Ogni campo del Flow, ad es. `{{preferred_date}}`	La risposta del cliente	Flow
`status`	`success`, `failed` o `pending`	Pagamento
`response` e ogni campo della risposta	La risposta del webhook o di Esegui codice	L’azione webhook riceve una risposta (dopo Aggiungi risposta di esempio)
Ogni campo dell’evento	I dati dell’evento	Trigger delle integrazioni
`deal_id`, `deal_title`, `deal_value`, `deal_currency`, `pipeline_name`, `stage_name`, `previous_stage_name`, `owner_name`, `deal_items`	La scheda che si è spostata	Fase della pipeline cambiata
`waiting_hours`, `waiting_since`	Da quanto tempo e da quando la conversazione è in silenzio	Nessuna risposta per un po’
`followup_text`, `followup_due_at`, `followup_assignee`, `followup_overdue_hours`	Il testo, la scadenza, l’assegnatario e le ore di ritardo del follow-up	Follow-up in scadenza
`name`	Il nome del contatto (o il numero)	Sempre, nel testo del follow-up e nel titolo e nel valore della trattativa

Le tue variabili

Fai clic su Aggiungi variabile in Avanzate → Variabili. I nomi usano lettere, numeri e _, e iniziano con una lettera.

Origine	Valore	Esempio
Dai dati del trigger	Un percorso nei dati del trigger. La prima parte indica da dove provengono (`messageMetadata.`, `body.`, `response.`, `timer.`), il resto è il campo	`body.customer.email` legge `customer.email` dal corpo di un webhook
Valore fisso	Lo stesso testo ogni volta	Un codice sconto

Le variabili che aggiungi vengono mantenute quando cambi il trigger, il canale o il tipo di messaggio.

Variabili di stato

Gli stati conservano un valore per contatto (o per workflow) tra un passaggio e l’altro e nel tempo, ad esempio la lingua scelta dal cliente. Creali da Stati nel menu della scheda di un workflow: Stato (il nome), Valore (il valore predefinito), Tipo (ad es. Stato del contatto) e Tipo di dato. Ogni passaggio può usarli come {{state}}; impostali con Aggiorna un valore di stato. Funzionano nei messaggi, nelle condizioni e nei webhook, ma non nei modelli.

Dove funzionano le variabili

Dove	Cosa è disponibile	Se un valore manca
Testo e didascalia di Invia un messaggio	Tutto: dati del trigger, risposte dei Flow, le tue variabili, stati	Il messaggio non viene inviato (non riuscito)
Variabili di Invia un modello	Dati del trigger e le tue variabili (non le risposte dei Flow né gli stati)	Inviato vuoto, oppure così come è scritto se non è una delle variabili del passaggio; WhatsApp potrebbe rifiutarlo
URL e payload di Invia a un webhook	Tutto	Inviato così come è scritto, ad es. `{{phone}}`
Condizione Variabile	Tutto	La condizione confronta un valore vuoto
Testo di Crea follow-up, titolo di Crea trattativa, Aggiorna il valore della trattativa	`name`, le variabili del trigger (webhook, timer, pipeline, integrazione), le tue variabili, stati	Lasciato vuoto
Aggiorna un valore di stato	Dati del trigger, le tue variabili, stati	L’azione non riesce
Esegui codice	Dati del trigger (compresi il body o la risposta di un webhook), le tue variabili, stati	`undefined`

Avviato manualmente

I workflow manuali vengono eseguiti per i contatti o i gruppi che scegli, da Contatti (Avvia workflow), da un modulo per lead di Meta o da Avvia un altro workflow. Funzionano in modo diverso da quelli automatici:

Vengono usate solo le condizioni Contatto di un gruppo (con il primo gruppo scelto).
Ogni azione attende il suo tempo dopo l’azione precedente. Lascia a 0 l’attesa del modello, perché viene applicata due volte.
Invia un messaggio non può usare variabili: un messaggio con {{variables}} interrompe l’esecuzione. I modelli possono usare le opzioni predefinite Nome ed Email e valori fissi.
Funzionano queste azioni: Invia un modello, Invia un messaggio, Aggiungi a gruppi o tag, azioni del team e azioni della pipeline. Webhook, Esegui codice, passaggio al bot IA, stati, Salva dati, Ripeti un passaggio e Avvia un altro workflow non vengono eseguiti.
Le esecuzioni manuali non compaiono in Esecuzioni e non sbloccano i passaggi successivi.

Limiti

Elemento	Limite
Passaggi per workflow	10 nell’editor a moduli
Gruppi di condizioni per passaggio	6
Pulsanti di risposta rapida	3
Attendi prima di inviare	Nessun massimo (in secondi)
Attesa per nessuna risposta / ritardo	Da 5 minuti a 30 giorni
Scadenza del follow-up	Fino a 365 giorni
Testo del follow-up, titolo della trattativa	160 caratteri
Timeout del webhook	15 secondi; vengono conservate risposte fino a 64 KB
Tentativi di invio	5 tentativi, poi il messaggio viene scartato

Non ancora disponibile

Potresti volere…	Per ora
Un trigger a una data o a un’ora (ad es. un promemoria per un appuntamento)	Crea un follow-up per un collega, oppure imposta un promemoria dalla posta in arrivo
Fermare una sequenza quando il cliente risponde	Mantieni brevi le sequenze e usa Nessuna risposta per un po’ per il sollecito
Un’attesa sulle azioni del team o della pipeline	Usa Nessuna risposta per un po’ o Follow-up in scadenza per agire più tardi
Gli articoli dell’ordine come variabili	Controlla il valore con Importo totale
Un trigger di pagamento per le richieste di pagamento personalizzate	Solo gli ordini dal catalogo avviano Pagamento
Un trigger per sticker, posizioni, contatti o reazioni	Non supportato