Documentatie
Slack koppelen met een inkomende webhook
Maak een inkomende webhook in Slack voor een kanaal, voeg die toe aan AutoPSEO, verstuur een testbericht en los de fouten op die Slack teruggeeft wanneer een bericht niet wordt geplaatst.
AutoPSEO plaatst berichten in Slack via inkomende webhooks. Slack geeft je een URL die naar één kanaal schrijft, je plakt die URL in AutoPSEO en vanaf dat moment verschijnen rapporten en meldingen in dat kanaal. AutoPSEO zelf installeert niets in je workspace: het kan geen berichten lezen, geen kanalen opvragen en nergens plaatsen waar de webhook niet naar verwijst. Voeg voor elk kanaal waarin je berichten wilt ontvangen een aparte vermelding toe.
De webhook maken in Slack
Slack geeft inkomende webhooks uit via een Slack-app. Volg hiervoor de incoming webhook-handleiding van Slack:
- Maak een Slack-app voor je workspace, of open een app die je al voor meldingen gebruikt. Kies een naam die je team herkent, zoals SEO-rapporten.
- Open in de instellingen van de app Incoming Webhooks en zet Activate Incoming Webhooks aan.
- Klik op Add New Webhook to Workspace, kies het kanaal en bevestig. Voor een privékanaal moet je eerst zelf lid zijn.
- Kopieer de nieuwe URL onder Webhook URLs for Your Workspace. Die begint met
https://hooks.slack.com/services/.
Herhaal stap 3 en 4 voor elk extra kanaal; één app kan meerdere webhooks bevatten. Een URL die is aangemaakt met de oudere custom-integratiewebhooks van Slack werkt ook nog, al raadt Slack aan die naar een app te verplaatsen.
Slack behandelt de URL als een geheim: iedereen die de URL heeft, kan berichten in het kanaal plaatsen. Plak de URL in AutoPSEO en houd hem buiten tickets, wiki's en screenshots.
Toevoegen in AutoPSEO
- Zoek op Slack, Teams & Webhooks de sectie Slack - Connected workspaces en klik op Add to Slack. Het formulier New channel opent met Slack al als bestemming geselecteerd.
- Name: een label voor de lijsten van AutoPSEO, de bezorggeschiedenis en het testbericht, bijvoorbeeld
#seo-alerts. - Webhook URL: plak de Slack-URL. Voor een Slack-vermelding accepteert AutoPSEO alleen
https-adressen op slack.com, en meldt direct als de URL daar niet aan voldoet. - Klik op Add channel en vervolgens op Send test in de nieuwe rij. Binnen enkele seconden hoort er in Slack een kort bericht te verschijnen met de naam van de vermelding, en AutoPSEO laat zien hoe lang Slack over het antwoord deed.
De URL wordt versleuteld opgeslagen (AES-GCM). Daarna toont de lijst alleen nog de host en de laatste tekens. Kies daarom namen die duidelijk maken welk Slack-kanaal elke vermelding voedt.
Geef het vervolgens iets om te plaatsen: een geplande rapportage of een melding. De tabel Slack - Subscriptions onder de lijst toont daarna per Slack-kanaal elke regel die daar plaatst, het schema en of die actief of gepauzeerd is.
Meerdere kanalen en workspaces
Een webhook-URL hoort bij één kanaal in één workspace, en Slack staat niet toe dat een bericht het kanaal overschrijft waarvoor de webhook is aangemaakt. Dat houdt het voorspelbaar:
- Eén Slack-kanaal, één vermelding. Wil je klanten verdelen over
#client-aen#client-b, maak dan voor elk een webhook en voeg beide toe. - Meerdere workspaces werken op dezelfde manier, omdat elke webhook hoort bij de workspace waarin je hem hebt gemaakt.
- Eén vermelding kan veel regels bevatten. Stuur het wekelijkse rapport en de melding bij een verkeersdaling naar dezelfde vermelding, of zet meldingen in een eigen, drukker kanaal.
Waarom een bericht niet aankwam
Send test toont de reden meteen. Voor geplande berichten open je de Delivery history, die het antwoord van Slack bewaart voor elke mislukte poging.
| Wat AutoPSEO toont | Wat het betekent | Wat te doen |
|---|---|---|
| Slack rejected the URL (no_service) | De webhook is in Slack verwijderd of uitgeschakeld, of de URL is verkeerd getypt | Maak een nieuwe webhook, voeg die toe en verwijder daarna de oude vermelding |
| The Slack channel no longer exists, or is archived | Slack antwoordde met channel_not_found of channel_is_archived | Maak een webhook voor een kanaal dat nog in gebruik is |
| Slack is rate limiting us | Slack antwoordde met HTTP 429 | Wacht even en gebruik daarna Send now of Test rule |
| Timed out after 10 seconds | Slack antwoordde niet op tijd | Probeer het later opnieuw |
| Your trial has ended | Geen actief abonnement of proefperiode | Kies een abonnement; geplande bezorging wordt daarmee hervat |
Een mislukt geplande rapport wordt in dezelfde periode niet opnieuw verstuurd, gebruik dus Send now zodra de oorzaak is verholpen. Een melding die niet kon worden geplaatst, wordt bij de eerstvolgende controle opnieuw beoordeeld (wanneer meldingen draaien).
Een Slack-kanaal verwijderen
Delete in de rij van de vermelding verwijdert de opgeslagen URL en, na een bevestiging waarin staat om hoeveel het er gaat, alle regels die daar plaatsen. AutoPSEO wijzigt niets in Slack: de webhook blijft werken totdat iemand hem in de Slack-app verwijdert. Doe dat dus ook als de URL mogelijk door anderen is gezien.