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

# Integrazione con Slack

> Collegate Living Security a Slack per inviare al vostro workspace notifiche di formazione, avvisi di sicurezza e aggiornamenti dei Playbook.

L'integrazione con Slack consente a Living Security di inviare notifiche direttamente al vostro workspace Slack. Potete informare gli utenti sulle assegnazioni di formazione, avvisare i team di sicurezza in caso di eventi di rischio e tenere aggiornati i responsabili sui progressi del team.

<Note>
  Per configurare l'invio di Nudge e Playbook, partite da **Impostazioni → Comunicazioni → Canali** e fate clic sulla scheda **Slack**. Questa pagina descrive la configurazione dell'app Slack sottostante.
</Note>

## Prerequisiti

Prima di configurare l'integrazione con Slack, assicuratevi di disporre di:

* Autorizzazioni di amministratore del workspace Slack o di installazione delle app
* Accesso al portale API di Slack su [api.slack.com](https://api.slack.com)
* Privilegi di amministratore in Living Security

## Creazione di un'app Slack

<Steps>
  <Step title="Creare una nuova app Slack">
    1. Accedete a [api.slack.com/apps](https://api.slack.com/apps)
    2. Fate clic su **Create New App**
    3. Selezionate **From scratch**
    4. Inserite un nome per l'app (ad es. "Living Security")
    5. Selezionate il vostro workspace
    6. Fate clic su **Create App**

    <Check>
      La vostra app compare nella dashboard delle API di Slack.
    </Check>
  </Step>

  <Step title="Configurare gli ambiti OAuth">
    1. Nella barra laterale sinistra, fate clic su **OAuth & Permissions**
    2. Scorrete fino a **Bot Token Scopes**
    3. Aggiungete i seguenti ambiti:

    | Ambito | Finalità |
    | - | - |
    | `chat:write` | Inviare messaggi ai canali |
    | `chat:write.public` | Inviare messaggi ai canali senza parteciparvi |
    | `users:read` | Cercare le informazioni sugli utenti |
    | `users:read.email` | Associare gli utenti tramite indirizzo email |

    <Tip>
      Aggiungete solo gli ambiti necessari alla vostra organizzazione. Meno ambiti significano maggiore sicurezza.
    </Tip>
  </Step>

  <Step title="Installare l'app nel workspace">
    1. Scorrete fino all'inizio di **OAuth & Permissions**
    2. Fate clic su **Install to Workspace**
    3. Verificate le autorizzazioni e fate clic su **Allow**

    <Check>
      Viene visualizzato un **Bot User OAuth Token** che inizia con `xoxb-`.
    </Check>
  </Step>

  <Step title="Ottenere il signing secret">
    1. Nella barra laterale sinistra, fate clic su **Basic Information**
    2. Scorrete fino a **App Credentials**
    3. Copiate il **Signing Secret**

    <Warning>
      Mantenete riservato il signing secret. Non condividetelo mai in repository pubblici o nei log.
    </Warning>
  </Step>
</Steps>

## Aggiunta delle credenziali in Living Security

<Steps>
  <Step title="Accedere alle integrazioni in uscita">
    Andate su **Impostazioni → Integrazioni → In uscita** e fate clic sulla scheda **Slack**.
  </Step>

  <Step title="Aggiungere le credenziali">
    Fate clic su **Add Credential** e inserite:

    <ParamField body="botToken" type="string" required>
      Il vostro Bot User OAuth Token che inizia con `xoxb-`. Si trova in **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      Il Signing Secret della vostra app. Si trova in **Basic Information → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Facoltativo. Necessario solo per le connessioni in Socket Mode. Inizia con `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Facoltativo. Un nome descrittivo per questa credenziale (ad es. "Production Slack").
    </ParamField>
  </Step>

  <Step title="Salvare e verificare">
    Fate clic su **Salva**. La credenziale compare nell'elenco con lo stato **attivo**.

    <Check>
      L'integrazione con Slack è ora collegata e pronta a inviare notifiche.
    </Check>
  </Step>
</Steps>

## Tipi di notifica

Una volta effettuato il collegamento, Living Security può inviare a Slack i seguenti tipi di notifica:

| Notifica | Descrizione |
| - | - |
| Assegnazioni di formazione | Avvisano gli utenti quando viene assegnata una nuova formazione |
| Promemoria di formazione | Ricordano agli utenti le scadenze imminenti |
| Conferme di completamento | Confermano il completamento della formazione |
| Avvisi di sicurezza | Informano i team di sicurezza degli eventi di rischio |
| Riepiloghi dei Playbook | Inviano aggiornamenti periodici sulle prestazioni dei Playbook |

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="I messaggi non compaiono nei canali">
    * Verificate che il bot sia stato invitato nel canale (`/invite @YourBotName`)
    * Controllate che sia stato aggiunto l'ambito `chat:write.public` per pubblicare nei canali pubblici senza parteciparvi
    * Verificate che l'ID del canale sia corretto (utilizzate l'ID del canale, non il nome)
  </Accordion>

  <Accordion title="Errore di token non valido">
    * Assicuratevi di aver copiato il token completo che inizia con `xoxb-`
    * Verificate che l'app sia ancora installata nel vostro workspace
    * Controllate se il token è stato rigenerato (è necessario aggiornarlo in Living Security)
  </Accordion>

  <Accordion title="Limitazione della frequenza">
    Slack limita le richieste API. Se visualizzate errori di limitazione della frequenza:

    * Riducete la frequenza delle notifiche
    * Raggruppate più notifiche in messaggi di riepilogo
    * Contattate l'assistenza per i casi d'uso con volumi elevati
  </Accordion>
</AccordionGroup>

## Best practice

<Tip>
  Create un canale Slack dedicato alle notifiche di Living Security (ad es. `#security-training`) per mantenere ordinati gli avvisi e ridurre il rumore nei canali generali.
</Tip>

* Utilizzate etichette significative per le credenziali quando gestite più workspace
* Verificate periodicamente quali canali ricevono le notifiche
* Configurate riepiloghi delle notifiche anziché messaggi singoli per gli avvisi ad alto volume
* Rivedete ogni trimestre le autorizzazioni dell'app Slack e rimuovete gli ambiti inutilizzati

## Argomenti correlati

<CardGroup cols={2}>
  <Card title="Integrazione email" icon="envelope" href="/it/integrations/outbound/email">
    Configurate l'email come canale di invio.
  </Card>

  <Card title="Integrazione con Teams" icon="microsoft" href="/it/integrations/outbound/teams">
    Configurate Microsoft Teams come canale di invio.
  </Card>

  <Card title="Registro delle comunicazioni" icon="clock-rotate-left" href="/it/features/communications/log">
    Monitorate lo stato e la cronologia di recapito di Slack.
  </Card>

  <Card title="Come configurare una nuova integrazione" icon="plug" href="/it/integrations/managing/setup">
    Guida generale alla configurazione delle integrazioni.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.