> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arya.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Trigger

> Gli eventi che avviano i workflow: 7 tipi disponibili.

Un **trigger** è l'evento che avvia l'esecuzione di un workflow. Arya offre 7 tipi di trigger che coprono praticamente ogni caso d'uso.

## Tipi di trigger

<AccordionGroup>
  <Accordion title="Record created / updated / deleted">
    Si attiva quando un record viene creato, modificato o eliminato.

    **Parametri**:

    * **Oggetto** (Deal, Company, Contact, Task, Project, custom...)
    * **Evento** (Created / Updated / Deleted)
    * **Filtri** opzionali (es. solo se `valore > 10000`)

    **Esempi**: notificare sales manager su deal nuovo > €50k; creare task di follow-up quando si aggiunge un contatto.
  </Accordion>

  <Accordion title="Status changed">
    Si attiva quando lo stato di un record cambia.

    **Parametri**:

    * **Oggetto**
    * **Campo stato** (`stage` per deal, `status` per task, ecc.)
    * **Da** (qualsiasi o valore specifico)
    * **A** (qualsiasi o valore specifico)

    **Esempi**: deal → Won → crea progetto; fattura → Pagata → notifica cliente con ringraziamento.
  </Accordion>

  <Accordion title="Scheduled (cron)">
    Si attiva a intervalli regolari (cron-like).

    **Parametri**:

    * **Frequenza**: ogni ora, ogni giorno alle X, settimanalmente, mensilmente, custom cron expression
    * **Timezone**: Europe/Rome default
    * **Filtri**: workflow runna su un insieme di record (es. tutti i deal aperti)

    **Esempi**: report settimanale team ogni lunedì alle 9; cleanup fine mese; solleciti automatici fatture scadute.
  </Accordion>

  <Accordion title="Webhook in ingresso">
    Si attiva quando Arya riceve una chiamata HTTP POST a un URL univoco.

    **Parametri**:

    * **URL webhook** (generato da Arya, es. `https://api.arya.so/webhooks/abc123`)
    * **Metodo autenticazione** (token, firma HMAC, nessuna)
    * **Parse payload**: definisci schema del JSON atteso

    **Esempi**: integrazione con Zapier/Make; form Typeform che crea contatto; evento da sistema custom.
  </Accordion>

  <Accordion title="Form submitted">
    Si attiva quando un form pubblico di Arya viene compilato.

    **Parametri**:

    * **Form**: seleziona form esistente (vedi [Form pubblici](/it/automazioni/overview))
    * I campi del form diventano variabili disponibili

    **Esempi**: iscrizione newsletter → aggiunge a lista; richiesta demo → crea deal.
  </Accordion>

  <Accordion title="Email received">
    Si attiva quando arriva un'email a un indirizzo monitorato.

    **Parametri**:

    * **Indirizzo monitorato**: un alias dedicato (es. `leads@arya.so → interno`)
    * **Filtri**: mittente, subject, keyword

    **Esempi**: email a `sales@` → crea lead; email a `support@` → crea ticket.
  </Accordion>

  <Accordion title="Manual">
    Si attiva solo quando lo lanci tu (dall'app o dalla API).

    **Parametri**:

    * **Scope**: da record (icona action), da lista (bulk), da menu globale
    * **Input richiesti**: campi che l'utente compila prima di lanciare

    **Esempi**: bulk email a contatti selezionati; genera report ad hoc; script di bonifica dati.
  </Accordion>
</AccordionGroup>

## Filtri sui trigger

Oltre ai parametri base, ogni trigger accetta filtri per non attivare workflow su ogni record:

```
Record created AND
  deal.value > 10000 AND
  deal.stage = "Qualified"
```

Riduce rumore e consumo risorse.

## Rate limiting

<Warning>
  Per proteggere l'infrastruttura, alcuni trigger hanno limiti:

  * Scheduled: max 1 esecuzione al minuto per workflow
  * Webhook: max 100 chiamate/secondo per workspace
  * Email: max 1.000 email parseate/giorno (piani base)

  Limiti alzati su piani Enterprise.
</Warning>

## Debug trigger

In **Cronologia esecuzioni** vedi per ogni trigger:

* Quando è scattato
* Che record / payload ha attivato
* Quale ramo è stato percorso
* Risultato finale

## Domande frequenti

<AccordionGroup>
  <Accordion title="Posso avere più trigger per lo stesso workflow?">No, 1 trigger per workflow. Se servono più sorgenti, duplica il workflow o usa un trigger generico + condizioni.</Accordion>
  <Accordion title="I trigger webhook sono sincroni?">No, asincroni. Arya risponde 200 immediatamente; l'esecuzione può richiedere secondi o minuti.</Accordion>
  <Accordion title="Posso disattivare temporaneamente un trigger?">Sì, switch **Attivo/Pausato** sul workflow.</Accordion>
</AccordionGroup>