Intégration Slack

Recevez un message dans un canal Slack quand vos retours demandent votre attention. Voxtrics publie dans Slack à partir d’une alerte : une règle qui surveille les réponses entrantes, par exemple « au moins 3 notes de 2 ou moins en une heure ». Slack se connecte via un webhook entrant, une adresse web que Slack vous fournit pour un canal : il n’y a donc rien à installer côté Voxtrics.

Créer un webhook dans Slack

Vous devez avoir le droit d’ajouter des applications à votre espace de travail Slack. Si seuls les administrateurs approuvent les applications dans votre espace de travail, Slack demande d’abord l’accord de l’un d’eux.

Ouvrez vos applications Slack, cliquez sur Create New App et choisissez From scratch.
Nommez l’application, par exemple Voxtrics, choisissez votre espace de travail et cliquez sur Create App.
Dans les paramètres de l’application, ouvrez Incoming Webhooks et activez Activate Incoming Webhooks.
Cliquez sur Add New Webhook to Workspace, choisissez le canal qui doit recevoir les alertes et autorisez l’accès. Pour un canal privé, rejoignez-le d’abord.
Copiez la nouvelle URL sous Webhook URLs for Your Workspace. Elle ressemble à https://hooks.slack.com/services/T0000/B0000/XXXXXXXX.

Le guide de Slack sur les webhooks entrants (en anglais) : Sending messages using incoming webhooks.

Toute personne disposant de l’URL du webhook peut publier dans le canal. Ne la mettez pas dans des endroits publics comme des dépôts de code : Slack désactive les URL de webhook qu’il trouve publiées.

Envoyer les alertes vers Slack

Allez dans Alertes et cliquez sur Nouvelle alerte, ou sur l’icône en forme de crayon (Modifier) d’une règle existante.
Définissez le nom, la portée, la fenêtre temporelle et la condition de la règle, comme décrit dans Alertes.
Sous Notifier via, sélectionnez Slack et collez l’URL dans URL du webhook Slack.
Cliquez sur Créer l’alerte, ou sur Enregistrer les modifications pour une règle existante.

Un webhook ne publie que dans le canal pour lequel il a été créé. Pour recevoir aussi les alertes dans un autre canal, créez un webhook pour ce canal et une règle dédiée. Plusieurs règles peuvent utiliser le même webhook.

Ce que dit le message

À chaque déclenchement de la règle, le canal reçoit un court message en texte brut avec le nom de la règle, le domaine, le nombre de réponses correspondantes dans la fenêtre temporelle et la raison du déclenchement. Les réponses elles-mêmes n’y figurent pas : ouvrez le déclenchement dans Alertes pour les voir.

Une règle se déclenche au plus une fois toutes les 30 minutes, ou moins souvent si vous définissez un délai de répétition. Les alertes d’un espace publient au plus 200 messages par jour vers Slack et Telegram réunis. Au-delà, une règle se déclenche toujours et le déclenchement apparaît dans Alertes, mais rien n’est publié.

Si les messages n’arrivent pas

Si l’alerte ne s’enregistre pas, vérifiez que l’URL commence par https://hooks.slack.com/. Voxtrics n’accepte que les adresses de webhook Slack, pas un lien vers un canal ou un message.
Vérifiez que la règle est activée et s’est déclenchée : chaque déclenchement est listé dans Alertes.
Si la règle s’est déclenchée mais que rien n’est arrivé dans Slack, le webhook ne fonctionne plus : l’application a été supprimée, le canal a été archivé ou supprimé, ou Slack a désactivé l’URL. Créez un nouveau webhook et collez-le dans la règle.