💡
Puoi ingrandire tutte le schermate facendo clic su di esse. Le schermate mostrano il nodo stesso e il relativo menu delle impostazioni.

Avvia conversazione

Un workflow può avviarsi in cinque modi: quando il contatto avvia una conversazione, tramite un trigger esterno con una chiamata webhook (attualmente in versione beta), tramite un trasferimento da un Agente IA di Connect, in base a una data salvata nel contatto oppure manualmente, quando un operatore avvia il workflow per un contatto. Puoi scegliere la modalità nel nodo Avvio, in Tipo di trigger.

Avvio con una nuova conversazione, iniziata dal contatto

Supponiamo che tu gestisca un sito web in cui è integrata la nostra chat. Un contatto avvia una conversazione tramite il pulsante della chat. Un chatbot collegato al workflow guida il cliente attraverso il processo predefinito
Questo nodo è incluso per impostazione predefinita in ogni workflow e, in questo stato, non può essere ulteriormente configurato.
Image without caption

Avvio tramite un trigger esterno

Supponiamo invece che tu utilizzi un sistema indipendente da Lime Connect e desideri avviare un workflow automatizzato in Lime Connect sulla base dei dati di quel sistema.
In questo caso, non è il contatto ad avviare il workflow, ma un evento precedentemente definito (programmato) nel tuo sistema di terze parti, che viene trasmesso a Lime Connect tramite un'interfaccia.
Per avviare il workflow tramite un trigger esterno, è necessaria esperienza di programmazione e nell'utilizzo delle interfacce.
Attualmente, il trigger webhook può essere utilizzato solo in combinazione con i nodi dei modelli WhatsApp.
Qui puoi configurare l'URL del webhook e l'header di autorizzazione. Puoi inoltre specificare i campi dati previsti che verranno trasmessi al tuo sistema.
Image without caption
Esempio di caso d'uso (apri facendo clic sulla freccia a sinistra)

Avvio tramite un trasferimento da un Agente IA di Connect

Puoi anche trasferire la conversazione in corso dal tuo Agente IA di Connect a un workflow. A questo scopo, il nodo Avvio deve essere impostato sul tipo corrispondente.
Se necessario, puoi anche passare al workflow i dati a cui il tuo Agente IA ha accesso. Questi dati saranno poi disponibili come variabili all'interno del workflow.
Image without caption

Avvio in base alla data di un campo del contatto

Un workflow può avviarsi anche in un momento già salvato nel contatto. Un caso tipico è un messaggio di auguri inviato ogni anno il giorno del compleanno del contatto.
Nel nodo Avvio, imposta Tipo di trigger su Basato sulla data del contatto. Le altre opzioni sono All'avvio della conversazione, Alla chiamata del webhook, Al trasferimento da Connect AI e Avviato manualmente.
Il nodo Avvio con il tipo di trigger impostato su Basato sulla data del contatto
Il nodo Avvio con il tipo di trigger impostato su Basato sulla data del contatto
Prima di scegliere un campo, verifica che sia utilizzabile. Sono idonei solo i campi del contatto con tipo di input Data o Data e ora. Il tipo di input di un campo salvato non può essere modificato in seguito; pertanto, se un compleanno è memorizzato in un campo di testo, il campo deve essere creato nuovamente con il tipo di input Data in Impostazioni > Strumenti di chat > Campi dati.
In Esegui il, fai clic su Seleziona variabile del contatto e scegli il campo che contiene la data. La selezione mostra solo i campi idonei e le schede delle variabili della conversazione e del workflow non vengono visualizzate.
La selezione delle variabili che mostra solo i campi data del contatto
La selezione delle variabili che mostra solo i campi data del contatto
Ora del giorno imposta l'orario di esecuzione del workflow, che è alle 9:00 se non lo modifichi. È possibile selezionare solo intervalli di 30 minuti.
Scostamento sposta l'esecuzione rispetto alla data stessa. Lascia Nessuno scostamento per eseguire il workflow nella data indicata. Scegli Prima o Dopo per spostarla, quindi specifica una quantità e un'unità. Un campo Data consente di selezionare solo i giorni. Un campo Data e ora consente anche minuti e ore, perché include un orario.
Ripeti ogni anno esegue il workflow ogni anno nella stessa data. Questa opzione è inizialmente disattivata, quindi devi attivarla per un messaggio di auguri di compleanno. Lasciala disattivata per una data che deve generare un solo avvio, come una data di registrazione.

Avvio manuale da parte di un operatore

Con il tipo di trigger Avviato manualmente, un operatore avvia manualmente il workflow per un contatto specifico, direttamente dal profilo del contatto nel Centro messaggi. Utilizzalo per i flussi che non devono avviarsi da soli, ma solo quando lo decide qualcuno del team. All'avvio, l'operatore può inserire dei valori, ad esempio un numero d'ordine che verrà poi utilizzato dal workflow.
Chi crea il workflow lo configura nell'editor: imposta il nodo Avvio, quindi attiva il workflow e collega un chatbot. Gli operatori lo eseguono poi dal profilo di un contatto nel Centro messaggi.
Non confondere questo trigger con l'avvio tramite una nuova conversazione descritto sopra: in quel caso è il contatto ad avviare la conversazione, mentre qui è un operatore ad avviare il workflow.
Quando crei il workflow, inserisci Invia messaggio modello WhatsApp prima di ogni nodo che richiede una conversazione. Un workflow avviato manualmente viene eseguito per il contatto e parte senza una conversazione. Solo questo nodo ne apre una, inviando al contatto un modello WhatsApp approvato tramite uno dei tuoi canali WhatsApp. È descritto nella pagina "Nodi di azione". Il nodo successivo viene eseguito immediatamente e non attende una risposta.
Il modello viene inviato solo se disponi di un canale WhatsApp con un modello approvato e se il contatto non è bloccato e ha un numero di cellulare che utilizza WhatsApp. Senza un canale WhatsApp, un workflow avviato manualmente può utilizzare solo nodi che non richiedono una conversazione.
Tra i nodi di questa pagina, Messaggio e Attiva componente aggiuntivo richiedono una conversazione. Rilevatore di parole chiave attende un messaggio del contatto nella conversazione. Posiziona tutti e tre dopo il nodo del modello. Condizione non richiede una conversazione, così come i nodi che riguardano solo il contatto, ad esempio Aggiorna contatto (pagina "Nodi di azione") o Richiesta API (pagina "Nodi di raccolta informazioni").
Scegli il tipo di trigger prima di qualsiasi altra impostazione nel nodo Avvio: modificarlo in seguito reimposta il nodo e cancella tutte le impostazioni del tipo precedente, incluse le variabili di input.
Apri il workflow nell'editor, fai clic sul nodo Avvio e, in Tipo di trigger, seleziona Avviato manualmente.
In Variabili di input, definisci i valori che l'operatore deve inserire all'avvio; se non ne servono, lascia vuota la sezione. Per ogni valore, fai clic su Aggiungi variabile e assegna un nome alla variabile, ad esempio "order_number". Un nome può contenere solo lettere latine dalla a alla z e dalla A alla Z, cifre, "-" e "_", e ogni nome può essere utilizzato una sola volta. Per ogni variabile, imposta anche:
  • Obbligatorio: se selezionato, l'operatore può avviare il workflow solo dopo aver inserito un valore. Le nuove variabili sono inizialmente obbligatorie.
  • Tipo: Stringa per il testo oppure Numero. Un campo Numero accetta solo numeri all'avvio, inclusi decimali e numeri negativi. Questo "Tipo" determina ciò che l'operatore può inserire; il Tipo di trigger sopra determina come si avvia il workflow.
  • Descrizione: un suggerimento per l'operatore su cosa inserire. Viene visualizzato all'avvio tramite l'icona delle informazioni accanto al nome del campo.
Image without caption
Se l'operatore lascia vuoto un campo facoltativo, la variabile rimane vuota: un nodo Messaggio non mostra nulla al suo posto e un nodo Invia messaggio modello WhatsApp che la utilizza come segnaposto non riesce a essere eseguito. Rendi obbligatoria una variabile se un modello la richiede.
Nei nodi successivi al nodo Avvio, trovi le variabili di input nella selezione delle variabili, nella scheda Questo workflow, ad esempio "order_number" come segnaposto in un modello WhatsApp. Poiché il workflow viene eseguito per un contatto, puoi anche utilizzare i campi del contatto.
Quando il workflow è pronto, attiva l'interruttore Attivo nella parte superiore dell'editor e conferma con Attiva.
Image without caption
Assegna quindi il workflow a un chatbot, come descritto nella pagina Workflow alla voce "Assegna il tuo workflow a un chatbot": aggiungi un chatbot con tipo di bot "WORKFLOW" oppure aprine uno esistente. Un chatbot ha esattamente un workflow collegato, quindi selezionare questo workflow per un chatbot esistente sostituisce quello precedente.
Seleziona il workflow in Workflow collegato e fai clic su Salva. Qui è possibile selezionare solo workflow attivi, per questo devi prima attivarlo. Senza questo chatbot il workflow non può essere avviato e i messaggi inviati dal workflow appaiono nella conversazione come inviati da questo chatbot.
Image without caption
I passaggi seguenti sono destinati agli operatori; chi ha creato il workflow può utilizzarli per testarlo. Tutti gli operatori vedono il pulsante Esegui workflow una volta che la funzionalità Workflow è stata acquistata per l'account; non è necessaria un'autorizzazione separata per l'avvio.
Apri il profilo del contatto nel Centro messaggi, ad esempio tramite Contatti nel menu di navigazione. La barra delle schede mostra Profilo, Conversazioni e, a seconda del ruolo, Workflow. A destra trovi il pulsante Esegui workflow.
Image without caption
Fai clic su Esegui workflow. Nella finestra omonima, seleziona il workflow in Workflow. L'elenco mostra tutti i workflow attivi con il tipo di trigger Avviato manualmente. Se il workflow ha variabili di input, per ognuna compare un campo con il relativo nome e i campi obbligatori sono contrassegnati.
L'avvio esegue realmente il workflow: il modello WhatsApp viene inviato al contatto. Per testarlo, utilizza un contatto con il tuo numero di cellulare. Ogni clic su Avvia avvia una nuova esecuzione. Non è possibile interrompere una singola esecuzione dal profilo del contatto; è possibile interrompere tutte le esecuzioni contemporaneamente disattivando il workflow con "Interrompi le esecuzioni attive e disattiva".
Compila i campi e fai clic su Avvia. I campi facoltativi lasciati vuoti non vengono trasmessi.
Image without caption
Dopo l'avvio, viene visualizzato l'avviso "Workflow avviato". Il contatto non nota nulla finché il workflow non gli invia qualcosa, ad esempio il modello WhatsApp.
Per verificare che abbia funzionato, apri la scheda Workflow del profilo del contatto. La vedono solo gli operatori il cui ruolo consente di visualizzare i workflow; se non la vedi, chiedi a qualcuno che dispone dell'accesso. Ogni esecuzione è elencata con il suo stato: Attivo, In attesa, Terminato o Errore. Fai clic sul nome del workflow per aprire Attività del workflow con il relativo Registro di esecuzione; Mostra dettagli su un passaggio mostra il nodo e il relativo errore.
Image without caption
Se non riesci ad avviare un workflow:
  • Non vedi "Esegui workflow": la funzionalità Workflow non è stata acquistata per il tuo account.
  • "Non ci sono workflow attivi con un trigger manuale. Creane e attivane uno nell'editor dei workflow per eseguirlo qui.": nessun workflow ha sia il tipo di trigger Avviato manualmente sia lo stato Attivo. Chiedi a chi ha creato il workflow di attivarlo.
  • "Per eseguire questo workflow, collegalo a un bot di tipo workflow nelle impostazioni del chatbot." dopo aver fatto clic su Avvia: nessun chatbot ha questo workflow come Workflow collegato. Chi ha creato il workflow deve assegnarlo a un chatbot, come descritto nella pagina Workflow alla voce "Assegna il tuo workflow a un chatbot".
  • "Avvia" rimane disattivato: non è ancora stato selezionato un workflow oppure un campo obbligatorio è ancora vuoto.
  • "Inserisci un numero.": il campo appartiene a una variabile di tipo Numero. Inserisci solo un numero.
Se un'esecuzione mostra Errore, il Registro di esecuzione indica il nodo che non è stato eseguito correttamente. Cause comuni e relative soluzioni:
  • Un nodo Messaggio o Attiva componente aggiuntivo precede il modello: posiziona Invia messaggio modello WhatsApp prima di esso.
  • Il contatto è bloccato: i modelli non vengono inviati ai contatti bloccati.
  • Il contatto non ha un numero di cellulare: aggiungi il numero di cellulare nel profilo del contatto e avvia di nuovo.
  • Il numero di cellulare non utilizza WhatsApp: verifica il numero nel profilo del contatto.
  • Il canale WhatsApp è bloccato o non valido: verifica il canale WhatsApp nelle impostazioni dei canali.
  • Il modello scelto nel nodo non è approvato sul relativo canale WhatsApp: scegli un modello approvato nel nodo.
  • Un segnaposto del modello è rimasto vuoto, ad esempio a causa di una variabile di input facoltativa vuota: rendi obbligatoria la variabile oppure compila il campo all'avvio.
  • La conversazione WhatsApp del contatto ha già un workflow attivo: attendi che quel workflow termini, quindi avvia di nuovo.
Se il nodo Avvio mostra un errore:
  • "Questo campo può contenere solo caratteri alfanumerici, “-” o “_”.": il nome della variabile contiene un altro carattere, ad esempio uno spazio o "ä". Rinomina la variabile.
  • "Questo nome di variabile è già in uso.": due variabili di input hanno lo stesso nome. Rinomina una delle due.

Condizione

Utilizza questo nodo quando vuoi offrire al contatto percorsi diversi in base a una condizione.
Nel nostro esempio: tutti i contatti il cui indirizzo email contiene "company1" seguono il percorso A; tutti gli altri seguono il percorso B.
Le condizioni vengono valutate dal sistema dall'alto verso il basso finché non ne viene soddisfatta una. Tutte le condizioni successive non vengono più valutate.
Image without caption

Rilevatore di parole chiave

Utilizza questo nodo quando vuoi eseguire un'azione in base a parole chiave che hai definito.
Nel nostro esempio: non appena il contatto invia la parola chiave "Support", viene attivata l'azione collegata successivamente.
In un workflow avviato manualmente, questo nodo attende un messaggio del contatto nella conversazione, quindi posizionalo dopo il nodo "Invia messaggio modello WhatsApp"; vedi "Avvio manuale da parte di un operatore".
Image without caption

Messaggio

Utilizza questo nodo quando vuoi mostrare ai contatti uno o più blocchi di testo. Puoi anche aggiungere pulsanti o contenuti multimediali.
Nel nostro esempio: dopo la visualizzazione del testo, al contatto vengono mostrati due pulsanti cliccabili che lo portano all'URL salvato.
In un workflow avviato manualmente, questo nodo funziona solo dopo che un modello WhatsApp ha aperto la conversazione; altrimenti l'esecuzione termina con "Errore". Vedi "Avvio manuale da parte di un operatore".
Image without caption

Attiva componente aggiuntivo

Utilizza questo nodo quando vuoi attivare un componente aggiuntivo da noi offerto durante la conversazione.
Nel nostro esempio: viene attivato il componente aggiuntivo Lime CRM e la conversazione viene convertita in un oggetto Lime CRM. Questo avviene in background.
Image without caption
In un workflow avviato manualmente, questo nodo funziona solo dopo che un modello WhatsApp ha aperto la conversazione; altrimenti l'esecuzione termina con "Errore". Vedi "Avvio manuale da parte di un operatore".

Ritardo

Utilizza questo nodo quando il workflow deve attendere un po' prima di eseguire il nodo successivo. In Tempo di attesa, inserisci un numero intero e scegli l'unità: secondi, minuti, ore o giorni.
Image without caption
Per ricavare il tempo di attesa da una variabile, attiva Usa variabile e seleziona una variabile che contiene il tempo di attesa in secondi. Se il tempo di attesa impostato è superiore a 24 ore e il nodo successivo invia un messaggio, l'editor mostra un avviso: WhatsApp non consente di inviare messaggi liberi dopo più di 24 ore dall'ultimo messaggio del contatto. In questo caso, utilizza un modello WhatsApp.