Canaux Microsoft Teams

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. Consultez 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 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 ?.

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

​

Statut des canaux

La page Canaux Teams répertorie chaque canal avec son statut.

​

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

​

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.

​

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.