Comment connecter Slack

Cette intégration permet à Tulina de lire et poster dans votre Slack — canaux, fils et messages directs — soit en tant que bot, soit en votre nom.

Qui peut faire ça. Quelqu'un qui peut installer une app dans votre workspace Slack. Selon vos réglages de workspace, ça peut demander l'approbation d'un admin Slack. Côté Tulina, un membre de l'org, ou un admin d'org ou d'équipe si vous voulez partager la connexion.

Combien de temps ça prend. 10 minutes.

Slack émet ses tokens par workspace, donc chaque workspace crée sa propre app. C'est attendu, et c'est ce que ce guide détaille.

Une chose à savoir avant de commencer : ça ne peut pas se faire depuis l'app mobile Slack. La gestion des apps Slack vit sur le web, sur api.slack.com. Vous pouvez le faire depuis un navigateur mobile, mais la console est conçue pour un grand écran — activez « Request desktop site », ou utilisez un ordinateur si vous en avez un à portée. L'app Slack elle-même n'est nécessaire qu'à la dernière étape.

Étape 1 — Créer l'app Slack

1. Ouvrez api.slack.com/apps?new_app=1, qui va directement à la boîte de dialogue de création.
2. Choisissez From scratch.
3. Donnez-lui un nom — Tulina, par exemple. C'est ce nom que vos collègues verront à côté de chaque message qu'elle poste.
4. Choisissez le workspace où l'installer, puis créez l'app.

Étape 2 — Choisir ce qu'elle a le droit de faire

Dans le menu de gauche de l'app, ouvrez OAuth & Permissions et descendez jusqu'à Scopes. Ajoutez des scopes sous Bot Token Scopes si vous comptez utiliser un token bot, ou sous User Token Scopes pour un token utilisateur. L'étape 4 explique lequel choisir.

N'ajoutez que ce dont vous avez besoin. Vous pourrez revenir en ajouter plus tard, au prix d'une réinstallation de l'app.

• Poster un message — chat:write
• Lister les canaux publics — channels:read
• Lire l'historique d'un canal public — channels:history
• Trouver quelqu'un par son adresse email — users:read et users:read.email
• Travailler dans les canaux privés — groups:read et groups:history
• Ouvrir et lire les messages directs — im:write, im:read et im:history
• Réagir à un message — reactions:write
• Télécharger un fichier partagé dans Slack — files:read

Un ensemble de départ raisonnable est chat:write, channels:read, channels:history, users:read et users:read.email. Ça couvre la lecture et l'écriture dans les canaux publics, et le fait d'adresser les personnes par email.

Étape 3 — L'installer et copier le token

1. Revenez en haut de OAuth & Permissions, installez l'app sur votre workspace et approuvez l'écran de permissions.
2. Copiez le token qui apparaît. Un token bot commence par xoxb-, un token utilisateur par xoxp-.

Si on vous dit que la demande a été envoyée plutôt que de vous montrer un token, votre workspace exige l'approbation d'un admin pour les nouvelles apps. Quelqu'un avec ce droit doit l'approuver avant que le token existe.

Traitez le token comme un mot de passe. Il donne accès à tout ce que vous avez coché à l'étape 2.

Étape 4 — Connecter Slack depuis Tulina

Dans Tulina, ouvrez Connecteurs, trouvez Slack, et choisissez l'onglet qui correspond à pour qui est la connexion.

• Personal — un token utilisateur (xoxp-). Tulina agit en votre nom, et atteint chaque canal et message direct que vous pouvez déjà voir. Rien à inviter nulle part.
• Org ou Team — un token bot (xoxb-). Une identité partagée pour toute l'org ou l'équipe, qui continue de fonctionner même si une personne part. Il n'atteint que les canaux où il a été invité.

Collez le token dans le champ correspondant et enregistrez. Vous pouvez remplir les deux si vous voulez avoir les deux comportements disponibles.

Étape 5 — Inviter le bot dans vos canaux

Sautez cette étape si vous avez utilisé un token utilisateur.

Un bot ne voit que les canaux auxquels il appartient. Dans Slack — l'app mobile convient très bien pour cette partie — ouvrez chaque canal où vous voulez que Tulina travaille et tapez :

/invite @Tulina

Utilisez le nom que vous avez donné à l'app à l'étape 1.

Un processus qui poste dans un canal a aussi besoin que le bot y soit. Publier le brief du lundi et Les PR mergées font avancer les tickets et un résumé part se terminent tous deux par un post, et la page connecteur Slack liste tous les processus qui utilisent Slack.

Dépannage

La liste des canaux revient vide, ou le post échoue avec not_in_channel. Le bot n'a pas été invité dans ce canal. Retournez à l'étape 5.

Une erreur nommant un scope manquant, comme missing_scope. Slack dit lequel il veut. Ajoutez-le à l'étape 2, puis réinstallez l'app pour que la nouvelle permission soit accordée, et recopiez le token.

invalid_auth ou not_authed. Le token a été copié avec un espace superflu, ou il a été révoqué. Recopiez-le depuis OAuth & Permissions.

Tulina dit qu'aucun identifiant Slack n'est configuré. Le token a été enregistré sur un onglet différent de celui utilisé. Un token personnel ne s'applique qu'à vous ; un token partagé doit aller sur l'onglet Org ou Team.

Quelqu'un a quitté l'entreprise et Slack s'est arrêté. Un token utilisateur appartient à la personne qui l'a émis et meurt avec son compte. C'est la raison de préférer un token bot sur l'onglet Org pour tout ce dont l'équipe dépend.