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

# Integració amb Slack

> Connecteu Living Security amb Slack per enviar notificacions de formació, alertes de seguretat i actualitzacions de Playbook al vostre espai de treball.

La integració amb Slack permet que Living Security enviï notificacions directament al vostre espai de treball de Slack. Podeu avisar els usuaris de les assignacions de formació, alertar els equips de seguretat sobre esdeveniments de risc i mantenir els responsables informats sobre el progrés de l'equip.

<Note>
  Per configurar el lliurament de Nudges i de Playbooks, comenceu a **Settings → Communications → Channels** i feu clic a la targeta **Slack**. Aquesta pàgina tracta la configuració de l'aplicació de Slack subjacent.
</Note>

## Requisits previs

Abans de configurar la integració amb Slack, assegureu-vos de disposar de:

* Permisos d'administrador de l'espai de treball de Slack o de instal·lació d'aplicacions
* Accés al portal de l'API de Slack a [api.slack.com](https://api.slack.com)
* Privilegis d'administrador de Living Security

## Creació d'una aplicació de Slack

<Steps>
  <Step title="Creeu una aplicació de Slack nova">
    1. Aneu a [api.slack.com/apps](https://api.slack.com/apps)
    2. Feu clic a **Create New App**
    3. Seleccioneu **From scratch**
    4. Introduïu un nom per a l'aplicació (p. ex., «Living Security»)
    5. Seleccioneu el vostre espai de treball
    6. Feu clic a **Create App**

    <Check>
      L'aplicació apareix al tauler de l'API de Slack.
    </Check>
  </Step>

  <Step title="Configureu els àmbits d'OAuth">
    1. A la barra lateral esquerra, feu clic a **OAuth & Permissions**
    2. Desplaceu-vos fins a **Bot Token Scopes**
    3. Afegiu els àmbits següents:

    | Àmbit | Finalitat |
    | - | - |
    | `chat:write` | Enviar missatges als canals |
    | `chat:write.public` | Enviar missatges als canals sense unir-s'hi |
    | `users:read` | Consultar la informació dels usuaris |
    | `users:read.email` | Fer coincidir els usuaris per adreça de correu electrònic |

    <Tip>
      Afegiu només els àmbits que necessiti la vostra organització. Com menys àmbits, més seguretat.
    </Tip>
  </Step>

  <Step title="Instal·leu l'aplicació a l'espai de treball">
    1. Desplaceu-vos a la part superior d'**OAuth & Permissions**
    2. Feu clic a **Install to Workspace**
    3. Reviseu els permisos i feu clic a **Allow**

    <Check>
      Apareix un **Bot User OAuth Token** que comença per `xoxb-`.
    </Check>
  </Step>

  <Step title="Obtingueu el signing secret">
    1. A la barra lateral esquerra, feu clic a **Basic Information**
    2. Desplaceu-vos fins a **App Credentials**
    3. Copieu el **Signing Secret**

    <Warning>
      Mantingueu el signing secret en privat. No el compartiu mai en repositoris públics ni en registres.
    </Warning>
  </Step>
</Steps>

## Addició de credencials a Living Security

<Steps>
  <Step title="Navegueu a Outbound Integrations">
    Aneu a **Settings → Integrations → Outbound** i feu clic a la targeta **Slack**.
  </Step>

  <Step title="Afegiu les credencials">
    Feu clic a **Add Credential** i introduïu:

    <ParamField body="botToken" type="string" required>
      El Bot User OAuth Token, que comença per `xoxb-`. Es troba a **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      El Signing Secret de l'aplicació. Es troba a **Basic Information → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Opcional. Només és necessari per a les connexions en mode Socket. Comença per `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Opcional. Un nom descriptiu per a aquesta credencial (p. ex., «Production Slack»).
    </ParamField>
  </Step>

  <Step title="Deseu i verifiqueu">
    Feu clic a **Save**. La credencial apareix a la llista amb l'estat **active**.

    <Check>
      La integració amb Slack ja està connectada i a punt per enviar notificacions.
    </Check>
  </Step>
</Steps>

## Tipus de notificacions

Un cop connectada, Living Security pot enviar a Slack els tipus de notificacions següents:

| Notificació | Descripció |
| - | - |
| Assignacions de formació | Avisa els usuaris quan se'ls assigna una formació nova |
| Recordatoris de formació | Recorda als usuaris els terminis que s'acosten |
| Confirmacions de finalització | Confirma quan s'ha completat una formació |
| Alertes de seguretat | Notifica els equips de seguretat els esdeveniments de risc |
| Resums de Playbook | Envia actualitzacions periòdiques sobre el rendiment dels Playbooks |

## Resolució de problemes

<AccordionGroup>
  <Accordion title="Els missatges no apareixen als canals">
    * Verifiqueu que el bot ha estat convidat al canal (`/invite @YourBotName`)
    * Comproveu que s'ha afegit l'àmbit `chat:write.public` per publicar en canals públics sense unir-s'hi
    * Confirmeu que l'identificador del canal és correcte (utilitzeu l'identificador del canal, no el nom)
  </Accordion>

  <Accordion title="Error de token no vàlid">
    * Assegureu-vos d'haver copiat el token complet, que comença per `xoxb-`
    * Verifiqueu que l'aplicació continua instal·lada a l'espai de treball
    * Comproveu si el token s'ha regenerat (caldrà actualitzar-lo a Living Security)
  </Accordion>

  <Accordion title="Limitació de velocitat">
    Slack limita les sol·licituds a l'API. Si veieu errors de límit de velocitat:

    * Reduïu la freqüència de les notificacions
    * Consolideu diverses notificacions en missatges de resum
    * Poseu-vos en contacte amb el suport per a casos d'ús de gran volum
  </Accordion>
</AccordionGroup>

## Bones pràctiques

<Tip>
  Creeu un canal de Slack dedicat a les notificacions de Living Security (p. ex., `#security-training`) per mantenir les alertes organitzades i reduir el soroll als canals generals.
</Tip>

* Utilitzeu etiquetes de credencial significatives quan gestioneu diversos espais de treball
* Auditeu regularment quins canals reben notificacions
* Configureu resums de notificacions en lloc de missatges individuals per a les alertes de gran volum
* Reviseu trimestralment els permisos de l'aplicació de Slack i elimineu els àmbits que no s'utilitzin

## Contingut relacionat

<CardGroup cols={2}>
  <Card title="Integració amb el correu electrònic" icon="envelope" href="/ca/integrations/outbound/email">
    Configureu el correu electrònic com a canal de lliurament.
  </Card>

  <Card title="Integració amb Teams" icon="microsoft" href="/ca/integrations/outbound/teams">
    Configureu Microsoft Teams com a canal de lliurament.
  </Card>

  <Card title="Registre de comunicacions" icon="clock-rotate-left" href="/ca/features/communications/log">
    Feu el seguiment de l'estat i l'historial de lliurament de Slack.
  </Card>

  <Card title="Com configurar una integració nova" icon="plug" href="/ca/integrations/managing/setup">
    Guia general de configuració d'integracions.
  </Card>
</CardGroup>


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