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

# Slack-integratie

> Koppel Living Security aan Slack om trainingsmeldingen, beveiligingswaarschuwingen en Playbook-updates naar uw workspace te sturen.

De Slack-integratie stelt Living Security in staat om meldingen rechtstreeks naar uw Slack-workspace te sturen. Informeer gebruikers over toegewezen trainingen, waarschuw beveiligingsteams over risicogebeurtenissen en houd managers op de hoogte van de voortgang van hun team.

<Note>
  Voor het instellen van de levering van Nudges en Playbooks begint u bij **Instellingen → Communications → Channels** en klikt u op de kaart **Slack**. Deze pagina behandelt de onderliggende configuratie van de Slack-app.
</Note>

## Vereisten

Controleer voordat u de Slack-integratie configureert of u over het volgende beschikt:

* Beheerdersrechten voor de Slack-workspace of rechten om apps te installeren
* Toegang tot het Slack API-portaal op [api.slack.com](https://api.slack.com)
* Beheerdersrechten voor Living Security

## Een Slack-app maken

<Steps>
  <Step title="Een nieuwe Slack-app maken">
    1. Ga naar [api.slack.com/apps](https://api.slack.com/apps)
    2. Klik op **Create New App**
    3. Selecteer **From scratch**
    4. Voer een naam voor de app in (bijvoorbeeld "Living Security")
    5. Selecteer uw workspace
    6. Klik op **Create App**

    <Check>
      Uw app verschijnt in het Slack API-dashboard.
    </Check>
  </Step>

  <Step title="OAuth-scopes configureren">
    1. Klik in de linkerzijbalk op **OAuth & Permissions**
    2. Scrol naar **Bot Token Scopes**
    3. Voeg de volgende scopes toe:

    | Scope | Doel |
    | - | - |
    | `chat:write` | Berichten naar kanalen sturen |
    | `chat:write.public` | Berichten naar kanalen sturen zonder eraan deel te nemen |
    | `users:read` | Gebruikersinformatie opzoeken |
    | `users:read.email` | Gebruikers koppelen op basis van e-mailadres |

    <Tip>
      Voeg alleen de scopes toe die uw organisatie nodig heeft. Minder scopes betekent betere beveiliging.
    </Tip>
  </Step>

  <Step title="De app in uw workspace installeren">
    1. Scrol naar de bovenkant van **OAuth & Permissions**
    2. Klik op **Install to Workspace**
    3. Controleer de machtigingen en klik op **Allow**

    <Check>
      Er verschijnt een **Bot User OAuth Token** dat begint met `xoxb-`.
    </Check>
  </Step>

  <Step title="Uw signing secret ophalen">
    1. Klik in de linkerzijbalk op **Basisinformatie**
    2. Scrol naar **App Credentials**
    3. Kopieer de **Signing Secret**

    <Warning>
      Houd uw signing secret geheim. Deel deze nooit in openbare repositories of logboeken.
    </Warning>
  </Step>
</Steps>

## Inloggegevens toevoegen in Living Security

<Steps>
  <Step title="Naar Uitgaande integraties navigeren">
    Ga naar **Instellingen → Integraties → Uitgaand** en klik op de kaart **Slack**.
  </Step>

  <Step title="Uw inloggegevens toevoegen">
    Klik op **Add Credential** en voer het volgende in:

    <ParamField body="botToken" type="string" required>
      Uw Bot User OAuth Token dat begint met `xoxb-`. Te vinden onder **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      De Signing Secret van uw app. Te vinden onder **Basisinformatie → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Optioneel. Alleen vereist voor Socket Mode-verbindingen. Begint met `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Optioneel. Een herkenbare naam voor deze inloggegevens (bijvoorbeeld "Production Slack").
    </ParamField>
  </Step>

  <Step title="Opslaan en verifiëren">
    Klik op **Opslaan**. De inloggegevens verschijnen in uw lijst met de status **actief**.

    <Check>
      Uw Slack-integratie is nu verbonden en gereed om meldingen te versturen.
    </Check>
  </Step>
</Steps>

## Soorten meldingen

Zodra de koppeling tot stand is gebracht, kan Living Security de volgende soorten meldingen naar Slack sturen:

| Melding | Beschrijving |
| - | - |
| Trainingstoewijzingen | Waarschuwen gebruikers wanneer een nieuwe training is toegewezen |
| Trainingsherinneringen | Herinneren gebruikers aan naderende deadlines |
| Voltooiingsbevestigingen | Bevestigen dat een training is voltooid |
| Beveiligingswaarschuwingen | Informeren beveiligingsteams over risicogebeurtenissen |
| Playbook-samenvattingen | Sturen periodieke updates over de prestaties van Playbooks |

## Probleemoplossing

<AccordionGroup>
  <Accordion title="Berichten verschijnen niet in kanalen">
    * Controleer of de bot is uitgenodigd voor het kanaal (`/invite @YourBotName`)
    * Controleer of de scope `chat:write.public` is toegevoegd om zonder deelname in openbare kanalen te kunnen posten
    * Controleer of de kanaal-ID juist is (gebruik de kanaal-ID, niet de naam)
  </Accordion>

  <Accordion title="Foutmelding voor ongeldig token">
    * Zorg dat u het volledige token hebt gekopieerd, beginnend met `xoxb-`
    * Controleer of de app nog steeds in uw workspace is geïnstalleerd
    * Controleer of het token opnieuw is gegenereerd (dan moet het in Living Security worden bijgewerkt)
  </Accordion>

  <Accordion title="Beperking van het aantal verzoeken">
    Slack beperkt het aantal API-verzoeken. Als u foutmeldingen over deze beperking ziet:

    * Verlaag de frequentie van meldingen
    * Bundel meerdere meldingen in samenvattende berichten
    * Neem contact op met support voor toepassingen met een groot volume
  </Accordion>
</AccordionGroup>

## Best practices

<Tip>
  Maak een apart Slack-kanaal aan voor meldingen van Living Security (bijvoorbeeld `#security-training`) om waarschuwingen overzichtelijk te houden en de ruis in algemene kanalen te beperken.
</Tip>

* Gebruik duidelijke labels voor inloggegevens wanneer u meerdere workspaces beheert
* Controleer regelmatig welke kanalen meldingen ontvangen
* Stel samenvattingen van meldingen in in plaats van afzonderlijke berichten voor waarschuwingen met een groot volume
* Controleer elk kwartaal de machtigingen van de Slack-app en verwijder ongebruikte scopes

## Gerelateerd

<CardGroup cols={2}>
  <Card title="E-mailintegratie" icon="envelope" href="/nl/integrations/outbound/email">
    Configureer e-mail als bezorgkanaal.
  </Card>

  <Card title="Teams-integratie" icon="microsoft" href="/nl/integrations/outbound/teams">
    Configureer Microsoft Teams als bezorgkanaal.
  </Card>

  <Card title="Communicatielogboek" icon="clock-rotate-left" href="/nl/features/communications/log">
    Volg de bezorgstatus en de geschiedenis van Slack-berichten.
  </Card>

  <Card title="Een nieuwe integratie instellen" icon="plug" href="/nl/integrations/managing/setup">
    Algemene handleiding voor het instellen van integraties.
  </Card>
</CardGroup>


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