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

# Azioni

> La libreria di azioni disponibili: record, email, messaggi, HTTP, integrazioni.

Le **azioni** sono i "mattoni" che concatenate nei workflow. Arya offre 30+ azioni native organizzate per categoria.

## Categorie

<CardGroup cols={2}>
  <Card title="Record">Crea, aggiorna, elimina, duplica record di qualsiasi oggetto.</Card>
  <Card title="Comunicazione">Email, SMS, Slack, WhatsApp, Telegram, notifiche push in-app.</Card>
  <Card title="Integrazioni">Azioni native di DocuSign, FatturaInCloud, Google Calendar, Notion, Trello, ecc.</Card>
  <Card title="Flusso">Condizione IF, Branch, Loop For each, Wait, Stop workflow.</Card>
  <Card title="Dati">Trasforma (map), Aggrega (sum/count), Calcola formule, HTTP Request.</Card>
  <Card title="AI">Chiama AryaChat, genera documento, riassume, estrae dati.</Card>
</CardGroup>

## Azioni record

<AccordionGroup>
  <Accordion title="Create record">
    Crea un nuovo record di qualsiasi oggetto. Mappa i campi con variabili.

    **Esempio**:

    ```
    Create Project:
      name: {{trigger.deal.name}}
      company: {{trigger.deal.company}}
      budget: {{trigger.deal.value}}
      start_date: {{now}}
    ```
  </Accordion>

  <Accordion title="Update record">
    Aggiorna campi di un record esistente.
  </Accordion>

  <Accordion title="Delete record">
    Elimina un record (soft-delete, recuperabile).
  </Accordion>

  <Accordion title="Duplicate record">
    Clona un record con possibilità di sovrascrivere campi.
  </Accordion>

  <Accordion title="Link records">
    Collega due record esistenti (es. un contatto a un deal).
  </Accordion>

  <Accordion title="Add to list">
    Aggiunge un record a una lista statica.
  </Accordion>
</AccordionGroup>

## Azioni comunicazione

<AccordionGroup>
  <Accordion title="Send email">
    Invia email via SMTP Arya o via tue integrazioni Gmail/SendGrid.

    **Parametri**: da (mittente), a, cc, bcc, oggetto, corpo (HTML supportato), allegati.
  </Accordion>

  <Accordion title="Send SMS">
    Via provider SMS configurato (Twilio, MessageBird).
  </Accordion>

  <Accordion title="Post Slack message">
    Canale o DM. Supporta formattazione Slack (blocks, allegati, bottoni interattivi).
  </Accordion>

  <Accordion title="Send WhatsApp message">
    Via [integrazione WhatsApp Business](/it/integrazioni/whatsapp). Richiede template approvati per messaggi outbound.
  </Accordion>

  <Accordion title="Send Telegram message">
    Personale o a gruppo/canale.
  </Accordion>

  <Accordion title="Create in-app notification">
    Notifica Arya per utenti specifici.
  </Accordion>
</AccordionGroup>

## Azioni flusso

<AccordionGroup>
  <Accordion title="IF condition">
    Ramo T/F in base a condizione. Vedi [workflow builder](/it/automazioni/workflow-builder).
  </Accordion>

  <Accordion title="Switch / branch">
    Più rami in base al valore di un campo (es. `regione: Nord → branch A, Sud → branch B, Estero → branch C`).
  </Accordion>

  <Accordion title="For each">
    Loop su una lista di record. Esegue azioni annidate per ogni item.
  </Accordion>

  <Accordion title="Wait">
    Pausa. Parametri:

    * Durata fissa (es. 1 ora, 1 giorno)
    * Fino a data/ora
    * Fino a evento (es. quando questo deal passa a Won)
  </Accordion>

  <Accordion title="Stop workflow">
    Interrompe l'esecuzione (utile in condizioni di errore gravi).
  </Accordion>
</AccordionGroup>

## Azioni dati

<AccordionGroup>
  <Accordion title="HTTP request">
    Chiama qualsiasi API REST esterna. GET, POST, PUT, DELETE. Headers e body custom. Parse risposta JSON.

    **Esempio**: notifica sistema esterno al cambio stato deal.
  </Accordion>

  <Accordion title="Transform / map">
    Trasforma dati: `rename`, `format_date`, `concat`, `uppercase`, ecc.
  </Accordion>

  <Accordion title="Aggregate">
    Su una lista: somma, media, count, max, min.
  </Accordion>

  <Accordion title="Calculate">
    Formula personalizzata con output numerico o stringa.
  </Accordion>
</AccordionGroup>

## Azioni AI

<AccordionGroup>
  <Accordion title="Ask AryaChat">
    Prompt libero verso AryaChat. Output: testo. Consuma crediti AI.

    **Esempio**: `Scrivi email di benvenuto professionale per {{trigger.contact.first_name}} di {{trigger.contact.company.name}}`.
  </Accordion>

  <Accordion title="Generate document">
    Genera PDF/DOCX da template + dati dinamici.

    **Esempio**: contratto NDA con dati cliente precompilati.
  </Accordion>

  <Accordion title="Summarise">
    Riassume un testo lungo in N frasi / N caratteri.
  </Accordion>

  <Accordion title="Extract data">
    Estrae dati strutturati da testo libero: email, nomi, importi, date.

    **Esempio**: da un'email di richiesta estrae nome, ruolo, azienda → crea contatto.
  </Accordion>
</AccordionGroup>

## Azioni integrazioni native

Per ogni integrazione attiva (vedi [Integrazioni](/it/integrazioni/overview)), Arya aggiunge azioni specifiche:

* **Google Calendar**: crea evento, invita partecipanti
* **DocuSign**: invia busta per firma
* **FatturaInCloud**: emetti fattura elettronica
* **WooCommerce**: crea ordine, aggiorna stock
* **Notion**: crea pagina nel DB specifico
* **Trello**: crea card in una lista
* **Meta Business**: importa lead da Facebook Ads

## Output e concatenazione

Ogni azione produce un **output** consumabile dalle azioni successive:

```
Azione 1 (Create record) → output: {id, url, name, ...}
Azione 2 (Send email) → body: "Progetto creato: {{action_1.output.url}}"
```

## Domande frequenti

<AccordionGroup>
  <Accordion title="Posso creare azioni custom?">Non direttamente. Ma con **HTTP request** chiami qualsiasi API, effettivamente permettendo integrazione con qualsiasi sistema.</Accordion>
  <Accordion title="Le azioni AI consumano crediti?">Sì. Vedi stime in [Lezione 10](/it/arya-101/lezione-10-ai-e-aryachat).</Accordion>
  <Accordion title="Posso salvare bundle di azioni come 'sub-workflow'?">Sì, come sub-workflow richiamabile da altri workflow. Utile per DRY.</Accordion>
</AccordionGroup>