Agente operativo: trigger

Un trigger è la prima casella sulla lavagna: decide quando il flusso viene eseguito e con quali dati inizia. Ogni tipo di trigger può comparire una sola volta su una lavagna, e una lavagna può contenere più tipi (per esempio una chiamata del centralino e un'esecuzione manuale). I trigger avviano esecuzioni solo mentre l'agente è attivo; un'esecuzione di prova dal progettista funziona in ogni caso.

Chiamata terminata (centralino)#

Ogni chiamata registrata dal centralino del progetto avvia il flusso. Il centralino si collega una volta per tutto il progetto in Integrazioni (vedere Contatti e integrazione con il centralino). Il trigger fornisce ai passaggi:

• caller_number, caller_name, callee_number, callee_name, direction (inbound, outbound, internal)
• duration_sec, status (answered, missed e così via), subject, extension (il nome dell'utente dell'interno)
• recording_url (il link di download del centralino) e recording_ref (il nome del file della registrazione)
• call_id, contact_id, contact_number

Una chiamata persa non ha registrazione. I passaggi che ne hanno bisogno (download, trascrizione, riassunto, report) si segnano Saltato: niente da fare e l'esecuzione si completa comunque, quindi una chiamata persa non lascia mai un'esecuzione in attesa di nuovi tentativi.

Tenete recording_url all'interno del flusso: contiene il segreto di download del centralino. Per identificare una registrazione in un altro sistema inviate invece recording_ref.

Una chiamata del centralino può avviare più agenti: ogni agente attivo con questo trigger viene eseguito.

Webhook ricevuto#

Qualunque cosa sia in grado di inviare JSON può avviare l'agente: la lavagna mostra l'URL proprio dell'agente nell'ispettore (anche in Impostazioni). Il corpo della richiesta diventa il dato del trigger, quindi un campo order_id nel corpo è {{trigger.order_id}} nei passaggi.

Esegue a pianificazione#

Avvia il flusso ogni ora, ogni giorno alle 09:00, nei giorni feriali alle 09:00, ogni lunedì alle 09:00, il primo del mese alle 09:00 o secondo la vostra espressione cron, nel fuso orario che scegliete, al massimo una volta ogni cinque minuti. Due scelte:

• Se l'esecuzione precedente è ancora in corso: saltare questa, oppure accodarla.
• Attivazioni perse mentre il servizio era fermo: saltarle, oppure eseguire una volta.

Dopo il salvataggio il progettista mostra la stima di esecuzioni e costo al mese, perché ogni esecuzione è fatturata per il tempo di lavoro. La Panoramica mostra la prossima esecuzione pianificata. Il trigger fornisce scheduled_for, fired_at, cron, timezone e missed_by_s.

Chiamato da un altro agente#

Un altro agente operativo del progetto passa dei dati a questo, con Chiama un altro agente o con il Distributore. I dati inviati sono il dato del trigger; caller_agent e caller_run_id dicono chi ha chiamato. Usatelo per agenti che svolgono un lavoro per molti altri.

Esecuzione manuale#

Avvia il flusso dalla console o dall'API con dati che scrivete voi. Utile per lavagne che eseguite su richiesta, per esempio trascrivere una registrazione a partire dal suo URL.

Messaggio WhatsApp ricevuto#

Un cliente ha scritto a uno dei numeri WhatsApp del progetto (vedere WhatsApp: il tuo agente sul numero della tua azienda). Solo i messaggi dei clienti: le risposte del vostro team hanno un trigger a parte. Restringetelo con Numero (vuoto: ogni numero del progetto), Tipo di messaggio, Quali messaggi (ogni messaggio, il primo messaggio di una conversazione, oppure un messaggio dopo 24 ore di silenzio, che apre una nuova finestra di 24 ore) e Il testo contiene, che cerca anche nella didascalia o nella trascrizione di un messaggio vocale. Il trigger fornisce ai passaggi:

• from (il numero di telefono del cliente, vuoto se lo nasconde), user_id (il suo ID utente WhatsApp, sempre presente), username, profile_name
• text (per un messaggio vocale, la sua trascrizione), type, caption, media, location
• conversation_id, wamid, timestamp, number_id, number, contact_id, window_open_until, window_opened, first_in_conversation
• answered_by: chi risponde a questo messaggio secondo le impostazioni di risposta del numero (agent, team_then_agent o team), così una lavagna agisce solo quando risponderanno delle persone

Usate event_id (uguale a wamid) quando il sistema a cui inviate ha bisogno di una chiave che non si ripete mai.

Risposta del team su WhatsApp#

Qualcuno del vostro team ha risposto a un cliente su WhatsApp, dalla console o dall'app WhatsApp Business sul telefono. Restringetelo con Numero, Inviato da (la console o l'app sul telefono) e Il testo contiene. Fornisce il text della risposta, sent_by, rep_name (chi ha risposto, dalla console), agent_paused_until, conversation_id e wamid, oltre a from e user_id del cliente. Un uso tipico: annotare nel vostro CRM le risposte del team.

Ascoltare l'evento reale#

I trigger Webhook ricevuto, Chiamata terminata (centralino), Chiamato da un altro agente, Messaggio WhatsApp ricevuto e Risposta del team su WhatsApp hanno un pulsante Ascolta nell'ispettore. Premetelo, poi fate accadere l'evento: inviate il webhook dall'altro sistema, fate e chiudete una chiamata sul centralino, eseguite la lavagna che chiama questa, scrivete al numero WhatsApp da un telefono, oppure rispondete a un cliente dalla console o dall'app WhatsApp Business. L'evento successivo viene mostrato nell'ispettore esattamente come il trigger lo riceverebbe, formattato, e non viene eseguito, anche se l'agente è disattivato. L'ascolto dura dieci minuti. Premete Usa come dati di prova per eseguire la lavagna con quei dati esatti.

È il modo più rapido per conoscere i veri nomi dei campi che un sistema invia, invece di indovinarli.