Documentation
Slack, Teams et webhooks
Envoyez des rapports Search Console planifiés et des alertes vers Slack, Microsoft Teams ou n'importe quel endpoint HTTPS, le tout géré depuis une seule page avec un journal des envois.
AutoPSEO peut faire sortir ses chiffres de l'application de deux façons : des rapports planifiés qui reprennent les principaux indicateurs Search Console d'une propriété, et des alertes qui se déclenchent lorsqu'un détecteur voit bouger les clics, le CTR, les positions, l'indexation, les classements suivis ou les audits. Les deux arrivent dans un canal que vous ajoutez une seule fois : un webhook entrant Slack, une URL Workflows de Microsoft Teams, ou n'importe quel endpoint HTTPS public qui accepte du JSON signé. Vous gérez le tout depuis une seule page.
Où le trouver
Ouvrez Slack, Teams & Webhooks dans la barre latérale gauche, ou allez dans Account et choisissez Manage sur la carte Slack, Teams & webhooks (l'ouvrir dans l'application). La page comporte une section par destination (Slack - Connected workspaces, Microsoft Teams, Outbound webhooks), suivies de Scheduled reports, Alerts et Delivery history.
Canaux, règles et envois
La fonctionnalité repose sur trois éléments.
- Canal : une URL de destination, étiquetée Slack, Microsoft Teams ou Webhook. AutoPSEO stocke l'URL chiffrée et n'en affiche ensuite que l'hôte et les derniers caractères. Un compte peut contenir 25 canaux.
- Règle : un rapport planifié ou une alerte, associé à un seul canal. Un canal peut alimenter autant de règles que vous le souhaitez, dans la limite de 50 règles par compte. Pour recevoir la même alerte dans Slack et dans Teams, créez deux règles.
- Envoi : une tentative de publication d'un message. Delivery history conserve les 50 dernières tentatives, tous canaux confondus, y compris les tests et les synthèses ponctuelles, avec leur statut (envoyé, échoué ou ignoré), le statut HTTP, le temps de réponse de la destination et le motif de l'échec, le cas échéant.
Les canaux et les règles sont rattachés à votre propre identifiant de connexion. Un collègue qui souhaite recevoir des alertes dans son propre canal doit configurer les siens.
De zéro au premier message
- Connectez les propriétés Search Console sur lesquelles vous voulez produire des rapports (Connecter Search Console). La propriété de démonstration apparaît dans tous les sélecteurs : vous pouvez donc essayer une règle avant même que vos propres données soient disponibles.
- Ajoutez un canal avec Add to Slack, New Teams channel ou New webhook : donnez-lui un nom et collez l'URL. Pour savoir où obtenir chaque URL : Slack, Microsoft Teams, webhooks.
- Cliquez sur Send test sur la ligne du canal et vérifiez que le message est bien arrivé.
- Créez une règle avec New scheduled report ou New alert. Ces deux boutons restent grisés tant qu'aucun canal n'existe.
Quand les messages sont envoyés
Une tâche s'exécute au début de chaque heure (UTC) et détermine ce qui doit partir.
| Message | Moment de l'envoi |
|---|---|
| Rapport planifié | À l'heure que vous choisissez, en quotidien, hebdomadaire ou mensuel, au plus une fois par période |
| Alerte sur les clics, le CTR, la position, les requêtes perdues, le suivi de classement ou les audits | Vérifiée une fois par jour, lors de l'exécution de 06:00 UTC |
| Alerte sur les changements d'indexation | Vérifiée toutes les heures |
| Send test, Send now, Test rule | Immédiatement |
| Send to Slack depuis une page de rapport | Immédiatement (Utiliser AutoPSEO dans Slack) |
Les fenêtres des rapports et des alertes se terminent la veille de l'exécution, car Search Console publie ses données avec un décalage. Chaque message indique les dates utilisées, de sorte que personne n'a à les deviner.
Prérequis
- Un abonnement actif ou un essai en cours. Lorsqu'un essai se termine sans abonnement, les rapports planifiés et les alertes s'arrêtent, et la création de canaux, les modifications de règles, les tests et les envois sont refusés tant que vous n'avez pas choisi une offre (offres et facturation).
- Une destination que vous maîtrisez : l'autorisation de créer un webhook entrant dans Slack, un webhook Workflows dans un canal Teams, ou un endpoint HTTPS qui vous appartient.
Attention à qui peut lire le canal
Chaque message contient des données de performance de recherche : clics, impressions, requêtes et adresses de pages. Toute personne qui peut lire le canal Slack ou Teams, ou le système situé derrière un webhook, les voit ; publiez donc les propriétés de vos clients dans des canaux privés. L'URL de destination est elle aussi un secret : quiconque la détient peut publier dans votre canal, comme Slack le souligne pour ses webhooks. C'est pourquoi AutoPSEO ne l'affiche plus jamais une fois enregistrée.
À lire ensuite
- Connecter Slack avec un webhook entrant : créer l'URL dans Slack, l'ajouter, et les erreurs que Slack peut renvoyer.
- Rapports planifiés : types de rapports, périodes, cadence et règle d'un envoi par période.
- Alertes : les neuf détecteurs, les seuils, la gravité et la mise en sourdine.
- Utiliser AutoPSEO dans Slack : ce que contient un message et comment fonctionne Send to Slack.
- Microsoft Teams : URL Workflows et Adaptive Cards.
- Webhooks sortants : le corps JSON, les types d'événements et la vérification de la signature.
Présentations produit : AutoPSEO pour Slack et AutoPSEO pour Microsoft Teams.
Dans cette section
Connecter Slack avec un webhook entrant
Créez un webhook entrant Slack pour un canal, ajoutez-le à AutoPSEO, envoyez un message de test et corrigez les erreurs renvoyées par Slack lorsqu'un envoi échoue.
Rapports planifiés dans Slack, Teams ou un webhook
Publiez chaque jour, semaine ou mois dans un canal les clics, impressions, CTR et position d'une propriété, avec ses principales requêtes, pages ou variations de classement.
Alertes : détecteurs, seuils et gravité
Neuf détecteurs surveillent les clics, le CTR, la position, les requêtes perdues, les changements d'indexation, les classements et les audits, et ne publient dans un canal que lorsqu'un seuil est franchi.
Utiliser AutoPSEO dans Slack
Ce que contiennent les messages Slack d'AutoPSEO, comment Send to Slack publie n'importe quel tableau de rapport dans un canal, et ce que vous pouvez ou non faire depuis Slack.
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é.
Webhooks sortants : payload et signature
Recevez les alertes et les rapports d'AutoPSEO sous forme de JSON signé sur n'importe quel endpoint HTTPS : en-têtes de requête, champs du corps, types d'événements et vérification de la signature.