Documentation
Alertes et rapports Microsoft Teams
Créez un webhook Workflows dans un canal Teams, ajoutez-le à AutoPSEO et recevez des alertes et des rapports planifiés sous forme d'Adaptive Cards colorées selon leur gravité.
AutoPSEO publie dans Microsoft Teams via un webhook Workflows. Teams vous fournit une URL qui publie dans un canal donné, et vous l'ajoutez à AutoPSEO en tant que canal Teams. Les alertes, les rapports planifiés, les messages de test et les résumés de rapport ponctuels arrivent alors sous forme d'Adaptive Cards, avec un titre coloré selon la gravité et un bouton qui renvoie vers le rapport. Aucun espace de travail Slack n'est nécessaire, et il n'y a aucune application AutoPSEO à installer dans Teams.
Obtenir une URL de webhook depuis Teams
Le guide Microsoft sur les webhooks entrants construit l'URL avec l'application Workflows :
- Dans Teams, ouvrez le canal qui doit recevoir les cartes et choisissez Plus d'options (...) à côté de son nom.
- Choisissez Workflows et sélectionnez un modèle de webhook. Microsoft l'appelle actuellement Send webhook alerts to a channel ; l'indication affichée par AutoPSEO sur la page des paramètres utilise encore l'ancien nom, Post to a channel when a webhook request is received.
- Vérifiez l'équipe et le canal renseignés par le modèle, puis cliquez sur Enregistrer.
- Copiez le lien du webhook affiché par le workflow.
Une URL issue de l'ancien connecteur Incoming Webhook (sur webhook.office.com) reste acceptée. Microsoft retire les connecteurs Microsoft 365 et bloquera la création de nouveaux connecteurs ; utilisez donc Workflows pour toute configuration actuelle.
Ajouter le canal dans AutoPSEO
- Dans la section Microsoft Teams de Slack, Teams & Webhooks, cliquez sur Nouveau canal Teams. Le formulaire s'ouvre avec Microsoft Teams comme destination.
- Saisissez un Nom facile à reconnaître et collez l'URL. Pour une entrée Teams, AutoPSEO accepte les adresses Workflows et connecteur (hôtes tels que
logic.azure.com,powerautomate.com,azure-api.netetwebhook.office.com) et refuse les autres hôtes. - Cliquez sur Ajouter le canal, puis sur Envoyer un test sur sa ligne. Une carte portant le nom de l'entrée comme titre doit apparaître dans le canal.
- Créez un rapport planifié ou une alerte et choisissez ce canal.
Une règle envoie vers un seul canal. Pour recevoir la même alerte dans Slack et dans Teams, créez la règle deux fois, une pour chaque destination.
Structure de la carte
Chaque message devient une Adaptive Card (version 1.4, pleine largeur), encapsulée dans l'enveloppe message avec une pièce jointe application/vnd.microsoft.card.adaptive, comme dans les exemples de Microsoft.
- Titre en gros caractères gras. Pour les alertes, la carte utilise la couleur Attention pour les niveaux critique et élevé, Warning pour le niveau moyen et la couleur par défaut pour le niveau faible ; les rapports et les tests utilisent la couleur Accent.
- Résumé : la même phrase que dans un message Slack, avec la période concernée.
- Faits : jusqu'à 12 valeurs libellées, comme les clics et leur évolution, ou la valeur actuelle d'une alerte par rapport à sa référence.
- Tableau : pour les rapports et les résumés de rapport, jusqu'à dix lignes en police à chasse fixe.
- Pied de page : la propriété, un rappel que les données de Search Console accusent un retard d'environ un jour et que seuls les jours consolidés sont comptabilisés, ainsi que l'expéditeur.
- Ouvrir le rapport : un bouton qui mène au rapport correspondant dans AutoPSEO.
Pourquoi une carte n'est pas arrivée
Envoyer un test signale immédiatement un échec ; pour les messages planifiés, l'Historique des envois conserve la réponse renvoyée par Teams.
| Ce que vous voyez | Cause probable | Solution |
|---|---|---|
| « That does not look like a Teams Workflows or Incoming Webhook URL » à l'enregistrement | L'URL ne pointe pas vers un hôte Workflows ou connecteur | Copiez à nouveau le lien depuis le workflow |
| HTTP 400 sur Envoyer un test | Ce n'est finalement pas un webhook Teams : URL Slack, hook Zapier ou workflow modifié pour attendre un autre corps de requête | Créez un nouveau workflow à partir du modèle et ajoutez son URL |
| Expiration du délai après 10 secondes | Teams n'a pas répondu à temps | Réessayez plus tard |
| Les redirections ne sont pas suivies | L'URL redirige vers une autre adresse | Ajoutez l'URL finale à la place |
| Les cartes se sont arrêtées après le départ d'un collègue | Microsoft rattache chaque workflow à ses propriétaires, et un workflow sans propriétaire peut s'arrêter | Ajoutez des copropriétaires au workflow, ou recréez-le |
Un rapport planifié en échec n'est pas renvoyé sur la même période : corrigez la cause, puis utilisez Envoyer maintenant.
Quand utiliser plutôt un webhook
Teams et les webhooks sortants peuvent transporter les mêmes règles, mais ils s'adressent à des lecteurs différents. Un canal Teams s'adresse à des personnes : une carte mise en forme, sans rien à développer. Un webhook s'adresse à des logiciels : l'événement brut sous forme de JSON signé, pour Zapier, Make, n8n ou votre propre service. Teams attend une carte plutôt que le JSON d'événement d'AutoPSEO ; une URL Teams doit donc toujours être ajoutée sous Microsoft Teams.
Un aperçu de ce que Teams apporte aux utilisateurs est disponible sur la page Microsoft Teams.