# 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 %}

{% content-ref url="/pages/2ab4b0adeb5c9385d44c6528c35dc4944202f799" %}
[Come creare uno strumento](/strumenti/come-creare-uno-strumento.md)
{% endcontent-ref %}

{% content-ref url="/pages/OzIaDOfk0Zz9Dxv2ZEMZ" %}
[4.Strumenti e Regole](/task/4.strumenti-e-regole.md)
{% endcontent-ref %}

#### 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bookli.ai/task/4.strumenti-e-regole/5.trigger/azioni/chiamate-di-strumenti.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.