# Intégration Slack

Installez l'application RandomCoffee dans votre espace de travail Slack, choisissez les utilisateurs qu'elle provisionne, ajoutez des canaux privés et désinstallez-la.

import { AccordionItem, Accordions, Steps } from '@prosefly/astro-components';
import Callout from '@components/Callout.astro';
import IntegrationInstallPanel from '@components/app-screens/screens/IntegrationInstallPanel.astro';
import SlackPanel from '@components/app-screens/screens/SlackPanel.astro';

L'intégration Slack relie votre espace de travail RandomCoffee à votre espace de travail Slack. Une fois installée, elle fait deux choses :

- **Provisionnement** : RandomCoffee importe comme membres les utilisateurs de votre espace de travail Slack, ou des canaux que vous choisissez.
- **Messages** : les programmes qui utilisent Slack comme canal de communication envoient leurs invitations et leurs binômes sous forme de messages Slack.

L'intégration est disponible sur tous les plans.

## Avant de commencer

- Vous devez être admin de votre espace de travail RandomCoffee.
- Dans Slack, vous devez avoir le droit d'installer des applications et d'accorder les permissions qu'elles demandent (selon la politique de votre organisation). Sinon, demandez à votre administrateur Slack de faire l'installation avec vous.

## Installer l'intégration Slack

<Steps>

1. **Ouvrez l'intégration Slack.**

   Dans RandomCoffee, ouvrez "Paramètres", allez dans "Configuration", sélectionnez la carte "Intégration Slack" et cliquez sur "Installer".

   <IntegrationInstallPanel integration="slack" alt="Le panneau Intégration Slack, avec &quot;Connectez votre espace de travail Slack&quot; et le bouton Installer" />

2. **Accordez les permissions dans Slack.**

   Vous êtes redirigé vers une page Slack qui demande l'autorisation de connecter RandomCoffee à votre espace de travail. Cliquez sur "Allow". Les permissions sont détaillées [plus bas](#permissions-demandées).

   ![La page Slack où RandomCoffee demande l'accès à l'espace de travail Slack, avec les boutons Cancel et Allow](../../../../../assets/articles/slack/slack-permission-request.jpg)

3. **Choisissez ce qui est provisionné.**

   De retour dans RandomCoffee, choisissez comment provisionner votre espace de travail :

   - "Provisionner tout l'espace de travail" : tous les utilisateurs de votre espace de travail Slack sont importés.
   - "Provisionner des utilisateurs à partir de canaux spécifiques" : seuls les membres des canaux sélectionnés sont importés.

   Cliquez ensuite sur "Provisionnement". Votre choix détermine les utilisateurs Slack que RandomCoffee importe comme membres. Les membres existants sont mis à jour, sans doublon.

</Steps>

Pour savoir ce qui arrive ensuite aux membres (quand ils sont synchronisés, qui est ajouté ou retiré), lisez [Synchroniser les membres depuis Slack ou Microsoft Teams](/fr/admin/members/sync-from-slack-or-teams/).

### Gérer l'intégration

Une fois l'intégration installée, le panneau "Intégration Slack" affiche :

- "Espace de travail" : le nom de l'espace de travail Slack connecté.
- "Permissions" : la liste des permissions accordées par votre espace de travail Slack.
- "Provisionnement" : pour passer de tout l'espace de travail à des canaux spécifiques. Cliquez sur "Enregistrer" après une modification.
- "Actions" : "Mettre à jour les permissions" relance l'autorisation Slack, et "Supprimer" retire l'intégration (voir [Désinstaller l'intégration](#désinstaller-lintégration)).

<SlackPanel alt="Le panneau Intégration Slack une fois connecté, avec l'espace de travail Acme, les permissions accordées, &quot;Provisionner des utilisateurs à partir de canaux spécifiques&quot; avec six canaux, et les boutons Mettre à jour les permissions et Supprimer" />

## Permissions demandées

RandomCoffee demande à Slack les autorisations (scopes) suivantes pour son bot :

| Scope | Ce qu'il permet |
| --- | --- |
| `chat:write` | Envoyer des messages au nom de l'application RandomCoffee |
| `chat:write.public` | Envoyer des messages dans des canaux dont l'application n'est pas membre |
| `channels:read` | Voir les informations de base des canaux publics |
| `channels:join` | Rejoindre des canaux publics |
| `channels:manage` | Gérer les canaux publics auxquels l'application a été ajoutée, et en créer |
| `groups:read` | Voir les informations de base des canaux privés auxquels l'application a été ajoutée |
| `im:read` | Voir les informations de base des messages directs auxquels l'application a été ajoutée |
| `im:write` | Démarrer des messages directs avec des personnes |
| `mpim:read` | Voir les informations de base des messages de groupe auxquels l'application a été ajoutée |
| `mpim:write` | Démarrer des messages de groupe avec des personnes |
| `users:read` | Voir les personnes de l'espace de travail |
| `users:read.email` | Voir l'adresse email des personnes de l'espace de travail |
| `team:read` | Voir le nom, le domaine email et l'icône de l'espace de travail |
| `commands` | Ajouter des raccourcis et des commandes slash |

Vous retrouvez la même liste dans Slack, dans l'onglet "Configuration" de la page de l'application RandomCoffee.

![L'onglet Configuration de l'application RandomCoffee dans le Slack Marketplace, avec la liste des autorisations](../../../../../assets/articles/slack/slack-app-authorizations.jpg)

## Ajouter des canaux privés

Par défaut, RandomCoffee n'a pas accès aux canaux privés. Pour rendre un canal privé disponible pour le provisionnement et comme audience d'un programme, invitez-y l'application :

<Steps>

1. Dans Slack, ouvrez le canal privé.
2. Tapez `/invite @RandomCoffee` dans le champ de message et envoyez-le.
3. Slack confirme que RandomCoffee a été ajouté au canal.
4. De retour dans RandomCoffee, le canal privé apparaît dans la liste des canaux, signalé par un cadenas.

</Steps>

<SlackPanel section="provisioning" alt="Le réglage Provisionnement du panneau Intégration Slack, où le canal privé equipe-people est signalé par un cadenas et entouré" />

Pour ne plus utiliser un canal privé, ouvrez "Paramètres", puis "Configuration", ouvrez la carte "Intégration Slack", retirez le canal de la liste dans "Provisionnement" et cliquez sur "Enregistrer".

## Ancien bot Slack

<Callout type="danger">
  Si votre espace de travail Slack utilise encore l'ancien bot Slack de RandomCoffee (l'ancien bot gratuit), l'installation de l'intégration Slack l'arrête : ses exécutions planifiées et ses programmes actifs sont désactivés. Vous ne pouvez plus revenir à l'ancien bot ensuite.
</Callout>

## Désinstaller l'intégration

Vous pouvez déconnecter Slack de RandomCoffee, retirer l'application de Slack, ou les deux.

### Déconnecter Slack de RandomCoffee

Dans RandomCoffee, ouvrez "Paramètres", puis "Configuration", ouvrez la carte "Intégration Slack" et cliquez sur "Supprimer" dans "Actions". Un message vous rappelle ce qui arrive à vos programmes Slack : cliquez sur "OK" pour retirer l'intégration.

Vos programmes Slack passent alors à l'email, et ceux qui étaient en cours sont mis en pause. Relisez leurs messages, puis réactivez-les : voir [Personnaliser les messages](/fr/admin/programs/personalize-messages/).

### Retirer l'application de Slack

<Steps>

1. Dans Slack, sélectionnez l'application RandomCoffee, ouvrez son onglet "About" et cliquez sur "Configuration".
2. La page de l'application s'ouvre dans votre navigateur. Descendez jusqu'à "Remove App" et cliquez sur "Remove App".

</Steps>

![Le bas de la page de l'application RandomCoffee dans Slack, avec la section Remove App](../../../../../assets/articles/slack/slack-remove-app.jpg)

<Callout type="warning">
  Retirer l'application supprime RandomCoffee pour tous les membres de votre espace de travail Slack.
</Callout>

## FAQ

<Accordions>
<AccordionItem title="Puis-je donner accès à certains canaux seulement, plutôt qu'à tout l'espace de travail ?">

Oui. Dans "Provisionnement", choisissez "Provisionner des utilisateurs à partir de canaux spécifiques" et sélectionnez les canaux. Seuls leurs membres sont importés.

</AccordionItem>
<AccordionItem title="L'intégration Slack et l'intégration SIRH peuvent-elles fonctionner ensemble ?">

Oui. Les utilisateurs provisionnés depuis Slack qui existent aussi dans votre SIRH sont reconnus grâce à leur adresse email et complétés avec les données de votre SIRH. Voir [Intégration SIRH](/fr/documentation/integrations/hris/).

</AccordionItem>
<AccordionItem title="L'installation de l'intégration fait-elle passer mes programmes sur Slack ?">

Non. Chaque programme garde son propre canal de communication. Pour envoyer un programme par Slack, voir [Créer un programme](/fr/admin/programs/create-a-program/). Pour voir ce que les membres reçoivent dans Slack, voir [Comment fonctionne RandomCoffee](/fr/members/getting-started/how-randomcoffee-works/).

</AccordionItem>
</Accordions>