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 fattura almeno 30 secondi di automazione. 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.

Ascoltare l'evento reale#

I trigger Webhook ricevuto, Chiamata terminata (centralino) e Chiamato da un altro agente 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, oppure eseguite la lavagna che chiama questa. 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.