Saltar al contenido principal

Integrar POK con Sana

Integrar POK Proof of Knowledge con Sana permite emitir credenciales automáticamente cuando una persona completa un curso. Se registra la integración en el panel de POK, se conecta POK con el espacio de Sana y se elige qué cursos emiten qué credencial. A partir de ese momento, cada vez que Sana informa que se completó un curso, POK emite la credencial configurada a esa persona, sin ningún paso manual.

La conexión tiene dos direcciones, y cada una usa sus propias credenciales:

  • POK leyendo desde Sana: POK llama a la API de Sana para buscar a la persona que completó el curso. Usa las credenciales de API que se crean en el panel de Sana.
  • Sana notificando a POK: Sana envía cada finalización a POK. Usa las credenciales de conexión que POK entrega.

Los pasos siguientes cubren ambas direcciones.

Iniciar la integración desde POK​

  1. Ingresa a la sección Integraciones dentro del panel de POK.
  2. En el listado de plataformas disponibles, selecciona Sana.
  3. Asigna un nombre que identifique la integración (por ejemplo, "Sana 2026").
  4. Ingresa las credenciales de tu espacio de Sana:
    • URL del tenant de Sana: la dirección de Sana, por ejemplo https://tuempresa.sana.ai.
    • Client ID y Client Secret: las credenciales de API OAuth2 creadas en Sana (ver más abajo).
  5. Guarda la integración.

Diálogo de nueva integración en POK con el formulario de Sana: nombre de la integración, URL del tenant de Sana, Client ID y Client Secret

tip

El Client ID y el Client Secret provienen del cliente de API que se crea en la configuración de administrador de Sana. Si aún no los tienes, crea primero un cliente de API en Sana y luego regresa a este formulario.

Solicitar las credenciales de conexión a POK​

Para que Sana pueda notificar a POK las finalizaciones de curso, POK entrega un conjunto de credenciales de conexión dedicadas. Después de crear la integración, POK indica cómo solicitarlas.

Escribe a contact@pok.tech para solicitar las credenciales de conexión de Sana. POK enviará:

  • Un Client ID y un Client Secret (emitidos por POK, distintos de los de Sana).
  • La URL de token y la URL de statements que Sana necesita para llegar a POK.

Configurar la integración en Sana​

En Sana, configura la integración xAPI que envía los statements de finalización a POK, con los valores que POK envió:

  1. Abre la configuración de tu espacio de Sana y agrega una integración xAPI.
  2. Ingresa la URL de statements provista por POK como endpoint.
  3. En autenticación, elige OAuth2 client credentials e ingresa la URL de token, el Client ID y el Client Secret provistos por POK.
  4. Configura el tipo de actor (Actor type) en account. Es obligatorio: con cualquier otro tipo de actor la finalización llega sin el identificador de la persona y POK no puede emitir la credencial.
  5. Guarda la integración en Sana.

Formulario de integración xAPI de Sana con el Token URL, el Statements URL, el Client ID y el Client Secret de OAuth2, y el Actor type en Account

aviso

El tipo de actor debe ser account. Es el único ajuste del lado de Sana que, si queda mal, impide que se emitan las credenciales sin dar aviso.

Elegir qué cursos emiten credencial​

De vuelta en POK, define cuáles de tus cursos de Sana emiten una credencial y cómo se ve cada una.

  1. Abre la integración de Sana desde la sección Integraciones.
  2. Busca el curso que quieres configurar y selecciónalo.
  3. Completa la configuración de la credencial:
    • Selecciona el diseño de la credencial.
    • Vincula una página personalizada y una ruta de aprendizaje (opcional).
    • Define si la credencial tiene fecha de vencimiento.
    • Mapea los atributos personalizados del diseño con los datos de la persona.
    • Elige el tipo de credencial: básica o blockchain.
    • Define el idioma del correo que recibirá la persona.
  4. Guarda la configuración.

Página de configuración de credencial por curso en POK con el selector de curso y el formulario de la credencial

Una tilde verde marca cada curso que ya tiene una credencial configurada. Solo los cursos configurados emiten credenciales; las finalizaciones de cualquier otro curso se ignoran.

Para dejar de emitir en un curso, ábrelo nuevamente y elimina su configuración.

Cómo funciona la emisión​

Una vez que un curso está configurado y la integración de Sana está conectada, la emisión es automática:

  1. Una persona completa el curso en Sana.
  2. Sana informa la finalización a POK.
  3. POK busca a la persona en Sana y emite la credencial configurada.
  4. La persona recibe un correo con el enlace para aceptar su credencial.

No hace falta ninguna acción manual por cada persona. Si llega una finalización de un curso que no configuraste, POK simplemente la ignora.

Ante cualquier duda, escríbenos a contact@pok.tech

Más información​

Para ver cómo las integraciones de POK se conectan con tu LMS y otros sistemas, visita la página de la función de integraciones LMS y CRM.