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

# Intégration Slack

> Connectez Living Security à Slack pour envoyer à votre espace de travail des notifications de formation, des alertes de sécurité et des mises à jour de Playbook.

L'intégration Slack permet à Living Security d'envoyer des notifications directement dans votre espace de travail Slack. Informez les utilisateurs de leurs affectations de formation, alertez les équipes de sécurité en cas d'événements à risque et tenez les responsables au courant de la progression de leurs équipes.

<Note>
  Pour configurer l'envoi des coups de pouce et des Playbooks, accédez à **Paramètres → Communications → Canaux** et cliquez sur la carte **Slack**. Cette page traite de la configuration sous-jacente de l'application Slack.
</Note>

## Prérequis

Avant de configurer l'intégration Slack, assurez-vous de disposer des éléments suivants :

* Des autorisations d'administrateur de l'espace de travail Slack ou d'installation d'applications
* Un accès au portail API de Slack à l'adresse [api.slack.com](https://api.slack.com)
* Des privilèges d'administrateur Living Security

## Création d'une application Slack

<Steps>
  <Step title="Créer une nouvelle application Slack">
    1. Accédez à [api.slack.com/apps](https://api.slack.com/apps)
    2. Cliquez sur **Create New App**
    3. Sélectionnez **From scratch**
    4. Saisissez un nom d'application (par exemple, « Living Security »)
    5. Sélectionnez votre espace de travail
    6. Cliquez sur **Create App**

    <Check>
      Votre application apparaît dans le tableau de bord de l'API Slack.
    </Check>
  </Step>

  <Step title="Configurer les portées OAuth">
    1. Dans la barre latérale gauche, cliquez sur **OAuth & Permissions**
    2. Faites défiler jusqu'à **Bot Token Scopes**
    3. Ajoutez les portées suivantes :

    | Portée | Objectif |
    | - | - |
    | `chat:write` | Envoyer des messages dans les canaux |
    | `chat:write.public` | Envoyer des messages dans les canaux sans les rejoindre |
    | `users:read` | Rechercher des informations sur les utilisateurs |
    | `users:read.email` | Associer les utilisateurs par adresse e-mail |

    <Tip>
      N'ajoutez que les portées dont votre organisation a besoin. Moins il y a de portées, meilleure est la sécurité.
    </Tip>
  </Step>

  <Step title="Installer l'application dans votre espace de travail">
    1. Faites défiler jusqu'en haut de **OAuth & Permissions**
    2. Cliquez sur **Install to Workspace**
    3. Vérifiez les autorisations, puis cliquez sur **Allow**

    <Check>
      Un **Bot User OAuth Token** commençant par `xoxb-` s'affiche.
    </Check>
  </Step>

  <Step title="Récupérer votre secret de signature">
    1. Dans la barre latérale gauche, cliquez sur **Basic Information**
    2. Faites défiler jusqu'à **App Credentials**
    3. Copiez le **Signing Secret**

    <Warning>
      Gardez votre secret de signature confidentiel. Ne le partagez jamais dans des dépôts publics ni dans des journaux.
    </Warning>
  </Step>
</Steps>

## Ajout des identifiants dans Living Security

<Steps>
  <Step title="Accéder aux Intégrations sortantes">
    Accédez à **Paramètres → Intégrations → sortant** et cliquez sur la carte **Slack**.
  </Step>

  <Step title="Ajouter vos identifiants">
    Cliquez sur **Add Credential** et saisissez :

    <ParamField body="botToken" type="string" required>
      Votre Bot User OAuth Token commençant par `xoxb-`. Disponible dans **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      Le Signing Secret de votre application. Disponible dans **Basic Information → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Facultatif. Nécessaire uniquement pour les connexions en Socket Mode. Commence par `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Facultatif. Un nom convivial pour cet identifiant (par exemple, « Slack Production »).
    </ParamField>
  </Step>

  <Step title="Sauvegarder et vérifier">
    Cliquez sur **Sauvegarder**. L'identifiant apparaît dans votre liste avec le statut **actif**.

    <Check>
      Votre intégration Slack est désormais connectée et prête à envoyer des notifications.
    </Check>
  </Step>
</Steps>

## Types de notifications

Une fois la connexion établie, Living Security peut envoyer les types de notifications suivants vers Slack :

| Notification | Description |
| - | - |
| Affectations de formation | Alerter les utilisateurs lorsqu'une nouvelle formation leur est affectée |
| Rappels de formation | Rappeler aux utilisateurs les échéances à venir |
| Confirmations de réalisation | Confirmer qu'une formation a été terminée |
| Alertes de sécurité | Informer les équipes de sécurité des événements à risque |
| Résumés de Playbook | Envoyer des mises à jour périodiques sur les performances des Playbooks |

## Dépannage

<AccordionGroup>
  <Accordion title="Les messages n'apparaissent pas dans les canaux">
    * Vérifiez que le bot a été invité dans le canal (`/invite @YourBotName`)
    * Vérifiez que la portée `chat:write.public` est ajoutée pour publier dans les canaux publics sans les rejoindre
    * Confirmez que l'ID du canal est correct (utilisez l'ID du canal, et non son nom)
  </Accordion>

  <Accordion title="Erreur de jeton non valide">
    * Assurez-vous d'avoir copié le jeton complet commençant par `xoxb-`
    * Vérifiez que l'application est toujours installée dans votre espace de travail
    * Vérifiez si le jeton a été régénéré (une mise à jour dans Living Security est alors nécessaire)
  </Accordion>

  <Accordion title="Limitation de débit">
    Slack limite les requêtes API. Si vous voyez des erreurs de limitation de débit :

    * Réduisez la fréquence des notifications
    * Regroupez plusieurs notifications dans des messages récapitulatifs
    * Contactez le support pour les cas d'utilisation à fort volume
  </Accordion>
</AccordionGroup>

## Bonnes pratiques

<Tip>
  Créez un canal Slack dédié aux notifications de Living Security (par exemple, `#security-training`) afin de garder les alertes organisées et de réduire le bruit dans les canaux généraux.
</Tip>

* Utilisez des libellés d'identifiants explicites lorsque vous gérez plusieurs espaces de travail
* Vérifiez régulièrement quels canaux reçoivent des notifications
* Configurez des récapitulatifs de notifications plutôt que des messages individuels pour les alertes à fort volume
* Passez en revue chaque trimestre les autorisations de l'application Slack et supprimez les portées inutilisées

## Voir aussi

<CardGroup cols={2}>
  <Card title="Intégration e-mail" icon="envelope" href="/fr/integrations/outbound/email">
    Configurez l'e-mail comme canal de diffusion.
  </Card>

  <Card title="Intégration Teams" icon="microsoft" href="/fr/integrations/outbound/teams">
    Configurez Microsoft Teams comme canal de diffusion.
  </Card>

  <Card title="Journal des communications" icon="clock-rotate-left" href="/fr/features/communications/log">
    Suivez l'état et l'historique de livraison des messages Slack.
  </Card>

  <Card title="Comment configurer une nouvelle intégration" icon="plug" href="/fr/integrations/managing/setup">
    Guide général de configuration des intégrations.
  </Card>
</CardGroup>


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