Ir al contenido principal

Conectar Digiforma a Edusign: sincronice su asistencia

Importe automáticamente sus cursos, docentes y estudiantes de Digiforma a Edusign, y luego encuentre las asistencias firmadas en Digiforma.

Escrito por Elliot Boucher

La integración Digiforma × Edusign evita re-ingresar sus formaciones y asistencias en dos herramientas. Digiforma sigue siendo la referencia para la planificación; Edusign sigue siendo la referencia para el registro de asistencia.

Lo que hace la integración

  • Importa las sesiones planificadas o finalizadas, sus franjas, estudiantes inscritos y docentes de Digiforma a Edusign.

  • Crea automáticamente en Edusign los estudiantes y docentes faltantes cuando pueden ser identificados sin ambigüedad.

  • Envía a Digiforma las asistencias y firmas recogidas en Edusign.

  • Evita duplicados y protege los cursos ya firmados, bloqueados o finalizados.

Antes de comenzar

Debe ser el administrador de su organización Edusign y contar con una suscripción a Digiforma que incluya acceso al API GraphQL.

Para generar su token Digiforma:

  1. Inicie sesión en Digiforma.

  2. En las opciones avanzadas, verifique que el API GraphQL esté disponible.

  3. Abra la página de configuración del API.

  4. Haga clic en Generar un token.

  5. Copie inmediatamente el token y consérvelo en un lugar seguro.

Documentación Digiforma: GraphQL: l’API Digiforma.

Conectar Digiforma a Edusign

  1. Instale la aplicación Digiforma desde el Marketplace de Edusign.

  2. Abra la configuración de la aplicación en Edusign.

  3. Haga clic en Conectar Digiforma.

  4. Pegue su token API Digiforma, sin añadir el prefijo «Bearer».

  5. Valide la conexión.

Edusign transfiere automáticamente al conector las autorizaciones propias de su organización. No necesita copiar una clave API Edusign. El token de Digiforma es testado antes de ser registrado; una vez validada la conexión, la primera sincronización comienza automáticamente.

¿Qué datos se sincronizan?

¿Qué sesiones de Digiforma son importadas?

Solo las sesiones planificadas y validadas, así como las sesiones finalizadas, son importadas en Edusign.

  • Proyecto, borrador o planificación en curso: no se crea ningún curso ni formación en Edusign.

  • Sesión planificada y validada: se importa en la próxima sincronización, automáticamente cada 15 minutos por defecto o después de una sincronización manual.

  • Sesión finalizada: sigue siendo reconocida por el conector, respetando las reglas de protección de cursos pasados.

  • Sesión ya importada y luego vuelta a planificación: los elementos existentes en Edusign no se eliminan automáticamente. Esta protección evita que un cambio de estado accidental elimine una planificación operativa.

Para hacer una sesión importable, ábrala en Digiforma, termine su planificación y luego use la acción para aprobarla y pasarla a modo planificado. Aparecerá luego en Edusign durante la próxima sincronización.

De Digiforma a Edusign

  • Una sesión de formación de Digiforma se convierte en una formación en Edusign.

  • Una franja de Digiforma se convierte en un curso en Edusign.

  • Los estudiantes inscritos se convierten en estudiantes Edusign.

  • Los docentes se convierten en profesores Edusign.

  • El nombre, las fechas, los horarios, el lugar, los participantes y docentes de la franja son trasladados a Edusign.

  • Las audiencias propias de las franjas y sub-sesiones se respetan cuando están definidas en Digiforma.

De Edusign a Digiforma

Solo se envían los datos de asistencia:

  • presencia o firma de un estudiante;

  • ausencia o falta de firma según el estado final del curso;

  • firma de un docente.

Las modificaciones de nombre, horario, sala, participantes, descripción, cuestionario o cualquier otro campo realizadas en Edusign no modifican nunca Digiforma.

¿Cuándo ocurre la sincronización?

Planificación de Digiforma a Edusign

Actualmente, Digiforma no proporciona webhook para los cambios de sesión. El conector a tal efecto revisa Digiforma cada 15 minutos por defecto. Una nueva sesión o modificación aparece normalmente en Edusign durante la siguiente sincronización.

Asistencia de Edusign a Digiforma

Los webhooks de Edusign notifican rápidamente las firmas y el bloqueo de cursos. Una verificación periódica permanece activa como respaldo si un evento se retrasa o se pierde.

¿Qué sucede cuando un curso se modifica en Digiforma?

  • Curso futuro, no bloqueado y sin presencia ni firma: las modificaciones aplicables se llevan a Edusign.

  • Curso futuro con una presencia, firma, bloqueo o asistencia ya enviada: el curso de Edusign está protegido y permanece sin cambios.

  • Curso comenzado hoy antes de las 12 h, no bloqueado y sin evidencia de asistencia: se puede seguir actualizando con la configuración por defecto.

  • Curso comenzado hoy a partir de las 12 h: permanece sin cambios.

  • Curso anterior a hoy: permanece sin cambios.

  • Curso cuya nueva fecha de Digiforma se desplaza al pasado: el curso existente de Edusign no se reescribe.

  • Curso histórico trasladado a una fecha futura: se puede actualizar si no está bloqueado y sin asistencia.

  • Fecha, hora o zona horaria inválida: la sincronización en cuestión falla sin enviar un curso inválido a Edusign.

El límite de las 12 h corresponde a la configuración por defecto y puede ajustarse. Estas protecciones previenen que una modificación tardía invalide firmas ya recogidas.

¿Y si tanto Digiforma como Edusign se han modificado?

Por defecto, solo los campos realmente modificados en Digiforma desde la sincronización anterior se aplican en Edusign. Las modificaciones en Edusign irrelevantes se conservan.

Ejemplo: si la sala es modificada en Edusign y luego el horario en Digiforma, el nuevo horario se aplica pero la sala ingresada en Edusign se conserva. Si el mismo campo se ha modificado en ambas herramientas, Digiforma tiene prioridad para ese campo mientras el curso sea aún modificable.

Un modo opcional permite que Digiforma tenga prioridad total para todos los campos manejados: nombre, horarios, sala, formación madre, estudiantes y docentes.

¿Qué sucede cuando un curso se modifica en Edusign?

  • Una presencia o una nueva firma puede enviarse a Digiforma.

  • Las otras modificaciones permanecen solo en Edusign.

  • Los horarios, salas, participantes e información del curso nunca se envían de vuelta a Digiforma.

¿Cuándo se envían las asistencias a Digiforma?

Envío final — modo por defecto

Las asistencias se envían cuando el curso de Edusign está bloqueado. Este modo es recomendado cuando el registro de asistencia no debe aparecer en Digiforma hasta que el curso haya concluido y sido verificado.

Envío en directo — opcional

Mientras un curso está en curso y no bloqueado, cada cambio de asistencia puede enviarse rápidamente a Digiforma. Cuando el curso está bloqueado posteriormente, el conector realiza una última verificación. Un estado ya enviado y sin cambios no se envía una segunda vez.

Si llega una nueva firma mientras se está realizando un envío, se programa automáticamente una verificación adicional para enviar el estado más reciente.

¿Dónde ver las asistencias en Digiforma?

  1. Abra la sesión de formación en cuestión.

  2. Acceda a Seguimiento, luego al registro o seguimiento de asistencias.

  3. Despliegue el módulo y luego la franja correspondiente.

Los estudiantes y docentes inscritos deben aparecer con su estado de asistencia.

¿Por qué no aparece un estudiante?

Verifique si está en la sección Prospectos en espera de Digiforma. Un prospecto en espera aún no es un estudiante inscrito en la sesión: Digiforma no le asigna por lo tanto una línea de registro de asistencia que el conector podría actualizar.

Acepte o convierta primero el prospecto en estudiante inscrito, verifique su asignación a la sesión o franja, luego espere la próxima sincronización.

¿Cómo se reconocen las personas?

El conector busca sucesivamente una correspondencia ya conocida, el identificador Digiforma asociado a la persona en Edusign, luego una dirección de correo electrónico idéntica. Si no existe una persona compatible, se crea automáticamente en Edusign.

Se necesita una dirección de correo electrónico válida para la creación. Si la misma dirección ya pertenece a una persona gestionada por otra integración o asociada a otro identificador, la coincidencia es bloqueada para evitar asignar una presencia a la persona equivocada.

¿Una asistencia puede enviarse dos veces?

El conector memoriza una huella técnica del estado ya enviado. Si ningún participante ni estado de asistencia ha cambiado, no reenvía la misma información a Digiforma. En caso de una nueva firma o cambio de estado, se envía la nueva versión.

¿Qué sucede si una sincronización falla?

Los errores temporales, como una indisponibilidad de red o una limitación de API, se reintentan automáticamente. Si el error persiste, la operación se guarda para diagnóstico y puede relanzarse tras su corrección.

Antes de un envío, el conector verifica que el conjunto de estudiantes y docentes de la franja correspondan en ambas herramientas. Si falta una correspondencia, todo el envío de la franja se suspende para evitar un registro parcial o incorrectamente asignado.

¿Qué sucede si se elimina una franja en Digiforma?

Por defecto, el curso correspondiente no se elimina automáticamente de Edusign.

Una opción de eliminación controlada puede habilitarse. Solo concierne a un curso creado por la integración, situado en el futuro, no bloqueado, sin firma ni presencia, y cuya eliminación haya sido confirmada directamente en Digiforma. Los estudiantes, docentes, formaciones históricas y cursos ya iniciados nunca se eliminan automáticamente.

¿Se pueden importar cursos pasados?

No por defecto. Una importación histórica puede habilitarse por un periodo determinado. Los cursos históricos ya sincronizados siguen protegidos contra modificaciones automáticas.

¿Qué opciones pueden adaptarse?

  • La frecuencia de sincronización.

  • El envío final o en directo de las asistencias.

  • La eventual importación de un periodo pasado.

  • La hora límite para las actualizaciones en el mismo día.

  • La prioridad parcial o completa de Digiforma sobre los campos gestionados.

  • La eliminación controlada de cursos futuros eliminados en Digiforma.

  • La activación independiente de la importación de planificación y del envío de asistencias.

Los valores por defecto privilegian la protección de firmas, la conservación de modificaciones Edusign irrelevantes y la ausencia de eliminación automática.

¿Qué datos no se sincronizan?

  • Las empresas, clientes y financiadores.

  • Los programas, módulos, objetivos y tarifas.

  • Las facturas.

  • Los documentos, certificados, evaluaciones y cuestionarios.

  • Los grupos Edusign.

  • Los cambios de perfil realizados después de la creación de una persona.

  • Las modificaciones de planificación de Edusign a Digiforma.

  • Las asistencias de Digiforma a Edusign.

  • Las eliminaciones de personas o formaciones.

¿Cómo se protegen las credenciales y los datos?

Las claves Edusign y tokens de Digiforma están cifrados antes de su almacenamiento y nunca se muestran en la interfaz operativa. El conector no guarda las firmas en sí mismas, los cuerpos completos de los webhooks, los números de teléfono ni los perfiles completos de los participantes. Solo conserva las correspondencias e información técnica necesarias para la sincronización, la prevención de duplicados y el diagnóstico.

¿Cómo reemplazar un token de Digiforma?

Abra de nuevo la configuración de la aplicación Digiforma en Edusign, haga clic en Conectar Digiforma y luego proporcione el nuevo token. Se verifica antes de reemplazar el anterior.

¿Qué sucede si se desinstala la aplicación?

La desinstalación detiene la sincronización y elimina las credenciales, correspondencias e historiales técnicos conservados por el conector para su organización. No elimina automáticamente las formaciones, cursos, estudiantes, docentes o asistencias ya presentes en Edusign o Digiforma.

¿Qué verificar si nada parece sincronizarse?

  • La sesión Digiforma está planificada y validada: una sesión aún en etapa de proyecto, borrador o en curso de planificación no se importa.

  • El token Digiforma sigue siendo válido y la opción API GraphQL está incluida en su suscripción.

  • El estudiante está inscrito en la sesión, y no solo está presente como prospecto en espera.

  • El horario incluye al menos un docente identificable.

  • El curso no está pasado, bloqueado o ya firmado cuando usted espera una actualización del plano.

  • En modo de envío final, el curso Edusign ha sido bloqueado.

  • Ha esperado hasta 15 minutos para una modificación proveniente de Digiforma.

Si el problema persiste, contacte al soporte Edusign indicando la organización, la sesión Digiforma, el horario y el curso Edusign involucrados. Nunca transmita su token API en una conversación de soporte no segura.

¿Ha quedado contestada tu pregunta?