¿Cómo configurar Slack en Skyone Studio?

Esta documentación describe el proceso completo para configurar la integración de Slack en Skyone Studio. El objetivo es permitir que los flujos de agentes creados en Skyone Studio se comuniquen directamente con canales y usuarios en Slack. Está dirigida a administradores y desarrolladores responsables de configurar integraciones y gestionar flujos en Skyone Studio.

Beneficios

  • Permite comunicación directa entre Skyone Studio y Slack.

  • Automatiza respuestas e interacciones en canales o mensajes privados.

  • Centraliza flujos de atención y notificaciones en un único lugar.

  • Facilita la gestión de usuarios y permisos.

Términos importantes (Glosario)

  • Slack API: Interfaz que permite crear y configurar apps para integración.

  • Bot User OAuth Token: Token de autenticación para que el bot interactúe en Slack.

  • Signing Secret: Clave de seguridad para validar comunicaciones.

  • Scopes: Permisos asignados a una app en Slack.

  • Webhook URL: Dirección usada por Slack para enviar eventos al Studio.

Etapas de configuración

Para configurar Slack, necesitarás estar simultáneamente en Skyone Studio y en Slack for Developers. Además, debes tener un workspace y un canal en Slack.

Pasos:

[ Paso 01 ] Crea una app en Slack: Base de la integración y generación de credenciales. [ Paso 02 ] Configura los permisos de la app: Define los scopes necesarios. [ Paso 03 ] Crea el Bot User OAuth Token: Token para autenticar en el Studio. [ Paso 04 ] Activa la interactividad: Permite respuestas desde Slack. [ Paso 05 ] Activa eventos: Envío de menciones y mensajes al Studio. [ Paso 06 ] Añade la cuenta de Slack en Skyone Studio: Registra las credenciales. [ Paso 07 ] Inserta la URL del Studio en Slack: Para recibir eventos. [ Paso 08 ] Activa la pestaña de Mensajes: Habilita la interacción directa con el bot. [ Paso 09 ] Confirma que el bot fue agregado al workspace de Slack. [ Paso 10 ] Prueba tu Slack: Envía un mensaje para verificar la integración.

Paso 01: Crea una app en Slack

  1. En la página Your Apps, selecciona Create New App.

  2. Selecciona la opción From scratch.

  1. Ingresa el nombre de tu app y selecciona el Workspace donde desarrollarás la app.

  1. Haz clic en Create App.

Una vez creada la app, se mostrará la página Basic Information. Necesitarás esta y otras secciones del área de Features para la configuración. Mantenla abierta.

Paso 02: Configura los permisos de la app

En Slack, los permisos se llaman Scopes. Estos definen lo que la app puede acceder o ejecutar, como leer menciones, enviar mensajes, acceder a archivos o consultar información de usuarios.

Ejemplo de scopes añadidos:

  1. En el menú lateral, entra en OAuth & Permissions.

  2. En la sección Scopes, haz clic en Add an OAuth Scope y añade los siguientes:

Paso 03: Crea el Bot User OAuth Token

  1. En OAuth & Permissions, dentro de la sección OAuth Tokens, haz clic en Install to Docs.

  1. Selecciona el canal previamente creado donde la app publicará mensajes.

  2. Haz clic en Permitir.

¡Listo! El Bot User OAuth Token fue creado y se usará posteriormente.

Paso 04: Activa la interactividad

  1. En el menú lateral, entra en Interactivity & Shortcuts.

  2. En la sección Interactivity, habilita la opción activando el botón.

Paso 05: Activa eventos

  1. En el menú lateral, entra en Event Subscriptions.

  1. En la sección Enable Events, habilita la opción activando el botón.

  2. En Subscribe to bot events, haz clic en Add Bot User Event y añade los siguientes eventos:

  1. Haz clic en Save Changes.

Paso 06: Añade la cuenta de Slack en Skyone Studio

Para conectar Slack en Skyone Studio, los pasos se dividen en tres secciones: Flujo del Agente, Cuenta y Usuarios.

  1. Accede a Skyone Studio.

  2. Crea o abre el Flujo del Agente deseado.

  3. Haz clic en “Publicar”.

  4. Haz clic en la opción “Slack”.

  5. Elige el flujo del agente que deseas configurar.

  6. Haz clic en “Administrar cuentas”.

  1. Haz clic en “Crear cuenta”.

  2. En el modal que se muestra, completa los siguientes campos:

  • Nombre: nombre para identificar la cuenta.

  • Token del bot: accede a la página OAuth & Permissions en Slack, localiza la sección OAuth Tokens, copia el Bot User OAuth Token y pégalo en este campo.

  • Signing secret: accede a la página Basic Information en Slack, copia el valor de Signing Secret y pégalo en este campo.

  1. Haz clic en “Crear” y cierra el modal.

  2. De regreso a la pantalla anterior en el Studio, selecciona la cuenta creada.

  3. En la sección Usuarios y Grupos, haz clic en “Administrar usuarios y grupos”.

  1. Haz clic en “Crear usuario”.

  2. Completa los siguientes campos:

  • Nombre

  • Correo electrónico

  • Tipo: selecciona “Slack”

Si el usuario no está registrado como tipo Slack, la IA no podrá enviar una respuesta.

  • Configuraciones del correo electrónico: activa la opción “Usar el mismo correo” si el correo registrado en Slack es el mismo que el indicado arriba. De lo contrario, escribe el correo correspondiente.

  1. Haz clic en “Crear” y cierra el modal.

  2. El usuario se mostrará automáticamente y también podrá ser agregado manualmente en “Seleccionar usuarios”.

  3. Finalmente, haz clic en “Guardar publicación”.

  4. Observa que se muestra una URL de Webhook. Copia esta URL para utilizarla en el siguiente paso de configuración.

Paso 07: Inserta la URL del Studio en Slack

  1. Accede nuevamente a Slack API.

  2. En el menú lateral, entra en “Event Subscriptions”.

  3. En la sección “Enable Events”, pega la URL copiada anteriormente en el campo “Request URL”.

  1. Luego, accede a la página “Interactivity & Shortcuts” y pega la misma URL copiada anteriormente en el campo “Request URL”.

  1. Haz clic en “Save Changes” para finalizar.

Paso 08: Activa la pestaña de Mensajes

  1. En Slack API, entra en App Home.

  2. En la sección Show Tabs, activa la opción Messages Tab.

  3. Selecciona Allow users to send Slash commands and messages from the messages tab.

Paso 09: Confirma que el bot fue agregado al workspace de Slack

  1. En el chat de Slack, haz clic en “Más acciones” (los tres puntos ubicados en la esquina derecha).

  2. En el menú desplegable, haz clic en “Editar configuraciones”.

  1. Accede a la pestaña “Integraciones”.

  2. En “Apps”, verifica si el bot aparece en esta sección. Si no aparece, haz clic en “Agregar apps” para añadirlo.

Paso 10: Prueba tu Slack

Busca tu canal y prueba la integración escribiendo un mensaje de saludo.

FAQ – Configuración de Slack en Skyone Studio

¿Necesito permiso de administrador en Slack para configurar?

Sí. Es necesario tener permiso de administrador (o equivalente) para crear la app, definir permisos, activar eventos e instalar el bot en el Workspace.

¿Puedo usar cualquier Workspace en Slack?

No. La app debe crearse en el Workspace que será utilizado en la integración con Skyone Studio.

¿Qué hacer si el bot no responde?

  • Verifica que el bot fue agregado al Workspace.

  • Confirma que los permisos (scopes) estén configurados correctamente.

  • Revisa que el Bot User OAuth Token y el Signing Secret fueron registrados correctamente en el Studio.

  • Asegúrate de que la Request URL fue insertada y validada en Slack.

  • Verifica que el usuario esté registrado como tipo Slack en el Studio.

Previous¿Cómo configurar WhatsApp en Skyone Studio?Next¿Cómo configurar el Chat Privado en Skyone Studio?

Last updated