Slack koppelen aan je werkruimte

Wat je gaat bouwen

Aan het eind van deze zelfstudie heb je:

• Een Slack-app die voor je werkruimte is aangemaakt, met de juiste rechten en gebeurtenissen al ingesteld
• Een live verbinding tussen Slack en Control Center
• Je eigen Slack-account gekoppeld aan je Control Center-gebruiker
• Een agent die je antwoordt in een Slack-thread en een ticket dat met een slash-commando is aangemaakt

Vereisten:

• Je eerste werkruimte en Je eerste agent starten afgerond — een werkruimte zonder agenten kan een Slack-bericht ontvangen, maar heeft niemand om het te beantwoorden
• De CEO-agent van de werkruimte heeft een adapter en een model ingesteld via Instellingen → Werkruimte → Agenten. De brug wekt de CEO, niet de agent die je in de vorige zelfstudie hebt geconfigureerd, en een agent zonder adapter draait op de ingebouwde loop met het standaardmodel van Anthropic.
• De rol owner of admin in de Control Center-werkruimte (een chat-app verbinden geldt voor de hele werkruimte)
• Toestemming om apps te maken en te installeren in je Slack-werkruimte

Niets hiervan heeft een publiek adres, een tunnel of een inkomende poort nodig. Control Center belt naar buiten met Slack via Socket Mode, dus dit werkt vanaf een laptop achter NAT.

Stap 1: Een app-configuratietoken voor Slack ophalen

Dit is het enige geheim dat je met de hand moet ophalen. Het laat Control Center de app voor je aanmaken en later bewerken.

1. Open api.slack.com/apps
2. Scrol naar de sectie met app-configuratietokens onderaan de pagina
3. Genereer een tokenpaar voor je Slack-werkruimte
4. Kopieer het refresh-token — het begint met xoxe-

Stap 2: Control Center de app laten aanmaken

1. Ga in Control Center naar Instellingen → Werkruimte → Algemeen en zoek de kaart Chatbruggen
2. Klik in het blok Slack op Maak de app voor mij
3. Plak het app-configuratietoken
4. Controleer hoe de bot eruit komt te zien:
   • App-naam: hoe Slack de app vermeldt, bijvoorbeeld Control Center · Acme
   • Botnaam: wat mensen na @ typen, bijvoorbeeld control-center
   • Korte beschrijving en Wat de bot zegt te kunnen
   • Slash-commando: standaard cc, dus het commando is /cc
   • Directe berichten: laat dit aan staan zodat leden de bot een DM kunnen sturen
5. Klik op App maken

Control Center stelt de hele app-definitie samen — Socket Mode aan, de bot-scopes en gebeurtenisabonnementen die hij nodig heeft, het slash-commando, het tabblad Messages — en maakt de app aan in Slack.

Stap 3: De twee stappen afronden die alleen Slack kan

Slack heeft geen API om een app-token te genereren of een app te installeren, dus de dialoog geeft je beide als links:

1. Een app-token genereren — opent Basic Information → App-Level Tokens. Maak een token met de scope connections:write en kopieer het. Het begint met xapp-
2. De app installeren — opent Install App. Installeer in je werkruimte en kopieer daarna het Bot User OAuth Token. Het begint met xoxb-

Bewaar beide waarden voor de volgende stap.

Stap 4: Verbinden

1. Klik terug in de dialoog op Inloggegevens plakken
2. Vul het Bot-token (xoxb-…) en het App-token (xapp-…) in
3. Laat App-configuratietoken leeg — die uit stap 1 is al opgeslagen (Slack heeft hem geroteerd en Control Center heeft de nieuwe bewaard)
4. Klik op Verbinden

Control Center verifieert het bot-token bij Slack voordat het iets opslaat en opent daarna de socket. De rij toont nu de naam van de bot en de naam van je Slack-werkruimte met het label Live.

Stap 5: Je eigen Slack-account koppelen

De verbinding maakt de bot bereikbaar; de koppeling maakt jou herkenbaar. Zolang je Slack-identiteit niet is gekoppeld, handelt de bot niet op je berichten — hij schrijft een bericht nooit toe aan wie de app ook maar heeft geïnstalleerd.

Koppelen is persoonlijk en staat daarom op een andere pagina dan de werkruimtebrede verbinding.

1. Ga naar Instellingen → Werkruimte → Profiel en identiteit en zoek de kaart Gekoppelde chataccounts
2. Klik op Mijn Slack-account koppelen
3. Kopieer het commando dat het toont, bijvoorbeeld /cc link K7M2QP
4. Stuur dat commando in Slack naar de bot in een DM
5. De bot antwoordt “Gekoppeld — je bent …”

De code is eenmalig en verloopt na 15 minuten. Als je Slack-e-mailadres overeenkomt met een Control Center-gebruiker die al lid is van deze werkruimte, koppelt de brug je automatisch zodra je voor het eerst met hem praat en kun je deze stap overslaan.

Als je de bot vermeldt voordat dit is gebeurd, weigert hij en zegt waarom. De drie weigeringen verschillen van elkaar, dus lees goed welke je krijgt:

• Afzender zonder koppeling: de bot vertelt je hoe je koppelt. Kom terug naar deze stap.
• Gekoppeld, maar geen lid van deze werkruimte: vraag een beheerder je uit te nodigen.
• Lid met een alleen-lezenrol (kijker of gast): de bot begint geen werk namens jou.

Stap 6: Een agent iets laten doen

1. Nodig de bot in Slack uit in een kanaal: /invite @control-center

2. Vermeld hem met een echte opdracht:

   @control-center vat de open PR’s op de repo api samen

De brug:

1. Maakt een Control Center-ruimte voor die Slack-thread, vernoemd naar het Slack-kanaal en je opdracht
2. Weckt de voordeur-agent van de werkruimte (de CEO-agent als die er is, anders de eerste agent)
3. Streamt het antwoord van de agent terug naar de Slack-thread terwijl het wordt geschreven

Antwoord in dezelfde Slack-thread om verder te gaan — verdere vermeldingen zijn niet nodig, want de Slack-thread is nu overbrugd. Of stuur de bot een DM in plaats van een kanaal te gebruiken; elk DM-gesprek drijft zijn eigen Control Center-ruimte aan, met een titel en een statusregel “aan het denken…” terwijl de agent werkt.

Streaming vereist de streaming-API van Slack, die niet elk abonnement heeft. Als je app die niet krijgt, stopt de brug voor de hele verbinding met proberen en plaatst hij elke reactie als één bericht in plaats daarvan; op de kaart Chatbruggen staat dan “Live streamen staat uit voor deze Slack-app — antwoorden komen als één bericht.” Al het andere werkt hetzelfde.

Stap 7: Een ticket aanmaken zonder Slack te verlaten

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

De bot antwoordt met de ticketsleutel die hij heeft aangemaakt. Het ticket is een gewoon lokaal Control Center-ticket, door jou gemeld en klaar om aan een agent te worden toegewezen. /cc help laat zien wat het commando allemaal kan.

Samenvatting

Je hebt vanuit Control Center een Slack-app aangemaakt, die via een uitgaande socket verbonden, je Slack-identiteit aan je Control Center-gebruiker gekoppeld en een agent vanuit een Slack-thread aangestuurd. Alles wat in Slack gebeurde, bestaat ook in Control Center: de Slack-thread is een ruimte, het antwoord is een transcript en het ticket is een ticket.

Volgende: Slack-integratie instellen behandelt de handmatige route, het roteren van tokens en probleemoplossing. Lees Chatbruggen voor het model eronder.