> ## Documentation Index > Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt > Use this file to discover all available pages before exploring further. # Canaux Slack > Envoyer les notifications de l’équipe vers un canal Slack avec un webhook entrant 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](https://docs.wirespeed.co/fr/settings/notifications.md#fréquence-des-notifications) 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](https://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. > [!NOTE] > > Slack peut modifier ces écrans. Si ce que vous voyez ne correspond pas, suivez le guide de Slack : [Sending messages using incoming webhooks](https://api.slack.com/messaging/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](https://docs.wirespeed.co/fr/settings/notifications.md#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. | Statut | Ce que vous voyez | Signification | | - | - | - | | **Actif** | L’interrupteur **Activé** est activé | Les notifications sont remises. | | **En échec** | Une icône d’avertissement orange à côté du nom | Des livraisons récentes ont échoué pour une raison qui compte dans la désactivation du canal. L’info-bulle indique combien, par exemple « 2 livraisons sur 3 ont échoué ». | | **Désactivé manuellement** | L’interrupteur **Activé** est désactivé. Les canaux qui ont des abonnements affichent aussi **Inactif tant que désactivé** sous le nombre d’abonnements | Vous avez mis le canal en pause. Les notifications ne lui sont pas envoyées. | | **Désactivé après des échecs de livraison** | Une icône rouge à côté du nom et un bouton **Réactiver**. Les canaux qui ont des abonnements affichent aussi **Inactif jusqu’à sa réactivation** | Wirespeed a désactivé le canal et suspendu ses abonnements. | ### 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](#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 | Message | Solution | | - | - | | Utilisez une URL de webhook entrant Slack ([https://hooks.slack.com/services/…](https://hooks.slack.com/services/…)) | L’URL ne provient pas des webhooks entrants de Slack. Créez le webhook comme décrit à l’[étape 1](#étape-1--créer-le-webhook-dans-slack). | | Les webhooks de workflow Slack ne sont pas pris en charge ici. | L’URL appartient à un workflow de Workflow Builder de Slack, qui attend une charge utile différente. Créez un webhook entrant dans une application Slack, ou utilisez le canal de notification Webhooks pour les workflows et les charges utiles personnalisées. | | Ce n’est pas une URL de webhook entrant Slack. | Copiez l’**URL du webhook** depuis la page **Incoming Webhooks** de l’application, et non depuis la barre d’adresse de votre navigateur. | | Saisissez une URL valide | Collez l’URL exactement telle que Slack l’a fournie. | | L’URL du webhook doit commencer par https\:// | Copiez de nouveau l’URL sans la modifier. | | L’URL du webhook doit utiliser le port https par défaut | Copiez de nouveau l’URL sans la modifier. | | L’URL du webhook ne doit pas contenir de nom d’utilisateur ni de mot de passe | Copiez de nouveau l’URL sans la modifier. | | Cette URL de webhook Slack est déjà enregistrée pour un autre canal Slack | Utilisez le canal existant, ou créez un second webhook pour un second canal. | | Un canal Slack nommé « … » existe déjà | Les noms de canaux doivent être uniques au sein d’une équipe, sans tenir compte de la casse. Choisissez un autre nom. | ### Résultats de l’envoi de test | Message | Solution | | - | - | | Slack a rejeté la requête (401, 403, 404 ou une erreur telle que `no_service`) | Le webhook a été révoqué, l’application a été retirée de l’espace de travail, ou le canal a été supprimé ou archivé. Créez un nouveau webhook et collez son URL. | | Aucune réponse de Slack en 10 secondes, ou Impossible de joindre Slack | Slack est lent ou indisponible. Réessayez plus tard. | | Trop de notifications de test | Attendez le délai indiqué, puis réessayez. | ### 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. | Indication | Cause | Solution | | - | - | - | | Le canal Slack a été supprimé ou archivé, ou le webhook a été révoqué. | Slack a renvoyé `channel_not_found`, `no_service` ou `channel_is_archived`. | Créez un nouveau webhook entrant pour le canal, puis sélectionnez **Réactiver** sur le canal, collez l’URL, envoyez un test réussi et enregistrez avec **Enregistrer les modifications**. | | Slack a bloqué la requête. | Slack a renvoyé `action_prohibited`. L’application a été retirée de l’espace de travail, le webhook a été révoqué, ou un paramètre de l’espace de travail le bloque. | Créez un nouveau webhook entrant et collez son URL. Si cela ne suffit pas, demandez à l’administrateur de votre espace de travail Slack si un paramètre restreint l’application. | | L’URL enregistrée ne peut pas être utilisée. | Wirespeed n’a pas pu utiliser l’URL enregistrée. Cela ne compte jamais dans la désactivation d’un canal. | Collez l’URL à nouveau. Contactez le support si le problème se reproduit. | | Vérifiez le webhook dans les paramètres de votre application Slack. | Une autre erreur. | Ouvrez la page **Incoming Webhooks** de l’application, corrigez le problème, puis sélectionnez **Réactiver** sur le canal, envoyez un test réussi et enregistrez avec **Enregistrer les modifications**. | ## 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.