Presentación
Si utiliza la aplicación de mensajería Slack para la comunicación interna, Docebo puede integrarse con ella de modo tal que pueda configurar las notificaciones de la plataforma para que se envíen a través de Slack.
Al igual que cualquier notificación de la plataforma, las notificaciones de Slack se pueden programar y asignar a grupos, ramas, cursos y planes de aprendizaje específicos, y se pueden enviar a su equipo como mensajes directos (desde el bot de Docebo en un mensaje privado del Slackbot) o a través de canales públicos.
A tener en cuenta:
- Docebo para Slack versión 2 no admite el motor de notificaciones heredado.
- Para quienes migren desde Docebo para Slack versión 1, consulte Migración de Docebo para Slack versión 1 a la versión 2.
- Slack impone un límite de un mensaje por segundo por usuario o canal. La integración de Docebo con Slack no puede superar este límite. Si su plataforma genera notificaciones a una frecuencia mayor, es posible que algunos mensajes se pongan en cola o se retrasen.
Migración de Docebo para Slack versión 1 a la versión 2
Antes de empezar
Docebo para Slack versión 1 utiliza el motor de notificaciones heredado de Docebo. En cambio, Docebo para Slack versión 2 utiliza el nuevo motor de notificaciones. Como resultado, cuando se lanzó el nuevo motor de notificaciones, todos los usuarios de Docebo para Slack versión 1 quedaron excluidos de la migración desde el motor de notificaciones heredado.
A efectos prácticos, la migración de la versión 1 de Slack a la versión 2 conlleva dos migraciones: una es un cambio en la integración y la otra, que Docebo realiza en su lugar, es la migración al nuevo motor de notificaciones.
Para migrar de la versión 1 de Slack a la versión 2 sin interrupciones, los pasos deben llevarse a cabo en el siguiente orden:
- Configuración de la integración de Docebo para Slack versión 2.
Esto debe hacerse primero, ya que desbloqueará la capacidad de migrar al nuevo motor de notificaciones. También asegura que, cuando su plataforma de aprendizaje migre al nuevo motor de notificaciones, siga recibiendo notificaciones a través de Slack sin problemas. - Migración de su motor de notificaciones desde la versión heredada.
Una vez que esto se haya completado correctamente, Docebo para Slack versión 2 se hará cargo de la gestión de las notificaciones sin interrupciones. - Posibilidad de restablecer la versión 1 de Docebo para Slack.
Al realizar este paso, se eliminarán las conexiones a su cuenta de Slack heredadas de la integración de la versión 1, que ahora ya no ofrece ninguna funcionalidad.
Detalles de la migración
Para migrar de Docebo para Slack versión 1 a la versión 2, configure primero la integración de Docebo para Slack versión 2 de acuerdo a los siguientes capítulos empezando por activar la aplicación Slack versión 2 en su plataforma y asegurarse de guardar su configuración.
A continuación, póngase en contacto con su gestor de éxito de clientes o con un agente de asistencia para activar el nuevo motor de notificaciones de la plataforma. Se le confirmará que se ha recibido su solicitud y se le notificará cuando se haya activado el motor de notificaciones. Tenga en cuenta que este paso no es automático y puede tardar varios días en completarse. Sus notificaciones existentes se migrarán a la nueva infraestructura de notificaciones.
Advertencia: Si activa el nuevo motor de notificaciones de la plataforma antes de configurar Docebo para Slack versión 2, dejará de recibir notificaciones. Es importante que siga el orden de las instrucciones de este capítulo.
Una vez activado el nuevo motor de notificaciones, desactive Docebo para Slack versión 1 como se describe en el capítulo Restablecer su configuración de Docebo para Slack.
Consejo: Aunque la integración de la versión 2 funcionará inmediatamente como se describe en este artículo, no recibirá notificaciones de la plataforma desde la versión 2 de Slack hasta que el nuevo motor de notificaciones se haya activado correctamente en Docebo. En su lugar, las notificaciones serán proporcionadas por la versión 1 de la integración de Slack.
Para seguir recibiendo notificaciones, deje la versión 1 de la integración activa en paralelo para que, una vez migrado su motor de notificaciones, la nueva integración asuma sin problemas la prestación de estos servicios.
Activación de la aplicación Slack versión 2 en su plataforma
Active la aplicación Slack V2 tal y como se describe en el artículo Gestión de aplicaciones y características de la base de conocimientos. La aplicación aparece en la pestaña Integraciones de terceros.
Configuración de Slack en Docebo
Para configurar Slack en su plataforma, asegúrese en primer lugar de haber iniciado sesión en su cuenta de Slack como administrador, luego acceda al Menú de navegación, localice Complementos e integraciones (icono de puzzle) y pulse el elemento Slack V2.
A continuación, pulse el botón Configurar Slack para continuar.
Si ya ha iniciado sesión en Slack en el mismo navegador, pulse Permitir en la siguiente pantalla; de lo contrario, inicie sesión en Slack y, a continuación, siga las instrucciones para permitir que la integración se conecte a su espacio de trabajo de Slack.
A tener en cuenta: Debe tener la sesión iniciada en Slack como administrador o como usuario con el rol de administrador de la integración en el sistema para poder conectar Docebo para Slack V2 a su espacio de trabajo de Slack.
La integración de Slack utilizará los siguientes alcances dentro de Slack:
-
incoming-webhook- Crear webhooks unidireccionales para publicar mensajes en un canal específico -
commands- Añadir atajos y/o comandos de barra que las personas puedan utilizar -
channels:read- Ver información básica sobre los canales públicos de un espacio de trabajo -
team:read- Ver el nombre, el dominio de correo electrónico y el icono de los espacios de trabajo a los que está conectado Learning Hub -
users:read- Ver las personas en un espacio de trabajo -
users:read.email- Ver las direcciones de correo electrónico de las personas en un espacio de trabajo -
users.profile:read- Ver detalles del perfil de las personas en un espacio de trabajo
Una vez que la conexión se haya completado correctamente, se le redirigirá a la página de propiedades de Slack V2.
A continuación, en la página Configuración del usuario, necesitará asignar el identificador de usuario de Slack con el identificador de usuario de Docebo. Tenga en cuenta que, en Docebo, solo los valores ID de usuario y Nombre de usuario son unívocos de forma predeterminada.
A tener en cuenta: Para una asignación y actualización precisas de usuarios, los identificadores de usuario de Slack y Docebo deben ser idénticos. Si el ID de usuario de Slack es diferente, los usuarios no se asignarán (si se usa el método de asignación) o bien se les aprovisionará como nuevos usuarios con el ID de usuario de Slack, sin vincularlos a una cuenta de Docebo existente (si se usa el método de aprovisionamiento).
Sincronización de usuarios
A continuación, seleccione su método de sincronización. Tiene la opción de usar el método de asignación de usuarios, que asigna un usuario de Slack a un usuario de Docebo, o el método de aprovisionamiento de usuarios. La asignación de usuarios asignará un usuario de Slack a un usuario existente de Docebo, no aprovisionará nuevos usuarios de Slack a Docebo. El aprovisionamiento de usuarios le permitirá crear nuevos usuarios dentro de Docebo que coincidan con los campos que haya elegido sincronizar.
Asignación de usuarios
El método de asignación de usuarios le permitirá sincronizar rápidamente sus usuarios existentes en Docebo con su base de usuarios de Slack. Una vez que haya asignado el identificador de usuario correcto que desee utilizar, asegúrese de que en la sección Método de sincronización esté seleccionado Activar la asignación de usuarios.
A continuación, pulse Guardar cambios para activar la sincronización.
Aprovisionamiento de usuarios
Activar el aprovisionamiento de usuarios sincronizará sus usuarios de Slack con Docebo. En primer lugar, seleccione el botón de opción Activar aprovisionamiento de usuarios en la sección Método de sincronización.
A continuación, seleccione la rama predeterminada en la que se aprovisionarán los nuevos usuarios pulsando el botón Seleccionar rama. Una vez seleccionada la rama adecuada, pulse el botón Seleccionar.
A tener en cuenta: Si un usuario ya está aprovisionado en Docebo antes de que se implemente esta integración, el usuario podría ser movido a la rama que elija en la integración.
A continuación, si desea actualizar la información de todos los usuarios existentes, pulse el botón Actualizar la información de los usuarios existentes. Si desea enviar una notificación al usuario de que se ha creado su cuenta en Docebo, seleccione la casilla Enviar una notificación El usuario ha sido creado (si existe).
Después, seleccione qué campos de Docebo desea que coincidan con campos de Slack. Los siguientes campos son obligatorios y no pueden eliminarse de la lista de campos coincidentes:
- Nombre de usuario
- Correo electrónico
- Nombre de pila
- Apellido/s
Para cambiar o establecer la asignación de un campo, pulse la lista desplegable en el área Campo Slack del campo que desee editar y seleccione de la lista de campos disponibles en Slack.
A tener en cuenta: El campo que haya elegido como identificador en la sección Identificador de usuario no podrá editarse ni eliminarse.
Si desea asignar campos adicionales en Slack, pulse el botón Agregar campos y, en la ventana deslizante, seleccione los campos que desee añadir y, a continuación, pulse Agregar.
A continuación, puede asignar el campo o campos adicionales de la misma forma que los campos obligatorios. Si desea eliminar los campos agregados, puede pulsar el icono de la papelera al final de la fila de cada campo adicional.
Una vez completados los pasos de configuración, pulse Guardar cambios.
Ajustes de sincronización
En la pestaña Sincronización, la opción para sincronizar los datos de los usuarios con Slack cada vez que se crea o modifica un usuario está habilitada de forma predeterminada. Esto permite la sincronización automática de los datos del usuario al actualizarse estos. Si desactiva esta opción, deberá pulsar el botón Sincronizar en la sección Sincronización manual cada vez que desee actualizar el aprovisionamiento o la asignación de usuarios.
A tener en cuenta: La sincronización manual realiza una importación completa de los datos y sobrescribirá los usuarios previamente asignados con la nueva información. Esto debería realizarse únicamente si se ha equivocado en sus opciones de configuración previas y ya ha llevado a cabo una sincronización. Dependiendo de la cantidad de usuarios asignados, esta acción podría llevar mucho tiempo.
Gestión de su conexión existente
La pestaña Conexión de la integración de Slack v2 le permite encontrar información sobre el nombre de su espacio de trabajo conectado y el ID de su equipo. Esta información se puede encontrar en la sección Detalles de la pestaña Conexión.
Si desea restablecer su conexión con Slack, pulse el botón Restablecer datos.
A tener en cuenta: Al pulsar el botón Restablecer datos se eliminarán todos los datos asignados y los identificadores de usuarios de Slack de su sistema, así como la conexión con Slack. No se eliminarán los usuarios aprovisionados en Docebo. Esta acción no se puede deshacer.
A continuación, en la ventana de confirmación, pulse Restablecer.