# 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.

     ![Selezione del Call Start Trigger](https://docs.voicelogica.ai/assets/workflows/start/call-start.png)
     ![Call Start Trigger posizionato](https://docs.voicelogica.ai/assets/workflows/start/on-call-start-created.png)

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](https://docs.voicelogica.ai/assets/workflows/start/autopopulate-api.png)

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](https://docs.voicelogica.ai/assets/workflows/start/api-settings.png)
     ![Menu a tendina Call Parameters](https://docs.voicelogica.ai/assets/workflows/start/call-parameters.png)
     ![Numero di telefono accodato all'URL](https://docs.voicelogica.ai/assets/workflows/start/wf-start-appended.png)

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](https://docs.voicelogica.ai/assets/workflows/start/wf-start-response.png)

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](https://docs.voicelogica.ai/assets/workflows/start/wf-ai-response.png)
     ![Informazioni di contesto](https://docs.voicelogica.ai/assets/workflows/start/wf-background-info.png)
     ![Impostazione Do Not Respond](https://docs.voicelogica.ai/assets/workflows/start/wf-donotrespond.png)
     ![Sezione delle proprietà](https://docs.voicelogica.ai/assets/workflows/start/wf-properties.png)
     ![Proprietà personalizzata mappata sulla risposta API](https://docs.voicelogica.ai/assets/workflows/start/wf-client.png)

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](https://docs.voicelogica.ai/assets/workflows/start/wf-prompt-client.png)

> **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.