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

# Notifiche workspace

> Configura quali eventi generano notifiche e come sono distribuite.

Gli Admin configurano a livello workspace quali eventi generano notifiche e i canali di default. Ogni utente può poi personalizzare le sue.

## Policy workspace

<Steps>
  <Step title="Impostazioni → Notifiche workspace">Solo Admin.</Step>

  <Step title="Eventi globali">
    Per ogni tipo di evento (deal won, fattura scaduta, task assegnato...):

    * **Sempre notifica**: ignora preferenze utente
    * **Default utente**: l'utente può disabilitare
    * **Opt-in**: disabilitato di default, utente può attivare
  </Step>

  <Step title="Canali default">
    Per i nuovi utenti, canali pre-selezionati:

    * Push mobile
    * Email
    * Slack (se integrato)
    * In-app
  </Step>
</Steps>

## Eventi notificabili

| Categoria       | Eventi                                                    |
| --------------- | --------------------------------------------------------- |
| **CRM**         | Deal creato/assegnato, stage cambiato, chiuso vinto/perso |
| **Task**        | Assegnato, scaduto, completato, commento ricevuto         |
| **HR**          | Ferie richieste, approvate, nuovo dipendente              |
| **Finance**     | Fattura emessa, pagata, scaduta                           |
| **Automazioni** | Workflow fallito, webhook ricevuto                        |
| **Sistema**     | Nuova versione Arya, manutenzione programmata             |
| **Social**      | Menzioni, reazioni su bulletin                            |

## Granularità

Ogni evento può avere regole specifiche:

<AccordionGroup>
  <Accordion title="Per ruolo">
    Alcuni eventi notificano solo certi ruoli. Es. "Fattura > 10.000€ in scadenza" → solo CFO + Admin.
  </Accordion>

  <Accordion title="Per soglia">
    "Deal won" notifica solo team vendite se valore > 5.000€.
  </Accordion>

  <Accordion title="Per condizioni">
    "Task scaduto" notifica solo se priorità = Alta o Urgente.
  </Accordion>
</AccordionGroup>

## Ore silenziose workspace

Configura orari in cui il workspace non invia notifiche (rispetta work-life balance):

* **Weekend**: nessuna notifica non critica
* **Fuori orario**: es. 19:00-08:00 feriali
* **Festività**: auto-silenziate

Eventi `Critici` bypassano (es. workflow rotto che blocca fatturazione).

## Template notifiche

Personalizza i messaggi di notifica:

<Steps>
  <Step title="Impostazioni → Notifiche → Template" />

  <Step title="Scegli evento">Es. "Deal won".</Step>

  <Step title="Edita template">
    * **Subject email**: `🎉 Deal {{deal.name}} chiuso vinto!`
    * **Body email**: markdown con variabili
    * **Push mobile**: breve (max 200 char)
    * **Slack**: supporto blocks
  </Step>

  <Step title="Preview">Vedi render con dati di esempio.</Step>
</Steps>

## Branding email

Per email in uscita:

* Logo workspace in header
* Colori brand
* Firma personalizzata per ruolo (es. "Il team di Acme SpA")
* Footer con link utili (FAQ, contatti)

## Integrazione Slack / Teams

Se il tuo team usa Slack o Microsoft Teams come canale primario:

<Steps>
  <Step title="Collega integrazione">[Slack](/it/integrazioni/slack) o Teams.</Step>
  <Step title="Mappa eventi a canali">Es. "Deal won" → #celebrazioni, "Task scaduto" → #operations.</Step>
  <Step title="Regole di routing">Escludi eventi che inonderebbero i canali (es. "commento su task" → DM diretto invece di canale).</Step>
</Steps>

## Monitoring

Dashboard **Impostazioni → Notifiche → Analytics**:

* Volume notifiche inviate
* Open rate email
* Canali più usati
* Utenti con più silenzi (potrebbero essere sopraffatti)

## Domande frequenti

<AccordionGroup>
  <Accordion title="Un utente può silenziare completamente le notifiche?">Sì, ma eventi `Critici` (marcati dall'Admin) non sono silenziabili.</Accordion>
  <Accordion title="Come evitare il burnout da notifiche?">Riduci eventi notificabili. Usa digest giornaliero invece di real-time per eventi non urgenti.</Accordion>
</AccordionGroup>