# Chiamate di strumenti

#### 1. Cos’è la funzione "Chiamate di strumenti"

La funzione **Chiamate di strumenti** permette di eseguire strumenti personalizzati creati nella sezione **Strumenti**.

Gli strumenti possono essere:

* API esterne,
* funzioni custom,
* integrazioni operative.

La chiamata agli strumenti può essere usata in due modalità:

* come **Azione** all’interno di una regola,
* come **Regola autonoma**, indipendente dagli altri flussi.

#### 2. Quando utilizzarla

Puoi richiamare strumenti:

* all’interno di un flusso basato su **trigger CRM** (es. lead in arrivo, stato chiamata, appuntamento prenotato),
* in risposta a un **trigger conversazionale** (es. richiesta specifica dell’utente),
* come processo autonomo indipendente dalla conversazione.

#### 3. Come configurarla

{% stepper %}
{% step %}

### Vai nella sezione **Regole**

Crea una nuova regola o aggiungi un’azione a una regola esistente.
{% endstep %}

{% step %}

### Seleziona **Chiamate di strumenti**

Scegli questa azione tra le opzioni disponibili.
{% endstep %}

{% step %}

### Scegli lo strumento da richiamare

Seleziona lo strumento desiderato tra quelli creati nella sezione **Strumenti**.
{% endstep %}

{% step %}

### Configura i parametri richiesti

Imposta eventuali parametri necessari dallo strumento (vedi manuale **Strumenti**) per evitare errori di esecuzione.
{% endstep %}

{% step %}

### Salva la regola

Verifica la configurazione e salva la regola.
{% endstep %}
{% endstepper %}

#### 4. Esempi di utilizzo

* **Trigger Lead in arrivo** → Azione: Chiamata a uno strumento CRM esterno per salvare i dati del contatto.
* **Trigger Stato chiamata = Completed** → Azione: invio dati a un sistema di analytics tramite API.
* **Trigger conversazionale (utente chiede preventivo)** → Azione: chiamata a uno strumento che genera e restituisce un preventivo.
* **Regola autonoma** → chiamata periodica a uno strumento di verifica dati.

#### 5. Buone pratiche

{% hint style="info" %}

* Mantieni un naming chiaro per i tuoi strumenti, in modo da identificarli facilmente nelle regole.
* Se uno strumento richiede parametri, definiscili in modo preciso nella regola per evitare errori.
* Utilizza la funzione come “ponte” tra la conversazione/CRM e sistemi esterni, centralizzando tutte le integrazioni in un unico punto.
  {% endhint %}