Intégration des interphones IP BAS-IP aux systèmes de bâtiment existants

Sur un seul site, l’équipe de gestion peut travailler dans une plateforme de gestion immobilière, l’équipe de sécurité dans un système de contrôle d’accès, et les résidents dans une application mobile distincte. Si le système d’interphonie (contrôle d’accès) reste une autre partie isolée du bâtiment, les mêmes utilisateurs, droits d’accès et événements doivent être gérés à plusieurs endroits.

BAS-IP peut être intégré à l’infrastructure numérique existante du bâtiment. La plateforme de gestion immobilière peut rester l’interface opérationnelle principale pour le personnel, tandis que l’application existante pour les résidents peut acquérir des fonctionnalités d’interphonie, de vidéo et d’ouverture de porte.

Il existe quatre approches principales : l’interopérabilité via des protocoles standard, BAS-IP Link API, BAS-IP Mobile SDK et BAS-IP Device API. Le bon choix dépend de ce qui doit être intégré et de la façon dont le système existant fonctionne.

Qu’est-ce que BAS-IP Link ?

BAS-IP Link est une plateforme logicielle pour gérer les appareils BAS-IP connectés, les sites et les appartements, les utilisateurs, les identifiants d’accès, les appels et la configuration des appareils.

Elle est disponible selon deux modèles de déploiement : Link Self-Hosted (auto-hébergé), installé sur l’infrastructure de serveur propre au client, et Link Cloud, fourni sous forme de service cloud BAS-IP.

Certaines intégrations fonctionnent via Link, tandis que d’autres communiquent directement avec l’équipement BAS-IP.

Interopérabilité via des protocoles standard

Toutes les intégrations ne nécessitent pas de développement logiciel.

L’équipement BAS-IP prend en charge des protocoles standard déjà largement utilisés dans les systèmes de téléphonie, de vidéosurveillance (CCTV) et de contrôle d’accès :

• SIP — la platine de rue s’enregistre en tant que client SIP sur le PBX (autocommutateur téléphonique privé) du client, permettant aux appels d’être acheminés vers les combinés et les softphones existants ;
• RTSP — la platine peut être ajoutée à un VMS (système de gestion vidéo) ou un NVR (enregistreur vidéo réseau) en tant que source vidéo aux côtés des autres caméras de vidéosurveillance sur le site ;
• Wiegand — le lecteur intégré à la platine peut transmettre un identifiant à un système de contrôle d’accès tiers.

Ces scénarios sont configurés aux deux extrémités et ne nécessitent pas de développement à l’aide d’une API ou d’un SDK BAS-IP.

Remarque. Pour les intégrations SIP, la compatibilité des codecs audio et vidéo entre le système tiers et l’équipement BAS-IP spécifique doit être vérifiée au préalable. Par exemple, l’équipement BAS-IP prend en charge les scénarios utilisant PCMA pour l’audio et H.264 pour la vidéo. L’ensemble de codecs actuellement pris en charge doit toujours être vérifié pour le modèle et la version de firmware (micrologiciel) concernés.

Les protocoles standard peuvent transporter un appel, un flux vidéo ou un identifiant, mais ils ne comprennent pas qui est l’utilisateur, à quel appartement il appartient ou quels droits d’accès il devrait avoir.

Lorsque l’intégration doit travailler avec les données elles-mêmes — créer des utilisateurs, accorder ou révoquer des accès, ou récupérer des événements — une API ou un SDK est requis.

BAS-IP Link API : intégration avec une plateforme de gestion immobilière ou côté serveur

Link API est conçu pour les cas où un système tiers a besoin d’interagir de manière programmatique avec BAS-IP Link : par exemple, une plateforme de gestion immobilière, un système de contrôle d’accès ou une autre plateforme d’entreprise déjà utilisée sur le site.

L’emménagement d’un résident en est un exemple simple.

Un membre du personnel crée le profil du résident dans la plateforme existante : nom, appartement et coordonnées. Sans intégration, le même utilisateur doit ensuite être créé manuellement une seconde fois dans le système d’interphonie.

Avec Link API, les données peuvent être transférées automatiquement. L’utilisateur est créé dans le bon site et le bon appartement au sein de BAS-IP Link, d’où l’information peut être appliquée à l’infrastructure BAS-IP connectée.

Ce n’est qu’un cas d’utilisation possible.

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

• les utilisateurs et la structure du site ;
• les droits d’accès ;
• les identifiants d’accès permanents, y compris les cartes, les badges, les codes PIN, les codes QR, Face ID, UKEY et les numéros d’immatriculation des véhicules ;
• les identifiants temporaires avec une période de validité définie ;
• l’accès des invités et les visiteurs ;
• la messagerie aux résidents ;
• les numéros virtuels et le transfert d’appels ;
• la configuration des appareils à distance ;
• les événements et les journaux.

Les fonctionnalités exactes utilisées dépendent des exigences du projet.

Avec cette architecture, la plateforme existante du client peut rester l’interface opérationnelle quotidienne de son personnel.

Statut actuel. Les intégrations côté serveur tiers via Link API sont actuellement implémentées sur BAS-IP Link Self-Hosted.

La prise en charge de BAS-IP Link Cloud est en cours de développement et sera fournie via une passerelle API (API gateway).

Si le projet est destiné à utiliser Link Cloud, le cas d’utilisation requis et les options disponibles doivent être discutés avec BAS-IP avant le début du développement.

BAS-IP Mobile SDK : fonctionnalité d’interphone à l’intérieur de votre propre application mobile

Le deuxième scénario courant est celui d’une organisation qui possède déjà sa propre application mobile pour les résidents, les locataires ou les employés.

Cette application peut déjà gérer les demandes de maintenance, les paiements, les réservations de commodités et les notifications. Introduire une application distincte uniquement pour l’interphonie peut donc s’avérer inutile.

BAS-IP Mobile SDK ajoute les fonctions clés d’interphone, d’entrée et d’accès à l’application existante via BAS-IP Link, notamment :

• l’authentification de l’utilisateur ;
• les appels audio et vidéo entrants et sortants ;
• l’aperçu vidéo en direct de la platine de rue avant de répondre à un appel ;
• les notifications push ;
• l’ouverture de porte ;
• l’historique des appels ;
• l’accès mobile basé sur le BLE (Bluetooth Low Energy) via le composant UKEY ;
• l’appel de l’ascenseur à l’étage du résident.

iOS et Android sont tous deux pris en charge.

Le résident peut répondre à un appel de la platine de rue directement dans l’application qu’il utilise déjà, voir un aperçu en direct du visiteur avant de répondre, et ouvrir la porte.

L’équipe de développement n’a pas besoin de construire la couche d’appel de l’interphone à partir de zéro. La communication SIP et l’interaction avec BAS-IP Link sont déjà gérées par les composants fournis ; le rôle du partenaire est d’intégrer ces composants dans sa propre application.

Le Mobile SDK ne reproduit pas toutes les fonctionnalités disponibles dans l’application BAS-IP Link. Il fournit un ensemble défini de capacités prêtes à l’emploi.

Si une fonction requise n’est pas incluse dans le SDK — par exemple, la génération de codes QR pour les invités — le partenaire peut l’implémenter dans sa propre application en utilisant des appels directs à Link API.

Statut actuel. Les intégrations Mobile SDK sont implémentées sur BAS-IP Link Self-Hosted.

Les projets nécessitant BAS-IP Link Cloud doivent être planifiés une fois que la passerelle API Cloud sera disponible.

BAS-IP Device API : intégration directe avec l’équipement

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

Les platines de rue BAS-IP, les moniteurs intérieurs et les autres appareils compatibles, y compris le module d’ascenseur, disposent de leurs propres API locales. Un système tiers peut donc communiquer directement avec l’équipement.

La distinction 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 à son tour l’équipement BAS-IP connecté.

L’intégration directe des appareils est bien adaptée à un projet local avec une gamme limitée et connue de modèles d’appareils.

L’intégration via Link est généralement plus appropriée lorsque la solution couvre différents modèles, un grand nombre d’appareils ou plusieurs sites, car Link réduit la dépendance de l’intégration aux spécificités des modèles d’appareils et des versions de firmware individuels.

L’accès à Device API est plus simple : la documentation est accessible au public et aucun NDA n’est requis.

Les développeurs peuvent s’inscrire via le portail des développeurs BAS-IP et confirmer leur adresse e-mail.

Webhooks

Les platines de rue BAS-IP basées sur Android prennent également en charge les webhooks.

Cela permet à un système tiers de recevoir des événements au fur et à mesure qu’ils se produisent, y compris l’ouverture de la porte, l’accès accordé ou refusé, les mises à jour de l’appareil et les autres événements enregistrés dans le journal de l’appareil.

Ceci est utile dans les scénarios de bâtiments intelligents (smart building) où un autre système doit réagir immédiatement à un événement d’accès ou à l’ouverture d’une porte.

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

Ils ne sont pas pris en charge sur les platines basées sur Linux, les moniteurs intérieurs ou au niveau de BAS-IP Link.

Quelle approche d’intégration devez-vous choisir ?

Vous n’avez pas nécessairement besoin de choisir la méthode d’intégration à l’avance. Dans la plupart des cas, la bonne approche devient évidente une fois que le système existant et le cas d’utilisation requis ont été décrits.

Qu’apporte l’intégration sur le site ?

• Configuration initiale plus rapide : les données utilisateur et les paramètres associés peuvent être transférés à partir du système dans lequel ils sont déjà conservés.
• Moins de saisie de données en double : la même information n’a pas besoin d’être saisie à plusieurs reprises dans des interfaces différentes.
• Données opérationnelles unifiées : les événements d’interphonie, d’entrée et d’accès peuvent être regroupés avec d’autres informations du site.
• Flux de travail familiers : le personnel peut continuer à travailler dans les systèmes qu’il connaît déjà, tandis que les résidents peuvent utiliser une application unique.

Plus le site, la base d’utilisateurs et le nombre de systèmes connectés sont importants, plus l’avantage devient perceptible.

Comment fonctionne un projet d’intégration ?

L’organisation commence par décrire son système existant et le cas d’utilisation requis. Par exemple : « Nous avons déjà une application pour les résidents et nous voulons que les résidents répondent aux appels de l’interphone à l’intérieur de celle-ci. »

BAS-IP aide à identifier la méthode d’intégration appropriée et à convenir du résultat attendu.

Pour Link API et Mobile SDK, le matériel technique est fourni une fois le projet validé et un NDA signé. Un projet distinct contenant les spécifications requises est créé pour chaque partenaire.

La documentation de Device API est accessible au public.

L’intégration elle-même est développée par l’équipe du partenaire.

BAS-IP répond aux questions techniques relatives à ses produits, aide à clarifier le scénario d’intégration et apporte son assistance lorsqu’une implémentation basée sur la documentation ne se comporte pas comme prévu.

Si un projet nécessite des fonctionnalités qui ne sont pas actuellement disponibles dans le produit, le besoin peut être discuté avec l’équipe produit de BAS-IP. L’étendue des travaux et leur place dans le plan de développement sont évaluées en premier. Une telle évaluation ne constitue pas un engagement sur une date de sortie spécifique.

L’environnement de test et les dispositions matérielles sont convenus pour chaque projet individuel.

La solution terminée est testée par le partenaire. Une fois le développement terminé, le partenaire démontre le résultat à BAS-IP ou fournit une description de l’intégration réalisée.

Pour une intégration typique, environ un mois de temps de développement ciblé peut être utilisé comme indication générale.

La durée calendaire globale est généralement plus longue, en fonction de la disponibilité de l’équipe du partenaire et du temps nécessaire pour se familiariser avec le système.

Combien coûte l’intégration ?

BAS-IP ne facture normalement pas de frais distincts pour l’accès à la documentation et aux outils d’intégration.

Les produits BAS-IP continuent d’être concédés sous licence selon leurs conditions de licence standard.

Tout développement de produit supplémentaire ou demande de modification de la priorité de ces travaux sont convenus séparément.

Foire aux questions

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

Link API connecte BAS-IP à un système côté serveur tel qu’une plateforme de gestion immobilière ou un système de contrôle d’accès. Mobile SDK ajoute les fonctionnalités d’interphone et d’ouverture de porte BAS-IP à une application mobile. Les deux peuvent être utilisés ensemble au sein d’un même projet.

BAS-IP Link est-il requis pour chaque intégration ?

Non. De nombreux appareils BAS-IP ont leur propre API locale, un système tiers peut donc communiquer directement avec l’équipement. Link est généralement plus utile lorsqu’une intégration doit couvrir différents modèles d’appareils, un grand nombre d’appareils ou plusieurs sites.

Un NDA est-il requis ?

Un NDA est requis pour Link API et Mobile SDK. La documentation de Device API est accessible au public.

Les webhooks sont-ils pris en charge ?

Oui, sur les platines de rue basées sur Android. Un système tiers peut recevoir les événements de l’appareil en temps réel. Les webhooks ne sont pas disponibles sur les platines basées sur Linux, les moniteurs intérieurs ou au niveau de BAS-IP Link.

Une plateforme tierce peut-elle être intégrée à BAS-IP Link Cloud ?

Les intégrations côté serveur tiers via Link API sont actuellement implémentées sur Link Self-Hosted. Des fonctionnalités équivalentes pour Link Cloud sont en cours de développement.

Combien de développeurs sont requis ?

Pour Link API, un développeur back-end ou full-stack sera normalement requis. Pour Mobile SDK, un développeur mobile est requis. Les intégrations plus importantes peuvent également nécessiter une expertise DevOps.

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

Dites-nous quelle plateforme, application ou équipement vous utilisez déjà et ce que vous souhaitez que l’intégration accomplisse.

L’équipe BAS-IP peut vous aider à identifier l’approche la plus appropriée : interopérabilité de protocole standard, Link API, Mobile SDK, Device API, ou une combinaison de ceux-ci.