Integración de intercomunicadores IP BAS-IP con sistemas de construcción existentes

En un solo sitio, el equipo de gestión puede trabajar en una plataforma de gestión de propiedades, el equipo de seguridad en un sistema de control de acceso y los residentes en una aplicación móvil separada. Si el sistema de entrada de puertas (intercomunicador) sigue siendo otra parte aislada del edificio, los mismos usuarios, derechos de acceso y eventos deben administrarse en varios lugares.

BAS-IP se puede integrar en la infraestructura digital existente del edificio. La plataforma de gestión de propiedades puede seguir siendo la interfaz operativa principal para el personal, mientras que la aplicación existente para residentes puede obtener la funcionalidad de intercomunicador, video y apertura de puertas.

Existen cuatro enfoques principales: interoperabilidad a través de protocolos estándar, BAS-IP Link API, BAS-IP Mobile SDK y BAS-IP Device API. La elección correcta depende de qué se necesite integrar y cómo funcione el sistema existente.

¿Qué es BAS-IP Link?

BAS-IP Link es una plataforma de software para gestionar dispositivos BAS-IP conectados, sitios y apartamentos, usuarios, credenciales de acceso, llamadas y configuración de dispositivos.

Está disponible en dos modelos de implementación: Link Self-Hosted (autoalojado), instalado en la infraestructura de servidores propia del cliente, y Link Cloud, proporcionado como un servicio en la nube de BAS-IP.

Algunas integraciones funcionan a través de Link, mientras que otras se comunican directamente con el equipo BAS-IP.

Interoperabilidad a través de protocolos estándar

No toda integración requiere desarrollo de software.

El equipo BAS-IP admite protocolos estándar que ya se utilizan ampliamente en sistemas de telefonía, CCTV (videovigilancia) y control de acceso:

• SIP: el panel de entrada se registra como un cliente SIP en el PBX del cliente, lo que permite que las llamadas se envíen a teléfonos y softphones existentes;
• RTSP: el panel se puede agregar a un VMS (sistema de gestión de video) o NVR como fuente de video junto con las otras cámaras de CCTV del sitio;
• Wiegand: el lector incorporado en el panel puede pasar un identificador de credencial a un sistema de control de acceso de terceros.

Estos escenarios se configuran en ambos extremos y no requieren desarrollo frente a una API o SDK de BAS-IP.

Nota. Para las integraciones SIP, se debe comprobar de antemano la compatibilidad de los códecs de audio y vídeo entre el sistema de terceros y el equipo BAS-IP específico. Por ejemplo, el equipo BAS-IP admite escenarios que utilizan PCMA para audio y H.264 para vídeo. Siempre se debe comprobar el conjunto de códecs compatible en ese momento para el modelo y la versión de firmware pertinentes.

Los protocolos estándar pueden transportar una llamada, un flujo de video o un identificador de credencial, pero no entienden quién es el usuario, a qué apartamento pertenece o qué derechos de acceso debería tener.

Cuando la integración necesita trabajar con los datos en sí (crear usuarios, otorgar o revocar acceso, o recuperar eventos), se requiere una API o SDK.

BAS-IP Link API: integración con una gestión de propiedades o plataforma del lado del servidor

Link API está diseñada para casos en los que un sistema de terceros necesita interactuar programáticamente con BAS-IP Link: por ejemplo, una plataforma de gestión de propiedades, un sistema de control de acceso u otra plataforma empresarial que ya esté en uso en el sitio.

Un ejemplo sencillo es la mudanza de un residente.

Un miembro del personal crea el perfil del residente en la plataforma existente: nombre, apartamento y datos de contacto. Sin una integración, el mismo usuario debe crearse manualmente por segunda vez en el sistema de intercomunicación.

Con Link API, los datos se pueden transferir automáticamente. El usuario se crea en el sitio y apartamento correctos dentro de BAS-IP Link, desde donde la información se puede aplicar a la infraestructura BAS-IP conectada.

Ese es solo un posible caso de uso.

A través de Link API, un sistema de terceros puede trabajar con:

• usuarios y estructura del sitio;
• derechos de acceso;
• credenciales de acceso permanente, que incluyen tarjetas, llaveros, códigos PIN, códigos QR, Face ID, UKEY y números de matrícula de vehículos;
• credenciales temporales con un período de validez definido;
• acceso de invitados y visitantes;
• mensajería para residentes;
• números virtuales y desvío de llamadas;
• configuración remota de dispositivos;
• eventos y registros (logs).

La funcionalidad exacta utilizada depende de los requisitos del proyecto.

Con esta arquitectura, la plataforma existente del cliente puede seguir siendo la interfaz operativa diaria para su personal.

Estado actual. Las integraciones del lado del servidor de terceros a través de Link API se implementan actualmente en BAS-IP Link Self-Hosted.

El soporte para BAS-IP Link Cloud está en desarrollo y se proporcionará a través de una puerta de enlace API (API gateway).

Si el proyecto está destinado a utilizar Link Cloud, el caso de uso requerido y las opciones disponibles deben discutirse con BAS-IP antes de que comience el desarrollo.

BAS-IP Mobile SDK: funcionalidad de intercomunicador dentro de su propia aplicación móvil

El segundo escenario común es el de una organización que ya tiene su propia aplicación móvil para residentes, inquilinos o empleados.

Es posible que esa aplicación ya gestione solicitudes de mantenimiento, pagos, reservas de servicios y notificaciones. Por lo tanto, puede resultar innecesario introducir una aplicación independiente exclusivamente para la entrada a la puerta.

BAS-IP Mobile SDK añade funciones clave de intercomunicador, entrada de puerta y acceso a la aplicación existente a través de BAS-IP Link, que incluyen:

• autenticación de usuario;
• llamadas de audio y video entrantes y salientes;
• vista previa de video en vivo desde el panel de entrada antes de contestar una llamada;
• notificaciones push;
• apertura de puerta (liberación);
• historial de llamadas;
• acceso móvil basado en BLE (Bluetooth Low Energy) a través del componente UKEY;
• llamar al ascensor hasta el piso del residente.

Tanto iOS como Android son compatibles.

El residente puede responder una llamada desde el panel de entrada directamente en la aplicación que ya usa, ver una vista previa en vivo del visitante antes de responder y abrir la puerta.

El equipo de desarrollo no necesita construir la capa de llamadas del intercomunicador desde cero. La comunicación SIP y la interacción con BAS-IP Link ya son manejadas por los componentes suministrados; el papel del socio es integrar esos componentes en su propia aplicación.

El SDK móvil no reproduce todas las funciones disponibles en la aplicación BAS-IP Link. Proporciona un conjunto definido de capacidades listas para usar.

Si una función requerida no está incluida en el SDK, por ejemplo, la generación de códigos QR para invitados, el socio puede implementarla en su propia aplicación mediante llamadas directas a Link API.

Estado actual. Las integraciones del SDK móvil se implementan en BAS-IP Link Self-Hosted.

Los proyectos que requieran BAS-IP Link Cloud deben planificarse después de que la puerta de enlace de Cloud API esté disponible.

BAS-IP Device API: integración directa con el equipo

No toda integración requiere BAS-IP Link.

Los paneles de entrada BAS-IP, los monitores interiores y otros dispositivos compatibles, incluido el módulo de ascensor, tienen sus propias API locales. Por lo tanto, un sistema de terceros puede comunicarse directamente con el equipo.

La distinción es sencilla:

• Device API conecta su sistema directamente a dispositivos BAS-IP específicos.
• Link API conecta su sistema a BAS-IP Link, que a su vez gestiona el equipo BAS-IP conectado.

La integración directa del dispositivo es ideal para un proyecto local con una gama limitada y conocida de modelos de dispositivos.

La integración a través de Link es generalmente más adecuada cuando la solución cubre diferentes modelos, una mayor cantidad de dispositivos o varios sitios, porque Link reduce la dependencia de la integración a los aspectos específicos de los modelos de dispositivos individuales y las versiones de firmware.

Obtener acceso a Device API es más sencillo: la documentación está disponible públicamente y no se requiere NDA (Acuerdo de confidencialidad).

Los desarrolladores pueden registrarse a través del portal de desarrolladores de BAS-IP y confirmar su dirección de correo electrónico.

Webhooks

Los paneles de entrada BAS-IP basados en Android también admiten webhooks.

Esto permite a un sistema de terceros recibir eventos a medida que ocurren, incluida la apertura de puertas, el acceso concedido o denegado, las actualizaciones del dispositivo y otros eventos registrados en el registro del dispositivo.

Esto es útil en escenarios de edificios inteligentes (smart buildings) donde otro sistema debe reaccionar inmediatamente a un evento de acceso o apertura de puerta.

Los webhooks se configuran directamente en el panel de entrada a través de la configuración del dispositivo.

No son compatibles en paneles basados en Linux, monitores interiores o a nivel de BAS-IP Link.

¿Qué enfoque de integración debería elegir?

No es estrictamente necesario que elija el método de integración de antemano. En la mayoría de los casos, el enfoque correcto queda claro una vez que se han descrito el sistema existente y el caso de uso requerido.

¿Qué aporta la integración al lugar (sitio)?

• Configuración inicial más rápida: los datos del usuario y los parámetros relacionados se pueden transferir desde el sistema en el que ya se mantienen.
• Menor entrada de datos duplicados: no es necesario ingresar la misma información repetidamente en diferentes interfaces.
• Datos operativos unificados: los eventos de intercomunicador, entrada de puerta y acceso se pueden reunir con otra información del sitio.
• Flujos de trabajo familiares: el personal puede continuar trabajando en los sistemas que ya conoce, mientras que los residentes pueden usar una sola aplicación.

Cuanto mayor sea el sitio, la base de usuarios y el número de sistemas conectados, más notable será el beneficio.

¿Cómo funciona un proyecto de integración?

La organización comienza describiendo su sistema existente y el caso de uso requerido. Por ejemplo: «Ya tenemos una aplicación para residentes y queremos que los residentes respondan las llamadas del intercomunicador dentro de ella».

BAS-IP ayuda a identificar el método de integración apropiado y acordar el resultado esperado.

Para Link API y Mobile SDK, los materiales técnicos se proporcionan una vez que se haya acordado el proyecto y se haya firmado un NDA. Se crea un proyecto independiente con las especificaciones necesarias para cada socio.

La documentación de Device API está disponible públicamente.

La integración en sí es desarrollada por el equipo del socio.

BAS-IP responde a preguntas técnicas relativas a sus productos, ayuda a aclarar el escenario de integración y asiste en los casos en que una implementación basada en la documentación no se comporte como se espera.

Si un proyecto requiere una funcionalidad que no está disponible actualmente en el producto, el requisito se puede analizar con el equipo de producto de BAS-IP. Primero se evalúa el alcance del trabajo y su lugar en el plan de desarrollo. Dicha evaluación no constituye un compromiso con una fecha de lanzamiento específica.

El entorno de pruebas y los arreglos de hardware se acuerdan para cada proyecto individual.

La solución completada es probada por el socio. Una vez que se termina el desarrollo, el socio demuestra el resultado a BAS-IP o proporciona una descripción de la integración completada.

Para una integración típica, se puede utilizar alrededor de un mes de tiempo de desarrollo concentrado como guía general.

La duración total en el calendario suele ser mayor, dependiendo de la disponibilidad del equipo del socio y del tiempo necesario para familiarizarse con el sistema.

¿Cuánto cuesta la integración?

Normalmente, BAS-IP no cobra una tarifa separada por el acceso a la documentación y las herramientas de integración.

Los productos BAS-IP siguen teniendo licencia bajo sus términos de licencia estándar.

Cualquier desarrollo de producto adicional o solicitud para cambiar la prioridad de dicho trabajo se acuerda por separado.

Preguntas frecuentes

¿Cuál es la diferencia entre Link API y Mobile SDK?

Link API conecta BAS-IP con un sistema del lado del servidor, como una plataforma de gestión de propiedades o un sistema de control de acceso. Mobile SDK añade la funcionalidad de intercomunicador y apertura de puertas de BAS-IP a una aplicación móvil. Ambos se pueden utilizar juntos en el mismo proyecto.

¿Es necesario BAS-IP Link para todas las integraciones?

No. Muchos dispositivos BAS-IP tienen su propia API local, por lo que un sistema de terceros puede comunicarse con el equipo directamente. Link suele ser más útil cuando una integración necesita abarcar diferentes modelos de dispositivos, una gran cantidad de dispositivos o varios sitios.

¿Se requiere un NDA?

Se requiere un NDA para Link API y Mobile SDK. La documentación de Device API está disponible públicamente.

¿Se admiten los webhooks?

Sí, en paneles de entrada basados en Android. Un sistema de terceros puede recibir eventos del dispositivo en tiempo real. Los webhooks no están disponibles en paneles basados en Linux, monitores interiores ni a nivel de BAS-IP Link.

¿Se puede integrar una plataforma de terceros con BAS-IP Link Cloud?

Las integraciones del lado del servidor de terceros a través de Link API se implementan actualmente en Link Self-Hosted. La funcionalidad equivalente para Link Cloud está en desarrollo.

¿Cuántos desarrolladores se requieren?

Para Link API, normalmente se requerirá un desarrollador de back-end o full-stack. Para Mobile SDK, se requiere un desarrollador móvil. Las integraciones más grandes también pueden requerir experiencia en DevOps.

¿Desea integrar BAS-IP con su sistema?

Díganos qué plataforma, aplicación o equipo ya utiliza y qué desea lograr con la integración.

El equipo de BAS-IP puede ayudar a identificar el enfoque más adecuado: interoperabilidad de protocolo estándar, Link API, Mobile SDK, Device API o una combinación de estos.