Configura la integración de 2N Intercom
Cómo configurar la integración del intercomunicador 2N
La integración del intercomunicador 2N permite a los visitantes usar el código QR de su invitación en un intercomunicador 2N para acceder al edificio. Cuando está habilitada, Salto IDM sincroniza el ciclo de vida de la persona visitante (crear, revocar, eliminar), la empresa y la ventana de validez con 2N, y mantiene un único código PIN entre IDM y 2N para evitar discrepancias.
La integración se habilita y configura por entorno, cada uno con sus propias credenciales y prueba de conexión.
Usa esta guía para habilitar la integración, configurarla correctamente y validar de extremo a extremo el comportamiento del código QR, el código PIN y el ciclo de vida de la persona.
Requisitos previos
Antes de empezar, asegúrate de tener:
- Credenciales de la API de 2N y accesibilidad de red desde Salto IDM hasta el punto de enlace de 2N.
- Una cuenta de administrador de Salto IDM con acceso a Configuración > Integraciones.
- Al menos un entorno de IDM para configurar. Si tienes entornos de Staging y de producción, valida primero en Staging.
- Plantillas de invitación para visitantes que incluyan el código QR, si los visitantes usan códigos QR en los intercomunicadores.
Paso 1: Habilitar el módulo del intercomunicador 2N
- Ve a Configuración > Integraciones.
- Busca Intercomunicador 2N y activa el módulo (On) para el entorno de destino.
- Si Enviar QR a Salto está activado, aparece un toggle adicional de Almacenar código QR de 2N. Habilítalo si deseas que el código QR se almacene en IDM para auditoría o para reenviar invitaciones.
Mantén Staging y producción aislados. Valida la integración primero en Staging y, luego, repite la misma configuración en producción. La habilitación de módulos y las credenciales se configuran por entorno, y los datos de Staging no se migran automáticamente a producción.
Paso 2: Añadir las credenciales de 2N y probar la conexión
- Abre la página de configuración de 2N en Configuración > Integraciones > 2N.
- Introduce tu punto de enlace de la API de 2N y tus credenciales, tal como te las haya proporcionado tu administrador de 2N.
- Selecciona Probar conexión.
No procedas hasta que Probar conexión se realice correctamente. Una conexión fallida puede hacer que la sincronización en segundo plano se detenga o dé errores durante el aprovisionamiento de personas.
Paso 3: Configurar el comportamiento para el entorno
- Elige qué tipos de identidad pueden sincronizarse con 2N. Las personas visitantes son el caso de uso principal.
- Confirma que las plantillas de invitación para visitantes incluyan un código QR. Si tu proceso utiliza un tótem o un código PIN por correo electrónico, asegúrate de que el formato coincida con lo que espera 2N.
- Decide si deseas almacenar los códigos QR de 2N en IDM. Almacenarlos ayuda con el soporte y el reenvío de invitaciones.
Paso 4: Validar la integración
- Crea una persona visitante de prueba con una ventana de visita válida, envía la invitación y confirma que se genera el código QR.
- En un dispositivo 2N, presenta el código QR y confirma que se concede el acceso dentro de la ventana de visita.
- Confirma que aparece el mismo código PIN en el tótem o en la invitación por correo electrónico y en 2N.
- Revoca y, a continuación, elimina a la persona de prueba, y confirma que las actualizaciones correspondientes se realizan en 2N.
Paso 5: Poner en marcha
Antes de habilitar la integración en producción, confirma que:
- Las credenciales de 2N se almacenan de forma segura (por ejemplo, en un gestor de contraseñas) y se rotan según tu política.
- Probar conexión se realiza correctamente tanto en Staging como en producción.
- Las plantillas de visitantes incluyen el código QR y han sido revisadas por las partes interesadas.
- El formato del código PIN no entra en conflicto entre IDM y 2N.
- Los administradores y el personal de recepción están formados sobre el comportamiento esperado y la resolución de problemas.
Cómo funciona la sincronización
- Crear persona: IDM envía una solicitud de creación (o actualización) a 2N con la persona, la empresa, el código QR y la ventana de validez.
- Revocar o desactivar: IDM actualiza 2N para restringir o eliminar la validez de la persona.
- Eliminar persona: IDM envía una solicitud de eliminación a 2N para eliminar la identidad.
Cuando el módulo 2N está deshabilitado para un entorno, IDM no llama a la API de 2N para ningún evento del ciclo de vida de la persona.
Mensajes de error comunes
| Mensaje | Qué hacer |
|---|---|
| Probar conexión falla | Comprueba el punto de enlace de la API de 2N, las credenciales y la accesibilidad de red desde IDM hasta el punto de enlace de 2N. No habilites el módulo para el entorno hasta que la prueba se realice correctamente. |
| El código PIN que se muestra en el tótem o en el correo electrónico no coincide con el de 2N | Verifica la política de formato de código PIN del entorno y, a continuación, vuelve a guardar a la persona para activar una nueva sincronización. |
| El código QR no se acepta en el intercomunicador | Confirma que la visita está dentro de su ventana de validez y que la plantilla de invitación incluye el código QR. |
| La eliminación de una persona visitante falla | Confirma que Probar conexión se realiza correctamente para el entorno. Si el entorno no tiene 2N configurado, la eliminación de una persona visitante debería seguir funcionando; ponte en contacto con el soporte de Salto si no lo hace. |
Preguntas frecuentes
¿Deshabilitar el módulo 2N detiene todas las llamadas a 2N? Sí. Cuando el módulo está deshabilitado para un entorno, IDM no llama a la API de 2N para la creación, revocación o eliminación de personas.
¿Cómo nos aseguramos de que aparezca el mismo código PIN en IDM y en 2N? La integración sincroniza la generación del código PIN para que el tótem, el correo electrónico y 2N reciban el mismo valor. Si ves una discrepancia, verifica la política de formato de código PIN del entorno y vuelve a guardar a la persona para activar una nueva sincronización.
¿Podemos almacenar códigos QR de 2N en IDM? Sí. Cuando Enviar QR a Salto está activado, habilita Almacenar código QR de 2N para conservar el código QR dentro de IDM para soporte y reenvío de invitaciones.
Atrás