> ## 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 Microsoft Teams

> Envoyer les notifications de l’équipe vers un canal Microsoft Teams avec un webhook Workflows

Wirespeed peut publier des cartes de notification dans un canal Microsoft Teams. Vous créez un webhook pour le canal avec l’application **Workflows** de Microsoft, puis vous ajoutez son URL dans Wirespeed en tant que canal Teams. La gestion des canaux Teams, 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 et son historique des livraisons, sans **Envoyer un test**.

Les canaux Teams servent aux notifications à l’échelle de l’équipe. Pour envoyer des messages à des utilisateurs individuels dans Teams pour le ChatOps, utilisez plutôt l’[intégration Microsoft Teams](https://docs.wirespeed.co/fr/integrations/microsoft-teams.md). Consultez [Canaux Teams et intégration Microsoft Teams](https://docs.wirespeed.co/fr/settings/notifications.md#canaux-teams-et-intégration-microsoft-teams) pour comparer les deux.

## Types de notifications pris en charge

Les canaux Teams 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 Teams 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é à ajouter des workflows au canal Teams.
* Le workflow appartient à la personne qui le crée. Si cette personne quitte votre organisation et que personne d’autre n’est propriétaire du workflow, celui-ci cesse de fonctionner. Ajoutez un copropriétaire après l’avoir créé.

## Étape 1 : créer le webhook dans Teams

1. Dans Microsoft Teams, ouvrez le canal, sélectionnez **⋯** (Plus d’options), puis **Workflows**.
2. Recherchez le modèle **Send webhook alerts to a channel** et sélectionnez-le. Les anciennes versions de Teams le nomment **Post to a channel when a webhook request is received**. Selon la langue de Teams, ces noms peuvent être traduits.
3. Confirmez l’équipe et le canal, puis sélectionnez **Enregistrer**.
4. Sélectionnez **Copier le lien du webhook**. Copiez l’URL complète, y compris tout ce qui suit `?`.

> [!WARNING]
>
> Utilisez le modèle simple **Send webhook alerts to a channel**. Les variantes **from specific people** et **from people in an org** exigent une connexion Microsoft à chaque requête : Teams rejette donc les notifications de Wirespeed avec une erreur 401.

> [!NOTE]
>
> Ces étapes ont été vérifiées pour la dernière fois dans Microsoft Teams le 13 octobre 2026. Si ce que vous voyez ne correspond pas, suivez le guide de Microsoft : [Créer des webhooks entrants avec Workflows pour Microsoft Teams](https://support.microsoft.com/fr-fr/teams/apps-service/create-incoming-webhooks-with-workflows-for-microsoft-teams).

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. En cas de fuite, créez un nouveau workflow, collez son URL dans le canal dans Wirespeed, puis supprimez l’ancien workflow.

## Étape 2 : ajouter le canal dans Wirespeed

1. Accédez à **Paramètres > Notifications**.
2. Sur la carte **Teams**, sélectionnez **Connecter**. Si votre équipe a déjà des canaux Teams, sélectionnez plutôt l’icône en forme d’engrenage (⚙, **Gérer les canaux Teams**).
3. Sélectionnez **Ajouter un canal Teams**.
4. Saisissez un **Nom**. Il est affiché dans la liste Teams 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 une carte 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 Teams 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 carte de notification d’exemple à ce workflow. 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 Teams** signifie que Microsoft a accepté la requête, et la carte devrait apparaître sous peu dans le canal. Si ce n’est pas le cas, consultez [Cartes manquantes](#cartes-manquantes). 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 Teams**, puis choisissez l’un de vos canaux sous **Sélectionner un canal Teams**. 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 Teams** au bas du menu.

Si votre équipe n’a pas encore de canal Teams, la section s’intitule **Teams** 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 Teams 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 Teams** répertorie chaque canal avec son statut.

| 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 Teams après **trois échecs de livraison sans livraison réussie entre eux**, en ne comptant que les échecs suivants :

* Teams rejette l’URL (HTTP 401 ou 403).
* Le workflow n’existe plus (HTTP 404 ou 410).
* Le workflow est désactivé dans Power Automate.

Une livraison réussie remet le compteur à zéro. Les pannes de Microsoft, 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 Teams**, 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 Teams (consultez [Dépannage](#dépannage)). Si vous avez créé un nouveau workflow, 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 une carte 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

Microsoft limite un webhook Teams Workflows à **4 requêtes par seconde et par webhook**. Chaque canal a sa propre URL de webhook : les canaux ne partagent donc pas cette limite.

Lorsqu’un webhook dépasse la limite, Teams répond par une erreur « trop de requêtes » (HTTP 429). Wirespeed suspend alors les livraisons vers ce canal pendant le délai d’attente demandé par Teams (30 secondes si Teams n’en indique aucun, et jamais plus de 5 minutes), puis envoie les cartes 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.

Les cartes plus longues que ce que Teams autorise sont raccourcies et se terminent par un lien vers les détails complets dans Wirespeed.

## Dépannage

### Erreurs lors de l’enregistrement de l’URL

| Message | Solution |
| - | - |
| Ce n’est pas une URL de déclencheur HTTP Workflows. | Copiez l’URL avec **Copier le lien du webhook** dans le workflow, et non depuis la barre d’adresse de votre navigateur. |
| Utilisez une URL Workflows de Microsoft Teams (logic.azure.com ou environment.api.powerplatform.com) | L’URL n’est pas un webhook Workflows. Wirespeed n’accepte pas les webhooks de connecteurs Office 365 (`webhook.office.com`), que Microsoft est en train de retirer. Créez un workflow comme décrit à l’[étape 1](#étape-1--créer-le-webhook-dans-teams). |
| L’URL du webhook ne contient pas sa signature (sig). | L’URL a été tronquée. Copiez l’URL complète, y compris tout ce qui suit `?`. |
| Saisissez une URL valide | Collez l’URL exactement telle que Teams 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 Teams est déjà enregistrée pour un autre canal Teams | Utilisez le canal existant, ou créez un second workflow pour un second canal. |
| Un canal Teams 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 |
| - | - |
| Teams a rejeté la requête (401) | Le workflow utilise un modèle qui exige une connexion, ou l’URL a changé. Créez le workflow avec **Send webhook alerts to a channel**, puis copiez de nouveau l’URL. |
| Teams a rejeté la requête (404) | Le workflow a été supprimé. Créez-en un nouveau et collez son URL. |
| Aucune réponse de Teams en 10 secondes, ou Impossible de joindre Teams | Microsoft est lent ou indisponible. Réessayez plus tard. |
| Trop de notifications de test | Attendez le délai indiqué, puis réessayez. |
| Acceptée par Teams, mais aucune carte n’apparaît | Ouvrez l’historique d’exécution du workflow dans Teams. Consultez [Cartes manquantes](#cartes-manquantes). |

### 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 workflow a été supprimé ou son URL n’est plus valide. | Le workflow a été supprimé ou recréé, ou Microsoft a changé son URL. | Ouvrez le workflow dans Teams et copiez son URL actuelle, puis sélectionnez **Réactiver** sur le canal, collez l’URL, envoyez un test réussi et enregistrez avec **Enregistrer les modifications**. |
| Teams a refusé la signature de l’URL ou bloqué l’accès. | La signature de l’URL a changé, le workflow exige une connexion, ou une stratégie de votre locataire Microsoft le bloque. | Copiez de nouveau l’URL complète depuis le workflow. Si cela ne suffit pas, demandez à votre administrateur Microsoft 365 ou Power Platform si une stratégie bloque le workflow. |
| Le workflow est désactivé dans Power Automate. | Le propriétaire l’a désactivé, ou Microsoft l’a désactivé (par exemple après un changement de licence). | Activez le workflow dans l’application Workflows, ajoutez un copropriétaire, puis sélectionnez **Réactiver** sur le canal, envoyez un test réussi et enregistrez avec **Enregistrer les modifications**. |
| 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 workflow dans Power Automate. | Une autre erreur. | Ouvrez l’historique d’exécution du workflow, corrigez le problème, puis sélectionnez **Réactiver** sur le canal, envoyez un test réussi et enregistrez avec **Enregistrer les modifications**. |

### Cartes manquantes

Si Wirespeed indique qu’une livraison a été acceptée mais qu’aucune carte n’apparaît dans le canal, le workflow a reçu la notification, mais son étape de publication de la carte a échoué. Wirespeed ne peut pas voir ces échecs. Ouvrez l’historique d’exécution du workflow dans Teams et vérifiez :

* si le propriétaire du workflow est toujours membre de l’équipe ou du canal ;
* si une connexion du workflow a expiré.

## 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.