Documentazione
Avvisi e report su Microsoft Teams
Crea un webhook Workflows in un canale Teams, aggiungilo ad AutoPSEO e ricevi avvisi e report pianificati come Adaptive Card colorate in base alla gravità.
AutoPSEO pubblica su Microsoft Teams tramite un webhook Workflows. Teams ti fornisce un URL che pubblica in un singolo canale, e tu lo aggiungi ad AutoPSEO come canale Teams. Avvisi, report pianificati, messaggi di prova e riepiloghi di report una tantum arrivano quindi come Adaptive Card, con il titolo colorato in base alla gravità e un pulsante che rimanda al report. Non serve alcun workspace Slack e in Teams non c'è nessuna app AutoPSEO da installare.
Ottenere un URL del webhook da Teams
La guida ai webhook in ingresso di Microsoft crea l'URL con l'app Workflows:
- In Teams, vai al canale che deve ricevere le card e scegli Altre opzioni (...) accanto al suo nome.
- Scegli Workflows e seleziona un modello di webhook. Microsoft lo chiama attualmente Send webhook alerts to a channel; il suggerimento di AutoPSEO nella pagina delle impostazioni usa ancora il nome precedente, Post to a channel when a webhook request is received.
- Controlla il team e il canale che il modello ha compilato, poi fai clic su Salva.
- Copia il link del webhook che il workflow ti mostra.
Un URL del vecchio connettore Incoming Webhook (su webhook.office.com) è ancora accettato. Microsoft sta dismettendo i connettori di Microsoft 365 e bloccherà quelli nuovi, quindi per qualsiasi configurazione che crei adesso usa Workflows.
Aggiungere il canale in AutoPSEO
- Nella sezione Microsoft Teams di Slack, Teams & Webhooks, fai clic su Nuovo canale Teams. Il modulo si apre con Microsoft Teams come destinazione.
- Inserisci un Nome facilmente riconoscibile e incolla l'URL. Per una voce Teams AutoPSEO accetta indirizzi Workflows e dei connettori (host come
logic.azure.com,powerautomate.com,azure-api.netewebhook.office.com) e rifiuta qualsiasi altro host. - Fai clic su Aggiungi canale, poi su Invia test nella riga corrispondente. Nel canale dovrebbe comparire una card con il nome della voce come titolo.
- Crea un report pianificato o un avviso e scegli questo canale.
Una regola invia a un solo canale. Per avere lo stesso avviso sia su Slack sia su Teams, crea la regola due volte, una per ciascuno.
Come è strutturata la card
Ogni messaggio diventa un'unica Adaptive Card (versione 1.4, a larghezza piena), inserita nell'envelope message con un allegato application/vnd.microsoft.card.adaptive, come negli esempi di Microsoft.
- Titolo in grande e in grassetto. Gli avvisi usano il colore Attention della card per criticità critica e alta, Warning per la media e il colore predefinito per la bassa; report e test usano il colore Accent.
- Riepilogo: la stessa frase di un messaggio Slack, con l'intervallo di date.
- Dati: fino a 12 valori con etichetta, come i clic e la loro variazione, oppure il valore attuale di un avviso rispetto alla sua baseline.
- Tabella: per report e riepiloghi di report, fino a dieci righe in un carattere a spaziatura fissa.
- Piè di pagina: la property, un promemoria che i dati di Search Console hanno un ritardo di circa un giorno e che vengono conteggiati solo i giorni consolidati, e il mittente.
- Apri report: un pulsante che porta al report corrispondente in AutoPSEO.
Perché una card non è arrivata
Invia test segnala subito un errore; per i messaggi pianificati, la Cronologia di consegna conserva la risposta ricevuta da Teams.
| Cosa vedi | Causa probabile | Soluzione |
|---|---|---|
| "That does not look like a Teams Workflows or Incoming Webhook URL" al salvataggio | L'URL non appartiene a un host Workflows o dei connettori | Copia di nuovo il link dal workflow |
| HTTP 400 su Invia test | In realtà non è un webhook di Teams: un URL di Slack, un hook di Zapier o un workflow modificato in modo da aspettarsi un corpo diverso | Crea un nuovo workflow dal modello e aggiungi il suo URL |
| Timeout dopo 10 secondi | Teams non ha risposto in tempo | Riprova più tardi |
| I reindirizzamenti non vengono seguiti | L'URL inoltra altrove | Aggiungi l'URL finale |
| Le card si sono interrotte dopo l'uscita di un collega | Microsoft associa ogni workflow alle persone che ne sono proprietarie, e un workflow senza proprietario può smettere di funzionare | Aggiungi dei co-proprietari al workflow oppure ricrealo |
Un report pianificato non riuscito non viene rinviato nello stesso periodo: risolvi la causa e usa Invia ora.
Quando usare invece un webhook
Teams e i webhook in uscita possono gestire le stesse regole, ma si rivolgono a lettori diversi. Un canale Teams è pensato per le persone: una card formattata e nulla da sviluppare. Un webhook è pensato per il software: l'evento grezzo come JSON firmato per Zapier, Make, n8n o per un tuo servizio. Teams si aspetta una card e non il JSON degli eventi di AutoPSEO, quindi un URL di Teams va sempre inserito sotto Microsoft Teams.
Una panoramica di ciò che ottengono gli utenti di Teams è disponibile nella pagina di Microsoft Teams.