Documentatie
Microsoft Teams-meldingen en -rapporten
Maak een Workflows-webhook aan in een Teams-kanaal, voeg die toe aan AutoPSEO en ontvang meldingen en geplande rapporten als Adaptive Cards, gekleurd naar ernst.
AutoPSEO plaatst berichten in Microsoft Teams via een Workflows-webhook. Teams geeft je een URL die in één kanaal post, en die URL voeg je in AutoPSEO toe als Teams-kanaal. Meldingen, geplande rapporten, testberichten en samenvattingen van losse rapporten komen dan binnen als Adaptive Cards, met een titel in een kleur die bij de ernst past en een knop terug naar het rapport. Je hebt geen Slack-werkruimte nodig en er hoeft geen AutoPSEO-app in Teams te worden geïnstalleerd.
Een webhook-URL ophalen in Teams
De handleiding voor inkomende webhooks van Microsoft maakt de URL aan met de Workflows-app:
- Ga in Teams naar het kanaal dat de kaarten moet ontvangen en kies ernaast Meer opties (...).
- Kies Workflows en selecteer een webhooksjabloon. Microsoft noemt dit momenteel Send webhook alerts to a channel; de hint van AutoPSEO op de instellingenpagina gebruikt nog de oudere naam, Post to a channel when a webhook request is received.
- Controleer het team en het kanaal dat het sjabloon heeft ingevuld en klik op Opslaan.
- Kopieer de webhooklink die de workflow toont.
Een URL van de oudere Incoming Webhook-connector (op webhook.office.com) wordt nog steeds geaccepteerd. Microsoft schaft Microsoft 365-connectors af en blokkeert nieuwe, dus gebruik Workflows voor alles wat je nu instelt.
Het kanaal toevoegen in AutoPSEO
- Klik in de sectie Microsoft Teams onder Slack, Teams & Webhooks op Nieuw Teams-kanaal. Het formulier opent met Microsoft Teams als bestemming.
- Vul een Naam in die je herkent en plak de URL. Voor een Teams-item accepteert AutoPSEO adressen van Workflows en connectors (hosts zoals
logic.azure.com,powerautomate.com,azure-api.netenwebhook.office.com) en weigert het andere hosts. - Klik op Kanaal toevoegen en vervolgens op Test verzenden in de bijbehorende rij. Er hoort een kaart in het kanaal te verschijnen met de naam van het item als titel.
- Maak een gepland rapport of een melding aan en kies dit kanaal.
Een regel verstuurt naar één kanaal. Wil je dezelfde melding in Slack en in Teams ontvangen, maak de regel dan twee keer aan, één keer voor elk kanaal.
Hoe de kaart is opgebouwd
Elk bericht wordt één Adaptive Card (versie 1.4, volledige breedte), verpakt in de message-envelop met een application/vnd.microsoft.card.adaptive-bijlage, zoals ook in de eigen voorbeelden van Microsoft.
- Titel in groot, vetgedrukt lettertype. Bij meldingen krijgt de kaart de kleur Attention voor kritiek en hoog, Warning voor gemiddeld en de standaardkleur voor laag; rapporten en tests gebruiken de kleur Accent.
- Samenvatting: dezelfde zin die in een Slack-bericht staat, met de datumperiode.
- Feiten: maximaal 12 waarden met label, zoals klikken en de verandering daarin, of de huidige waarde van een melding naast de basislijn.
- Tabel: voor rapporten en rapportsamenvattingen, maximaal tien rijen in een lettertype met vaste breedte.
- Voettekst: de property, een herinnering dat Search Console-data ongeveer een dag achterloopt en dat alleen afgeronde dagen meetellen, en de afzender.
- Rapport openen: een knop naar het bijbehorende rapport in AutoPSEO.
Waarom een kaart niet aankwam
Test verzenden meldt een fout meteen; bij geplande berichten bewaart de Bezorggeschiedenis het antwoord van Teams.
| Wat je ziet | Waarschijnlijke oorzaak | Oplossing |
|---|---|---|
| "That does not look like a Teams Workflows or Incoming Webhook URL" bij het opslaan | De URL staat niet op een Workflows- of connectorhost | Kopieer de link opnieuw uit de workflow |
| HTTP 400 bij Test verzenden | Toch geen Teams-webhook: een Slack-URL, een Zapier-hook of een workflow die is aangepast om een andere body te verwachten | Maak een nieuwe workflow op basis van het sjabloon en voeg de bijbehorende URL toe |
| Time-out na 10 seconden | Teams antwoordde niet op tijd | Probeer het later opnieuw |
| Omleidingen worden niet gevolgd | De URL verwijst door naar een ander adres | Voeg in plaats daarvan de uiteindelijke URL toe |
| Kaarten stopten nadat een collega vertrok | Microsoft koppelt elke workflow aan de mensen die eigenaar zijn, en een workflow zonder eigenaar kan stoppen | Voeg medeëigenaren toe aan de workflow, of maak hem opnieuw aan |
Een mislukt gepland rapport wordt in dezelfde periode niet opnieuw verstuurd: verhelp de oorzaak en gebruik Nu verzenden.
Wanneer je beter een webhook gebruikt
Teams en uitgaande webhooks kunnen dezelfde regels bedienen, maar ze zijn bedoeld voor andere lezers. Een Teams-kanaal is voor mensen: een opgemaakte kaart en niets om te bouwen. Een webhook is voor software: de ruwe gebeurtenis als ondertekende JSON voor Zapier, Make, n8n of je eigen service. Teams verwacht een kaart en niet de event-JSON van AutoPSEO, dus een Teams-URL hoort altijd onder Microsoft Teams.
Een overzicht van wat Teams-gebruikers krijgen vind je op de Microsoft Teams-pagina.