Συνδέστε το Slack στον χώρο εργασίας σας

Τι θα φτιάξετε

Στο τέλος αυτού του οδηγού θα έχετε:

• Μια εφαρμογή Slack δημιουργημένη για τον χώρο εργασίας σας, με τα σωστά δικαιώματα και συμβάντα ήδη ρυθμισμένα
• Μια ζωντανή σύνδεση ανάμεσα στο Slack και το Control Center
• Τον δικό σας λογαριασμό Slack συνδεδεμένο με τον χρήστη σας στο Control Center
• Έναν πράκτορα να σας απαντά σε ένα νήμα του Slack και ένα εισιτήριο καταχωρισμένο από μια εντολή slash

Προαπαιτούμενα:

• Ο πρώτος σας χώρος εργασίας και η αποστολή του πρώτου σας πράκτορα ολοκληρωμένα — ένας χώρος εργασίας χωρίς πράκτορες μπορεί να λάβει ένα μήνυμα από το Slack, αλλά δεν έχει κανέναν να απαντήσει
• Ο πράκτορας CEO του χώρου εργασίας έχει προσαρμογέα και μοντέλο ορισμένα στις Ρυθμίσεις → Χώρος εργασίας → Πράκτορες. Η γέφυρα ξυπνά τον CEO, όχι τον πράκτορα που ρυθμίσατε στον προηγούμενο οδηγό, και ένας πράκτορας χωρίς προσαρμογέα εκτελείται στον ενσωματωμένο βρόχο με το προεπιλεγμένο μοντέλο της Anthropic.
• Τον ρόλο owner ή admin στον χώρο εργασίας του Control Center (η σύνδεση μιας εφαρμογής συνομιλίας μιλά για λογαριασμό ολόκληρου του χώρου εργασίας)
• Δικαίωμα δημιουργίας και εγκατάστασης εφαρμογών στον χώρο εργασίας σας στο Slack

Τίποτα εδώ δεν χρειάζεται δημόσια διεύθυνση, tunnel ή θύρα εισόδου. Το Control Center καλεί προς τα έξω το Slack μέσω Socket Mode, οπότε αυτό λειτουργεί από έναν φορητό υπολογιστή πίσω από NAT.

Βήμα 1: Αποκτήστε ένα token ρύθμισης εφαρμογής Slack

Αυτό είναι το μοναδικό μυστικό που πρέπει να αποκτήσετε με το χέρι. Επιτρέπει στο Control Center να δημιουργήσει και αργότερα να επεξεργαστεί την εφαρμογή για εσάς.

1. Ανοίξτε το api.slack.com/apps
2. Μεταβείτε στο τμήμα token ρύθμισης εφαρμογής στο κάτω μέρος της σελίδας
3. Δημιουργήστε ένα ζεύγος token για τον χώρο εργασίας σας στο Slack
4. Αντιγράψτε το refresh token — ξεκινά με xoxe-

Βήμα 2: Αφήστε το Control Center να δημιουργήσει την εφαρμογή

1. Στο Control Center, μεταβείτε στις Ρυθμίσεις → Χώρος εργασίας → Γενικά και βρείτε την κάρτα Γέφυρες συνομιλίας
2. Στο τμήμα Slack, κάντε κλικ στο Δημιουργία εφαρμογής για μένα
3. Επικολλήστε το token ρύθμισης εφαρμογής
4. Ελέγξτε πώς θα είναι το bot:
   • Όνομα εφαρμογής: πώς εμφανίζει το Slack την εφαρμογή, π.χ. Control Center · Acme
   • Όνομα bot: τι πληκτρολογούν οι άνθρωποι μετά το @, π.χ. control-center
   • Σύντομη περιγραφή και Τι λέει το bot ότι μπορεί να κάνει
   • Εντολή κάθετου: cc από προεπιλογή, οπότε η εντολή είναι /cc
   • Άμεσα μηνύματα: αφήστε το ενεργό ώστε τα μέλη να μπορούν να στέλνουν άμεσα μηνύματα στο bot
5. Κάντε κλικ στο Δημιουργία εφαρμογής

Το Control Center συνθέτει ολόκληρο τον ορισμό της εφαρμογής — Socket Mode ενεργό, τα scopes και τις συνδρομές σε συμβάντα που χρειάζεται το bot, την εντολή slash, την καρτέλα Messages — και τη δημιουργεί στο Slack.

Βήμα 3: Ολοκληρώστε τα δύο βήματα που μπορεί να κάνει μόνο το Slack

Το Slack δεν έχει API για τη δημιουργία token επιπέδου εφαρμογής ή την εγκατάσταση μιας εφαρμογής, οπότε το παράθυρο διαλόγου σάς τα δίνει και τα δύο ως συνδέσμους:

1. Δημιουργία token επιπέδου εφαρμογής — ανοίγει το Basic Information → App-Level Tokens. Δημιουργήστε ένα token με το scope connections:write και αντιγράψτε το. Ξεκινά με xapp-
2. Εγκατάσταση της εφαρμογής — ανοίγει το Install App. Εγκαταστήστε την στον χώρο εργασίας σας και μετά αντιγράψτε το Bot User OAuth Token. Ξεκινά με xoxb-

Κρατήστε και τις δύο τιμές για το επόμενο βήμα.

Βήμα 4: Σύνδεση

1. Πίσω στο παράθυρο διαλόγου, κάντε κλικ στο Επικόλληση των διαπιστευτηρίων
2. Εισαγάγετε το Token bot (xoxb-…) και το Token επιπέδου εφαρμογής (xapp-…)
3. Αφήστε το Token ρύθμισης εφαρμογής κενό — αυτό του βήματος 1 έχει ήδη αποθηκευτεί (το Slack το περιέστρεψε και το Control Center αποθήκευσε το νέο)
4. Κάντε κλικ στη Σύνδεση

Το Control Center επαληθεύει το token bot με το Slack προτού αποθηκεύσει οτιδήποτε και μετά ανοίγει το socket. Η γραμμή τώρα δείχνει το όνομα του bot και το όνομα του χώρου εργασίας σας στο Slack με ετικέτα Ζωντανά.

Βήμα 5: Συνδέστε τον δικό σας λογαριασμό Slack

Η σύνδεση κάνει το bot προσβάσιμο· η σύνδεση του λογαριασμού κάνει εσάς αναγνωρίσιμο. Μέχρι να συνδεθεί η ταυτότητά σας στο Slack, το bot δεν θα ενεργεί βάσει των μηνυμάτων σας — δεν αποδίδει ποτέ ένα μήνυμα σε όποιον εγκατέστησε την εφαρμογή.

Η σύνδεση λογαριασμού είναι προσωπική, οπότε βρίσκεται σε διαφορετική σελίδα από τη σύνδεση που αφορά ολόκληρο τον χώρο εργασίας.

1. Μεταβείτε στις Ρυθμίσεις → Χώρος εργασίας → Προφίλ και ταυτότητα και βρείτε την κάρτα Συνδεδεμένοι λογαριασμοί συνομιλίας
2. Κάντε κλικ στο Σύνδεση του λογαριασμού μου Slack
3. Αντιγράψτε την εντολή που εμφανίζει, για παράδειγμα /cc link K7M2QP
4. Στο Slack, στείλτε αυτή την εντολή στο bot σε ένα άμεσο μήνυμα
5. Το bot απαντά “Linked — you are …”

Ο κωδικός είναι μίας χρήσης και λήγει σε 15 λεπτά. Αν το email σας στο Slack αντιστοιχεί σε χρήστη του Control Center που είναι ήδη μέλος αυτού του χώρου εργασίας, η γέφυρα σας συνδέει αυτόματα την πρώτη φορά που θα της μιλήσετε και μπορείτε να παραλείψετε αυτό το βήμα.

Αν κάνετε @-αναφορά στο bot πριν ολοκληρωθεί αυτό, αρνείται και εξηγεί γιατί. Οι τρεις αρνήσεις είναι διακριτές, οπότε προσέξτε ποια λάβατε:

• Αποστολέας χωρίς σύνδεση: το bot σας λέει πώς να συνδεθείτε. Επιστρέψτε σε αυτό το βήμα.
• Συνδεδεμένος, αλλά όχι μέλος αυτού του χώρου εργασίας: ζητήστε από έναν διαχειριστή να σας προσκαλέσει.
• Μέλος με ρόλο μόνο για ανάγνωση (viewer ή guest): το bot δεν θα ξεκινήσει εργασία για λογαριασμό σας.

Βήμα 6: Βάλτε έναν πράκτορα σε κάτι

1. Στο Slack, προσκαλέστε το bot σε ένα κανάλι: /invite @control-center

2. Κάντε @-αναφορά με ένα πραγματικό αίτημα:

   @control-center κάνε σύνοψη των ανοιχτών PR στο αποθετήριο api

Η γέφυρα:

1. Δημιουργεί έναν χώρο στο Control Center για εκείνο το νήμα του Slack, με όνομα βασισμένο στο κανάλι του Slack και στο αίτημά σας
2. Ξυπνά τον πράκτορα υποδοχής του χώρου εργασίας (τον πράκτορα CEO όταν υπάρχει, αλλιώς τον πρώτο πράκτορα)
3. Μεταδίδει σε ροή την απάντηση του πράκτορα πίσω στο νήμα του Slack καθώς γράφεται

Απαντήστε στο ίδιο νήμα του Slack για να συνεχίσετε — δεν χρειάζονται άλλες αναφορές, γιατί το νήμα του Slack είναι πλέον γεφυρωμένο. Ή στείλτε άμεσο μήνυμα στο bot αντί να χρησιμοποιήσετε κανάλι· κάθε συνομιλία άμεσων μηνυμάτων οδηγεί τον δικό της χώρο στο Control Center, με τίτλο και γραμμή κατάστασης “σκέφτεται…” όσο εργάζεται ο πράκτορας.

Η ροή απαιτεί το streaming API του Slack, το οποίο δεν το έχει κάθε πλάνο. Αν η εφαρμογή σας το απορρίψει, η γέφυρα σταματά να προσπαθεί για ολόκληρη τη σύνδεση και αναρτά κάθε απάντηση ως ένα μήνυμα και η κάρτα Γέφυρες συνομιλίας γράφει “Η ζωντανή ροή είναι απενεργοποιημένη για αυτή την εφαρμογή Slack — οι απαντήσεις φτάνουν ως ένα μήνυμα.” Όλα τα υπόλοιπα λειτουργούν το ίδιο.

Βήμα 7: Καταχωρίστε ένα εισιτήριο χωρίς να φύγετε από το Slack

/cc ticket Fix the flaky login test | It fails on CI about once a day.

Το bot απαντά με το κλειδί του εισιτηρίου που καταχώρισε. Το εισιτήριο είναι ένα συνηθισμένο τοπικό εισιτήριο του Control Center, με αναφορά από εσάς, έτοιμο να ανατεθεί σε έναν πράκτορα. Το /cc help απαριθμεί όλα όσα μπορεί να κάνει η εντολή.

Σύνοψη

Δημιουργήσατε μια εφαρμογή Slack από το Control Center, τη συνδέσατε μέσω εξερχόμενου socket, συνδέσατε την ταυτότητά σας στο Slack με τον χρήστη σας στο Control Center και κατευθύνατε έναν πράκτορα από ένα νήμα του Slack. Ό,τι συνέβη στο Slack υπάρχει και στο Control Center: το νήμα του Slack είναι ένας χώρος, η απάντηση είναι μια μεταγραφή, το εισιτήριο είναι ένα εισιτήριο.

Επόμενα: Η Ρύθμιση ενσωμάτωσης Slack καλύπτει τη χειροκίνητη διαδρομή, την περιστροφή token και την αντιμετώπιση προβλημάτων. Για το μοντέλο από κάτω, διαβάστε τις Γέφυρες συνομιλίας.