# Mettere in esecuzione un workflow

} from '../../../../components/docs';

Un workflow è un grafo: un **trigger**, poi nodi. Costruirlo sotto **Work Flows** non basta. Un phone trigger non fa nulla finché il workflow non è **on** per quell'agent sotto **Skills - Tools & Workflows**. Una canvas non salvata non viene eseguita.

Il catalogo dei nodi (API, email, SMS, HubSpot, rami) è [Workflow Nodes](https://docs.voicelogica.ai/it/workflow-nodes/). Questa sezione riguarda *quando* il grafo inizia.

## Perché la configurazione è importante

Tre cose devono essere vere o il grafo è solo decorazione:

1. Un **trigger** sta sulla canvas.
2. Ha cliccato **Save & go live** (o salvato una versione).
3. Per un phone trigger - il toggle del workflow è **on** per *questo* agent sotto **Business Workflows**.

**Run test** nel builder prova il grafo. Non prova che un chiamante in diretta lo colpirà.

## Aprire Work Flows

Sidebar - **Work Flows**. Riga della pagina: *Automations that connect systems, fetch live data, send messages and run logic — triggered by calls, schedules or events.*

Stato vuoto: **Build your first workflow**. Pulsante: **+ Workflow**.

  <ShotPlaceholder
    src="/assets/workflows/list.png"
    name="wf-list"
    alt="Stato vuoto Work Flows Build your first workflow"
    capture="Sidebar Work Flows."
  />

**+ Workflow** apre **Create new workflow** (*Name it now — configure capabilities in the builder.*). Nota beta: limitato a **5 workflows during beta**. Inserisca **Workflow name**, quindi **+ Create workflow** (o Cancel).

  <ShotPlaceholder
    src="/assets/workflows/create-workflow.png"
    name="wf-create"
    alt="Dialogo Create new workflow con limite beta"
    capture="Create new workflow."
  />

Può anche usare **+ Add workflow** dalla sezione **Skills - Tools & Workflows** dell'agent - questo crea *e* lo elenca sotto **Business Workflows**.

## Quale trigger

Nel builder, **+ Add Trigger** apre **Phone Triggers** (e altro mentre scorre):

- **Sapere chi sta chiamando prima che l'IA parli** — turn on **Call Start Trigger** (needs Avvia il workflow quando viene ricevuta una chiamata. [On Call Start](https://docs.voicelogica.ai/it/workflows/on-call-start/).)
- **Agire solo dopo che qualcuno ha effettivamente risposto** — turn on **When Call Connects** (needs Avvia quando una chiamata è connessa. [When Call Connects](https://docs.voicelogica.ai/it/workflows/when-call-connects/).)
- **Il chiamante ha chiesto qualcosa che deve cercare in tempo reale** — turn on **During Call Trigger** (needs Il modello decide quando. Aggiunge latenza. [During Call](https://docs.voicelogica.ai/it/workflows/during-call/).)
- **Ha detto una frase (emergenza, annulla)** — turn on **Keyword Detected** (needs Avvia quando il chiamante dice parole specifiche. [Keyword Detected](https://docs.voicelogica.ai/it/workflows/keyword-detected/).)
- **Ha digitato cifre (# / timeout)** — turn on **On Key Pressed** (needs Avvia quando il chiamante preme un tasto. Richiede impostazioni della tastiera sull'agent. [On Key Pressed](https://docs.voicelogica.ai/it/workflows/keyword-pressed/).)
- **Dopo il riattacco: CRM, email, webhook** — turn on **Call Ends Trigger** (needs Avvia quando una chiamata termina. [On Call End](https://docs.voicelogica.ai/it/workflows/on-call-end/).)
- **Nessuno ha risposto** — turn on **Missed Call Trigger** (needs Avvia quando una chiamata è persa. [Missed Call](https://docs.voicelogica.ai/it/workflows/missed-call/).)
- **Il mio sistema avvia il grafo** — turn on **On API Call** (needs [On API Call](https://docs.voicelogica.ai/it/workflows/on-api-call/). Non necessita di un attach agent.)

  <ShotPlaceholder
    src="/assets/workflows/add-trigger.png"
    name="wf-triggers"
    alt="Catalogo Add a Trigger Phone Triggers"
    capture="Workflow Add Trigger."
  />

- **Call Start** — before pickup
- **When Call Connects** — after answer
- **During Call** — the model invokes it
- **Call Ends** — after hang-up
- **Keyword Detected** — spoken phrase
- **On Key Pressed** — DTMF
- **Missed Call** — unanswered inbound
- **On API Call** — POST run-workflow

HubSpot created / property-changed, WooCommerce e trigger di eventi simili appaiono nello stesso catalogo quando quelle [integrations](https://docs.voicelogica.ai/it/integrations/) sono connesse.

**AI Response to Caller** esiste solo sotto un trigger audio-live (Start, Connect, During, Keyword, Key Pressed) - non End o Missed. **Transfer Call** solo sotto Start, Connect o During.

## Prima configurazione - un Call Start, attach, provarlo

1. **Sidebar - Work Flows - + Workflow**

   Lo nomini in base al compito (ad esempio Caller lookup). **+ Create workflow**.

2. **+ Add Trigger - Call Start Trigger**

   Phone Triggers. Lo lasci vuoto - questo trigger non ha campi obbligatori.

3. **Save & go live** (in alto a destra)

   Usi **Save as version** quando vuole un checkpoint nominato. Esegua un builder test se disponibile - dry-run impedisce a Email / SMS di inviare.

4. **My Agents - questo agent - Skills - Tools & Workflows**

   Sotto **Business Workflows** (`N/M active`), attivi la riga **on**. O usi **+ Add workflow** se l'ha creato da qui.

     <ShotPlaceholder
       src="/assets/workflows/index-attach.png"
       name="index-attach"
       alt="Business Workflows con toggle workflow off"
       capture="Agent Tools and Workflows Business Workflows."
     />

5. **Una chiamata inbound reale** (o **Try this agent**)

   Apra **Calls**. Se nulla è stato eseguito, il toggle è off, ha testato un agent diverso o non ha mai salvato.

I workspace sono su un cap workflow beta (**Limited to 5 workflows during beta**). Se **Create workflow** è bloccato, elimini un grafo inutilizzato o aspetti che il limite venga alzato.

## Risoluzione problemi

**Il workflow non viene mai eseguito su una chiamata in diretta**

1. **Save & go live** nel builder.
2. Il workflow è **on** per *questo* agent (**Business Workflows**).
3. Il trigger corrisponde all'evento (Start vs End vs During).
4. Ha chiamato l'agent che ha il toggle, non un secondo.

**Il builder test funziona, i chiamanti no**

I builder test saltano l'agent attach. Attivi il toggle, quindi faccia una chiamata reale.

## Passi successivi

[On Call Start](https://docs.voicelogica.ai/it/workflows/on-call-start/) - primo grafo utile (lookup prima del pickup).  
[During Call](https://docs.voicelogica.ai/it/workflows/during-call/) - solo quando la richiesta non è nota in anticipo.  
[Workflow Nodes](https://docs.voicelogica.ai/it/workflow-nodes/) - API, email, SMS, rami.  
[Tools & Workflows](https://docs.voicelogica.ai/it/agent-configuration/built-in-tools/) - attach + built-in tools.