Salta ai contenuti
IT
Apri l’app

For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/it/workflows/on-call-start.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.

On Call Start

4 min di lettura
Copia come Markdown
Visualizza come MarkdownApri il file .md.md

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.

  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.

    Selezione del Call Start Trigger
    call-startExpand
    Call Start Trigger posizionato
    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.

    Selezione del nodo API
    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.

    Impostazioni API
    api-settingsExpand
    Menu a tendina Call Parameters
    call-parametersExpand
    Numero di telefono accodato all'URL
    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.

    Definizione della risposta API
    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).
    Impostazioni di AI Response to Caller
    wf-ai-responseExpand
    Informazioni di contesto
    wf-background-infoExpand
    Impostazione Do Not Respond
    wf-donotrespondExpand
    Sezione delle proprietà
    wf-propertiesExpand
    Proprietà personalizzata mappata sulla risposta API
    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.

    Proprietà usate nel prompt dell'agente
    wf-prompt-clientExpand
Perché il saluto del mio agent parte in ritardo quando uso un workflow On Call Start?

La ricerca del workflow On Call Start è ancora in corso e il saluto attende i suoi dati. Metta i dati in cache o alleggerisca il workflow, e non aggiunga una seconda chiamata API «per sicurezza».

Devo usare On Call Start o When Call Connects?

Usi When Call Connects quando l’azione deve avvenire dopo la risposta, con una persona in linea. Usi On Call Start quando il saluto ha bisogno dei dati, perché On Call Start viene eseguito prima che l’IA risponda.

Perché il mio workflow On Call Start non viene mai eseguito?

Il workflow deve essere salvato dall’angolo in alto a destra e assegnato all’agent (editor dell’agent → Skills → Tools & Workflows → Business Workflows). Un workflow non salvato o non assegnato non viene mai eseguito.

Come fa il mio agent a sapere chi sta chiamando già dal saluto?

Il workflow On Call Start chiama la sua API con il numero del chiamante (Contact Phone Number dal menu Call Parameters) prima che l’IA risponda. Nel nodo AI Response to Caller mappi i valori della risposta su proprietà personalizzate, per esempio client dal client_name della sua API, e le usi nel messaggio di benvenuto e nel prompt dell’agent.

Posso far rispondere prima un operatore umano e far intervenire l'IA solo dopo?

Sì. Nel nodo AI Response to Caller di un workflow On Call Start, Set Delay attende prima che l’IA risponda, così un operatore umano può rispondere per primo. Do Not Respond to Call impedisce all’IA di rispondere (la chiamata continua a squillare), e Forward Call inoltra la chiamata a un altro agent o numero.