/setup-slack.es

description: "Lesson command"
duration: "~15 min"
prerequisites: ["Acceso de administrador a un espacio de trabajo de Slack"]
level: "beginner"
tags: ["setup", "slack", "api"]
nonInteractiveMode: incompatible

Configuración de Slack API

Step 0: Verificar progreso de configuración

**Lo que la IA ejecuta automáticamente:** 1. Ejecutar `uv run python tools/setup_progress.py show --current setup-slack` para mostrar el progreso 2. **Este paso es opcional.** Puede omitirlo si no va a usar la integración con Slack 3. Detectar automáticamente el token existente:

• Verificar si `SLACK_USER_TOKEN` existe en `.env` o en el almacén de credenciales
• Si existe, verificar su validez con `auth.test` de la API de Slack. Si es válido, preguntar "La configuración de Slack ya está completa. ¿Desea omitirla?"

4. Si omite: Ejecutar `uv run python tools/setup_progress.py skip setup-slack --reason 'Usuario omitió'`

Lo que hará en esta sesión

| Elemento | Contenido | |----------|-----------| | Objetivo | Crear una Slack App, obtener un User Token, guardarlo de forma segura y habilitar las funciones de búsqueda y obtención de mensajes de Slack | | Duración | ~15 minutos | | Requisitos previos | Acceso de administrador al espacio de trabajo de Slack (o permiso para agregar Apps), navegador disponible | | Nivel de operación | Sin entrada de comandos CLI (todo lo ejecuta la IA automáticamente + solo operaciones GUI) |

**Flujo de la sesión:** 1. Abrir la página de administración de Slack App (la IA abre el navegador automáticamente) 2. Crear una nueva Slack App (hacer clic en botones en pantalla) 3. Configurar User Token Scopes (agregar los permisos necesarios) 4. Instalar en el espacio de trabajo (hacer clic en el botón de permitir) 5. Guardar el User Token de forma segura (usando credential_manager) 6. Prueba de operación (la IA la ejecuta automáticamente)

> **Consejo**: Si la IA deja de responder a mitad del proceso, escriba "por favor continúa" o "se detuvo" para reanudar.

---

Verificación de preparación

**Configuración de AskQuestion:**

{
  "title": "Confirmación previa a la sesión",
  "questions": [{
    "id": "readiness",
    "prompt": "¿Está listo?",
    "options": [
      {"id": "ready", "label": "¡Listo! Comencemos"},
      {"id": "chrome", "label": "Automatizar operaciones del navegador con /chrome"},
      {"id": "check_prereq", "label": "Quiero verificar los requisitos previos"},
      {"id": "no_slack", "label": "No tengo un espacio de trabajo de Slack"},
      {"id": "different_lesson", "label": "Ir a otra lección"}
    ]
  }]
}

(ready -> Ir al Step 1) (chrome -> Después de abrir el navegador en Step 1, seguir la sección "Automatización con integración Chrome") (check_prereq -> Indicar: "Está listo si ha iniciado sesión en un espacio de trabajo de Slack y tiene permiso para agregar Apps. Si no tiene permiso, consulte con el administrador del espacio de trabajo") (no_slack -> Indicar: "Puede crear un espacio de trabajo de Slack de forma gratuita. Cree un espacio de trabajo de prueba en https://slack.com/create y luego reinicie esta configuración") (different_lesson -> Mostrar lista de módulos)

---

Step 1: Abrir la página de administración de Slack App

**Lo que hace la IA:** 1. Detectar automáticamente el sistema operativo (Mac / Windows / Linux) 2. Ejecutar el siguiente comando para abrir el navegador automáticamente:

# Mac:
open https://api.slack.com/apps
# Windows:
start https://api.slack.com/apps
# Linux:
xdg-open https://api.slack.com/apps

**Una vez que se abra el navegador, mostrar el siguiente AskQuestion:**

{
  "title": "Step 1: Crear una Slack App",
  "questions": [{
    "id": "app_create",
    "prompt": "La página de administración de Slack App se abrió en su navegador. Siga estos pasos para crear una nueva App:\n\n1. Haga clic en el botón 'Create New App' en la esquina superior derecha\n2. Seleccione 'From scratch'\n3. Ingrese 'AIAgent Bootcamp' como nombre de la App\n4. Seleccione su espacio de trabajo en 'Pick a workspace'\n5. Haga clic en el botón 'Create App'\n\n¿Pudo crear la App?",
    "options": [
      {"id": "created", "label": "¡App creada!"},
      {"id": "browser_not_open", "label": "El navegador no se abrió"},
      {"id": "no_create_button", "label": "No encuentro el botón 'Create New App'"},
      {"id": "no_workspace", "label": "Mi espacio de trabajo no aparece"},
      {"id": "permission_error", "label": "Obtuve un error de permisos"}
    ]
  }]
}

(created -> Ir al Step 2) (browser_not_open -> Indicar: "Abra esta URL directamente en su navegador: https://api.slack.com/apps") (no_create_button -> Indicar: "Es posible que no haya iniciado sesión en Slack. Primero, haga clic en 'Sign in' en la esquina superior derecha para iniciar sesión con su cuenta de Slack") (no_workspace -> Indicar: "Recargue la página mientras está conectado a su espacio de trabajo. Si aún no aparece, es posible que necesite crear un nuevo espacio de trabajo") (permission_error -> Indicar: "El administrador del espacio de trabajo puede haber restringido la adición de Apps. Pida al administrador que permita agregar una Slack App llamada 'AIAgent Bootcamp'. Alternativamente, cree un espacio de trabajo de prueba gratuito en https://slack.com/create")

---

Automatización con integración Chrome (modo `/chrome`)

**Requisitos previos:** La extensión "Claude in Chrome" (v1.0.36+) está instalada en Chrome, y se inició con `claude --chrome` o se ejecutó `/chrome` dentro de la sesión.

**Lo que la IA ejecuta automáticamente con la integración Chrome:** 1. Abrir https://api.slack.com/apps en el navegador 2. Usar la integración Chrome para ejecutar secuencialmente:

• Hacer clic en "Create New App"
• Seleccionar "From scratch"
• Ingresar "AIAgent Bootcamp" como nombre de la App
• Seleccionar un espacio de trabajo en "Pick a workspace"
• Hacer clic en "Create App"
• Hacer clic en "OAuth & Permissions" en el menú izquier