Conectează Slack la spațiul tău de lucru

Ce vei construi

La finalul acestui tutorial vei avea:

• O aplicație Slack creată pentru spațiul tău de lucru, cu permisiunile și evenimentele potrivite deja configurate
• O conexiune activă între Slack și Control Center
• Contul tău Slack legat de utilizatorul tău Control Center
• Un agent care îți răspunde într-un fir Slack și un tichet înregistrat dintr-o comandă slash

Cerințe preliminare:

• Primul tău spațiu de lucru și Trimite primul agent finalizate — un spațiu de lucru fără agenți poate primi un mesaj Slack, dar nu are cine să îi răspundă
• Agentul CEO al spațiului de lucru are un adaptor și un model setate în Setări → Spațiu de lucru → Agenți. Puntea trezește agentul CEO, nu agentul pe care l-ai configurat în tutorialul anterior, iar un agent fără adaptor rulează pe bucla integrată, cu modelul implicit al Anthropic.
• Rolul owner sau admin în spațiul de lucru Control Center (conectarea unei aplicații de chat vorbește în numele întregului spațiu de lucru)
• Permisiunea de a crea și instala aplicații în spațiul tău de lucru Slack

Nimic de aici nu are nevoie de o adresă publică, de un tunel sau de un port de intrare. Control Center inițiază conexiunea spre exterior către Slack prin Socket Mode, așa că funcționează de pe un laptop aflat în spatele unui NAT.

Pasul 1: Obține un token de configurare a aplicației Slack

Acesta este singurul secret pe care trebuie să îl obții manual. Îi permite Control Center să creeze aplicația în locul tău și, mai târziu, să o editeze.

1. Deschide api.slack.com/apps
2. Derulează până la secțiunea de tokenuri de configurare a aplicației, în josul paginii
3. Generează o pereche de tokenuri pentru spațiul tău de lucru Slack
4. Copiază tokenul de reîmprospătare — începe cu xoxe-

Pasul 2: Lasă Control Center să creeze aplicația

1. În Control Center, mergi la Setări → Spațiu de lucru → General și găsește cardul Punți de chat
2. În blocul Slack, apasă Creează aplicația pentru mine
3. Lipește tokenul de configurare a aplicației
4. Verifică cum va arăta botul:
   • Nume aplicație: cum listează Slack aplicația, de ex. Control Center · Acme
   • Nume bot: ce tastează oamenii după @, de ex. control-center
   • Descriere scurtă și Ce spune botul că poate face
   • Comandă slash: implicit cc, așa că comanda este /cc
   • Mesaje directe: lasă activat pentru ca membrii să îi poată scrie botului în DM
5. Apasă Creează aplicația

Control Center compune întreaga definiție a aplicației — Socket Mode activat, scope-urile de bot și abonamentele la evenimente de care are nevoie, comanda slash, fila Messages — și o creează în Slack.

Pasul 3: Finalizează cei doi pași pe care doar Slack îi poate face

Slack nu are niciun API pentru a genera un token la nivel de aplicație sau pentru a instala o aplicație, așa că dialogul ți le dă pe amândouă sub formă de linkuri:

1. Generează un token la nivel de aplicație — deschide Basic Information → App-Level Tokens. Creează un token cu scope-ul connections:write și copiază-l. Începe cu xapp-
2. Instalează aplicația — deschide Install App. Instalează-o în spațiul tău de lucru, apoi copiază Bot User OAuth Token. Începe cu xoxb-

Păstrează ambele valori la îndemână pentru pasul următor.

Pasul 4: Conectează

1. Înapoi în dialog, apasă Lipește datele de autentificare
2. Introdu Token bot (xoxb-…) și Token la nivel de aplicație (xapp-…)
3. Lasă Token de configurare a aplicației gol — cel de la pasul 1 a fost deja stocat (Slack l-a rotit, iar Control Center l-a salvat pe cel nou)
4. Apasă Conectează

Control Center verifică tokenul de bot cu Slack înainte de a stoca ceva, apoi deschide socketul. Rândul afișează acum numele botului și numele spațiului tău de lucru Slack, cu o etichetă Live.

Pasul 5: Leagă-ți propriul cont Slack

Conexiunea face botul accesibil; legarea te face pe tine recognoscibil. Până când identitatea ta Slack este legată, botul nu va acționa pe baza mesajelor tale — nu atribuie niciodată un mesaj celui care a instalat aplicația.

Legarea este personală, așa că se află pe altă pagină decât conexiunea la nivel de spațiu de lucru.

1. Mergi la Setări → Spațiu de lucru → Profil și identitate și găsește cardul Conturi de chat legate
2. Apasă Leagă-mi contul Slack
3. Copiază comanda pe care o afișează, de exemplu /cc link K7M2QP
4. În Slack, trimite acea comandă botului într-un DM
5. Botul răspunde „Legat — ești …”

Codul se folosește o singură dată și expiră în 15 minute. Dacă emailul tău Slack corespunde unui utilizator Control Center care este deja membru al acestui spațiu de lucru, puntea te leagă automat prima dată când vorbești cu ea, iar tu poți sări peste acest pas.

Dacă menționezi botul înainte de a face asta, acesta refuză și explică de ce. Cele trei refuzuri sunt distincte, așa că citește care ți s-a aplicat:

• Expeditor nelegat: botul îți spune cum să faci legarea. Reia acest pas.
• Legat, dar nu ești membru al acestui spațiu de lucru: cere unui admin să te invite.
• Membru cu rol doar-citire (vizualizator sau invitat): botul nu va începe munca în numele tău.

Pasul 6: Pune un agent la treabă

1. În Slack, invită botul într-un canal: /invite @control-center

2. Menționează-l cu o cerere reală:

   @control-center rezumă PR-urile deschise din repo-ul api

Puntea:

1. Creează un spațiu Control Center pentru acel fir Slack, numit după canalul Slack și cererea ta
2. Trezește agentul de prim contact al spațiului de lucru (agentul CEO, când există unul, altfel primul agent)
3. Transmite în flux răspunsul agentului înapoi în firul Slack, pe măsură ce este scris

Răspunde în același fir Slack pentru a continua — nu mai sunt necesare alte mențiuni, pentru că firul Slack are acum o punte. Sau scrie-i botului în DM în loc să folosești un canal; fiecare conversație DM își conduce propriul spațiu Control Center, cu un titlu și o linie de stare „is thinking…” cât timp lucrează agentul.

Streamingul are nevoie de API-ul de streaming al Slack, pe care nu îl are orice plan. Dacă aplicației tale i se refuză, puntea nu mai încearcă pentru întreaga conexiune și postează fiecare răspuns ca un singur mesaj, iar cardul Punți de chat afișează „Streamingul live este oprit pentru această aplicație Slack — răspunsurile sosesc ca un singur mesaj.” Tot restul funcționează la fel.

Pasul 7: Înregistrează un tichet fără să părăsești Slack

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

Botul răspunde cu cheia tichetului pe care l-a înregistrat. Tichetul este un tichet Control Center local obișnuit, raportat de tine, gata să fie atribuit unui agent. /cc help listează tot ce poate face comanda.

Recapitulare

Ai creat o aplicație Slack din Control Center, ai conectat-o printr-un socket spre exterior, ai legat identitatea ta Slack de utilizatorul tău Control Center și ai dirijat un agent dintr-un fir Slack. Tot ce s-a întâmplat în Slack există și în Control Center: firul Slack este un spațiu, răspunsul este un transcript, tichetul este un tichet.

În continuare: Configurează integrarea Slack acoperă calea manuală, rotirea tokenurilor și depanarea. Pentru modelul din spate, citește Punți de chat.