Conecta Slack a tu espacio de trabajo

Qué vas a construir

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 en vivo 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 definidos 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

Aquí no hace falta ninguna dirección pública, ni un túnel, ni un puerto entrante. Control Center marca hacia fuera a Slack por Socket Mode, así que esto funciona desde un portátil detrás de NAT.

Paso 1: Obtener 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 la app por ti y la edite después.

1. Abre api.slack.com/apps
2. Baja 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 quedará el bot:
   • Nombre de la app: cómo lista Slack la app, por ejemplo Control Center · Acme
   • Nombre del bot: lo que la gente escribe tras @, por ejemplo control-center
   • Descripción corta y Lo que el bot dice que puede hacer
   • Comando: cc de forma predeterminada, así que el comando es /cc
   • Mensajes directos: déjalos activados 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 scopes de bot 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 puede hacer Slack

Slack no tiene API para generar un token de aplicación ni para instalar una app, así que el diálogo te ofrece ambos como enlaces:

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

Guarda ambos valores para el paso siguiente.

Paso 4: Conectar

1. De vuelta en el diálogo, haz clic en Pegar las credenciales
2. Introduce 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 está guardado (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 después abre el socket. La fila ahora muestra el nombre del bot y el de tu espacio de trabajo de Slack con la etiqueta En vivo.

Paso 5: Vincula tu propia cuenta de Slack

La conexión hace que se pueda llegar al bot; la vinculación te hace a ti reconocible. Hasta que tu identidad de Slack esté vinculada, el bot no actuará ante tus mensajes — nunca atribuye un mensaje a quien instaló la app.

La vinculación 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 «Linked — you are …»

El código es de un solo uso y caduca a los 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 dice por qué. Las tres negativas son distintas, así que fíjate en cuál has recibido:

• Remitente sin vincular: el bot te dice cómo vincular. 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 (observador o invitado): el bot no empezará a trabajar 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 petición real:

   @control-center resume las PR abiertas en el repo api

El puente:

1. Crea un espacio de Control Center para ese hilo de Slack, con el nombre del canal de Slack y tu petición
2. Despierta al agente de entrada del espacio de trabajo (el agente CEO si lo hay; si no, el primer agente)
3. Transmite la respuesta del agente 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á puenteado. O envía un mensaje directo al bot en vez de usar un canal; cada conversación por mensaje directo gestiona 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 tiene denegada, el puente deja de intentarlo para toda la conexión y publica cada respuesta como un solo mensaje, 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 ha registrado. El ticket es un ticket local normal de Control Center, informado por ti, listo para asignarlo 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 existe también 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 con Slack cubre la vía manual, la rotación de tokens y la resolución de problemas. Para el modelo que hay debajo, lee Puentes de chat.