> ## 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 des notifications de formation, des alertes de sécurité et des mises à jour de guides d'intervention à votre espace de travail.

L'intégration Slack permet à Living Security d'envoyer des notifications directement à votre espace de travail Slack. Informez les utilisateurs des formations qui leur sont attribuées, alertez les équipes de sécurité en cas d'événements à risque et tenez les gestionnaires au courant de la progression de leur équipe.

<Note>
  Pour configurer l'envoi des coups de pouce et des guides d'intervention, commencez par **Paramètres → Communications → Canaux**, puis cliquez sur la carte **Slack**. Cette page traite de la configuration de l'application Slack sous-jacente.
</Note>

## Prérequis

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

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

## Création d'une application Slack

<Steps>
  <Step title="Créer une 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 (p. ex. « 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 renseignements sur les utilisateurs |
    | `users:read.email` | Faire correspondre les utilisateurs par adresse courriel |

    <Tip>
      N'ajoutez que les portées dont votre organisation a besoin. Moins de portées signifie une meilleure 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. Examinez les autorisations, puis cliquez sur **Allow**

    <Check>
      Un **Bot User OAuth Token** commençant par `xoxb-` apparaît.
    </Check>
  </Step>

  <Step title="Obtenir 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**, puis 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-`. Il se trouve sous **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      Le Signing Secret de votre application. Il se trouve sous **Informations de base → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Facultatif. Requis uniquement pour les connexions en mode Socket. Commence par `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Facultatif. Un nom convivial pour cet identifiant (p. ex. « Slack de production »).
    </ParamField>
  </Step>

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

    <Check>
      Votre intégration Slack est maintenant 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 à Slack :

| Notification | Description |
| - | - |
| Attributions de formation | Avertit les utilisateurs lorsqu'une nouvelle formation leur est attribuée |
| Rappels de formation | Rappelle aux utilisateurs les échéances à venir |
| Confirmations d'achèvement | Confirme qu'une formation a été terminée |
| Alertes de sécurité | Informe les équipes de sécurité des événements à risque |
| Résumés de guides d'intervention | Envoie des mises à jour périodiques sur le rendement des guides d'intervention |

## Dépannage

<AccordionGroup>
  <Accordion title="Les messages n'apparaissent pas dans les canaux">
    * Vérifiez que le robot 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 exact (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 du débit">
    Slack limite les requêtes d'API. Si vous voyez des erreurs de limitation du débit :

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

## Pratiques exemplaires

<Tip>
  Créez un canal Slack dédié aux notifications de Living Security (p. ex. `#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 à volume élevé
* Examinez chaque trimestre les autorisations de l'application Slack et retirez les portées inutilisées

## Voir aussi

<CardGroup cols={2}>
  <Card title="Intégration du courriel" icon="envelope" href="/fr-CA/integrations/outbound/email">
    Configurez le courriel comme canal de diffusion.
  </Card>

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

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

  <Card title="Comment configurer une nouvelle intégration" icon="plug" href="/fr-CA/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.