Conecta Slack a tu espacio de trabajo

Qué vas a crear

Al terminar este tutorial tendrás:

• Una app de Slack creada para tu espacio de trabajo, con los permisos y los eventos correctos ya configurados
• Una conexión activa entre Slack y Control Center
• Tu propia cuenta de Slack vinculada a tu usuario de Control Center
• Un agente que te responde en un hilo de Slack y un ticket registrado desde un comando slash

Requisitos previos:

• Tu primer espacio de trabajo y Despacha tu primer agente completados — un espacio de trabajo sin agentes puede recibir un mensaje de Slack, pero no tiene a nadie que lo responda
• El agente CEO del espacio de trabajo tiene un adaptador y un modelo configurados en Ajustes → Espacio de trabajo → Agentes. El puente despierta al CEO, no al agente que configuraste en el tutorial anterior, y un agente sin adaptador se ejecuta en el bucle integrado con el modelo predeterminado de Anthropic.
• El rol owner o admin en el espacio de trabajo de Control Center (conectar una app de chat habla en nombre de todo el espacio de trabajo)
• Permiso para crear e instalar apps en tu espacio de trabajo de Slack

Nada de esto necesita una dirección pública, un túnel ni un puerto de entrada. Control Center marca hacia fuera a Slack mediante Socket Mode, así que esto funciona desde una computadora portátil detrás de NAT.

Paso 1: Obtén un token de configuración de la app de Slack

Este es el único secreto que tienes que conseguir a mano. Permite que Control Center cree y luego edite la app por ti.

1. Abre api.slack.com/apps
2. Desplázate hasta la sección de tokens de configuración de la app, al final de la página
3. Genera un par de tokens para tu espacio de trabajo de Slack
4. Copia el token de refresco — empieza por xoxe-

Paso 2: Deja que Control Center cree la app

1. En Control Center, ve a Ajustes → Espacio de trabajo → General y busca la tarjeta Puentes de chat
2. En el bloque Slack, haz clic en Crear la app por mí
3. Pega el token de configuración de la app
4. Revisa cómo se verá el bot:
   • Nombre de la app: cómo aparece la app en Slack, p. ej. Control Center · Acme
   • Nombre del bot: lo que la gente escribe después de @, p. ej. control-center
   • Descripción corta y Lo que el bot dice que puede hacer
   • Comando slash: cc de forma predeterminada, así que el comando es /cc
   • Mensajes directos: déjalo activado para que los miembros puedan enviar mensajes directos al bot
5. Haz clic en Crear app

Control Center compone toda la definición de la app — Socket Mode activado, los ámbitos y las suscripciones a eventos que necesita, el comando slash, la pestaña Messages — y la crea en Slack.

Paso 3: Completa los dos pasos que solo Slack puede hacer

Slack no tiene ninguna API para generar un token a nivel de app ni para instalar una app, así que el diálogo te entrega ambos como enlaces:

1. Generar un token de aplicación — abre Basic Information → App-Level Tokens. Crea un token con el ámbito connections:write y cópialo. Empieza por xapp-
2. Instalar la app — abre Install App. Instálala en tu espacio de trabajo y luego copia el Bot User OAuth Token. Empieza por xoxb-

Guarda ambos valores para el siguiente paso.

Paso 4: Conectar

1. De vuelta en el diálogo, haz clic en Pegar las credenciales
2. Escribe el Token del bot (xoxb-…) y el Token de aplicación (xapp-…)
3. Deja Token de configuración de la app vacío — el del paso 1 ya se guardó (Slack lo rotó y Control Center guardó el nuevo)
4. Haz clic en Conectar

Control Center verifica el token del bot con Slack antes de guardar nada y luego abre el socket. La fila ahora muestra el nombre del bot y el nombre de tu espacio de trabajo de Slack con una etiqueta En vivo.

Paso 5: Vincula tu propia cuenta de Slack

La conexión hace que el bot sea accesible; vincular hace que tú seas reconocible. Hasta que tu identidad de Slack esté vinculada, el bot no actuará sobre tus mensajes — nunca atribuye un mensaje a quien instaló la app.

Vincular es personal, así que vive en una página distinta de la conexión de todo el espacio de trabajo.

1. Ve a Ajustes → Espacio de trabajo → Perfil e identidad y busca la tarjeta Cuentas de chat vinculadas
2. Haz clic en Vincular mi cuenta de Slack
3. Copia el comando que muestra, por ejemplo /cc link K7M2QP
4. En Slack, envía ese comando al bot en un mensaje directo
5. El bot responde «Vinculado: eres …»

El código es de un solo uso y caduca en 15 minutos. Si tu correo de Slack coincide con un usuario de Control Center que ya es miembro de este espacio de trabajo, el puente te vincula automáticamente la primera vez que le hablas y puedes saltarte este paso.

Si mencionas al bot antes de hacer esto, se niega y explica por qué. Las tres negativas son distintas, así que lee cuál te tocó:

• Remitente sin vincular: el bot te dice cómo vincularte. Vuelve a este paso.
• Vinculado, pero no miembro de este espacio de trabajo: pide a un administrador que te invite.
• Miembro con un rol de solo lectura (viewer o guest): el bot no iniciará trabajo en tu nombre.

Paso 6: Pon a un agente a trabajar en algo

1. En Slack, invita al bot a un canal: /invite @control-center

2. Menciónalo con una solicitud real:

   @control-center summarize the open PRs on the api repo

El puente:

1. Crea un espacio de Control Center para ese hilo de Slack, con el nombre del canal de Slack y tu solicitud
2. Despierta al agente de entrada del espacio de trabajo (el agente CEO cuando lo hay; si no, el primer agente)
3. Transmite la respuesta del agente de vuelta al hilo de Slack a medida que se escribe

Responde en el mismo hilo de Slack para seguir — no hacen falta más menciones, porque el hilo de Slack ya está vinculado. O envía un mensaje directo al bot en lugar de usar un canal; cada conversación por mensaje directo genera su propio espacio de Control Center, con un título y una línea de estado “is thinking…” mientras el agente trabaja.

El streaming necesita la API de streaming de Slack, que no todos los planes tienen. Si tu app la rechaza, el puente deja de intentarlo durante toda la conexión y publica cada respuesta como un solo mensaje en su lugar, y la tarjeta Puentes de chat muestra «El streaming en vivo está desactivado para esta app de Slack: las respuestas llegan en un solo mensaje». Todo lo demás funciona igual.

Paso 7: Registra un ticket sin salir de Slack

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

El bot responde con la clave del ticket que registró. El ticket es un ticket local normal de Control Center, reportado por ti, listo para asignarse a un agente. /cc help enumera todo lo que puede hacer el comando.

Resumen

Creaste una app de Slack desde Control Center, la conectaste por un socket saliente, vinculaste tu identidad de Slack con tu usuario de Control Center y dirigiste a un agente desde un hilo de Slack. Todo lo que ocurrió en Slack también existe en Control Center: el hilo de Slack es un espacio, la respuesta es una transcripción, el ticket es un ticket.

Siguiente: Configurar la integración de Slack cubre la ruta manual, la rotación de tokens y la solución de problemas. Para el modelo que hay debajo, lee Puentes de chat.