Τεκμηρίωση

Ειδοποιήσεις και αναφορές στο Microsoft Teams

Δημιουργήστε ένα webhook του Workflows σε ένα κανάλι του Teams, προσθέστε το στο AutoPSEO και λαμβάνετε ειδοποιήσεις και προγραμματισμένες αναφορές ως Adaptive Cards με χρώμα ανάλογο της σοβαρότητας.

Λογαριασμός → Slack, Teams & Webhooks → Microsoft TeamsΑπαιτεί συνδρομή ή δοκιμαστική περίοδο4 λεπτά ανάγνωσης

Το AutoPSEO δημοσιεύει στο Microsoft Teams μέσω ενός webhook του Workflows. Το Teams σάς δίνει ένα URL που δημοσιεύει σε ένα κανάλι και εσείς το προσθέτετε στο AutoPSEO ως κανάλι Teams. Οι ειδοποιήσεις, οι προγραμματισμένες αναφορές, τα δοκιμαστικά μηνύματα και οι συνοπτικές αναφορές μίας χρήσης φτάνουν στη συνέχεια ως Adaptive Cards, με τον τίτλο χρωματισμένο ανάλογα με τη σοβαρότητα και ένα κουμπί που οδηγεί πίσω στην αναφορά. Δεν χρειάζεστε χώρο εργασίας Slack και δεν υπάρχει εφαρμογή AutoPSEO προς εγκατάσταση στο Teams.

Λήψη του URL του webhook από το Teams

Ο οδηγός για τα εισερχόμενα webhook της Microsoft δημιουργεί το URL με την εφαρμογή Workflows:

Στο Teams, μεταβείτε στο κανάλι που θα λαμβάνει τις κάρτες και επιλέξτε Περισσότερες επιλογές (...) δίπλα σε αυτό.
Επιλέξτε Workflows και διαλέξτε ένα πρότυπο webhook. Η Microsoft το ονομάζει σήμερα Send webhook alerts to a channel· η υπόδειξη του AutoPSEO στη σελίδα ρυθμίσεων χρησιμοποιεί ακόμη την παλαιότερη ονομασία, Post to a channel when a webhook request is received.
Ελέγξτε την ομάδα και το κανάλι που συμπλήρωσε το πρότυπο και κάντε κλικ στο Save.
Αντιγράψτε τον σύνδεσμο webhook που εμφανίζει η ροή εργασίας.

Ένα URL από τον παλαιότερο σύνδεσμο Incoming Webhook (στο webhook.office.com) γίνεται ακόμη δεκτό. Η Microsoft καταργεί τους συνδέσμους του Microsoft 365 Connectors και θα αποκλείσει τους νέους, γι' αυτό χρησιμοποιήστε το Workflows για ό,τι ρυθμίζετε τώρα.

Προσθήκη του καναλιού στο AutoPSEO

Στην ενότητα Microsoft Teams της σελίδας Slack, Teams & Webhooks, κάντε κλικ στο New Teams channel. Η φόρμα ανοίγει με προορισμό το Microsoft Teams.
Εισαγάγετε ένα Name που θα αναγνωρίζετε και επικολλήστε το URL. Για μια εγγραφή Teams το AutoPSEO δέχεται διευθύνσεις Workflows και connector (hosts όπως logic.azure.com, powerautomate.com, azure-api.net και webhook.office.com) και απορρίπτει άλλους hosts.
Κάντε κλικ στο Add channel και έπειτα στο Send test στη γραμμή του. Στο κανάλι θα πρέπει να εμφανιστεί μια κάρτα με τίτλο το όνομα της εγγραφής.
Δημιουργήστε μια προγραμματισμένη αναφορά ή μια ειδοποίηση και επιλέξτε αυτό το κανάλι.

Ένας κανόνας στέλνει σε ένα κανάλι. Για να λαμβάνετε την ίδια ειδοποίηση στο Slack και στο Teams, δημιουργήστε τον κανόνα δύο φορές, μία για κάθε κανάλι.

Πώς διαμορφώνεται η κάρτα

Κάθε μήνυμα γίνεται μία Adaptive Card (έκδοση 1.4, πλήρους πλάτους), τυλιγμένη στο περίβλημα message με συνημμένο application/vnd.microsoft.card.adaptive, όπως στα επίσημα παραδείγματα της Microsoft.

Τίτλος με μεγάλους έντονους χαρακτήρες. Οι ειδοποιήσεις παίρνουν το χρώμα Attention της κάρτας για κρίσιμη και υψηλή σοβαρότητα, Warning για μέτρια και το προεπιλεγμένο χρώμα για χαμηλή· οι αναφορές και οι δοκιμές χρησιμοποιούν το χρώμα Accent.
Περίληψη: η ίδια πρόταση που περιλαμβάνει ένα μήνυμα Slack, μαζί με το χρονικό παράθυρο.
Facts: έως 12 επισημασμένες τιμές, όπως τα κλικ και η μεταβολή τους ή η τρέχουσα τιμή μιας ειδοποίησης σε σχέση με τη βάση αναφοράς της.
Πίνακας: για αναφορές και συνοπτικές αναφορές, έως δέκα γραμμές σε γραμματοσειρά σταθερού πλάτους.
Υποσέλιδο: η ιδιότητα (property), μια υπενθύμιση ότι τα δεδομένα του Search Console καθυστερούν περίπου μία ημέρα και ότι υπολογίζονται μόνο οι ημέρες με οριστικά δεδομένα, και ο αποστολέας.
Open report: ένα κουμπί προς την αντίστοιχη αναφορά στο AutoPSEO.

Γιατί δεν έφτασε μια κάρτα

Το Send test αναφέρει αμέσως μια αποτυχία· για τα προγραμματισμένα μηνύματα, το Delivery history διατηρεί την απάντηση που έδωσε το Teams.

Τι βλέπετε	Πιθανή αιτία	Λύση
«That does not look like a Teams Workflows or Incoming Webhook URL» κατά την αποθήκευση	Το URL δεν ανήκει σε host του Workflows ή connector	Αντιγράψτε ξανά τον σύνδεσμο από τη ροή εργασίας
HTTP 400 στο Send test	Στην πραγματικότητα δεν είναι webhook του Teams: URL του Slack, hook του Zapier ή ροή εργασίας που τροποποιήθηκε ώστε να αναμένει διαφορετικό σώμα μηνύματος	Δημιουργήστε νέα ροή εργασίας από το πρότυπο και προσθέστε το URL της
Λήξη χρόνου μετά από 10 δευτερόλεπτα	Το Teams δεν απάντησε εγκαίρως	Δοκιμάστε ξανά αργότερα
Οι ανακατευθύνσεις δεν ακολουθούνται	Το URL προωθεί αλλού	Προσθέστε το τελικό URL
Οι κάρτες σταμάτησαν αφού αποχώρησε ένας συνάδελφος	Η Microsoft συνδέει κάθε ροή εργασίας με τα άτομα που την κατέχουν και μια ροή χωρίς κάτοχο μπορεί να σταματήσει	Προσθέστε συνιδιοκτήτες στη ροή εργασίας ή δημιουργήστε την ξανά

Μια προγραμματισμένη αναφορά που απέτυχε δεν ξαναστέλνεται στην ίδια περίοδο: διορθώστε την αιτία και χρησιμοποιήστε το Send now.

Πότε να χρησιμοποιήσετε αντί γι' αυτό ένα webhook

Το Teams και τα εξερχόμενα webhook μπορούν να διακινούν τους ίδιους κανόνες, αλλά εξυπηρετούν διαφορετικούς αποδέκτες. Ένα κανάλι Teams απευθύνεται σε ανθρώπους: μια μορφοποιημένη κάρτα και τίποτα να στήσετε. Ένα webhook απευθύνεται σε λογισμικό: το ακατέργαστο συμβάν ως υπογεγραμμένο JSON για το Zapier, το Make, το n8n ή τη δική σας υπηρεσία. Το Teams αναμένει κάρτα και όχι το JSON συμβάντων του AutoPSEO, γι' αυτό ένα URL του Teams ανήκει πάντα στο Microsoft Teams.

Μια επισκόπηση όσων προσφέρει το Teams υπάρχει στη σελίδα Microsoft Teams.