Em uma única instalação, a empresa de gestão trabalha em uma plataforma de gestão imobiliária, a equipe de segurança em um sistema de controle de acesso (SCA) e os residentes em um aplicativo móvel separado. Se a interfonia continuar sendo mais um sistema isolado, os mesmos usuários, direitos de acesso e eventos terão que ser gerenciados em vários lugares ao mesmo tempo.

O BAS-IP pode ser incorporado à infraestrutura digital do edifício que já está em uso. A plataforma de gestão continua sendo a principal interface de trabalho para a equipe, e o aplicativo existente para os residentes ganha funções de interfonia e abertura de portas.

Existem quatro maneiras de fazer isso: compatibilidade por meio de protocolos padrão, BAS-IP Link API, BAS-IP Mobile SDK e BAS-IP Device API. Abaixo, explicamos o que se adequa a cada tarefa.

O que é o BAS-IP Link

O BAS-IP Link é uma plataforma de software que gerencia os dispositivos BAS-IP conectados, edifícios e apartamentos, usuários, identificadores de acesso, chamadas e a configuração dos equipamentos.

Está disponível em duas versões: Link Self-Hosted no servidor do cliente e Link Cloud como um serviço em nuvem BAS-IP.

Compatibilidade por meio de protocolos padrão

Nem toda tarefa requer desenvolvedores. Os equipamentos BAS-IP funcionam com os mesmos protocolos padrão que a telefonia, o monitoramento de vídeo e os sistemas de controle de acesso:

• SIP — o painel é registrado como um cliente SIP no PBX do cliente, e as chamadas chegam aos telefones e softphones existentes;
• RTSP — o painel se conecta ao VMS ou NVR como uma fonte de vídeo junto com as outras câmeras do local;
• Wiegand — o leitor do painel transmite o identificador para um sistema de controle de acesso de terceiros.

Esses cenários são configurados em ambos os lados e não exigem trabalho com a API ou o SDK do BAS-IP.

Nota. Para o cenário SIP, é necessário verificar previamente a compatibilidade dos codecs de áudio e vídeo do sistema de terceiros com o equipamento específico da BAS-IP. Por exemplo, o equipamento BAS-IP suporta cenários com PCMA para áudio e H.264 para vídeo. O conjunto atual de codecs deve ser verificado para o modelo específico e a versão do firmware.

Os protocolos padrão permitem transmitir chamadas, fluxos de vídeo e identificadores, mas sozinhos não garantem a sincronização de usuários, apartamentos e direitos de acesso entre os sistemas.

Se for necessário automatizar a gestão de usuários, a emissão e revogação de direitos de acesso ou o trabalho com registros de eventos, são utilizados APIs ou SDKs.

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

A Link API permite automatizar o gerenciamento de residentes, direitos de acesso e eventos BAS-IP por meio da plataforma de gestão imobiliária, SCA ou outro sistema corporativo já em uso.

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

Um funcionário cria um perfil em sua plataforma: nome, apartamento e informações de contato. Sem integração, esse mesmo usuário é adicionado manualmente pela segunda vez ao sistema de interfone.

Por meio da Link API, os dados são transmitidos automaticamente: o usuário aparece na instalação e no apartamento corretos no BAS-IP Link, e a partir daí as informações são aplicadas à infraestrutura BAS-IP conectada.

Esse é apenas um dos cenários.

Por meio da Link API, um sistema de terceiros pode trabalhar com:

• usuários e estrutura das instalações;
• direitos de acesso;
• identificadores permanentes: cartões, chaveiros, códigos, QR codes, Face ID, UKEY e placas de veículos;
• identificadores temporários com tempo de validade limitado;
• acesso para convidados e visitantes;
• mensagens para os residentes;
• números virtuais e redirecionamento de chamadas;
• configuração remota dos dispositivos;
• eventos e registros.

O conjunto específico depende da tarefa.

Nesse esquema, a plataforma principal do cliente pode permanecer como a interface de trabalho de seus funcionários.

Atualmente, integrações de servidores de terceiros por meio da Link API são suportadas no BAS-IP Link Self-Hosted. Para projetos no Link Cloud, as opções de integração disponíveis precisam ser acordadas com a BAS-IP.

BAS-IP Mobile SDK: interfonia dentro do seu próprio aplicativo

O segundo cenário — a empresa já possui um aplicativo móvel para os residentes, inquilinos ou funcionários.

Este aplicativo pode incluir solicitações à empresa de gestão, pagamentos, reserva de espaços e notificações. Um aplicativo separado apenas para o interfone em uma situação assim pode ser redundante.

O BAS-IP Mobile SDK permite incorporar um amplo conjunto de funções de interfonia e controle de acesso em um aplicativo existente por meio do BAS-IP Link. Os recursos disponíveis incluem:

• autorização do usuário;
• receber e fazer chamadas de áudio e vídeo;
• visualização de vídeo do painel antes de atender a chamada;
• notificações push;
• abertura de portas;
• histórico de chamadas;
• acesso móvel via BLE por meio do componente UKEY;
• chamada do elevador para o andar permitido se houver um módulo de elevador BAS-IP configurado.

São suportados iOS e Android.

O residente atende a chamada do painel diretamente no aplicativo que já utiliza, pode ver o visitante mesmo antes de atender e abrir a porta.

O desenvolvedor não precisa construir o módulo de interfonia do zero: os detalhes da comunicação SIP e da interação com o BAS-IP Link já estão implementados em componentes prontos, e a tarefa da equipe do parceiro é integrá-los ao seu aplicativo.

O Mobile SDK não replica toda a funcionalidade do aplicativo BAS-IP Link, mas fornece um conjunto específico de recursos prontos para uso.

Algumas funções, que estão ausentes no Mobile SDK, estão disponíveis por meio da BAS-IP Link API. Por exemplo, a criação de QR codes para convidados e a reserva de espaços podem ser implementadas no aplicativo do parceiro por meio de uma integração adicional com a Link API.

A integração de aplicativos móveis de terceiros por meio do Mobile SDK é atualmente suportada no BAS-IP Link Self-Hosted.

BAS-IP Device API: trabalho direto com o equipamento

Nem toda integração requer o BAS-IP Link.

Os painéis de chamada, monitores internos e outros dispositivos BAS-IP suportados, incluindo o módulo de elevador, possuem sua própria API local, de modo que um sistema de terceiros pode acessar o equipamento diretamente.

A diferença é simples:

• Device API conecta seu sistema diretamente a dispositivos BAS-IP específicos.
• Link API conecta seu sistema ao BAS-IP Link, que já gerencia os equipamentos conectados.

O trabalho direto com os dispositivos é adequado para um projeto local com um conjunto limitado e previamente conhecido de modelos.

A integração por meio do Link é mais conveniente quando o sistema abrange diferentes modelos, um grande número de dispositivos ou várias instalações: o Link reduz a dependência da integração em relação às características de modelos individuais e de seus firmwares.

O acesso à Device API é mais fácil de obter: a documentação é aberta e nenhum NDA é necessário. Basta registrar-se no portal de desenvolvedores da BAS-IP — developers.bas-ip.com — e confirmar o e-mail.

Webhooks

Os painéis Android da BAS-IP suportam webhooks de forma adicional.

O sistema externo recebe eventos no momento em que ocorrem: abertura de porta, concessão ou negação de acesso, atualização do dispositivo e outros eventos de registro.

Isso é conveniente para cenários de edifícios inteligentes, onde outro sistema precisa reagir à passagem ou à abertura de uma porta.

Os webhooks são configurados diretamente no painel por meio da configuração do dispositivo.

Em painéis Linux, monitores e no nível do BAS-IP Link, os webhooks não são suportados.

Qual método de integração escolher

Não é obrigatório definir a abordagem com antecedência. Na maioria das vezes, ela se torna clara depois que o sistema existente e o cenário desejado são descritos.

O que isso traz para as instalações

• Configuração inicial mais rápida: os dados dos usuários e os parâmetros associados a eles podem ser transmitidos a partir do sistema onde já são mantidos.
• Menos entradas repetidas: os mesmos dados não precisam ser inseridos em várias interfaces.
• Dados globais das instalações: os eventos de interfonia e de acesso podem ser coletados juntamente com as demais informações.
• Processos de trabalho familiares: a equipe continua trabalhando no sistema familiar, e os residentes em um único aplicativo.

Quanto maior for a instalação, o número de usuários e os sistemas conectados, mais perceptível será o efeito.

Como ocorre a integração

O trabalho começa com a discussão da tarefa. O parceiro explica qual sistema utiliza e o que deseja realizar. Por exemplo, aceitar chamadas dos interfones BAS-IP em seu próprio aplicativo para residentes ou transmitir automaticamente os dados de novos usuários da plataforma de gestão imobiliária. Com base nesses requisitos, a BAS-IP ajuda a escolher o método de integração apropriado e a concordar sobre como a solução final deve funcionar.

Quando o cenário é definido, a equipe do parceiro recebe os materiais técnicos necessários e pode iniciar o desenvolvimento. Para trabalhar com a Link API e o Mobile SDK, um NDA é previamente assinado, enquanto a documentação da Device API é aberta. As condições de fornecimento do ambiente de teste, licenças e equipamentos são discutidas levando em conta as especificidades do projeto.

A própria integração é desenvolvida pela equipe do parceiro, e os especialistas da BAS-IP prestam consultoria sobre o funcionamento de seus produtos e ajudam a resolver problemas técnicos ao longo do caminho. Se as capacidades existentes da BAS-IP não forem suficientes para o cenário desejado, um desenvolvimento adicional pode ser discutido. Os prazos para tais modificações dependem da carga de trabalho e das prioridades atuais da equipe de produto.

Após a conclusão do desenvolvimento, o parceiro testa a integração em seu ambiente e, em seguida, demonstra o resultado à BAS-IP ou fornece uma descrição da solução implementada.

A duração da integração depende da complexidade do projeto, da arquitetura do sistema de terceiros e da carga de trabalho da equipe de desenvolvimento. O cronograma também é afetado pela preparação do ambiente de desenvolvimento e pelos testes.

Quanto custa

Por padrão, a BAS-IP não cobra taxas separadas pelo acesso à documentação e às ferramentas de integração.

O licenciamento dos produtos BAS-IP é feito em condições padrão, e modificações adicionais ou mudanças em suas prioridades são acordadas separadamente.

Perguntas frequentes

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

A Link API conecta o BAS-IP a um sistema de servidor — por exemplo, uma plataforma de gestão imobiliária ou um SCA. O Mobile SDK adiciona funções de interfone a um aplicativo móvel. Em um projeto, eles podem ser usados juntos.

O BAS-IP Link é necessário para a integração?

Nem sempre. Muitos dispositivos BAS-IP têm sua própria API local, de modo que um sistema de terceiros pode trabalhar diretamente com o equipamento. O Link geralmente é mais conveniente quando a integração abrange diferentes modelos, muitos dispositivos ou várias instalações.

É necessário um NDA?

O NDA é necessário para a Link API e para o Mobile SDK. A documentação da Device API é aberta.

Existem webhooks?

Sim, em painéis Android. O sistema externo pode receber os eventos do dispositivo em tempo real. Em painéis Linux, monitores e no nível do Link, não há webhooks.

É possível integrar uma plataforma de terceiros com o BAS-IP Link Cloud?

As integrações externas de sistemas de servidores de terceiros por meio da Link API são atualmente implementadas no Link Self-Hosted. Para o Link Cloud, essa capacidade está em desenvolvimento.

Deseja integrar o BAS-IP ao seu sistema?

Diga-nos qual plataforma, aplicativo ou equipamento você utiliza e qual cenário deseja realizar.

A equipe da BAS-IP ajudará você a determinar a opção adequada: compatibilidade de protocolos, Link API, Mobile SDK, Device API ou uma combinação deles.