Sur un même site, la société de gestion travaille sur une plateforme de gestion immobilière, le service de sécurité sur un système de contrôle d’accès (SCA) et les résidents sur une application mobile dédiée. Si l’interphonie reste un système isolé de plus, les mêmes utilisateurs, les droits d’accès et les événements doivent être gérés dans plusieurs endroits à la fois.

BAS-IP peut être intégré à l’infrastructure numérique du bâtiment déjà utilisée. La plateforme de gestion reste l’interface de travail principale pour le personnel, et l’application existante pour les résidents se dote des fonctions d’interphonie et d’ouverture de porte.

Il existe quatre façons de procéder : la compatibilité via les protocoles standards, BAS-IP Link API, BAS-IP Mobile SDK et BAS-IP Device API. Voici ce qui convient pour chaque tâche.

Qu’est-ce que BAS-IP Link

BAS-IP Link est une plateforme logicielle qui gère les appareils connectés BAS-IP, les bâtiments et les appartements, les utilisateurs, les identifiants d’accès, les appels et la configuration des équipements.

Elle est disponible en deux versions : Link Self-Hosted sur le serveur du client et Link Cloud en tant que service cloud BAS-IP.

Compatibilité via les protocoles standards

Les développeurs ne sont pas nécessaires pour toutes les tâches. Les équipements BAS-IP fonctionnent avec les mêmes protocoles standards que la téléphonie, la vidéosurveillance et les systèmes de contrôle d’accès :

• SIP — la platine s’enregistre en tant que client SIP sur le PBX du client, et les appels arrivent sur les téléphones et softphones existants ;
• RTSP — la platine se connecte au VMS ou au NVR comme source vidéo avec les autres caméras du site ;
• Wiegand — le lecteur de la platine transmet l’identifiant à un système de contrôle d’accès tiers.

Ces scénarios sont configurés des deux côtés et ne nécessitent pas de travailler avec l’API ou le SDK BAS-IP.

Remarque. Pour le scénario SIP, il est nécessaire de vérifier au préalable la compatibilité des codecs audio et vidéo du système tiers avec l’équipement spécifique BAS-IP. Par exemple, l’équipement BAS-IP prend en charge les scénarios avec PCMA pour l’audio et H.264 pour la vidéo. L’ensemble actuel de codecs doit être vérifié pour un modèle et une version de firmware spécifiques.

Les protocoles standards permettent de transmettre des appels, des flux vidéo et des identifiants, mais ils n’assurent pas à eux seuls la synchronisation des utilisateurs, des appartements et des droits d’accès entre les systèmes.

S’il est nécessaire d’automatiser la gestion des utilisateurs, l’attribution et la révocation des droits d’accès ou le travail avec les journaux d’événements, des API ou des SDK sont utilisés.

BAS-IP Link API : intégration avec une plateforme de gestion ou de serveur

Link API permet d’automatiser la gestion des résidents, des droits d’accès et des événements BAS-IP via la plateforme de gestion immobilière, le SCA ou toute autre plateforme d’entreprise déjà utilisée.

Un exemple simple est l’emménagement d’un résident.

Un employé crée un profil sur sa plateforme : nom, appartement et coordonnées. Sans intégration, ce même utilisateur est saisi manuellement une seconde fois dans le système d’interphonie.

Via Link API, les données sont transmises automatiquement : l’utilisateur apparaît dans le bâtiment et l’appartement appropriés dans BAS-IP Link, et à partir de là, les informations sont appliquées à l’infrastructure BAS-IP connectée.

Ce n’est qu’un des scénarios.

Via Link API, un système tiers peut travailler avec :

• les utilisateurs et la structure des bâtiments ;
• les droits d’accès ;
• les identifiants permanents : cartes, badges, codes, codes QR, Face ID, UKEY et numéros d’immatriculation ;
• les identifiants temporaires avec une durée de validité limitée ;
• l’accès pour les invités et les visiteurs ;
• les messages pour les résidents ;
• les numéros virtuels et le renvoi d’appels ;
• la configuration à distance des appareils ;
• les événements et les journaux.

L’ensemble spécifique dépend de la tâche.

Avec un tel schéma, la plateforme principale du client peut rester l’interface de travail de ses employés.

Actuellement, les intégrations de serveurs tiers via Link API sont prises en charge dans BAS-IP Link Self-Hosted. Pour les projets sur Link Cloud, les options d’intégration disponibles doivent être convenues avec BAS-IP.

BAS-IP Mobile SDK : l’interphonie au sein de votre propre application

Le deuxième scénario — l’entreprise dispose déjà d’une application mobile pour les résidents, les locataires ou les employés.

Celle-ci peut inclure des demandes à la société de gestion, des paiements, la réservation de locaux et des notifications. Une application séparée uniquement pour l’interphonie dans une telle situation peut être superflue.

BAS-IP Mobile SDK permet d’intégrer à une application existante un large éventail de fonctions d’interphonie et de contrôle d’accès via BAS-IP Link. Parmi les possibilités :

• l’autorisation de l’utilisateur ;
• la réception et l’émission d’appels audio et vidéo ;
• la visualisation de la vidéo de la platine avant de répondre à l’appel ;
• les notifications push ;
• l’ouverture de la porte ;
• l’historique des appels ;
• l’accès mobile via BLE grâce au composant UKEY ;
• l’appel de l’ascenseur vers l’étage autorisé s’il y a un module d’ascenseur BAS-IP configuré.

iOS et Android sont pris en charge.

Le résident reçoit l’appel de la platine directement dans l’application qu’il utilise déjà, peut voir le visiteur avant même de répondre et ouvrir la porte.

Le développeur n’a pas besoin de créer le module d’interphonie à partir de zéro : les détails de la communication SIP et de l’interaction avec BAS-IP Link sont déjà implémentés dans des composants prêts à l’emploi, et la tâche de l’équipe partenaire est de les intégrer à son application.

Mobile SDK ne reproduit pas toutes les fonctionnalités de l’application BAS-IP Link, mais fournit un ensemble de fonctionnalités prêtes à l’emploi.

Certaines fonctions absentes de Mobile SDK sont disponibles via BAS-IP Link API. Par exemple, la création de codes QR pour les invités et la réservation de locaux peuvent être mises en œuvre dans l’application partenaire via une intégration supplémentaire avec Link API.

L’intégration d’applications mobiles tierces via Mobile SDK est actuellement prise en charge dans BAS-IP Link Self-Hosted.

BAS-IP Device API : travail direct avec l’équipement

Toutes les intégrations ne nécessitent pas BAS-IP Link.

Les platines de rue, les moniteurs intérieurs et d’autres appareils pris en charge par BAS-IP, y compris le module d’ascenseur, disposent de leur propre API locale, de sorte qu’un système tiers peut accéder directement à l’équipement.

La différence est simple :

• Device API connecte votre système directement à des appareils BAS-IP spécifiques.
• Link API connecte votre système à BAS-IP Link, qui gère déjà l’équipement connecté.

Le travail direct avec les appareils convient à un projet local avec un ensemble de modèles limité et connu à l’avance.

L’intégration via Link est plus pratique lorsque le système couvre différents modèles, un grand nombre d’appareils ou plusieurs bâtiments : Link réduit la dépendance de l’intégration aux caractéristiques de modèles individuels et de leurs firmwares.

L’accès à Device API est plus facile à obtenir : la documentation est ouverte, aucun NDA n’est requis. Il suffit de s’inscrire sur le portail des développeurs BAS-IP — developers.bas-ip.com — et de confirmer l’email.

Webhooks

Les platines Android BAS-IP prennent en charge les webhooks en plus.

Le système externe reçoit les événements au moment où ils se produisent : ouverture de porte, accès accordé ou refusé, mise à jour de l’appareil et autres événements du journal.

C’est pratique pour les scénarios de bâtiments intelligents, où un autre système doit réagir à un passage ou à l’ouverture d’une porte.

Les webhooks sont configurés directement sur la platine via la configuration de l’appareil.

Sur les platines Linux, les moniteurs et au niveau de BAS-IP Link, les webhooks ne sont pas pris en charge.

Quelle méthode d’intégration choisir

Il n’est pas obligatoire de définir l’approche à l’avance. Le plus souvent, elle devient claire après avoir décrit le système existant et le scénario souhaité.

Ce que cela apporte sur le site

• Configuration initiale plus rapide : les données des utilisateurs et les paramètres associés peuvent être transmis depuis le système où ils sont déjà conservés.
• Moins de double saisie : les mêmes données n’ont pas besoin d’être saisies dans plusieurs interfaces.
• Données globales du site : les événements d’interphonie et d’accès peuvent être collectés avec le reste des informations.
• Processus de travail habituels : le personnel continue de travailler dans le système familier, et les résidents dans une seule application.

Plus le site, les utilisateurs et les systèmes connectés sont importants, plus l’effet est visible.

Comment se déroule l’intégration

Le travail commence par la discussion de la tâche. Le partenaire explique quel système il utilise et ce qu’il souhaite réaliser. Par exemple, accepter des appels des interphones BAS-IP dans sa propre application pour les résidents ou transmettre automatiquement les données des nouveaux utilisateurs depuis la plateforme de gestion immobilière. Sur la base de ces exigences, BAS-IP aide à choisir la méthode d’intégration appropriée et à convenir de la façon dont la solution finale doit fonctionner.

Lorsque le scénario est défini, l’équipe du partenaire reçoit les documents techniques nécessaires et peut commencer le développement. Pour travailler avec Link API et Mobile SDK, un NDA est préalablement signé, tandis que la documentation pour Device API est ouverte. Les conditions de mise à disposition de l’environnement de test, des licences et de l’équipement sont discutées en tenant compte des spécificités du projet.

L’intégration elle-même est développée par l’équipe du partenaire, et les spécialistes de BAS-IP fournissent des conseils sur le fonctionnement de leurs produits et aident à résoudre les problèmes techniques en cours de route. Si les fonctionnalités existantes de BAS-IP ne suffisent pas pour le scénario souhaité, un développement supplémentaire peut être discuté. Les délais pour de telles modifications dépendent de la charge de travail et des priorités actuelles de l’équipe produit.

Une fois le développement terminé, le partenaire teste l’intégration dans son environnement, puis démontre le résultat à BAS-IP ou fournit une description de la solution implémentée.

La durée de l’intégration dépend de la complexité du projet, de l’architecture du système tiers et de la charge de travail de l’équipe de développement. Les délais sont également affectés par la préparation de l’environnement de développement et les tests.

Combien cela coûte-t-il

Par défaut, BAS-IP ne facture pas de frais supplémentaires pour l’accès à la documentation et aux outils d’intégration.

L’octroi de licences pour les produits BAS-IP s’effectue dans des conditions standard, et les développements supplémentaires ou la modification de leurs priorités sont convenus séparément.

Questions fréquentes

Quelle est la différence entre Link API et Mobile SDK ?

Link API relie BAS-IP à un système serveur — par exemple, une plateforme de gestion immobilière ou un SCA. Mobile SDK ajoute des fonctions d’interphonie à une application mobile. Dans un projet, ils peuvent être utilisés ensemble.

BAS-IP Link est-il nécessaire pour l’intégration ?

Pas toujours. De nombreux appareils BAS-IP ont leur propre API locale, de sorte qu’un système tiers peut travailler directement avec l’équipement. Link est généralement plus pratique lorsque l’intégration couvre différents modèles, beaucoup d’appareils ou plusieurs bâtiments.

Un NDA est-il requis ?

Le NDA est requis pour Link API et Mobile SDK. La documentation pour Device API est ouverte.

Y a-t-il des webhooks ?

Oui, sur les platines Android. Le système externe peut recevoir les événements de l’appareil en temps réel. Sur les platines Linux, les moniteurs et au niveau de Link, il n’y a pas de webhooks.

Peut-on intégrer une plateforme tierce avec BAS-IP Link Cloud ?

Les intégrations externes de systèmes serveurs tiers via Link API sont actuellement réalisées sur Link Self-Hosted. Pour Link Cloud, cette fonctionnalité est en cours de développement.

Vous souhaitez intégrer BAS-IP à votre système ?

Dites-nous quelle plateforme, application ou équipement vous utilisez et quel scénario vous souhaitez réaliser.

L’équipe BAS-IP vous aidera à déterminer l’option appropriée : compatibilité des protocoles, Link API, Mobile SDK, Device API ou une combinaison de celles-ci.