Passer au contenu principal
Wirespeed peut publier des notifications dans un canal Slack. Vous créez un webhook entrant pour le canal dans une application Slack, puis vous ajoutez son URL dans Wirespeed en tant que canal Slack. La gestion des canaux Slack, les envois de test et le choix des notifications envoyées à chaque canal nécessitent le rôle Administrateur. Les autres utilisateurs peuvent ouvrir un canal pour voir un formulaire en lecture seule, son statut et son historique des livraisons, sans Envoyer un test. Les canaux Slack servent aux notifications à l’échelle de l’équipe. Wirespeed n’a besoin d’aucun accès à votre espace de travail Slack en dehors du webhook : il n’y a donc ni installation OAuth ni bot à inviter dans le canal. Pour les workflows créés dans Workflow Builder de Slack, ou pour une charge utile personnalisée, utilisez plutôt le canal de notification Webhooks. Les URL de webhook de workflow Slack ne sont pas acceptées ici.

​
Types de notifications pris en charge

Les canaux Slack peuvent recevoir les types de notifications suivants :
  • Nouveau dossier escaladé
  • Nouveau dossier confiné automatiquement
  • Nouvel événement de sécurité système
  • Nouveau défaut critique
  • État des intégrations
  • Compte et facturation
La Synthèse d’activité est envoyée uniquement par e-mail. Les canaux Slack reçoivent chaque notification en temps réel ; les paramètres de fréquence s’appliquent uniquement aux e-mails.

​
Avant de commencer

Vous devez être autorisé à créer des applications dans votre espace de travail Slack, ou disposer d’un administrateur qui peut créer le webhook pour vous.

​
Étape 1 : créer le webhook dans Slack

  1. Accédez à api.slack.com/apps, puis sélectionnez Create New App et From scratch. Nommez l’application (par exemple « Wirespeed ») et choisissez votre espace de travail. Si vous avez déjà une application pour Wirespeed, ouvrez-la.
  2. Dans les paramètres de l’application, ouvrez Incoming Webhooks et activez Activate Incoming Webhooks.
  3. Sélectionnez Add New Webhook to Workspace, choisissez le canal dans lequel Wirespeed doit publier, puis sélectionnez Allow.
  4. Copiez l’URL du webhook. Elle commence par https://hooks.slack.com/services/.
Chaque webhook publie dans le seul canal que vous avez choisi lors de sa création. Pour publier dans plusieurs canaux, ajoutez un webhook pour chacun et enregistrez chacun comme un canal Slack distinct dans Wirespeed.
Slack peut modifier ces écrans. Si ce que vous voyez ne correspond pas, suivez le guide de Slack : Sending messages using incoming webhooks.
L’URL du webhook est le seul identifiant nécessaire pour publier dans le canal : toute personne qui la possède peut y publier des messages. Traitez-la comme un mot de passe et ne la collez pas dans des tickets, des conversations ou des captures d’écran. Slack peut également révoquer une URL de webhook qu’il trouve publiée publiquement. En cas de fuite, supprimez le webhook dans les paramètres de votre application Slack, créez-en un nouveau et collez son URL dans le canal dans Wirespeed.

​
Étape 2 : ajouter le canal dans Wirespeed

  1. Accédez à Paramètres > Notifications.
  2. Sur la carte Slack, sélectionnez Connecter. Si votre équipe a déjà des canaux Slack, sélectionnez plutôt l’icône en forme d’engrenage (⚙, Gérer les canaux Slack).
  3. Sélectionnez Ajouter un canal Slack.
  4. Saisissez un Nom. Nommez chaque webhook d’après son canal Slack, par exemple #alertes-securite, afin de les distinguer. Le nom est affiché dans la liste Slack lorsque vous configurez une notification.
  5. Collez l’URL du webhook copiée à l’étape 1.
  6. Sélectionnez éventuellement Envoyer un test pour publier un message de test.
  7. Sélectionnez Enregistrer.
Wirespeed stocke l’URL du webhook chiffrée. Après l’enregistrement, vous pouvez la remplacer, mais pas la consulter. Chaque URL de webhook ne peut être enregistrée que pour un seul canal Slack par équipe. Lorsque vous modifiez un canal, le champ URL du webhook affiche •••••••• à la place de l’URL enregistrée. Laissez-le tel quel pour conserver l’URL enregistrée, ou collez une nouvelle URL pour la remplacer.

​
Envoyer un test

Envoyer un test envoie une notification d’exemple à ce webhook. Si vous avez saisi une nouvelle URL, le test utilise cette URL ; sinon, il utilise l’URL enregistrée. Modifier l’URL efface le résultat précédent. Acceptée par Slack signifie que Slack a accepté la requête, et le message devrait apparaître sous peu dans le canal. Wirespeed autorise jusqu’à 5 envois de test par équipe et par minute.

​
Étape 3 : choisir les notifications à envoyer

  1. Dans Paramètres > Notifications, repérez le type de notification dans la carte Notifications du compte de l’équipe.
  2. Sélectionnez l’icône en forme d’engrenage (⚙, Configurer) pour ouvrir la boîte de dialogue de configuration.
  3. Activez l’interrupteur Canal Slack, puis choisissez l’un de vos canaux sous Sélectionner un canal Slack. Ajoutez d’autres canaux, jusqu’à 10, avec Ajouter un autre canal.
  4. Enregistrez vos modifications.
Un canal déjà sélectionné pour ce type de notification, que vous avez désactivé ou que Wirespeed a désactivé après des échecs de livraison ne peut pas être sélectionné ; le menu l’indique par Déjà sélectionné, Désactivé ou Désactivé après des erreurs. Pour réactiver un canal ou résoudre le problème, sélectionnez Gérer les canaux Slack au bas du menu. Si votre équipe n’a pas encore de canal Slack, la section s’intitule Slack et affiche Connecter à la place. Les prestataires de services configurent les équipes clientes de la même manière que les boîtes de réception e-mail. Les abonnements de canaux Slack de l’équipe de votre prestataire de services fonctionnent comme vos autres abonnements de prestataire : ils couvrent automatiquement tous les comptes de vos clients, de sorte que le canal reçoit les notifications de chaque équipe cliente et que tous ses membres les voient. Pour envoyer les notifications d’une seule équipe cliente vers son propre canal, configurez-le en consultant cette équipe cliente. Consultez Comportement pour les prestataires de services.

​
Statut des canaux

La page Canaux Slack répertorie chaque canal avec son statut. Toute personne de votre équipe ayant accès aux paramètres de notifications peut voir le statut, le nombre d’échecs, la dernière erreur et l’historique des livraisons. Seuls les administrateurs peuvent modifier un canal.

​
Désactivation automatique

Wirespeed désactive un canal Slack après trois échecs de livraison sans livraison réussie entre eux, en ne comptant que les échecs suivants :
  • Slack rejette l’URL ou les autorisations du webhook (HTTP 401 ou 403, par exemple invalid_token ou action_prohibited).
  • Le webhook n’existe plus, ou son canal a été supprimé (HTTP 404 ou 410, par exemple no_service ou channel_not_found).
  • Slack indique que le webhook ne peut plus publier, dans une autre erreur 4xx : le canal a été archivé (channel_is_archived), l’application ou l’espace de travail a été retiré ou désactivé (no_active_hooks, no_team, team_disabled), ou la publication y est refusée (posting_to_general_channel_denied, user_not_found).
Une livraison réussie remet le compteur à zéro. Les pannes de Slack, les limitations de débit et les délais d’attente dépassés ne comptent jamais dans la désactivation d’un canal et ne remettent pas non plus le compteur à zéro ; Wirespeed retente ces livraisons. Les envois de test ne comptent pas. Lorsqu’un canal est désactivé, ses abonnements sont suspendus. Ils reprennent lorsque vous réactivez le canal.

​
Réactiver un canal

  1. Sur la page Canaux Slack, sélectionnez Réactiver sur le canal désactivé. La boîte de dialogue affiche dans un bandeau rouge la dernière erreur et la manière de la corriger.
  2. Corrigez la cause dans Slack (consultez Dépannage). Si vous avez créé un nouveau webhook, collez son URL dans URL du webhook.
  3. Sélectionnez Réactiver dans le bandeau rouge ou Envoyer un test au-dessus du pied de page (les deux deviennent Réessayer après un test en échec) pour envoyer un message de test à l’URL qui sera enregistrée. Si vous avez modifié l’URL, le test utilise la nouvelle URL.
  4. Lorsque le test réussit, le bandeau d’erreur devient gris et un bandeau vert Le canal est en bon état. apparaît. Sélectionnez Réactiver dans le bandeau vert, ou Enregistrer les modifications dans le pied de page, pour enregistrer.
Un test réussi est obligatoire. Enregistrer les modifications reste désactivé tant que le test de l’URL qui sera enregistrée n’a pas réussi, et modifier l’URL efface le résultat : il faut alors tester de nouveau. Si le problème réapparaît après la réactivation, le canal est de nouveau désactivé après trois autres échecs de livraison. Pour mettre en pause ou reprendre un canal vous-même, utilisez son interrupteur Activé.

​
Historique des livraisons

Ouvrez un canal en sélectionnant sa ligne, ou le menu … (Actions) de la ligne puis Modifier (Afficher si vous n’êtes pas administrateur), et sélectionnez Afficher l’historique des livraisons. La boîte de dialogue affiche les 100 livraisons, envois de test et changements de statut les plus récents, avec l’Heure, l’Événement, le Type, le Résultat et la Tentative de chacun. Seuls les tests de l’URL enregistrée du canal y figurent. Un test d’une URL saisie mais pas encore enregistrée n’est pas consigné.

​
Limites

Lorsque Slack répond qu’un webhook dépasse la limite (HTTP 429), Wirespeed suspend les livraisons vers ce canal pendant le délai d’attente demandé par Slack (5 minutes au maximum, et 30 secondes si Slack n’en indique pas), puis envoie les messages en attente. La limitation ne compte pas pour la désactivation du canal. Une notification qui ne peut pas être remise dans un délai d’environ 6 heures est abandonnée plutôt que d’arriver en retard. Un texte plus long que ce que Slack autorise est raccourci avec des points de suspension. Un message dont le contenu dépasse la limite de blocs de Slack est coupé et se termine par une note invitant à consulter les détails complets dans Wirespeed.

​
Dépannage

​
Erreurs lors de l’enregistrement de l’URL

​
Résultats de l’envoi de test

​
Canaux en échec ou désactivés

L’info-bulle de statut et la boîte de dialogue ouverte par Réactiver affichent la dernière erreur et une indication.

​
Modifier, remplacer ou supprimer un canal

  • Renommer ou remplacer l’URL : sélectionnez la ligne du canal, ou le menu … (Actions) de la ligne puis Modifier. Changez le nom ou collez une nouvelle URL, puis sélectionnez Mettre à jour. Laissez le champ URL tel quel pour conserver l’URL actuelle. Remplacer l’URL d’un canal en échec efface son état d’erreur. Un canal que vous avez désactivé reste désactivé.
  • Les canaux désactivés après des échecs de livraison s’ouvrent avec un bouton Réactiver dans le bandeau rouge qui envoie un test, et le bouton d’enregistrement s’appelle Enregistrer les modifications. Il reste désactivé tant qu’un test de l’URL qui sera enregistrée n’a pas réussi. L’enregistrement réactive alors le canal, avec ou sans nouvelle URL.
  • Supprimer : sélectionnez le menu … (Actions) de la ligne, puis Supprimer. La suppression d’un canal supprime également les abonnements qui lui envoient des notifications, et elle est irréversible.