# ¿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**](https://studio.skyone.cloud/es/login) y en [**Slack for Developers**](https://api.slack.com/developer-program). Además, debes tener un **workspace** y un **canal** en Slack.

#### Pasos:

[**\[ Paso 01 \]** Crea una app en Slack](#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](#paso-02-configura-los-permisos-de-la-app): Define los *scopes* necesarios.\
[**\[ Paso 03 \]** Crea el Bot User OAuth Token](#paso-03-crea-el-bot-user-oauth-token): Token para autenticar en el Studio.\
[**\[ Paso 04 \]** Activa la interactividad](#paso-04-activa-la-interactividad): Permite respuestas desde Slack.\
[**\[ Paso 05 \]** Activa eventos](#paso-05-activa-eventos): Envío de menciones y mensajes al Studio.\
[**\[ Paso 06 \]** Añade la cuenta de Slack en Skyone Studio](#paso-06-anade-la-cuenta-de-slack-en-skyone-studio): Registra las credenciales.\
[**\[ Paso 07 \]** Inserta la URL del Studio en Slack](#paso-07-inserta-la-url-del-studio-en-slack): Para recibir eventos.\
[**\[ Paso 08 \]** Activa la pestaña de Mensajes](#paso-08-activa-la-pestana-de-mensajes): Habilita la interacción directa con el bot.\
[**\[ Paso 09 \]** Confirma que el bot fue agregado al workspace de Slack.](#paso-09-confirma-que-el-bot-fue-agregado-al-workspace-de-slack)\
[**\[ Paso 10 \]** Prueba tu 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**](https://api.slack.com/apps), selecciona **Create New App**.
2. Selecciona la opción **From scratch**.

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2FQGqiB3SF5Jldof4eUPZK%2Fimage.png?alt=media&#x26;token=ca3606e0-c659-46d5-8d07-f558322bca56" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2FyeKr37nA24sit5yqWjMB%2Fimage.png?alt=media&#x26;token=8f0f69b2-e7ce-4361-9eec-a6232e91472c" alt=""><figcaption></figcaption></figure>

3. 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.

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2FviErOqQjpvaB61QpIjli%2Fimage%20(68).avif?alt=media&#x26;token=6fd277e1-9ccc-48df-b9dc-9fddcf2657e5" alt=""><figcaption></figcaption></figure>

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:

```
app_mentions:read
channels:history
chat:write
files:read
im:history
im:read
incoming-webhook
users:read
users:read.email
```

***

#### 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**.

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2FrBwKgizJpDauzAuRFG6U%2Fimage%20(69).avif?alt=media&#x26;token=9e16cce6-59d2-495a-b51b-f76564665931" alt=""><figcaption></figcaption></figure>

2. Selecciona el canal previamente creado donde la app publicará mensajes.
3. 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.

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2Fa7mrhJT393ye967IaoO6%2Fimage%20(70).avif?alt=media&#x26;token=754141c6-4d8a-4379-b47a-35198d32c5e1" alt=""><figcaption></figcaption></figure>

***

#### Paso 05: Activa eventos

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

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2FF2HbX23fg2qqJ5NUmKsy%2Fimage%20(71).avif?alt=media&#x26;token=19a20efd-a359-49e6-9faf-5123f6fdfb82" alt=""><figcaption></figcaption></figure>

2. En la sección **Enable Events**, habilita la opción activando el botón.
3. En **Subscribe to bot events**, haz clic en **Add Bot User Event** y añade los siguientes eventos:

```
app_mention
message.channels
message.im
```

4. 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”**.

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2F1pKFl0yQM6J1vLotW0jq%2Fimage%20(72).avif?alt=media&#x26;token=49c1ff4e-47d9-4904-89ae-3d70b59123b4" alt=""><figcaption></figcaption></figure>

7. Haz clic en **“Crear cuenta”**.
8. En el modal que se muestra, completa los siguientes campos:

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2F3JwJO1GIHFBl1YeBEPQ2%2Fdel%20edicao%20de%20imagem%20(1).png?alt=media&#x26;token=2b3cd356-234b-4ad1-b121-86e801b5bc46" alt=""><figcaption></figcaption></figure>

* **Nombre:** nombre para identificar la cuenta.
* **Cuenta pública:** al activar esta opción, cualquier persona podrá interactuar con la publicación vinculada, sin necesidad de autenticación.

{% hint style="info" %}
Una cuenta pública puede vincularse a una sola publicación.
{% endhint %}

* **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.

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2FdmylwwVUDLRzq8zWR2UZ%2Fimage%20(84).avif?alt=media&#x26;token=2a145823-7c24-40c0-bafb-c34df7da7cb1" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2FSAkoGqPALcLNfgqSfF1i%2Fimage%20(74).avif?alt=media&#x26;token=1b61e936-6b8a-4eab-ace0-9c8bee53be48" alt=""><figcaption></figcaption></figure>

9. Haz clic en “Crear” y cierra el modal.
10. De regreso a la pantalla anterior en el Studio, selecciona la cuenta creada.
11. En la sección **Usuarios y Grupos**, haz clic en **“Administrar usuarios y grupos”**.

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2F7oe3DnXaG1UUq0k4SOg4%2Fimage%20(75).avif?alt=media&#x26;token=20043c3a-a3f6-454f-94a4-7c1166516ddb" alt=""><figcaption></figcaption></figure>

12. Haz clic en **“Crear usuario”**.
13. Completa los siguientes campos:

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2F7iMtIVakCXDuHurnnu0Q%2Fimage%20(76).avif?alt=media&#x26;token=d9f8f16e-405b-46ad-99d0-79d89b2f7588" alt=""><figcaption></figcaption></figure>

* **Nombre**
* **Correo electrónico**
* **Tipo:** selecciona **“Slack”**

{% hint style="danger" %}
&#x20;Si el usuario no está registrado como tipo *Slack*, la IA no podrá enviar una respuesta.
{% endhint %}

* **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.

14. Haz clic en **“Crear”** y cierra el modal.
15. El usuario se mostrará automáticamente y también podrá ser agregado manualmente en **“Seleccionar usuarios”**.
16. Finalmente, haz clic en **“Guardar publicación”**.
17. 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”**.

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2FRUYH7Kw0wl7HrGVDAMe0%2Fimage%20-%202025-10-27T123218.219.png?alt=media&#x26;token=440eab4e-1031-41c9-9db1-6855c4ffdd92" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2FakRH48jawP6XTqfQUzb1%2Fimage%20(85).avif?alt=media&#x26;token=73046e98-4763-4513-89d1-c5f6ea03d650" alt=""><figcaption></figcaption></figure>

4. 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**.

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2FH8fn6TuTFOoOKefpy6v9%2Fimage%20(86).avif?alt=media&#x26;token=dd787196-7bb4-4f1b-833f-b4c19d12cc6c" alt=""><figcaption></figcaption></figure>

***

#### 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”**.

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2F7HjDkRIvzqCCOxbzSaXj%2Fimage%20(87).avif?alt=media&#x26;token=b029db69-691c-411b-9caf-8de31f7be5ec" alt=""><figcaption></figcaption></figure>

3. Accede a la pestaña **“Integraciones”**.
4. En **“Apps”**, verifica si el bot aparece en esta sección. Si no aparece, haz clic en **“Agregar apps”** para añadirlo.

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2F9z3XW5xygAza4FsjPkWB%2Fimage%20(88).avif?alt=media&#x26;token=21068a20-b788-4906-bcc6-504e7f0b51a0" alt=""><figcaption></figcaption></figure>

***

#### Paso 10: Prueba tu Slack

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

<figure><img src="https://3969362974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZB1uWLMGztphXAzIZJ1%2Fuploads%2FOBu9Z8RXgNQsAyAocBxR%2Fimage%20(89).avif?alt=media&#x26;token=fc7b3360-504d-4e88-a673-c97b8de45056" alt=""><figcaption></figcaption></figure>

***

### FAQ – Configuración de Slack en Skyone Studio

<details>

<summary>¿Necesito permiso de administrador en Slack para configurar?</summary>

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

</details>

<details>

<summary>¿Puedo usar cualquier Workspace en Slack?</summary>

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

</details>

<details>

<summary>¿Qué hacer si el bot no responde?</summary>

* 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.

</details>