> For the complete documentation index, see [llms.txt](https://docs.bookli.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bookli.ai/task/4.strumenti-e-regole/regole-autonome/come-funzionano-i-trigger-nelle-regole.md).

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