Slack
Prérequis
- Un Workspace Slack sur lequel vous pouvez installer des applications.
- Des droits d’administration ou de gestion des applications sur ce Workspace.
1. Créer une application Slack
- Ouvrez api.slack.com/apps → Create New App → From scratch.
- Donnez-lui un nom (par ex.
isthisthing.online Alerts) et choisissez votre Workspace.
2. Activer les Incoming Webhooks
- Dans la barre latérale des paramètres de l’app, cliquez sur Incoming Webhooks.
- Passez Activate Incoming Webhooks sur On.
- Cliquez sur Add New Webhook to Workspace.
- Choisissez le canal cible (par ex.
#incidents) → Allow.
Vous obtiendrez une URL du type :
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
Copiez cette URL — vous en aurez besoin à l’étape suivante.
3. Ajouter l’intégration dans isthisthing.online
- Allez dans Integrations → New Integration.
- Sélectionnez Slack comme type.
- Renseignez les champs :
| Champ | Valeur |
|---|---|
| Name | Libellé explicite, par ex. Slack #incidents |
| Webhook URL | L’URL de l’étape 2 |
| Channel | Laissez vide (le webhook publie dans le canal que vous avez choisi) |
- Activez les événements déclencheurs dont vous avez besoin (création / résolution / mise à jour).
- Cliquez sur Save.
4. Tester
Cliquez sur l’icône Test à côté de votre intégration dans la liste. Un message de test devrait apparaître dans votre canal Slack en quelques secondes.
Contenu du message
| Champ | Description |
|---|---|
| Event & Status | CREATED, RESOLVED ou UPDATED avec le statut d’Incident actuel |
| Workspace & Monitor | Noms et identifiants pour référence rapide |
| Timestamps | Heures de début, de résolution et d’émission en UTC |
| Links | Boutons pour ouvrir l’Incident ou le Dashboard du Workspace |
Dépannage
| Problème | Solution |
|---|---|
| Aucun message reçu | Vérifiez que l’intégration est activée et qu’au moins un événement déclencheur est activé. Vérifiez que l’URL du webhook est toujours active dans Slack. |
Erreur invalid_blocks | Régénérez le webhook dans Slack et mettez à jour l’URL dans les paramètres de votre intégration. |
| Mauvais canal | Les Incoming Webhooks publient dans le canal choisi à la création. Créez un nouveau webhook pour un autre canal. |
Sécurité
- Traitez les URL de webhook comme des secrets — ne les commitez pas dans le dépôt.
- Faites tourner l’URL immédiatement en cas d’exposition.
- Limitez la gestion des intégrations aux Owners et Admins du Workspace.