Presentación

Docebo Connect es un módulo de Docebo que actúa como conector entre su plataforma y sistemas SaaS de terceros, ayudándole a integrar su plataforma con más de 400 sistemas externos de terceros y reduciendo así el esfuerzo de integración.

Docebo Connect ofrece un extenso catálogo de conectores para los sistemas SaaS más populares, para gestionar flujos de trabajo automatizados (también conocidos como recetas) compartidos entre sistemas con el fin de intercambiar y compartir datos sobre la base de desencadenantes.

Tenga en cuenta que Docebo Connect aprovecha las API y la lógica empresarial ya existentes en los sistemas de integración y no crea otras nuevas. Además, Docebo Connect no gestiona flujos de SSO con proveedores de identidad (como SAML, OpenID Connect, etc.), integraciones de JavaScript (como Google Analytics o Google Tag Manager) o integraciones de iframe (como Docebo OEM o Salesforce Canvas).

Para más información sobre la definición de los términos y conceptos utilizados a lo largo de este artículo, lea el Glosario terminológico de Docebo Connect.

A tener en cuenta: Cualquier acción realizada en la plataforma Docebo a través de Docebo Connect está sujeta a las mismas restricciones y latencias que si la interfaz de la plataforma se utilizara manualmente. Las acciones de las recetas de Docebo Connect tampoco convertirán las acciones asíncronas de la plataforma en acciones síncronas y no pueden "saltarse la cola" de otras tareas a la espera de ser realizadas en la plataforma.

Activación de Docebo Connect

Para activar Docebo Connect en su plataforma o su entorno sandbox, contacte con el gestor de su cuenta de Docebo. Tenga en cuenta que, dependiendo de los requisitos de integración, puede haber costes asociados.

Antes de empezar

Al activar Docebo Connect, se creará un nuevo usuario de nivel Superadministrador en su sistema llamado service.connect. Este usuario no se puede editar ni eliminar en la Gestión de usuarios. El proceso de activación también creará una nueva aplicación OAuth2 en la sección API y SSO de los Ajustes avanzados de su plataforma.

Advertencia: Esta aplicación OAuth2 no debe eliminarse. Si lo hace, Docebo Connect dejará de funcionar.

Gestión de Docebo Connect

Una vez activado Docebo Connect en su plataforma, inicie sesión como Superadministrador, acceda a su menú de administrador desde el icono de engranaje, localice la sección Docebo Connect y pulse Gestionar.

Proyecto

Cuando abra por primera vez Docebo Connect, llegará a la pestaña Proyecto. Desde aquí es posible:

Crear, probar, modificar y eliminar sus propias recetas

Editar, iniciar, detener y reiniciar la ejecución de las recetas y, en caso necesario, depurarlas.

Advertencia: Cuando pruebe sus recetas, solo la receta/flujo de trabajo estará en modo de prueba, lo que significa que las llamadas a la API relacionadas se hacen realmente y, como consecuencia, la acción de crear, actualizar o eliminar que es invocada por esa acción afectará realmente al recurso en Docebo o en la plataforma de terceros.

Añadir, eliminar, iniciar y detener conectores prediseñados en aplicaciones

Los conectores son un requisito básico para cada sistema que desee integrar con la plataforma Docebo, proporcionan la conexión sobre la cual se construyen las recetas. Puede obtener más información sobre los conectores en la base de conocimientos de Workato (se abre en una nueva pestaña).

Advertencia:

• El conector de Docebo Learn docebo_connector_connection_internal, situado en la carpeta Activos de Connect, no debe ser movido, renombrado o eliminado - debe dejarse como está. La eliminación de esta conexión requerirá que se ponga en contacto con la asistencia para restaurar la funcionalidad.
• Si el conector se mueve fuera de la carpeta Activos de Connect, deberá volver a moverlo a Activos de Connect.
• Para recibir los lanzamientos de recetas en la carpeta de ejemplo, es obligatorio mantener el conector de Docebo en esta carpeta. Si mueve el conector de Docebo fuera de la carpeta Activos de Connect, dejará de recibir actualizaciones.
• Si se ha eliminado la carpeta, vuelva a crear una nueva con el mismo nombre, Activos de Connect, y vuelva a mover a ella la conexión.

Utilizar tablas de datos

Aquí puede crear y gestionar tablas de datos para hacer referencia de forma eficiente a los datos de uso frecuente y reutilizados. Las tablas de datos, al contrario que las de consulta, se encuentran dentro de su misma carpeta del proyecto. Para obtener más información, consulte Docebo Connect: Trabajar con tablas de datos.

Utilizar el sistema de papelera integrado

El sistema cuenta con un sistema de papelera integrado, lo que significa que, en caso de borrado involuntario de recetas o conectores, estos elementos pueden recuperarse fácilmente hasta que se eliminen manualmente del sistema de forma permanente.

Utilizar el sistema de control de versiones de recetas

También está el sistema de control de versiones de recetas, que permite restaurar cualquier versión anterior de la receta.

Organizar sus proyectos

Disponga sus recetas en carpetas y subcarpetas de acuerdo con sus necesidades de organización.

Esta pestaña enumera todas las recetas y conexiones ya configuradas en su plataforma. Las recetas son flujos de trabajo automatizados que pueden hacer que interactúen varias aplicaciones. Cada receta se compone de un desencadenante y una o más acciones que se llevan a cabo cuando tiene lugar el desencadenante. Más información en la base de conocimientos de Workato (se abre en una nueva pestaña).

Si está accediendo a Docebo Connect por primera vez, no habrá recetas configuradas excepto una receta llamada Ejemplos, que se crea automáticamente con fines de integración. Puede mantener esta receta como ejemplo para la creación de otras recetas o bien cambiarle el nombre.

Antes de utilizar las recetas contenidas en la carpeta Ejemplos, es necesario clonar las originales. Esto crea una copia de la receta que está vinculada a la receta original mantenida y actualizada automáticamente por Docebo. Cuando se actualice una receta, se le dará la oportunidad de actualizar también la receta clonada. Este proceso aísla sus recetas de ser sobrescritas automáticamente por cualquier actualización, borrando potencialmente cualquier personalización que haya realizado y/o bloqueando las recetas vinculadas a adiciones o automatizaciones en la producción.

Consejo: Para obtener más información sobre cómo clonar una receta, consulte Uso de Docebo Connect: Copiar recetas.

Además de esto, es posible encontrar una amplia colección de ejemplos de recetas en la pestaña Biblioteca de la comunidad, que proporciona y mantiene la comunidad de Workato.

Más información sobre cómo crear recetas en la base de conocimientos de Workato (se abre en una nueva pestaña).

Panel de control

En la pestaña Panel de control puede supervisar las tareas creadas por sus recetas. En esta pestaña, puede encontrar los detalles del flujo de ejecución de una tarea, es decir, qué pasos se ejecutaron y los datos de entrada y salida de cada paso. Más detalles sobre la monitorización de tareas (se abre en una nueva pestaña).

Esta página está dividida en tres secciones:

Panel de control

Aquí es posible supervisar el progreso de las tareas (número de ejecuciones, estados) durante un periodo de tiempo específico (por ejemplo, 7 días) y profundizar en el informe de cada tarea. Más información en la base de conocimientos de Workato (se abre en una nueva pestaña).

Gráfica de dependencias

Una herramienta que ilustra visualmente las relaciones entre cada activo y recurso (por ejemplo, recetas). Obtenga más información en la base de conocimientos de Workato (se abre en una nueva pestaña).

Registro de auditoría de actividades

Una interfaz simple y potente para que los administradores puedan supervisar de forma extensa los cambios en la cuenta, las conexiones, las recetas, las carpetas y los paquetes. Más información en la base de conocimientos de Workato (se abre en una nueva pestaña).

Conector SDK

Desde la pestaña Conector SDK es posible crear, actualizar o eliminar su propio conector personalizado y gestionar los conectores importados de la comunidad.

Estos conectores tienen un ámbito privado de forma predeterminada, lo que significa que solo son visibles y están disponibles para el propietario del conector. Una vez creado y publicado el conector, podrá utilizarlo en sus recetas.

Más información sobre el conector SDK en la base de conocimientos de Workato (se abre en una nueva pestaña).

Tabla de consulta

Consejo: Las tablas de consulta tienen un límite de tamaño de 10 columnas y 100.000 entradas (filas).

Desde la pestaña Tabla de consulta es posible gestionar sus propias tablas de consulta, definir una nueva tabla, crear, actualizar y eliminar entradas de tablas de consulta e importar masivamente datos mediante CSV.

Más información sobre las tablas de consulta en la base de conocimientos de Workato (se abre en una nueva pestaña).

Propiedades

En la pestaña Propiedades es posible crear, actualizar y eliminar sus propias propiedades de cuenta.

Más información sobre las propiedades de la cuenta en la base de conocimientos de Workato (se abre en una nueva pestaña).

Biblioteca de la comunidad

La Biblioteca de la comunidad es un gran lugar para explorar cuando se utiliza Docebo Connect por primera vez. En ella puede encontrar muchas recetas de ejemplo, así como conectores desarrollados, mantenidos y aportados por la comunidad de Workato.

En la sección de recetas de la pestaña Biblioteca de la comunidad puede buscar recetas de ejemplo por categorías (por ejemplo, Colaboración, RRHH, Utilidad, etc.), así como utilizando la función de búsqueda de texto.

Una vez identificada la receta de la comunidad que le interese, haciendo clic en Utilizar esta receta se importará la receta de la comunidad en Docebo Connect:

Desde aquí puede empezar a personalizar sus necesidades (a tener en cuenta: Docebo Connect requiere que utilice el conector de Docebo Learn en sus recetas):

En la sección Conectores personalizados puede encontrar una amplia colección de conectores desarrollados y mantenidos por la comunidad de Workato. Al igual que en el caso de las recetas, es posible explorar los conectores disponibles por categorías (por ejemplo, Colaboración, RRHH, Utilidad, etc.), así como utilizando la función de búsqueda de texto.

Una vez identificado el conector que se adapte a sus necesidades, puede importarlo a su cuenta de Docebo Connect haciendo clic en el botón Instalar conector:

Haga clic en Aceptar e instalar para completar el procedimiento de instalación:

El conector estará disponible en la pestaña Conector SDK:

Para poder utilizar el conector importado en sus recetas, tiene que lanzarlo en su cuenta de Docebo Connect haciendo clic en el botón Lanzar última versión:

Más información sobre los conectores de la comunidad en la base de conocimientos de Workato (se abre en una nueva pestaña).

Plataforma de las API

Con Docebo Connect, puede exponer recetas como extremos de API personalizados. Esto le permite ampliar la funcionalidad de la plataforma de las API existente de Docebo para adaptarla a sus necesidades. Consulte la base de conocimientos de Workato para obtener más información (se abre en una nueva pestaña).

La pestaña Plataforma de las API se divide en las siguientes vistas:

Pestaña Panel de control

Al acceder por primera vez a la plataforma de las API en Docebo Connect, se encontrará en la pestaña Panel de control. En esta se le presenta una descripción general del uso de su API de Docebo Connect. Consulte la base de conocimientos de Workato para obtener más información (se abre en una nueva pestaña).

Pestaña Colecciones de API

En la pestaña Colecciones de API, verá los grupos de extremos que puede crear. Tenga en cuenta que la colección de aprovisionamiento, si está presente, no debe eliminarse. Para obtener más información sobre cómo crear colecciones, consulte la base de conocimientos de Workato (se abre en una nueva pestaña).

Pestaña Políticas

Las políticas permiten controlar el uso de las API. Por ejemplo, puede restringir el uso de una API para limitar el número de veces que se llama con el fin de evitar la degradación del rendimiento. Establecer una política es opcional; sin embargo, no establecer políticas de acceso permite un uso sin restricciones. Para más detalles sobre cómo crear políticas, consulte la base de conocimientos de Workato (se abre en una nueva pestaña).

Pestaña Clientes

Los clientes son grupos de usuarios con acceso a las colecciones de API a través de su perfil de acceso. Los clientes pueden tener múltiples perfiles de acceso. Para más detalles sobre la creación y gestión de clientes, consulte la base de conocimientos de Workato (se abre en una nueva pestaña).

Pestaña Registros

Esta vista muestra una lista detallada de toda la actividad de conexión en su plataforma de las API.

Pestaña Biblioteca

La biblioteca es una lista de colecciones de API que pueden descubrir otros usuarios de su organización. Los usuarios pueden encontrar aquí la documentación, los ejemplos y las herramientas que necesitan para utilizar su API. Para obtener más información sobre todas las funciones de su biblioteca de colecciones de API, consulte la base de conocimientos de Workato (se abre en una nueva pestaña).

Pestaña Configuración

En esta pestaña puede configurar el prefijo de la API y establecer un dominio personalizado.

Prefijo de la ruta de la API

Aquí puede personalizar el prefijo de la URL para todos sus extremos. Para obtener más información sobre cómo personalizar el prefijo, consulte la base de conocimientos de Workato (se abre en una nueva pestaña).

Dominio personalizado

Puede utilizar un dominio personalizado para redirigir a sus extremos de API. Para obtener más información sobre cómo utilizar su propio dominio personalizado, consulte la base de conocimientos de Workato (se abre en una nueva pestaña).

Plantillas de mensajes

Las plantillas de mensajes le permiten preparar plantillas estáticas para los mensajes de uso frecuente utilizando Mustache (se abre en una pestaña nueva) como lenguaje de las plantillas. Estas plantillas se pueden utilizar para generar mensajes en varios formatos, como XML, JSON, HTML o texto.

Las plantillas de mensajes permiten al desarrollador de plantillas cambiar el formato del mensaje, separando la generación de la lógica de composición, sin realizar cambios en la receta que envía el mensaje.

Para más información, consulte la base de conocimientos de Workato (se abre en una nueva pestaña).

Acciones de recetas disponibles

Aquí se muestra una lista de las acciones de Docebo que puede utilizar en las recetas, ya sea como pasos finales o intermedios. Las acciones enumeradas aquí deben considerarse unas pautas generales. Cada acción incluye un conjunto de parámetros (como nombre de usuario, ID del curso, etc.).

Añadir curso al plan de aprendizaje

Añade un curso a un plan de aprendizaje en Docebo

Actualización por lotes de eventos rsvp

Actualización por lotes de un evento RSVP en Docebo

Crear curso

Crea un curso en Docebo

Crear evento

Crea un evento en Docebo

Crear plan de aprendizaje

Crea un plan de aprendizaje en Docebo

Crear sesión

Crea una sesión en Docebo

Crear usuario

Crea un usuario en Docebo

Crear usuarios por lotes

Creación de usuarios por lotes en Docebo

Acción personalizada

Construye su propia acción de Docebo con una solicitud personalizada

Acción personalizada (obsoleta)

Construye su propia acción de Docebo con una solicitud personalizada (obsoleta)

ADVERTENCIA: Esta acción de receta fue eliminada el 8 de noviembre de 2023. Para evitar problemas con la receta, sustituya esta acción de receta por Acción personalizada. Para ello, primero deberá eliminar esta acción de receta de su receta y volver a crear el resto de la receta desde ese punto utilizando la acción de receta Acción personalizada en su lugar.

Eliminar curso

Elimina un curso en Docebo

Eliminar evento

Elimina un evento en Docebo

Eliminar plan de aprendizaje

Elimina un plan de aprendizaje en Docebo

Eliminar sesión

Elimina una sesión en Docebo

Eliminar usuario

Elimina un usuario en Docebo

Eliminar usuarios

Elimina usuarios en Docebo

Duplicar sesión

Duplica una sesión en Docebo

Inscribir usuario en un curso

Inscribe a un usuario en un curso en Docebo

Inscribir usuario en una sesión

Inscribe a un usuario en una sesión en Docebo

Obtener recursos de certificación

Obtiene recursos de certificación en Docebo

Obtener certificaciones

Obtiene certificaciones en Docebo

Obtener premios de certificaciones

Obtiene premios de certificaciones en Docebo

Obtener curso por ID

Obtiene un curso por ID en Docebo

Obtener cursos

Obtiene todos los cursos en Docebo

Obtener inscripciones

Obtiene inscripciones en Docebo

Obtener inscripciones por ID de sesión

Obtiene inscripciones por ID de sesión en Docebo

Obtener evento por ID

Obtiene un evento por ID en Docebo

Obtener eventos por ID de sesión

Obtiene eventos por ID de sesión en Docebo

Obtener sesiones ILT

Obtiene sesiones ILT en Docebo

Obtener plan de aprendizaje por ID

Obtiene un plan de aprendizaje por ID en Docebo

Obtener planes de aprendizaje

Obtiene planes de aprendizaje en Docebo

Obtener sesión por ID

Obtiene una sesión por ID en Docebo

Obtener sesiones por ID del curso

Obtiene sesiones por ID del curso en Docebo

Obtener usuario por ID

Obtiene un usuario por ID en Docebo

Obtener usuarios

Obtiene usuarios en Docebo

Eliminar curso del plan de aprendizaje

Elimina un curso de un plan de aprendizaje en Docebo

Compartir archivo

Comparte un archivo en Docebo

Compartir enlace

Comparte un enlace en Docebo

Cancelar inscripción de usuario del curso

Cancela la inscripción de un usuario en un curso en Docebo

Cancelar inscripción de usuario del plan de aprendizaje

Cancela la inscripción de un usuario en un plan de aprendizaje en Docebo

Cancelar inscripción de usuario de la sesión

Cancela la inscripción de un usuario en una sesión en Docebo

Actualizar curso

Actualiza un curso en Docebo

Actualizar evento

Actualiza un evento en Docebo

Actualizar plan de aprendizaje

Actualiza un plan de aprendizaje en Docebo

Actualizar sesión

Actualiza una sesión en Docebo

Actualizar usuario

Actualiza un usuario en Docebo

Migración de la URL de los webhooks

Este capítulo está dirigido a quienes usan recetas que requieren webhooks. Tenga en cuenta que, a partir del 31 de diciembre de 2023, Workato desactivó todos los webhooks cuya URL comenzaba por www.workato.com, y los cambió a una URL que empezaba por webhooks.workato.com o webhooks.eu.workato.com. Para evitar problemas con sus recetas, siga los pasos descritos en este capítulo.

Para determinar la URL correcta que utilizar, acceda a la carpeta Menú de administrador. A continuación, en el menú Configuración, pulse Ajustes avanzados.

A continuación, pulse la pestaña Información de la plataforma y anote la Región del alojamiento. Si su región de alojamiento se encuentra en Europa, la URL correcta que debe utilizar para los webhooks es webhooks.eu.workato.com. De lo contrario, utilizará webhooks.workato.com.

Acceda a su página de administrador de Docebo pulsando el icono Administrador, después localice la sección Webhooks y pulse Gestionar.

A continuación, localice los webhooks asociados a sus recetas de Docebo Connect. Cualquier webhook que comience con la URL https://www.workato.com necesitará ser cambiado. Anote las recetas afectadas y vaya a Docebo Connect para recuperar la URL correcta.

Acceda a su página de administrador de Docebo pulsando el icono Administrador, después localice la sección Docebo Connect y pulse Gestionar.

En su carpeta Proyectos, localice la receta afectada por el cambio de la URL del webhook y pulse el botón de puntos suspensivos. A continuación, en el menú desplegable, seleccione Editar receta.

En el Editor de recetas, haga clic en la entrada Desencadenante y, en la ventana deslizante resultante, pulse el botón Copiar junto a la dirección del webhook de Workato. A continuación, pulse el botón Salir.

A continuación, vuelva a la pantalla Webhooks y localice el webhook que desee actualizar. Pulse el botón de puntos suspensivos al final de la fila del webhook y, en el menú desplegable, seleccione Editar.

En la pantalla General resultante, en la sección Extremo, pegue la URL copiada en el cuadro de texto URL de carga útil. A continuación, pulse el botón Guardar cambios.

Después de guardar los cambios, el webhook se actualizará, pero estará desactivado. Presione el botón de puntos suspensivos en la fila del webhook y haga clic en Activar para activarlo. El valor del estado indicará que el webhook está ahora activo.

Repita este proceso para cada webhook que requiera una nueva URL de carga útil.

A tener en cuenta: Si está utilizando integraciones de Docebo Connect que requieran la configuración de un webhook con un tercer proveedor, asegúrese de actualizar la URL de Workato de su webhook también allí.