Koppla Slack till din arbetsyta

Det här bygger du

När du är klar med den här guiden har du:

• En Slack-app skapad för din arbetsyta, med rätt behörigheter och händelser redan satta
• En live-anslutning mellan Slack och Control Center
• Ditt eget Slack-konto länkat till din Control Center-användare
• En agent som svarar dig i en Slack-tråd och ett ärende som skapas från ett slash-kommando

Förkunskaper:

• Din första arbetsyta och Starta din första agent avklarade – en arbetsyta utan agenter kan ta emot ett Slack-meddelande men har ingen som svarar på det
• Arbetsytans CEO-agent har en adapter och en modell inställda under Inställningar → Arbetsyta → Agenter. Bryggan väcker CEO:n, inte agenten du konfigurerade i den förra guiden, och en agent utan adapter körs på den inbyggda loopen med Anthropics standardmodell.
• Rollen owner eller admin i Control Center-arbetsytan (att ansluta en chattapp talar för hela arbetsytan)
• Behörighet att skapa och installera appar i din Slack-arbetsyta

Inget av det här kräver en publik adress, en tunnel eller en inkommande port. Control Center ringer ut till Slack över Socket Mode, så det fungerar från en bärbar dator bakom NAT.

Steg 1: Skaffa en token för appkonfiguration

Det här är den enda hemligheten du måste hämta för hand. Den låter Control Center skapa och senare redigera appen åt dig.

1. Öppna api.slack.com/apps
2. Rulla ned till avsnittet för tokens för appkonfiguration längst ned på sidan
3. Generera ett tokenpar för din Slack-arbetsyta
4. Kopiera refresh-token – den börjar med xoxe-

Steg 2: Låt Control Center skapa appen

1. Gå till Inställningar → Arbetsyta → Allmänt i Control Center och hitta kortet Chattbryggor
2. Klicka på Skapa app åt mig i blocket Slack
3. Klistra in token för appkonfiguration
4. Granska hur boten kommer att se ut:
   • Appnamn: hur Slack listar appen, t.ex. Control Center · Acme
   • Botnamn: vad folk skriver efter @, t.ex. control-center
   • Kort beskrivning och Vad boten säger att den kan göra
   • Slash-kommando: cc som standard, så kommandot blir /cc
   • Direktmeddelanden: låt det vara på så att medlemmar kan skicka DM till boten
5. Klicka på Skapa app

Control Center sätter ihop hela appdefinitionen – Socket Mode på, behörighetsomfången och händelseprenumerationerna boten behöver, slash-kommandot, fliken Messages – och skapar den i Slack.

Steg 3: Slutför de två stegen som bara Slack kan göra

Slack har inget API för att generera en appnivå-token eller installera en app, så dialogrutan ger dig båda som länkar:

1. Generera en appnivå-token – öppnar Basic Information → App-Level Tokens. Skapa en token med omfånget connections:write och kopiera den. Den börjar med xapp-
2. Installera appen – öppnar Install App. Installera i din arbetsyta och kopiera sedan Bot User OAuth Token. Den börjar med xoxb-

Spara båda värdena till nästa steg.

Steg 4: Anslut

1. Klicka på Klistra in inloggningsuppgifterna i dialogrutan igen
2. Ange Bot-token (xoxb-…) och Appnivå-token (xapp-…)
3. Lämna Token för appkonfiguration tom – den från steg 1 har redan sparats (Slack roterade den och Control Center sparade den nya)
4. Klicka på Anslut

Control Center verifierar bot-token mot Slack innan den sparar något och öppnar sedan socketen. Raden visar nu botens namn och din Slack-arbetsytas namn med en Live-tagg.

Steg 5: Länka ditt eget Slack-konto

Anslutningen gör boten nåbar; länkningen gör dig igenkännbar. Tills din Slack-identitet är länkad agerar inte boten på dina meddelanden – den tillskriver aldrig ett meddelande den som installerade appen.

Länkning är personlig, så den finns på en annan sida än den arbetsyteövergripande anslutningen.

1. Gå till Inställningar → Arbetsyta → Profil och identitet och hitta kortet Länkade chattkonton
2. Klicka på Länka mitt Slack-konto
3. Kopiera kommandot som visas, till exempel /cc link K7M2QP
4. Skicka kommandot till boten i ett DM i Slack
5. Boten svarar ”Linked — you are …”

Koden går bara att använda en gång och upphör att gälla efter 15 minuter. Om din Slack-e-postadress matchar en Control Center-användare som redan är medlem i den här arbetsytan länkar bryggan dig automatiskt första gången du pratar med den, och då kan du hoppa över det här steget.

Om du nämner boten innan det här är klart vägrar den och säger varför. De tre avslagen är olika, så läs vilket du fick:

• Olänkad avsändare: boten berättar hur du länkar. Kom tillbaka till det här steget.
• Länkad, men inte medlem i den här arbetsytan: be en admin bjuda in dig.
• Medlem med en skrivskyddad roll (viewer eller guest): boten startar inte arbete för din räkning.

Steg 6: Sätt en agent på något

1. Bjud in boten till en kanal i Slack: /invite @control-center

2. Nämn den med en riktig förfrågan:

   @control-center sammanfatta de öppna PR:arna i api-repot

Bryggan:

1. Skapar en yta i Control Center för den Slack-tråden, namngiven efter Slack-kanalen och din förfrågan
2. Väcker arbetsytans ingångsagent (CEO-agenten när det finns en, annars den första agenten)
3. Strömmar agentens svar tillbaka in i Slack-tråden medan det skrivs

Svara i samma Slack-tråd för att fortsätta – inga fler omnämningar behövs, för Slack-tråden är nu bryggad. Eller skicka DM till boten i stället för att använda en kanal; varje DM-konversation driver sin egen yta i Control Center, med en titel och en statusrad ”is thinking…” medan agenten arbetar.

Strömning kräver Slacks strömmande API, vilket inte alla abonnemang har. Om din app nekas det slutar bryggan försöka för hela anslutningen och postar i stället varje svar som ett enda meddelande, och kortet Chattbryggor visar ”Liveströmning är av för den här Slack-appen – svar kommer som ett meddelande.” Allt annat fungerar på samma sätt.

Steg 7: Skapa ett ärende utan att lämna Slack

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

Boten svarar med ärendenyckeln den skapade. Ärendet är ett vanligt lokalt Control Center-ärende, rapporterat av dig, redo att tilldelas en agent. /cc help listar allt kommandot kan göra.

Sammanfattning

Du skapade en Slack-app från Control Center, anslöt den över en utgående socket, länkade din Slack-identitet till din Control Center-användare och styrde en agent från en Slack-tråd. Allt som hände i Slack finns också i Control Center: Slack-tråden är en yta, svaret är en avskrift, ärendet är ett ärende.

Nästa: Konfigurera Slack-integration går igenom den manuella vägen, tokenrotation och felsökning. Läs Chattbryggor för modellen bakom.