Documentation
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.
AutoPSEO publie dans Slack via des webhooks entrants. Slack vous fournit une URL qui écrit dans un seul canal, vous collez cette URL dans AutoPSEO, et les rapports et alertes commencent à y arriver. AutoPSEO n'installe rien dans votre espace de travail : il ne peut ni lire les messages, ni lister vos canaux, ni publier ailleurs que là où pointe le webhook. Ajoutez une entrée pour chaque canal dans lequel vous souhaitez recevoir des messages.
Créer le webhook dans Slack
Slack émet les webhooks entrants via une application Slack. En suivant le guide des webhooks entrants de Slack :
- Créez une application Slack pour votre espace de travail, ou ouvrez-en une que vous utilisez déjà pour les notifications. Choisissez un nom que votre équipe reconnaîtra, par exemple Rapports SEO.
- Dans les paramètres de l'application, ouvrez Incoming Webhooks et activez Activate Incoming Webhooks.
- Cliquez sur Add New Webhook to Workspace, choisissez le canal et validez. Pour un canal privé, vous devez d'abord en être membre.
- Copiez la nouvelle URL depuis Webhook URLs for Your Workspace. Elle commence par
https://hooks.slack.com/services/.
Répétez les étapes 3 et 4 pour chaque canal supplémentaire ; une même application peut contenir plusieurs webhooks. Une URL créée avec les anciens webhooks d'intégration personnalisée de Slack fonctionne également, bien que Slack conseille de les migrer vers une application.
Slack considère l'URL comme un secret : toute personne qui la possède peut publier dans le canal. Collez-la dans AutoPSEO et gardez-la hors des tickets, des wikis et des captures d'écran.
L'ajouter à AutoPSEO
- Sur Slack, Teams & Webhooks, repérez Slack - Connected workspaces et cliquez sur Add to Slack. Le formulaire New channel s'ouvre avec Slack déjà sélectionné comme destination.
- Name : un libellé pour les listes d'AutoPSEO, l'historique des envois et le message de test, par exemple
#seo-alerts. - Webhook URL : collez l'URL Slack. Pour une entrée Slack, AutoPSEO n'accepte que les adresses
httpssur slack.com, et vous le signale immédiatement si l'URL ne convient pas. - Cliquez sur Add channel, puis sur Send test sur la nouvelle ligne. Un court message nommant l'entrée doit apparaître dans Slack en quelques secondes, et AutoPSEO indique le temps de réponse de Slack.
L'URL est stockée chiffrée (AES-GCM). Ensuite, la liste n'en affiche que l'hôte et les derniers caractères : choisissez donc des noms qui indiquent clairement quel canal Slack alimente chaque entrée.
Donnez-lui ensuite quelque chose à publier : un rapport planifié ou une alerte. Le tableau Slack - Subscriptions sous la liste affiche alors, pour chaque canal Slack, toutes les règles qui y publient, leur planification et leur état (actif ou en pause).
Plusieurs canaux et espaces de travail
Une URL de webhook appartient à un seul canal d'un seul espace de travail, et Slack ne permet pas à un message de remplacer le canal pour lequel le webhook a été créé. Cela rend le comportement prévisible :
- Un canal Slack, une entrée. Pour répartir des clients entre
#client-aet#client-b, créez un webhook pour chacun et ajoutez les deux. - Plusieurs espaces de travail fonctionnent de la même manière, puisque chaque webhook vit dans l'espace de travail où vous l'avez créé.
- Une entrée peut porter de nombreuses règles. Envoyez le rapport hebdomadaire et l'alerte de baisse de trafic vers la même entrée, ou gardez les alertes dans un canal plus actif qui leur est dédié.
Pourquoi un message n'est pas arrivé
Send test affiche immédiatement la cause. Pour les messages planifiés, ouvrez Delivery history, qui conserve la réponse de Slack pour chaque tentative échouée.
| Ce qu'affiche AutoPSEO | Signification | Que faire |
|---|---|---|
| Slack rejected the URL (no_service) | Le webhook a été supprimé ou désactivé dans Slack, ou l'URL contient une faute de frappe | Créez un nouveau webhook, ajoutez-le, puis supprimez l'ancienne entrée |
| The Slack channel no longer exists, or is archived | Slack a répondu channel_not_found ou channel_is_archived | Créez un webhook pour un canal toujours utilisé |
| Slack is rate limiting us | Slack a répondu HTTP 429 | Patientez un peu, puis utilisez Send now ou Test rule |
| Timed out after 10 seconds | Slack n'a pas répondu à temps | Réessayez plus tard |
| Your trial has ended | Aucun forfait ni période d'essai actif | Choisissez un forfait ; les envois planifiés reprennent avec lui |
Un rapport planifié en échec n'est pas renvoyé au cours de la même période : utilisez donc Send now une fois la cause corrigée. Une alerte qui n'a pas pu être publiée est réévaluée lors de sa prochaine vérification (quand les alertes s'exécutent).
Supprimer un canal Slack
Delete sur la ligne de l'entrée supprime l'URL stockée et, après une confirmation qui vous en indique le nombre, toutes les règles qui y publient. AutoPSEO ne modifie rien dans Slack : le webhook continue de fonctionner tant que personne ne le supprime dans l'application Slack. Faites-le aussi si l'URL a pu être vue par d'autres personnes.