Presentación
Conecte Slack para que el asistente de IA y los agentes puedan realizar búsquedas en los canales seleccionados cuando un usuario formule una pregunta.
Este es un conector activo. No se copia, indexa ni almacena ningún contenido de Slack en Docebo. Cuando un usuario formula una pregunta, Docebo busca en los canales que usted haya puesto a disposición en ese momento, utilizando la propia cuenta de Slack del usuario.
Funcionamiento de los permisos de Slack: cada usuario conecta su propia cuenta de Slack la primera vez que resulta necesario. Después, cada búsqueda se ejecuta con la identidad de ese usuario, por lo que solo podrá consultar el contenido al que tendría acceso directamente en Slack. La cuenta utilizada durante la configuración solo sirve para configurar la conexión y mostrar los canales que usted puede seleccionar.
1. Requisitos previos en el sistema de origen
Rol necesario
Debe tener permiso para crear aplicaciones en su espacio de trabajo de Slack. Si su espacio de trabajo requiere la aprobación de un administrador para las aplicaciones nuevas, un administrador de espacios de trabajo deberá aprobar la aplicación una vez (consulte el paso 3).
Configuración necesaria
La cuenta con la que autorice la conexión debe ser miembro de todos los canales privados que desee poner a disposición.
2. Preparación en el sistema de origen
Puede crear una aplicación nueva de Slack a partir del manifiesto proporcionado por Docebo (opción recomendada) o reutilizar una aplicación existente.
Crear la aplicación de Slack a partir del manifiesto
- En la pestaña Autorizar de Docebo, copie el manifiesto mediante el botón de copia.
- Abra Crear una aplicación de Slack (api.slack.com/apps) e inicie sesión en Slack si se le solicita.
- Seleccione A partir de un manifiesto, seleccione su espacio de trabajo y haga clic en Siguiente.
- Cambie el editor a JSON, sustituya su contenido por el manifiesto y, a continuación, haga clic en Siguiente y en Crear e instalar.
Slack abrirá la página Información básica de la nueva aplicación. El manifiesto ya incluye los permisos y la URL de redireccionamiento, por lo que no es necesario realizar ninguna configuración adicional.
El manifiesto solicita los siguientes ámbitos de token de usuario:
| Ámbito | Permiso |
|---|---|
| channels:read | Permite consultar información básica sobre los canales públicos |
| channels:history | Permite consultar mensajes y otro contenido de los canales públicos |
| groups:read | Permite consultar información básica sobre los canales privados a los que tiene acceso |
| groups:history | Permite consultar mensajes y otro contenido de los canales privados a los que tiene acceso |
| search:read.public | Permite buscar mensajes y archivos en los canales públicos |
| search:read.private | Permite buscar mensajes y archivos en los canales privados a los que tiene acceso |
| search:read.users | Permite buscar personas en el espacio de trabajo |
| users:read | Permite consultar las personas del espacio de trabajo |
¿Ya dispone de una aplicación de Slack? Reutilícela
Omita el manifiesto y configure su aplicación existente:
- Abra la aplicación en api.slack.com/apps y acceda a OAuth y permisos.
- En URL de redireccionamiento, añada la URL de devolución de llamada que se muestra en Docebo y haga clic en Guardar URL. Utilice el siguiente patrón: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback, por ejemplo, https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
- En Ámbitos → Ámbitos de token de usuario, añada todos los ámbitos indicados anteriormente.
- Mantenga desactivada la rotación de tokens. No es necesario activar ninguna opción en la página Agentes, por lo que debe mantener desactivado el interruptor Servidor MCP de Slack.
- Si Slack le solicita que vuelva a instalar la aplicación, hágalo y continúe con la sección siguiente.
3. Acciones necesarias en Docebo
| Información a introducir | Ubicación |
|---|---|
| Id. de cliente | Aplicación de Slack → Información básica → Credenciales de la aplicación |
| Secreto del cliente | Aplicación de Slack → Información básica → Credenciales de la aplicación. Haga clic en Mostrar junto a Secreto del cliente. No utilice el secreto de firma. |
Autorizar el conector
- Vaya a Complementos e integraciones → Conectores de conocimientos → Crear → Slack. Este menú solo está disponible para Superadministradores. En la pestaña Descripción general, revise el contenido que se buscará y seleccione Comenzar.
- En la pestaña Autorizar, siga los pasos para crear o reutilizar su aplicación de Slack (consulte la sección Preparación).
- En la página Información básica de su aplicación, dentro de Credenciales de la aplicación, copie el Id. de cliente y el secreto del cliente en los campos correspondientes de la pestaña Autorizar.
- Seleccione Autenticar, inicie sesión con la cuenta de Slack que sea miembro de todos los canales privados que desee poner a disposición y haga clic en Permitir. Si su espacio de trabajo requiere la aprobación de un administrador para las aplicaciones nuevas, Slack mostrará una pantalla de solicitud. Un administrador del espacios de trabajo deberá aprobar la aplicación una vez; después, seleccione Autenticar de nuevo.
- En la pestaña Canales, seleccione los canales que desee poner a disposición y guarde la selección.