> ## 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.

# Lezione 8 — La tua prima automazione

> Costruisci un workflow: deal vinto → crea progetto + notifica Slack + email al cliente.

<Note>
  **Lezione 8 di 10** · Circa 6 minuti · Prerequisito: [Lezione 7 — Preventivi e fatturazione](/it/arya-101/lezione-7-preventivi-e-fatturazione)
</Note>

## Cosa imparerai

* Come funziona il motore di automazione di Arya
* Come costruire un workflow visuale
* Come testarlo e monitorarne le esecuzioni

## Come funziona

Un **workflow** è una sequenza di azioni che parte al verificarsi di un **trigger**. Struttura:

```
Trigger (quando succede X) → Condizione (se Y) → Azione (fai Z)
```

Puoi concatenare più azioni, aggiungere rami condizionali, usare variabili e riferimenti ai record.

## Triggers disponibili

<AccordionGroup>
  <Accordion title="Record created / updated / deleted">
    Ogni volta che un record viene creato, modificato o eliminato. Filtri possibili per campo.
  </Accordion>

  <Accordion title="Status changed">
    Quando un record cambia stato (es. deal → Won, fattura → Pagata).
  </Accordion>

  <Accordion title="Scheduled (cron)">
    A intervalli regolari: ogni ora, ogni giorno alle 9, ogni lunedì, ecc.
  </Accordion>

  <Accordion title="Webhook in ingresso">
    URL pubblico che ricevi da sistemi esterni (Zapier, Make, API custom).
  </Accordion>

  <Accordion title="Form submitted">
    Un form pubblico di Arya viene compilato.
  </Accordion>

  <Accordion title="Email received">
    Arriva un'email a un indirizzo monitorato.
  </Accordion>

  <Accordion title="Manual">
    Il workflow parte solo quando lo lanci manualmente da un record o da una lista.
  </Accordion>
</AccordionGroup>

## Azioni disponibili

Oltre 30 azioni raggruppate in: record (crea, aggiorna, elimina, duplica), comunicazione (email, SMS, Slack, WhatsApp, Telegram), integrazioni (DocuSign, FatturaInCloud, Google Calendar), flusso (condizione, branch, attesa, loop), dati (trasforma, calcola, webhook in uscita).

## Costruisci il tuo primo workflow

Esempio: "Quando chiudo un deal come vinto, crea un progetto e avvisa #vendite su Slack".

<Steps>
  <Step title="Apri Automazioni">
    Click su **Automazioni** nella sidebar → **+ Nuovo workflow**.
  </Step>

  <Step title="Scegli il trigger">
    Seleziona **Status changed** sull'oggetto `Deal`.

    * Oggetto: `Deal`
    * Campo: `Stage`
    * Da: qualsiasi
    * A: `Won`

    <Frame>
      <img src="https://mintcdn.com/agevole/BUuJGD62nuns4mJL/images/arya-101/lesson-08/it/workflow-trigger.svg?fit=max&auto=format&n=BUuJGD62nuns4mJL&q=85&s=d82fec7673891c49db3a2258598f099f" alt="Selezione trigger 'Status changed' con filtro su stage Won" width="1200" height="720" data-path="images/arya-101/lesson-08/it/workflow-trigger.svg" />
    </Frame>
  </Step>

  <Step title="Aggiungi azione 'Crea progetto'">
    Click **+ Azione** → seleziona **Create record** → oggetto `Project`.

    Mappa i campi:

    * Nome progetto: `{{trigger.deal.name}}`
    * Cliente: `{{trigger.deal.company}}`
    * Budget: `{{trigger.deal.value}}`
    * Data inizio: `{{now}}`
  </Step>

  <Step title="Aggiungi azione 'Notifica Slack'">
    Click **+ Azione** → **Send Slack message** → canale `#vendite`.

    Messaggio:

    ```
    🎉 Deal vinto! {{trigger.deal.name}} — {{trigger.deal.value}} €
    Cliente: {{trigger.deal.company.name}}
    Owner: {{trigger.deal.owner.name}}
    Progetto creato: {{output.project.url}}
    ```

    <Note>
      Per Slack serve l'integrazione attiva — vedi [Integrazione Slack](/it/integrazioni/slack).
    </Note>
  </Step>

  <Step title="Aggiungi azione 'Email al cliente'">
    Click **+ Azione** → **Send email** → destinatario `{{trigger.deal.primary_contact.email}}`.

    Usa un template salvato o scrivi inline. Allegati: può includere il preventivo accettato.
  </Step>

  <Step title="Salva e attiva">
    Click **Salva** → attiva lo switch **Attivo**. Il workflow parte da subito ai prossimi eventi.
  </Step>
</Steps>

## Testare prima di produzione

<Steps>
  <Step title="Modalità test">
    Prima di attivare, click **Esegui in test** → seleziona un record di esempio. Arya simula tutte le azioni mostrandoti gli input e output senza effetti reali.
  </Step>

  <Step title="Dry run in produzione">
    Se attivi con la flag **Dry run**, le azioni vengono loggate ma non eseguite. Utile per validare su dati reali.
  </Step>
</Steps>

## Monitoraggio e debug

Nella sezione **Cronologia run** vedi ogni esecuzione:

* Data/ora
* Record trigger
* Stato: `Successo`, `Errore`, `Annullato`
* Durata
* Log dettagliato per ogni azione

<Frame>
  <img src="https://mintcdn.com/agevole/BUuJGD62nuns4mJL/images/arya-101/lesson-08/it/workflow-runs.svg?fit=max&auto=format&n=BUuJGD62nuns4mJL&q=85&s=4b7e220575f2a727ca2a8ded98eadc76" alt="Tabella cronologia esecuzioni workflow con stato e durata" width="1200" height="720" data-path="images/arya-101/lesson-08/it/workflow-runs.svg" />
</Frame>

Se un'azione fallisce (es. Slack offline), Arya può ritentare automaticamente secondo la politica che imposti.

## Webhook esposti

Se vuoi far partire un workflow da un sistema esterno, Arya genera un URL webhook univoco. Incollalo in Zapier/Make/sistemi custom — ogni chiamata POST avvia il workflow con il payload ricevuto.

## Verifica

<Check>Hai creato un workflow con almeno un trigger e un'azione</Check>
<Check>Hai testato in modalità test prima di attivarlo</Check>
<Check>Sai dove controllare la cronologia delle esecuzioni</Check>

## Prossima lezione

<Card title="Lezione 9 — Report e dashboard" icon="arrow-right" href="/it/arya-101/lezione-9-report-e-dashboard">
  Visualizza i tuoi dati con dashboard personalizzate e grafici.
</Card>