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
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
Sezione intitolata “Costruire il workflow”-
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-start 
on-call-start-created -
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-api -
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-settings 
call-parameters 
wf-start-appended -
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-response -
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← ilclient_namedella tua API).

wf-ai-response 
wf-background-info 
wf-donotrespond 
wf-properties 
wf-client -
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-client
Domande frequenti
Sezione intitolata “Domande frequenti”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.
