Integração de Intercomunicadores IP BAS-IP com Sistemas de Edifícios Existentes

Num único local, a equipa de gestão pode trabalhar numa plataforma de gestão de propriedades, a equipa de segurança num sistema de controlo de acessos, e os residentes numa aplicação móvel separada. Se o sistema de entrada de porta (intercomunicador) continuar a ser mais uma parte isolada do edifício, os mesmos utilizadores, direitos de acesso e eventos terão de ser geridos em vários locais.

A BAS-IP pode ser integrada na infraestrutura digital existente do edifício. A plataforma de gestão de propriedades pode continuar a ser a principal interface operacional para o pessoal, enquanto a aplicação existente para residentes pode ganhar funcionalidades de intercomunicador, vídeo e abertura de porta.

Existem quatro abordagens principais: interoperabilidade através de protocolos padrão, BAS-IP Link API, BAS-IP Mobile SDK e BAS-IP Device API. A escolha certa depende do que precisa de ser integrado e de como o sistema existente funciona.

O que é o BAS-IP Link?

O BAS-IP Link é uma plataforma de software para gerir dispositivos BAS-IP ligados, locais e apartamentos, utilizadores, credenciales de acesso, chamadas e configuração de dispositivos.

Está disponível em dois modelos de implementação: Link Self-Hosted (auto-alojado), instalado na própria infraestrutura de servidores do cliente, e Link Cloud, fornecido como um serviço de nuvem (cloud) BAS-IP.

Algumas integrações funcionam através do Link, enquanto outras comunicam diretamente com o equipamento BAS-IP.

Interopérabilidade através de protocolos padrão

Nem todas as integrações exigem desenvolvimento de software.

O equipamento BAS-IP suporta protocolos padrão já amplamente utilizados em sistemas de telefonia, CCTV e controlo de acessos:

• SIP: o painel de entrada regista-se como um cliente SIP no PBX do cliente, permitindo que as chamadas sejam entregues aos telefones e softphones existentes;
• RTSP: o painel pode ser adicionado a um VMS ou NVR como uma fonte de vídeo juntamente com as outras câmaras de CCTV no local;
• Wiegand: o leitor incorporado no painel pode passar um identificador de credencial a um sistema de controlo de acessos de terceiros.

Estes cenários são configurados em ambas as extremidades e não requerem desenvolvimento com uma API ou SDK da BAS-IP.

Nota. Para integrações SIP, a compatibilidade de codecs de áudio e vídeo entre o sistema de terceiros e o equipamento BAS-IP específico deve ser verificada com antecedência. Por exemplo, o equipamento BAS-IP suporta cenários utilizando PCMA para áudio e H.264 para vídeo. O conjunto de codecs atualmente suportado deve ser sempre verificado para o modelo e versão de firmware relevantes.

Protocolos padrão podem transportar uma chamada, fluxo de vídeo ou identificador de credencial, mas não compreendem quem é o utilizador, a que apartamento pertence ou que direitos de acesso deve ter.

Quando a integração precisa de trabalhar com os próprios dados (criar utilizadores, conceder ou revogar acessos, ou recuperar eventos), é necessária uma API ou um SDK.

BAS-IP Link API: integração com uma plataforma de gestão de propriedades ou do lado do servidor

A Link API é concebida para casos em que um sistema de terceiros precisa de interagir programaticamente com o BAS-IP Link: por exemplo, uma plataforma de gestão de propriedades, um sistema de controlo de acessos ou outra plataforma empresarial já em utilização no local.

Um exemplo direto é a mudança de um residente.

Um funcionário cria o perfil do residente na plataforma existente: nome, apartamento e detalhes de contacto. Sem uma integração, o mesmo utilizador tem de ser criado manualmente uma segunda vez no sistema de intercomunicador.

Com a Link API, os dados podem ser transferidos automaticamente. O utilizador é criado no local e apartamento corretos no BAS-IP Link, a partir de onde as informações podem ser aplicadas à infraestrutura BAS-IP ligada.

Este é apenas um caso de uso possível.

Através da Link API, um sistema de terceiros pode trabalhar com:

• utilizadores e estrutura do local;
• direitos de acesso;
• credenciais de acesso permanentes, incluindo cartões, porta-chaves (fobs), códigos PIN, códigos QR, Face ID, UKEY e números de matrícula de veículos;
• credenciais temporárias com um período de validade definido;
• acesso de convidados e visitantes;
• mensagens para residentes;
• números virtuais e reencaminhamento de chamadas;
• configuração remota de dispositivos;
• eventos e registos (logs).

A funcionalidade exata utilizada depende dos requisitos do projeto.

Com esta arquitetura, a plataforma existente do cliente pode continuar a ser a interface operacional diária para o seu pessoal.

Estado atual. As integrações do lado do servidor de terceiros através da Link API são atualmente implementadas no BAS-IP Link Self-Hosted.

O suporte para o BAS-IP Link Cloud está em desenvolvimento e será fornecido através de um API gateway.

Se a intenção do projeto for utilizar o Link Cloud, o caso de uso pretendido e as opções disponíveis devem ser discutidos com a BAS-IP antes do início do desenvolvimento.

BAS-IP Mobile SDK: funcionalidade de intercomunicador dentro da sua própria aplicação móvel

O segundo cenário comum é o de uma organização que já tem a sua própria aplicação móvel para residentes, inquilinos ou funcionários.

Essa aplicação já pode lidar com pedidos de manutenção, pagamentos, reservas de comodidades e notificações. Introduzir uma aplicação separada puramente para a entrada no edifício pode, portanto, ser desnecessário.

O BAS-IP Mobile SDK adiciona as principais funções de intercomunicador, entrada de porta e acesso à aplicação existente através do BAS-IP Link, incluindo:

• autenticação de utilizadores;
• chamadas de áudio e vídeo recebidas e efetuadas;
• pré-visualização de vídeo em direto do painel de entrada antes de atender uma chamada;
• notificações push;
• abertura de porta;
• histórico de chamadas;
• acesso móvel baseado em BLE através do componente UKEY;
• chamar o elevador para o piso do residente.

Tanto iOS como Android são suportados.

O residente pode atender uma chamada do painel de entrada diretamente na aplicação que já utiliza, ver uma pré-visualização em direto do visitante antes de atender, e abrir a porta.

A equipa de desenvolvimento não precisa de construir a camada de chamadas do intercomunicador do zero. A comunicação SIP e a interação com o BAS-IP Link já são tratadas pelos componentes fornecidos; o papel do parceiro é integrar esses componentes na sua própria aplicação.

O Mobile SDK não reproduz todas as funcionalidades disponíveis na aplicação BAS-IP Link. Fornece um conjunto definido de capacidades prontas a utilizar.

Se uma função necessária não estiver incluída no SDK (por exemplo, gerar códigos QR de convidados), o parceiro pode implementá-la na sua própria aplicação utilizando chamadas diretas à Link API.

Estado atual. As integrações do Mobile SDK são implementadas no BAS-IP Link Self-Hosted.

Os projetos que exijam o BAS-IP Link Cloud devem ser planeados após a disponibilização do Cloud API gateway.

BAS-IP Device API: integração direta com equipamento

Nem todas as integrações requerem o BAS-IP Link.

Os painéis de entrada BAS-IP, os monitores de interior e outros dispositivos suportados, incluindo o módulo de elevador, têm as suas próprias APIs locais. Um sistema de terceiros pode, portanto, comunicar diretamente com o equipamento.

A distinção é simples:

• A Device API liga o seu sistema diretamente a dispositivos BAS-IP específicos.
• A Link API liga o seu sistema ao BAS-IP Link, que por sua vez gere o equipamento BAS-IP ligado.

A integração direta de dispositivos adequa-se bem a um projeto local com uma gama limitada e conhecida de modelos de dispositivos.

A integração através do Link é geralmente mais adequada quando a solução abrange diferentes modelos, um número maior de dispositivos ou vários locais, porque o Link reduz a dependência da integração em relação às especificidades dos modelos de dispositivos e versões de firmware individuais.

O acesso à Device API é mais simples: a documentação está disponível publicamente e não é necessário NDA.

Os programadores podem registar-se através do portal para programadores da BAS-IP e confirmar o seu endereço de e-mail.

Webhooks

Os painéis de entrada BAS-IP baseados em Android também suportam webhooks.

Isto permite que um sistema de terceiros receba eventos à medida que ocorrem, incluindo a abertura de porta, acesso concedido ou negado, atualizações do dispositivo e outros eventos registados no registo (log) do dispositivo.

Isto é útil em cenários de edifícios inteligentes (smart buildings) onde outro sistema precisa de reagir imediatamente a um evento de acesso ou à abertura de uma porta.

Os webhooks são configurados diretamente no painel de entrada através da configuração do dispositivo.

Não são suportados em painéis baseados em Linux, monitores de interior ou ao nível do BAS-IP Link.

Que abordagem de integração deve escolher?

Não necessita necessariamente de escolher o método de integração com antecedência. Na maioria dos casos, a abordagem certa torna-se clara assim que o sistema existente e o caso de uso pretendido tenham sido descritos.

O que proporciona a integração no local?

• Configuração inicial mais rápida: os dados dos utilizadores e parâmetros relacionados podem ser transferidos do sistema onde já são mantidos.
• Menos introdução de dados duplicados: a mesma informação não tem de ser introduzida repetidamente em interfaces diferentes.
• Dados operacionais unificados: eventos de intercomunicador, entrada de portas e acessos podem ser reunidos com outras informações do local.
• Fluxos de trabalho familiares: o pessoal pode continuar a trabalhar nos sistemas que já conhece, enquanto os residentes podem usar uma única aplicação.

Quanto maior for o local, a base de utilizadores e o número de sistemas ligados, mais percetível se torna o benefício.

Como funciona um projeto de integração?

A organização começa por descrever o seu sistema existente e o caso de uso necessário. Por exemplo: “Já temos uma aplicação para residentes e queremos que os residentes atendam as chamadas do intercomunicador dentro dela.”

A BAS-IP ajuda a identificar o método de integração apropriado e a concordar com o resultado esperado.

Para a Link API e o Mobile SDK, os materiais técnicos são fornecidos uma vez que o projeto tenha sido acordado e um NDA tenha sido assinado. É criado um projeto separado com as especificações necessárias para cada parceiro.

A documentação da Device API está disponível ao público.

A integração em si é desenvolvida pela equipa do parceiro.

A BAS-IP responde a questões técnicas relativas aos seus produtos, ajuda a clarificar o cenário de integração e auxilia onde uma implementação baseada na documentação não se comporte como o esperado.

Se um projeto exigir funcionalidades não disponíveis atualmente no produto, o requisito pode ser discutido com a equipa de produto da BAS-IP. O âmbito do trabalho e o seu lugar no plano de desenvolvimento são avaliados primeiro. Essa avaliação não constitui um compromisso para uma data de lançamento específica.

O ambiente de teste e os arranjos de hardware são acordados para cada projeto individual.

A solução concluída é testada pelo parceiro. Terminada a fase de desenvolvimento, o parceiro demonstra o resultado à BAS-IP ou fornece uma descrição da integração concluída.

Para uma integração típica, cerca de um mês de tempo focado no desenvolvimento pode ser usado como um guia genérico.

A duração total no calendário é geralmente maior, dependendo da disponibilidade da equipa do parceiro e do tempo necessário para se familiarizar com o sistema.

Quanto custa a integração?

Normalmente, a BAS-IP não cobra uma taxa separada pelo acesso à documentação e ferramentas de integração.

Os produtos BAS-IP continuam a ser licenciados de acordo com os seus termos de licenciamento padrão.

Qualquer desenvolvimento adicional de produtos ou pedidos para alterar a prioridade de tal trabalho são acordados em separado.

Perguntas frequentes

Qual é a diferença entre a Link API e o Mobile SDK?

A Link API liga o BAS-IP a um sistema do lado do servidor (server-side), como uma plataforma de gestão de propriedades ou um sistema de controlo de acessos. O Mobile SDK adiciona as funções de intercomunicador e abertura de porta da BAS-IP a uma aplicação móvel. Ambos podem ser usados em conjunto dentro do mesmo projeto.

O BAS-IP Link é necessário para todas as integrações?

Não. Muitos dispositivos BAS-IP têm a sua própria API local, permitindo que um sistema de terceiros comunique diretamente com o equipamento. O Link é geralmente mais útil quando uma integração precisa de abranger diferentes modelos de dispositivos, um grande número de dispositivos ou vários locais.

É necessário um NDA?

É necessário um NDA para a Link API e para o Mobile SDK. A documentação da Device API está publicamente disponível.

Os webhooks são suportados?

Sim, em painéis de entrada baseados em Android. Um sistema de terceiros pode receber eventos do dispositivo em tempo real. Os webhooks não estão disponíveis em painéis baseados em Linux, monitores de interior ou ao nível do BAS-IP Link.

Uma plataforma de terceiros pode ser integrada no BAS-IP Link Cloud?

As integrações do lado do servidor de terceiros através da Link API estão atualmente implementadas no Link Self-Hosted. Funcionalidade equivalente para o Link Cloud está em desenvolvimento.

Quantos programadores são necessários?

Para a Link API, será normalmente necessário um programador back-end ou full-stack. Para o Mobile SDK, é necessário um programador mobile. Integrações de maior dimensão podem também exigir conhecimentos de DevOps.

Quer integrar o BAS-IP com o seu sistema?

Diga-nos que plataforma, aplicação ou equipamento já utiliza e o que pretende que a integração alcance.

A equipa da BAS-IP pode ajudar a identificar a abordagem mais adequada: interoperabilidade através de protocolo padrão, Link API, Mobile SDK, Device API, ou uma combinação destes.