---
title: Trigger
description: I 12 eventi che avviano un workflow — filtri di attivazione, dati che ogni trigger mette a disposizione degli step successivi e protezioni anti-loop.
---

Ogni workflow parte da **un** trigger. La regola generale dei filtri: quando
un trigger ha un filtro (fonti, esiti, form, stati) e lo lasci **vuoto**, si
attiva su **tutti** gli eventi di quel tipo.

## Il catalogo

| Trigger | Si attiva quando… | Filtro |
|---|---|---|
| **Nuovo Lead Creato** | nasce un lead, da qualsiasi canale | Fonti (Social Ads, Form / Landing, Widget sito, Chiamata in entrata, Import, Inserimento manuale, Integrazione, Altro) |
| **Cambio Stato Lead** | un lead cambia stato | Stati target |
| **Cambio Stato Pratica** | un deal cambia fase | Pipeline e fasi target |
| **Esito Chiamata** | viene fissato l'esito di una chiamata | Esiti (da Impostazioni → Esiti chiamata) |
| **Form Inviato** | qualcuno invia un form pubblicato | Form ([guida dedicata](/docs/form/automazioni)) |
| **Chiamata in Arrivo** | arriva una chiamata su un numero collegato | — (si collega dal numero) |
| **Nuova conversazione WhatsApp** | inizia una conversazione WhatsApp (non a ogni messaggio) | — (si collega dal numero) |
| **Nuova conversazione SMS** | inizia una conversazione via SMS (non a ogni messaggio) | — (si collega dal numero) |
| **Risposta Rapida WhatsApp** | il contatto tocca un pulsante di risposta rapida | ID dei pulsanti (es. CONFIRM, RESCHEDULE) |
| **Avvio Campagna** | una campagna processa i suoi lead (uno alla volta) | — (si collega dalla campagna) |
| **Trigger Webhook** | un sistema esterno fa una POST all'URL dedicato dello step | — |
| **Nuova Riga da Foglio Google** | arriva una riga nuova su un foglio configurato | mapping colonne |

Note operative:

- **Chiamata in Arrivo**: il workflow si aggancia dal numero (pagina del
  numero → tab Workflows) e deve contenere lo step che risponde (es.
  "Rispondi con Bot Specifico").
- **Nuova conversazione WhatsApp / SMS**: si agganciano anch'essi dal numero,
  ma scattano **una volta per conversazione**, al primo messaggio — non a ogni
  messaggio ricevuto. Ripartono solo se la conversazione viene chiusa e il
  contatto scrive di nuovo (anche toccando un pulsante di risposta rapida). Il
  loro compito è decidere **quale bot** seguirà la conversazione, con lo step
  "Affida la conversazione a questo bot": senza quello step la conversazione
  resta a una persona.
- **Trigger Webhook**: l'URL si trova nel pannello dello step ed è attivo
  dopo il salvataggio del workflow. Chiunque lo conosca può avviare il
  workflow: **tienilo riservato**.
- **Nuova Riga da Foglio Google**: richiede la condivisione del foglio con
  il service account e l'installazione di uno script Google Apps Script
  (istruzioni nel pannello dello step).

## I dati nel contesto

Ogni trigger inietta dei dati che gli step successivi possono usare (nei
filtri delle condizioni e nelle [variabili dei
testi](/docs/workflow/azioni-e-condizioni#le-variabili-nei-testi)):

| Trigger | Dati principali |
|---|---|
| Nuovo Lead Creato, Cambio Stato Lead, Risposta Rapida WhatsApp | il **lead** (nome, email, telefono, stato, parametri personalizzati; nel cambio stato anche le aziende collegate) |
| Esito Chiamata | la **chiamata** e l'**esito**, più il lead se collegato |
| Form Inviato | il **form**, le **risposte** (etichette leggibili), la **chiusura raggiunta**, più il lead **solo se** il form raccoglie contatti |
| Cambio Stato Pratica | il **deal** completo, con pipeline, fase attuale e fase precedente |
| Trigger Webhook / Foglio Google | il payload ricevuto / la riga mappata |

<Callout type="warn">
  **Il lead non è sempre garantito.** Con "Form Inviato" un sondaggio senza
  dati di contatto non produce alcun lead; gli step che lo richiedono
  (email, WhatsApp, attività) vanno protetti con una condizione a monte.
</Callout>

<Callout type="info">
  **Anti-loop integrato**: un workflow che crea un lead (o fissa un esito,
  o genera una submission) non ri-attiva **sé stesso**. Può però attivare
  **altri** workflow: tienilo presente quando più automazioni ascoltano lo
  stesso evento.
</Callout>

## Prossimi passi

<Cards>
  <Card
    href="/docs/workflow/azioni-e-condizioni"
    title="Azioni e condizioni"
    description="Cosa può fare il workflow dopo il trigger."
  />
  <Card
    href="/docs/form/automazioni"
    title="Automazioni dei Form"
    description="Il caso guidato: trigger Form Inviato + smistamento per chiusura."
  />
</Cards>