Τεκμηρίωση

Σύνδεση του Slack με incoming webhook

Δημιουργήστε ένα incoming webhook του Slack για ένα κανάλι, προσθέστε το στο AutoPSEO, στείλτε ένα δοκιμαστικό μήνυμα και διορθώστε τα σφάλματα που επιστρέφει το Slack όταν αποτυγχάνει μια δημοσίευση.

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

Το AutoPSEO δημοσιεύει στο Slack μέσω incoming webhooks. Το Slack σάς δίνει ένα URL που γράφει σε ένα κανάλι, εσείς επικολλάτε αυτό το URL στο AutoPSEO και οι αναφορές και οι ειδοποιήσεις αρχίζουν να φτάνουν εκεί. Το ίδιο το AutoPSEO δεν εγκαθιστά τίποτα στον χώρο εργασίας σας: δεν μπορεί να διαβάσει μηνύματα, να εμφανίσει τη λίστα των καναλιών σας ούτε να δημοσιεύσει οπουδήποτε δεν δείχνει το webhook. Προσθέστε μία καταχώριση για κάθε κανάλι στο οποίο θέλετε να λαμβάνετε μηνύματα.

Δημιουργία του webhook στο Slack

Το Slack εκδίδει τα incoming webhooks μέσω μιας εφαρμογής Slack. Ακολουθώντας τον οδηγό του Slack για τα incoming webhooks:

Δημιουργήστε μια εφαρμογή Slack για τον χώρο εργασίας σας ή ανοίξτε μία που χρησιμοποιείτε ήδη για ειδοποιήσεις. Επιλέξτε ένα όνομα που θα αναγνωρίζει η ομάδα σας, όπως SEO reports.
Στις ρυθμίσεις της εφαρμογής, ανοίξτε το Incoming Webhooks και ενεργοποιήστε το Activate Incoming Webhooks.
Κάντε κλικ στο Add New Webhook to Workspace, επιλέξτε το κανάλι και εγκρίνετε. Για ιδιωτικό κανάλι πρέπει πρώτα να είστε μέλος του.
Αντιγράψτε το νέο URL από το Webhook URLs for Your Workspace. Ξεκινά με https://hooks.slack.com/services/.

Επαναλάβετε τα βήματα 3 και 4 για κάθε επιπλέον κανάλι· μία εφαρμογή μπορεί να έχει πολλά webhooks. Ένα URL που δημιουργήθηκε με τα παλαιότερα webhooks προσαρμοσμένων ενσωματώσεων (custom integrations) του Slack εξακολουθεί επίσης να λειτουργεί, αν και το Slack συνιστά τη μετάβαση σε εφαρμογή.

Το Slack αντιμετωπίζει το URL ως μυστικό: όποιος το έχει μπορεί να δημοσιεύσει στο κανάλι. Επικολλήστε το στο AutoPSEO και μην το αφήνετε σε tickets, wikis ή στιγμιότυπα οθόνης.

Προσθήκη στο AutoPSEO

Στη σελίδα Slack, Teams & Webhooks, βρείτε το Slack - Connected workspaces και κάντε κλικ στο Add to Slack. Ανοίγει η φόρμα New channel με το Slack ήδη επιλεγμένο ως προορισμό.
Name: μια ετικέτα για τις λίστες του AutoPSEO, το ιστορικό παραδόσεων και το δοκιμαστικό μήνυμα, για παράδειγμα #seo-alerts.
Webhook URL: επικολλήστε το URL του Slack. Για μια καταχώριση Slack το AutoPSEO δέχεται μόνο διευθύνσεις https στο slack.com και σας ενημερώνει αμέσως αν το URL δεν ταιριάζει.
Κάντε κλικ στο Add channel και έπειτα στο Send test στη νέα γραμμή. Ένα σύντομο μήνυμα με το όνομα της καταχώρισης θα πρέπει να εμφανιστεί στο Slack μέσα σε λίγα δευτερόλεπτα, ενώ το AutoPSEO αναφέρει πόσο χρόνο χρειάστηκε το Slack για να απαντήσει.

Το URL αποθηκεύεται κρυπτογραφημένο (AES-GCM). Από εκεί και πέρα η λίστα εμφανίζει μόνο τον κεντρικό υπολογιστή (host) και τους τελευταίους χαρακτήρες του, οπότε επιλέξτε ονόματα που δείχνουν καθαρά ποιο κανάλι Slack τροφοδοτεί κάθε καταχώριση.

Στη συνέχεια, δώστε του κάτι να δημοσιεύσει: μια προγραμματισμένη αναφορά ή μια ειδοποίηση. Ο πίνακας Slack - Subscriptions κάτω από τη λίστα εμφανίζει τότε, ανά κανάλι Slack, κάθε κανόνα που δημοσιεύει εκεί, το πρόγραμμά του και αν είναι ενεργός ή σε παύση.

Πολλά κανάλια και χώροι εργασίας

Ένα webhook URL ανήκει σε ένα κανάλι ενός χώρου εργασίας και το Slack δεν επιτρέπει σε ένα μήνυμα να αλλάξει το κανάλι για το οποίο δημιουργήθηκε. Αυτό κρατά τα πράγματα προβλέψιμα:

Ένα κανάλι Slack, μία καταχώριση. Για να χωρίσετε τους πελάτες ανάμεσα στα #client-a και #client-b, δημιουργήστε ένα webhook για το καθένα και προσθέστε και τα δύο.
Οι πολλοί χώροι εργασίας λειτουργούν με τον ίδιο τρόπο, καθώς κάθε webhook ανήκει στον χώρο εργασίας όπου το δημιουργήσατε.
Μία καταχώριση μπορεί να εξυπηρετεί πολλούς κανόνες. Στείλτε την εβδομαδιαία αναφορά και την ειδοποίηση πτώσης επισκεψιμότητας στην ίδια καταχώριση ή κρατήστε τις ειδοποιήσεις σε ένα πιο πολυσύχναστο κανάλι δικό τους.

Γιατί δεν έφτασε ένα μήνυμα

Το Send test εμφανίζει αμέσως την αιτία. Για τα προγραμματισμένα μηνύματα, ανοίξτε το Delivery history, που διατηρεί την απάντηση του Slack για κάθε αποτυχημένη προσπάθεια.

Τι εμφανίζει το AutoPSEO	Τι σημαίνει	Τι να κάνετε
Το Slack απέρριψε το URL (no_service)	Το webhook αφαιρέθηκε ή απενεργοποιήθηκε στο Slack ή το URL έχει πληκτρολογηθεί λάθος	Δημιουργήστε νέο webhook, προσθέστε το και μετά διαγράψτε την παλιά καταχώριση
Το κανάλι Slack δεν υπάρχει πλέον ή έχει αρχειοθετηθεί	Το Slack απάντησε `channel_not_found` ή `channel_is_archived`	Δημιουργήστε ένα webhook για ένα κανάλι που εξακολουθεί να χρησιμοποιείται
Το Slack περιορίζει τον ρυθμό των αιτημάτων	Το Slack απάντησε με HTTP 429	Περιμένετε λίγο και μετά χρησιμοποιήστε το Send now ή το Test rule
Έληξε ο χρόνος αναμονής μετά από 10 δευτερόλεπτα	Το Slack δεν απάντησε εγκαίρως	Δοκιμάστε ξανά αργότερα
Η δοκιμαστική περίοδος έχει λήξει	Δεν υπάρχει ενεργό πρόγραμμα ή δοκιμαστική περίοδος	Επιλέξτε πρόγραμμα· οι προγραμματισμένες παραδόσεις συνεχίζονται μαζί του

Μια αποτυχημένη προγραμματισμένη αναφορά δεν στέλνεται ξανά στην ίδια περίοδο, γι' αυτό χρησιμοποιήστε το Send now μόλις διορθωθεί η αιτία. Μια ειδοποίηση που δεν κατέστη δυνατό να δημοσιευτεί αξιολογείται ξανά στον επόμενο έλεγχό της (πότε εκτελούνται οι ειδοποιήσεις).

Κατάργηση ενός καναλιού Slack

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