# Come funzionano i trigger nelle regole

{% stepper %}
{% step %}

### Cos’è un trigger

Un **trigger** è l’elemento che avvia una regola o un set di azioni.

Può essere attivato da:

* eventi della **conversazione** (contenuto o andamento del dialogo)
* eventi di tipo **CRM** (stati tecnici o gestionali legati al lead, alla chiamata o agli appuntamenti)
  {% endstep %}

{% step %}

### Tipologie di trigger

I trigger si dividono in due grandi categorie:

* **Eventi conversazionali**
  * Si attivano in base a ciò che accade nella conversazione in tempo reale.
  * Esempio: il cliente si arrabbia, chiede informazioni specifiche, o formula una richiesta particolare.
* **Eventi  CRM**
  * Si attivano in base a stati o eventi legati al lead, al calendario o alla chiamata.
  * Esempio: chiamata terminata, lead in arrivo, appuntamento prenotato, conversazione completata.
    {% endstep %}

{% step %}

### Elenco dei trigger CRM principali

* **Lead in arrivo** → scatta quando un nuovo contatto entra nella task.
* **Stato chiamata** → scatta in base all’esito della telefonata:
  * Completed (completata)
  * Busy (occupato)
  * Failed (fallita)
  * Error (errore)
  * Without Response (senza risposta)
  * Transfer (trasferita)
* **Evento conversazione** → gestisce lo stato logico della conversazione:
  * Completed (completata)
  * Disable (disabilitata)
  * Timeout (chiusa per inattività)
* **Appuntamento prenotato** → si attiva quando viene fissato un appuntamento.
  {% endstep %}

{% step %}

### Evento conversazionale

Si configurano indicando una **descrizione** (quando deve partire) e uno **speech di attivazione** (ciò che l’AI dirà prima di eseguire l’azione).

Esempio: (Conversazione su Whatsapp)

* Descrizione: “Usa questo strumento se la persona è particolarmente arrabbiata.”
* Speech di attivazione: “Un attimo, notifico subito il team di supporto.”
* Azione: disattivazione AI + invio notifica email.

Esempio: (Chiamata telefonica)

* Descrizione: “Usa questo strumento se la persona è particolarmente arrabbiata.”
* Speech di attivazione: “Mi perdoni, chiudo la chiamata e la farò richiamare dal mio supervisore”
* Azione: disattivazione AI + invio notifica email.
  {% endstep %}

{% step %}

### Esempi di utilizzo pratico

* **Stato chiamata = Completed**
  * Azione: invio email di riepilogo.
* **Stato conversazione = Completed**
  * Azione: avvio di un workflow CRM (es. spostamento lead a “gestito”).
* **Lead in arrivo**
  * Azione: invio notifica al team commerciale.
* **Appuntamento prenotato**
  * Azione: avvio automazioni di reminder o notifica al consulente.
* **Trigger conversazionale (utente arrabbiato)**
  * Azione: disattiva AI e trasferisci la chiamata a un operatore umano.
    {% endstep %}

{% step %}

### Relazione con altre regole

* I trigger **Evento conversazione** sono collegati alle azioni *Definisci completamente*, *Disattiva AI* e *Definisci Timeout* (visita i  relativi manuali a fine pagina).
* I trigger **Evento chiamata** comprendono anche i casi speciali come il trasferimento, che può essere usato per avviare altre azioni (es. invio email post-trasferimento).
* Il trigger **Nuovo Lead** e quello **Appuntamento prenotato** sono fondamentali per avviare flussi immediati di automazione.
  {% endstep %}

{% step %}

### Buone pratiche

* Dai sempre un nome chiaro alle regole per riconoscere facilmente il loro scopo.
* Combina trigger conversazionali con trigger CRM per coprire sia la parte dialogica sia quella gestionale.
* Usa condizioni specifiche per evitare l’attivazione di azioni indesiderate.
* Consulta i manuali dedicati per approfondire i singoli trigger (apri per l’elenco).

<details>

<summary>Manuali dedicati</summary>

* Stato conversazione
* Stato chiamata
* Lead in arrivo
* Appuntamento prenotato
* Trigger conversazionale

</details>
{% endstep %}
{% endstepper %}

Consulta questi moduli per padroneggiare Booki:

{% content-ref url="/pages/d1e09042252d26a84f07b9ee1bdeccb2673a1782" %}
[Imposta Timeout](/task/4.strumenti-e-regole/regole-autonome/imposta-timeout.md)
{% endcontent-ref %}

{% content-ref url="/pages/8eb58467f25e690038cbd9da7d695e1aaaad4e9f" %}
[Come disattivare l'AI su una conversazione](/conversazioni/come-disattivare-lai-su-una-conversazione.md)
{% endcontent-ref %}

{% content-ref url="/pages/3aa896e21013e60b3b1e81baaff41dddf320b62f" %}
[Evento chiamata](/task/4.strumenti-e-regole/5.trigger/evento-chiamata.md)
{% endcontent-ref %}

{% content-ref url="/pages/037615f78f12f9478a697613dd2bbe64f1bde26b" %}
[Appuntamento Prenotato](/task/4.strumenti-e-regole/5.trigger/appuntamento-prenotato.md)
{% endcontent-ref %}

{% content-ref url="/pages/34e082ef698167ab2fbb66e11f6ceb815180357c" %}
[Conversazionale](/task/4.strumenti-e-regole/5.trigger/conversazionale.md)
{% endcontent-ref %}


---

# 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/regole-autonome/come-funzionano-i-trigger-nelle-regole.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.