On Call Start

I workflow di inizio chiamata si attivano prima che l’IA risponda al telefono — un aspetto cruciale per evitare ritardi durante la chiamata. Recupera ciò che ti serve dai tuoi sistemi prima che l’IA risponda, e l’agente parte con il contesto completo; fai le stesse chiamate API a metà conversazione e ogni risposta diventa percettibilmente più lenta.

Alla fine di questa guida avrai un workflow che arricchisce il tuo agente con dati in tempo reale dal tuo sistema prima dell’inizio di ogni chiamata: un Call Start Trigger, una chiamata API con parametri dinamici, una struttura di risposta definita e un nodo AI Response to Caller che riporta contesto e proprietà personalizzate nel messaggio di benvenuto e nel prompt dell’agente.

Costruire il workflow

1. Aggiungi il Call Start Trigger

   Nel tuo workflow, fai clic su Add Trigger e scegli Call Start Trigger dal catalogo (digita “call start” per trovarlo). Una volta posizionato, puoi collegarci i nodi di azione.

   

   call-startExpand

   

   on-call-start-createdExpand

2. Collegati alla tua API

   Aggiungi il nodo Connect To External Service (cerca “API” o “external”) — si collega automaticamente al trigger da cui hai avviato la connessione.

   

   autopopulate-apiExpand

3. Configura la chiamata API con parametri dinamici

   Apri le impostazioni del nodo (icona dell’ingranaggio) e inserisci l’URL del tuo endpoint. Usa il menu a tendina Call Parameters sopra l’URL per inserire valori in tempo reale — scegli Contact Phone Number e il numero del chiamante viene accodato al tuo URL, sostituito a runtime per ogni chiamata.

   

   api-settingsExpand

   

   call-parametersExpand

   

   wf-start-appendedExpand

4. Definisci la risposta API attesa

   Nella sezione API Response, descrivi la struttura restituita dal tuo endpoint — ad es. client_name, customer_satisfaction. Questi campi diventano disponibili per i nodi successivi.

   

   wf-start-responseExpand

5. Configura il nodo AI Response to Caller

   Questo nodo riporta i dati dentro la chiamata:

   • Background information for AI — fornisce all’agente i valori della risposta API come contesto.
   • Do Not Respond to Call — impedisce all’IA di rispondere (la chiamata continua a squillare).
   • Forward Call — instrada invece verso un altro agente o numero.
   • Set Delay — attende prima che l’IA risponda, dando a un operatore umano la possibilità di rispondere per primo.
   • Custom properties — soprattutto, mappa i valori della risposta su proprietà con un nome (ad es. client ← il client_name della tua API).

   

   wf-ai-responseExpand

   

   wf-background-infoExpand

   

   wf-donotrespondExpand

   

   wf-propertiesExpand

   

   wf-clientExpand

6. Usa le proprietà nel tuo agente

   Fai riferimento alle proprietà personalizzate nel messaggio di benvenuto e nel prompt di sistema dell’agente — l’IA inizia ogni chiamata sapendo già chi sta chiamando, con zero latenza durante la conversazione.

   

   wf-prompt-clientExpand

Salva e assegna

Salva il workflow dall’angolo in alto a destra, poi assegnalo al tuo agente (editor dell’agente → Skills → Tools & Workflows → Business Workflows). Un workflow non salvato o non assegnato non viene mai eseguito.