Collega Slack al tuo spazio di lavoro

Cosa costruirai

Alla fine di questo tutorial avrai:

• Un’app di Slack creata per il tuo spazio di lavoro, con i permessi e gli eventi giusti già impostati
• Una connessione attiva tra Slack e Control Center
• Il tuo account Slack collegato al tuo utente di Control Center
• Un agente che ti risponde in un thread di Slack e un ticket aperto da un comando slash

Prerequisiti:

• Il tuo primo spazio di lavoro e Invia il tuo primo agente completati — uno spazio di lavoro senza agenti può ricevere un messaggio da Slack, ma non ha nessuno che risponda
• L’agente CEO dello spazio di lavoro ha un adattatore e un modello impostati in Impostazioni → Spazio di lavoro → Agenti. Il ponte sveglia il CEO, non l’agente che hai configurato nel tutorial precedente, e un agente senza adattatore viene eseguito sul ciclo integrato con il modello predefinito di Anthropic.
• Il ruolo owner o admin nello spazio di lavoro di Control Center (connettere un’app di chat parla a nome dell’intero spazio di lavoro)
• Il permesso di creare e installare app nel tuo spazio di lavoro Slack

Nulla di tutto questo richiede un indirizzo pubblico, un tunnel o una porta in entrata. Control Center si connette in uscita a Slack tramite Socket Mode, quindi funziona da un portatile dietro NAT.

Passaggio 1: procurati un token di configurazione dell’app Slack

Questo è l’unico segreto che devi recuperare a mano. Consente a Control Center di creare e in seguito modificare l’app per te.

1. Apri api.slack.com/apps
2. Scorri fino alla sezione dei token di configurazione dell’app, in fondo alla pagina
3. Genera una coppia di token per il tuo spazio di lavoro Slack
4. Copia il token di refresh — inizia con xoxe-

Passaggio 2: lascia che Control Center crei l’app

1. In Control Center, vai in Impostazioni → Spazio di lavoro → Generale e trova la scheda Ponti di chat
2. Nel blocco Slack, clicca Crea l’app per me
3. Incolla il token di configurazione dell’app
4. Esamina come apparirà il bot:
   • Nome dell’app: come Slack elenca l’app, ad es. Control Center · Acme
   • Nome del bot: ciò che le persone digitano dopo @, ad es. control-center
   • Descrizione breve e Ciò che il bot dice di saper fare
   • Comando: cc per impostazione predefinita, quindi il comando è /cc
   • Messaggi diretti: lascialo attivo così i membri possono inviare messaggi diretti al bot
5. Clicca Crea l’app

Control Center compone l’intera definizione dell’app — Socket Mode attivo, gli scope del bot e le sottoscrizioni agli eventi di cui ha bisogno, il comando slash, la scheda Messages — e la crea in Slack.

Passaggio 3: completa i due passaggi che solo Slack può fare

Slack non ha un’API per generare un token a livello di app o installare un’app, quindi la finestra di dialogo ti fornisce entrambi come link:

1. Genera un token a livello di app — apre Basic Information → App-Level Tokens. Crea un token con lo scope connections:write e copialo. Inizia con xapp-
2. Installa l’app — apre Install App. Installa nel tuo spazio di lavoro, poi copia il Bot User OAuth Token. Inizia con xoxb-

Tieni a portata di mano entrambi i valori per il passaggio successivo.

Passaggio 4: connetti

1. Torna nella finestra di dialogo e clicca Incolla le credenziali
2. Inserisci il Token del bot (xoxb-…) e il Token a livello di app (xapp-…)
3. Lascia vuoto il Token di configurazione dell’app — quello del passaggio 1 è già stato salvato (Slack lo ha ruotato e Control Center ha salvato quello nuovo)
4. Clicca Connetti

Control Center verifica il token del bot con Slack prima di salvare qualsiasi cosa, poi apre il socket. La riga ora mostra il nome del bot e il nome del tuo spazio di lavoro Slack con un’etichetta In linea.

Passaggio 5: collega il tuo account Slack

La connessione rende il bot raggiungibile; il collegamento rende riconoscibile te. Finché la tua identità Slack non è collegata, il bot non agirà sui tuoi messaggi — non attribuisce mai un messaggio a chi ha installato l’app.

Il collegamento è personale, quindi si trova in una pagina diversa da quella della connessione a livello di spazio di lavoro.

1. Vai in Impostazioni → Spazio di lavoro → Profilo e identità e trova la scheda Account di chat collegati
2. Clicca Collega il mio account Slack
3. Copia il comando che mostra, ad esempio /cc link K7M2QP
4. In Slack, invia quel comando al bot in un messaggio diretto
5. Il bot risponde «Collegato — sei …»

Il codice è monouso e scade dopo 15 minuti. Se la tua e-mail Slack corrisponde a un utente di Control Center che è già membro di questo spazio di lavoro, il ponte ti collega automaticamente la prima volta che gli parli e puoi saltare questo passaggio.

Se menzioni il bot prima di averlo fatto, rifiuta e spiega perché. I tre rifiuti sono distinti, quindi leggi quale hai ricevuto:

• Mittente non collegato: il bot ti spiega come collegarti. Torna a questo passaggio.
• Collegato, ma non membro di questo spazio di lavoro: chiedi a un amministratore di invitarti.
• Membro con un ruolo di sola lettura (viewer o guest): il bot non avvierà lavoro a tuo nome.

Passaggio 6: metti un agente su qualcosa

1. In Slack, invita il bot in un canale: /invite @control-center

2. Menzionalo con una richiesta concreta:

   @control-center riassumi le PR aperte sul repo api

Il ponte:

1. Crea uno spazio di Control Center per quel thread di Slack, con il nome del canale Slack e della tua richiesta
2. Sveglia l’agente d’ingresso dello spazio di lavoro (l’agente CEO quando esiste, altrimenti il primo agente)
3. Trasmette in streaming la risposta dell’agente nel thread di Slack mentre viene scritta

Rispondi nello stesso thread di Slack per continuare — non servono altre menzioni, perché ora il thread di Slack è collegato. Oppure invia un messaggio diretto al bot invece di usare un canale; ogni conversazione in messaggio diretto gestisce il proprio spazio di Control Center, con un titolo e una riga di stato «Sto pensando…» mentre l’agente lavora.

Lo streaming richiede l’API di streaming di Slack, che non tutti i piani includono. Se alla tua app viene rifiutata, il ponte smette di provarci per tutta la connessione e pubblica ogni risposta come un unico messaggio; la scheda Ponti di chat mostra «Lo streaming in tempo reale è disattivato per questa app Slack: le risposte arrivano in un unico messaggio». Tutto il resto funziona allo stesso modo.

Passaggio 7: apri un ticket senza lasciare Slack

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

Il bot risponde con la chiave del ticket che ha aperto. Il ticket è un normale ticket locale di Control Center, segnalato da te, pronto per essere assegnato a un agente. /cc help elenca tutto ciò che il comando può fare.

Riepilogo

Hai creato un’app di Slack da Control Center, l’hai connessa tramite un socket in uscita, hai collegato la tua identità Slack al tuo utente di Control Center e hai guidato un agente da un thread di Slack. Tutto ciò che è accaduto in Slack esiste anche in Control Center: il thread di Slack è uno spazio, la risposta è una trascrizione, il ticket è un ticket.

Avanti: Configura l’integrazione Slack copre il percorso manuale, la rotazione dei token e la risoluzione dei problemi. Per il modello sottostante, leggi Ponti di chat.