Générer un webhook dans Slack

1. Créez une application Slack (si vous n’en avez pas déjà une)

Créer votre application Slack

Choisissez un nom et l’espace de travail auquel associer votre application (vous publierez sans doute de nombreux messages de test : pensez à créer un canal dédié aux essais), puis cliquez sur Create App. Si vous avez déjà créé une application, vous pouvez l’utiliser à la place.

2. Activez les Incoming Webhooks pour votre application Slack

Après avoir créé votre application Slack, vous êtes redirigé vers sa page de réglages (si vous utilisez une application existante, ouvrez simplement ses réglages depuis votre tableau de bord de gestion des applications).

Sélectionnez ensuite la fonctionnalité Incoming Webhooks, puis cliquez sur l’interrupteur Activate Incoming Webhooks pour l’activer.

3. Créez un Incoming Webhook vers votre espace de travail Slack

Une fois les Incoming Webhooks activés, la page de réglages se recharge et de nouvelles options apparaissent. L’une d’elles est un bouton bien pratique, Add New Webhook to Workspace : cliquez dessus.

Ce bouton lance une version abrégée du processus d’installation des applications Slack, entièrement autonome, pour que vous n’ayez à écrire aucun code pour générer une URL d’Incoming Webhook. Un écran semblable à celui-ci s’affiche :

Choisissez le canal dans lequel l’application publiera, puis cliquez sur le bouton Authorize. Pour ajouter l’Incoming Webhook à un canal privé, vous devez d’abord être membre de ce canal.

Vous revenez alors aux réglages de votre application, où une nouvelle entrée apparaît dans la section Webhook URLs for Your Workspace, avec une URL de webhook qui ressemble à ceci :

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Cette URL est votre tout nouvel Incoming Webhook, propre à un seul utilisateur et à un seul canal.

Ajouter l’URL de votre webhook Slack dans le plugin Commentful

Pour configurer les notifications Slack de Commentful, créez une URL de webhook Slack en suivant les étapes ci-dessus, puis, dans le plugin Figma Commentful, ouvrez le bouton d’icône Settings (en haut à droite de la fenêtre du plugin). Cliquez sur Enable webhook notifications for review links, vérifiez que Slack est sélectionné dans le menu déroulant Webhook Platform, puis copiez-collez l’URL de votre webhook Slack et cliquez sur Save Webhook URL :

par exemple, https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Pour vérifier que l’intégration Slack fonctionne, cliquez sur le bouton Send Test Message : Commentful envoie alors une notification de test à votre canal Slack.

Ajouter l’URL de votre webhook Slack dans l’application web Commentful

Pour configurer les notifications Slack de Commentful, créez une URL de webhook Slack en suivant les étapes ci-dessus, puis, dans l’application web Commentful (en ouvrant n’importe quel lien de revue partagé dans votre navigateur), appuyez sur les touches CTRL + K de votre clavier et copiez-collez l’URL de votre webhook Slack :

par exemple, https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Pour vérifier que l’intégration Slack fonctionne, cliquez sur le bouton Send Test Message to Slack : Commentful envoie alors une notification de test à votre canal Slack.

Les notifications par webhook Slack sont envoyées dans le canal Slack choisi sous forme d’alertes de canal. Si vos commentaires Commentful contiennent du texte comme @name, Slack peut l’afficher dans le corps du message, mais Commentful n’associe pas automatiquement les relecteurs Commentful aux utilisateurs Slack : les mentions Slack natives ne sont donc pas garanties.