En una misma instalación, la empresa de gestión trabaja en una plataforma de gestión inmobiliaria, el equipo de seguridad en un sistema de control de acceso (SCA) y los residentes en una aplicación móvil independiente. Si la intercomunicación sigue siendo un sistema aislado más, los mismos usuarios, derechos de acceso y eventos tendrán que gestionarse en varios lugares a la vez.

BAS-IP puede integrarse en la infraestructura digital del edificio que ya se está utilizando. La plataforma de gestión sigue siendo la interfaz de trabajo principal para el personal, y la aplicación existente para los residentes adquiere las funciones de intercomunicación y apertura de puertas.

Hay cuatro formas de hacerlo: compatibilidad mediante protocolos estándar, BAS-IP Link API, BAS-IP Mobile SDK y BAS-IP Device API. A continuación, explicamos qué se adapta a cada tarea.

Qué es BAS-IP Link

BAS-IP Link es una plataforma de software que gestiona los dispositivos BAS-IP conectados, los edificios y apartamentos, los usuarios, los identificadores de acceso, las llamadas y la configuración de los equipos.

Está disponible en dos versiones: Link Self-Hosted en el servidor del cliente y Link Cloud como servicio en la nube de BAS-IP.

Compatibilidad mediante protocolos estándar

No todas las tareas requieren desarrolladores. Los equipos BAS-IP funcionan con los mismos protocolos estándar que la telefonía, la videovigilancia y los sistemas de control de acceso:

• SIP — el panel se registra como un cliente SIP en la centralita (PBX) del cliente, y las llamadas llegan a los teléfonos y softphones existentes;
• RTSP — el panel se conecta al VMS o NVR como una fuente de vídeo junto con las demás cámaras de la instalación;
• Wiegand — el lector del panel transmite el identificador a un sistema de control de acceso de terceros.

Estos escenarios se configuran en ambos lados y no requieren trabajar con la API ni con el SDK de BAS-IP.

Nota. Para el escenario SIP, es necesario comprobar de antemano la compatibilidad de los códecs de audio y vídeo del sistema de terceros con el equipo BAS-IP específico. Por ejemplo, el equipo BAS-IP admite escenarios con PCMA para audio y H.264 para vídeo. El conjunto actual de códecs debe verificarse para el modelo y la versión de firmware específicos.

Los protocolos estándar permiten la transmisión de llamadas, flujos de vídeo e identificadores, pero por sí solos no garantizan la sincronización de usuarios, apartamentos y derechos de acceso entre los sistemas.

Si es necesario automatizar la gestión de usuarios, la emisión y revocación de los derechos de acceso o el trabajo con registros de eventos, se utilizan API o SDK.

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

Link API permite automatizar la gestión de residentes, los derechos de acceso y los eventos de BAS-IP a través de la plataforma de gestión inmobiliaria, el SCA u otro sistema corporativo que ya se utilice.

Un ejemplo sencillo es la mudanza de un residente.

Un empleado crea un perfil en su plataforma: nombre, apartamento y datos de contacto. Sin integración, este mismo usuario se añade manualmente por segunda vez al sistema de intercomunicación.

A través de Link API, los datos se transmiten automáticamente: el usuario aparece en la instalación y el apartamento correctos en BAS-IP Link, y a partir de ahí la información se aplica a la infraestructura BAS-IP conectada.

Este es solo uno de los escenarios.

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

• los usuarios y la estructura de las instalaciones;
• los derechos de acceso;
• los identificadores permanentes: tarjetas, llaveros, códigos, códigos QR, Face ID, UKEY y matrículas de vehículos;
• los identificadores temporales con un periodo de validez limitado;
• el acceso para invitados y visitantes;
• los mensajes para los residentes;
• los números virtuales y el desvío de llamadas;
• la configuración remota de los dispositivos;
• los eventos y registros.

El conjunto específico depende de la tarea.

En este esquema, la plataforma principal del cliente puede seguir siendo la interfaz de trabajo de sus empleados.

Actualmente, las integraciones de servidores de terceros a través de Link API son compatibles con BAS-IP Link Self-Hosted. Para proyectos en Link Cloud, las opciones de integración disponibles deben acordarse con BAS-IP.

BAS-IP Mobile SDK: intercomunicación dentro de su propia aplicación

El segundo escenario: la empresa ya tiene una aplicación móvil para los residentes, inquilinos o empleados.

Esta puede incluir solicitudes a la empresa de gestión, pagos, reserva de espacios y notificaciones. Una aplicación independiente solo para la intercomunicación en esta situación podría ser redundante.

BAS-IP Mobile SDK permite integrar un amplio conjunto de funciones de intercomunicación y control de acceso a través de BAS-IP Link en una aplicación existente. Las funciones disponibles incluyen:

• la autorización del usuario;
• recibir y realizar llamadas de audio y vídeo;
• la visualización de vídeo del panel antes de responder a la llamada;
• las notificaciones push;
• la apertura de la puerta;
• el historial de llamadas;
• el acceso móvil a través de BLE mediante el componente UKEY;
• la llamada al ascensor al piso autorizado si hay un módulo de ascensor BAS-IP configurado.

Compatible con iOS y Android.

El residente recibe la llamada del panel directamente en la aplicación que ya utiliza, puede ver al visitante incluso antes de contestar y abrir la puerta.

El desarrollador no necesita construir el módulo de intercomunicación desde cero: los detalles de la comunicación SIP y la interacción con BAS-IP Link ya están implementados en componentes listos para usar, y la tarea del equipo del socio es integrarlos en su aplicación.

Mobile SDK no reproduce toda la funcionalidad de la aplicación BAS-IP Link, sino que proporciona un conjunto específico de características listas para usar.

Algunas funciones que faltan en Mobile SDK están disponibles a través de BAS-IP Link API. Por ejemplo, la creación de códigos QR para invitados y la reserva de espacios pueden implementarse en la aplicación del socio a través de una integración adicional con Link API.

La integración de aplicaciones móviles de terceros a través de Mobile SDK actualmente es compatible con BAS-IP Link Self-Hosted.

BAS-IP Device API: trabajo directo con el equipo

No todas las integraciones requieren BAS-IP Link.

Las placas de calle, los monitores interiores y otros dispositivos BAS-IP compatibles, incluido el módulo de ascensor, tienen su propia API local, por lo que un sistema de terceros puede acceder directamente al equipo.

La diferencia es sencilla:

• Device API conecta su sistema directamente a dispositivos BAS-IP específicos.
• Link API conecta su sistema a BAS-IP Link, que ya gestiona los equipos conectados.

El trabajo directo con los dispositivos es adecuado para un proyecto local con un conjunto de modelos limitado y conocido de antemano.

La integración a través de Link es más conveniente cuando el sistema abarca diferentes modelos, un gran número de dispositivos o varias instalaciones: Link reduce la dependencia de la integración de las características de los modelos individuales y sus firmwares.

El acceso a Device API es más fácil de obtener: la documentación está abierta y no se requiere NDA. Basta con registrarse en el portal de desarrolladores de BAS-IP — developers.bas-ip.com — y confirmar el correo electrónico.

Webhooks

Los paneles Android de BAS-IP admiten webhooks de forma adicional.

El sistema externo recibe los eventos en el momento en que ocurren: apertura de puerta, concesión o denegación de acceso, actualización del dispositivo y otros eventos del registro.

Esto es conveniente para los escenarios de edificios inteligentes, en los que otro sistema tiene que reaccionar al paso o a la apertura de una puerta.

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

En los paneles Linux, los monitores y en el nivel de BAS-IP Link, los webhooks no son compatibles.

Qué método de integración elegir

No es obligatorio definir el enfoque por adelantado. En la mayoría de los casos, queda claro una vez que se describen el sistema existente y el escenario deseado.

Qué aporta esto a la instalación

• Configuración inicial más rápida: los datos de los usuarios y los parámetros asociados a ellos pueden transferirse desde el sistema donde ya se mantienen.
• Menos introducción duplicada de datos: los mismos datos no tienen que introducirse en múltiples interfaces.
• Datos globales de la instalación: los eventos de intercomunicación y acceso pueden recopilarse junto con el resto de la información.
• Procesos de trabajo habituales: el personal sigue trabajando en el sistema al que está acostumbrado, y los residentes en una única aplicación.

Cuanto mayor sea la instalación, el número de usuarios y los sistemas conectados, más notable será el efecto.

Cómo se lleva a cabo la integración

El trabajo comienza con la discusión de la tarea. El socio explica qué sistema utiliza y qué desea implementar. Por ejemplo, recibir llamadas de los intercomunicadores BAS-IP en su propia aplicación para residentes o transferir automáticamente los datos de los nuevos usuarios desde la plataforma de gestión inmobiliaria. En función de estos requisitos, BAS-IP ayuda a elegir el método de integración adecuado y a acordar cómo debe funcionar la solución final.

Una vez definido el escenario, el equipo del socio recibe los materiales técnicos necesarios y puede iniciar el desarrollo. Para trabajar con Link API y Mobile SDK se firma previamente un NDA, mientras que la documentación de Device API está abierta. Las condiciones para proporcionar el entorno de prueba, las licencias y los equipos se discuten teniendo en cuenta las características específicas del proyecto.

La propia integración es desarrollada por el equipo del socio, mientras que los especialistas de BAS-IP asesoran sobre el funcionamiento de sus productos y ayudan a resolver las dudas técnicas durante el proceso. Si las funciones existentes de BAS-IP no son suficientes para el escenario deseado, puede discutirse un desarrollo adicional. Los plazos para este tipo de modificaciones dependen de la carga de trabajo y las prioridades actuales del equipo de producto.

Una vez finalizado el desarrollo, el socio prueba la integración en su entorno y luego demuestra el resultado a BAS-IP o proporciona una descripción de la solución implementada.

La duración de la integración depende de la complejidad del proyecto, de la arquitectura del sistema de terceros y de la carga de trabajo del equipo de desarrollo. Los plazos también se ven afectados por la preparación del entorno de desarrollo y las pruebas.

Cuánto cuesta

Por defecto, BAS-IP no cobra tarifas adicionales por el acceso a la documentación y a las herramientas de integración.

La concesión de licencias para los productos BAS-IP se realiza en condiciones estándar, y los desarrollos adicionales o el cambio en sus prioridades se acuerdan por separado.

Preguntas frecuentes

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

Link API conecta BAS-IP con un sistema de servidor (por ejemplo, una plataforma de gestión inmobiliaria o un SCA). Mobile SDK añade funciones de intercomunicación a una aplicación móvil. Pueden utilizarse conjuntamente en el mismo proyecto.

¿Es necesario BAS-IP Link para la integración?

No siempre. Muchos dispositivos BAS-IP tienen su propia API local, de modo que un sistema de terceros puede trabajar directamente con el equipo. Link suele ser más conveniente cuando la integración abarca diferentes modelos, muchos dispositivos o varias instalaciones.

¿Se requiere un NDA?

Se requiere un NDA para Link API y Mobile SDK. La documentación de Device API está abierta.

¿Hay webhooks?

Sí, en los paneles Android. El sistema externo puede recibir los eventos del dispositivo en tiempo real. En los paneles Linux, los monitores y a nivel de Link, no hay webhooks.

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

Las integraciones externas de sistemas de servidores de terceros a través de Link API se implementan actualmente en Link Self-Hosted. Para Link Cloud, esta función está en desarrollo.

¿Desea integrar BAS-IP en su sistema?

Díganos qué plataforma, aplicación o equipo utiliza y qué escenario desea implementar.

El equipo de BAS-IP le ayudará a determinar la opción adecuada: compatibilidad de protocolos, Link API, Mobile SDK, Device API o una combinación de ellas.