Ce guide explique comment configurer votre système Mews pour y intégrer le système de verrouillage Assa Abloy Vostio. Il est destiné aux administrateurs système qui peuvent ajouter et modifier les intégrations. Il comprend également une aide à la résolution d'erreurs, en cas d'événements inattendus liés à l'intégration. Vous ne devez effectuer la procédure d'installation qu'une seule fois au départ. Une fois l'intégration ajoutée, le personnel de votre établissement peut créer des clés depuis Mews Operations sans avoir besoin de se connecter au système Vostio.
Dans cet article, vous apprendrez comment paramétrer votre système Mews pour l'intégrer à la base de données Assa Abloy Vostio le système de verrouillage de porte d'Assa Abloy :
Introduction
Vue d'ensemble
Avant de commencer le processus étape par étape, voici un schéma du fonctionnement du système.
Prérequis
Voici ce dont vous aurez besoin pour configurer l'intégration :- Intégration Assa Abloy Vostio : contactez votre support technique Assa Abloy local et demandez-lui de configurer et d'activer une intégration au niveau de Mews. Dans le cadre de ce processus, vous devrez générer des identifiants pour l'API de Vostio qui vous seront demandés dans Mews. Référez-vous à la section Étape 1 : obtenir vos identifiants Vostio ci-dessous.
- Autorisations d'accès : les autorisations d'accès pour ajouter et modifier des intégrations dans le système de Mews.
- Encodeurs de clés : au moins un encodeur de clés physique.
Processus de configuration
Les étapes du processus de configuration sont les suivantes :
Étape 1 : Obtenir les identifiants Vostio
Vous devez obtenir les identifiants Vostio dont Mews a besoin pour accéder à l'API de Vostio. Lors de cette étape, suivez le processus de configuration de Vostio pour installer l'intégration et générer les identifiants qui permettront à Mews de se connecter à Vostio. Les identifiants se trouvent dans un fichier que vous téléchargez sur votre ordinateur. Vous devez stocker le fichier de manière sécurisée, car il contient des informations d'accès confidentielles au système Vostio. Lors de l'étape 2, vous devrez saisir les données dans le système Mews.
Remarque : Tous les exemples présentés dans ce guide sont factices.
Traitement
- Connectez-vous au système Vostio à l'adresse https://vostio.assaabloy.com/.
- Suivez les instructions du manuel ou du guide d'installation de Vostio pour configurer l'intégration à Mews et naviguez jusqu'à la partie du système à partir de laquelle vous générez un nouvel ensemble d'identifiants API de Vostio.
- Saisissez un nom significatif pour les détails, par exemple, "Mews - <nom de l'établissement>".
- Téléchargez le fichier contenant les identifiants et stockez-le de manière sécurisée afin de pouvoir l'ouvrir et en extraire le contenu.
- Ouvrez le fichier des identifiants dans votre éditeur de texte par défaut, par exemple Notepad sur Windows ou TextEdit sur Mac. Vous aurez besoin du nom d'utilisateur et du mot de passe lors de l'étape 2 « Créer l'intégration Vostio dans Mews ». Utilisez le copier-coller pour extraire les données pertinentes.
Remarque :
- Vous devez uniquement utiliser le texte entre guillemets, pas les guillemets.
- L'exemple présenté ici utilise des données fictives.
Par exemple :
- Nom d'utilisateur : S3I4l4VOhvfC308uk877
- Mot de passe : QPxC6PxU;*DSH%H9D.i#
Étape 2 : Créer l'intégration Vostio dans Mews
Vous devez posséder les autorisations d'accès nécessaires pour ajouter et configurer des intégrations.
- Connectez-vous à Mews Operations.
- Allez dans le menu principal
> Marketplace. Dans la catégorie « Gestion des équipements », où sont listées les intégrations d'encodage de clés, saisissez « vostio » dans la barre de recherche. Le nom de l'intégration est « Vostio key cutter integration » (Intégration d'encodage de clés Vostio).
- Cliquez sur Explorer pour ouvrir l'intégration et accéder aux paramètres.
- Saisissez le Nom, le Nom d'utilisateur et le Mot de passe. Vous pouvez laisser le nom par défaut, c'est-à-dire « Vostio-integration », en guise de Nom. Pour le Nom d'utilisateur et le Mot de passe, saisissez le nom d'utilisateur et le mot de passe de l'API de Vostio que vous avez obtenus lors de l'étape 1.
- Cliquez sur Sauvegarder.
Étape 3 : Configurer les encodeurs de clés
Configurez les encodeurs de clés spécifiques qui encoderont physiquement les clés. Lors de cette étape, vous configurerez tous vos encodeurs de clés spécifiques dans Mews, un pour chaque appareil physique. Suivez la procédure ci-dessous.
ℹ️ Terminologie
Veuillez noter que les termes anglais « Key cutter » (pour la taille de clés) et « Key encoder » (pour l'encodage de clés) désignent le même appareil. Par le passé, les clés traditionnelles étaient découpées physiquement dans du métal. De nos jours, les clés d'hôtel se présentent habituellement sous forme de cartes de la taille de cartes de crédit.
Traitement
- Dans le système Vostio, suivez le manuel ou le guide d'installation Vostio pour accéder à la liste des encodeurs. Prenez note des noms des encodeurs. Vous devrez utiliser ces noms lorsque vous ajouterez les encodeurs dans Mews.
- Dans Mews Operations, ouvrez l'intégration Vostio que vous avez créée lors de l'étape 2 et cliquez sur Encodeurs de clés. Cliquez sur + dans le coin supérieur droit pour ajouter un nouvel encodeur de clés.
- Pour chaque encodeur de clés que vous ajoutez, vous devez renseigner son Nom et son Identifiant. Sélectionnez un nom approprié et explicite. Par exemple, « Réception GAUCHE » ou « Réception DROITE ».
- Dans le champ Identifiant, saisissez le nom de l'encodeur de clés, tel qu'il apparaît dans le système Vostio. Cela permettra à Mews d'identifier l'encodeur de clés correspondant lors de l'interaction avec l'intégration Vostio.
- Laissez le champ Données JSON vide.
- Cliquez sur Sauvegarder pour créer l'encodeur de clés.
- Une fois que tous les détails de l'intégration ont été complétés avec succès, sélectionnez Activé pour rendre l'intégration opérationnelle.
- Ensuite, cliquez sur Sauvegarder.
Étape 4 : Configurer les mappages d'espaces
Si nécessaire, configurez le mappage des espaces pour mapper les espaces de Mews aux espaces de Vostio. Cette étape est facultative, elle est uniquement nécessaire si vos chambres et vos autres espaces ont des noms ou des identifiants différents dans Vostio et dans Mews. Suivez la procédure détaillée ci-dessous pour configurer les mappages.
ℹ️ Que sont les mappages des espaces ?
Si Mews se réfère à ses chambres et ses autres espaces en utilisant des noms et des identifiants différents à ceux qui sont utilisés dans Vostio, vous devez les mapper. Par exemple, si Mews émet une commande de création de clé pour l'espace « 402 », mais que cet espace est identifié par « 0402X » dans Vostio, alors le système doit savoir qu'il doit envoyer une commande pour « 0402X », et pas pour « 402 ». Si l'identifiant est le même dans les deux systèmes, vous pouvez ignorer cette étape.
Traitement
Pour commencer, vérifiez le système de nommage des espaces et de numérotation des chambres dans Vostio pour déterminer s'il est différent du système de Mews. Suivez le manuel ou le guide d'installation de Vostio pour accéder à l'écran correspondant.
- Pour configurer les mappages des espaces dans Mews Operations, ouvrez l'intégration Vostio créée lors de l'étape 2.
- Cliquez sur Mappages des encodeurs de clés. Cliquez sur + dans le coin supérieur droit pour ajouter chaque nouvelle entrée de mappage d'encodeur de clés au tableau de mappage.
-
Pour chaque mappage d'encodeur de clés que vous ajoutez, vous devez saisir l'identifiant de la chambre et de la serrure.
-
- Room est le nom ou le numéro de la chambre ou de l'espace dans Mews,
- L'Identifiant de serrure est le nom ou le numéro de la chambre correspondante ou de l'espace correspondant dans le système Vostio.
Étape 5 : Tester l'intégration
Vérifiez que l'intégration fonctionne correctement. Cette étape finale consiste à essayer l'intégration pour s'assurer qu'elle fonctionne. Si elle ne fonctionne pas, retournez en arrière et vérifiez les étapes précédentes. Référez-vous au schéma au début de ce guide. Si cela ne vous permet pas de résoudre le problème, consultez la section Résolution d'erreurs ci-dessous.
Pour tester l'intégration, suivez votre processus normal de création de clés, que ce soit depuis l'écran de gestion des réservations dans Mews Operations ou via le Mews Kiosk.
Si vous créez des clés pour une réservation et que vous avez configuré plusieurs encodeurs de clés, vous devez sélectionner celui que vous voulez utiliser.
Résolution d'erreurs
Si l'intégration ne fonctionne pas comme elle devrait, retournez en arrière et vérifiez les étapes précédentes. Vous pouvez vous référer au schéma au début de ce guide.
La meilleure manière d'identifier un problème est de vérifier la progression de la commande de Création de clé dans le système, depuis le moment de la demande de clé dans le système de Vostio jusqu'à l'encodage physique de la clé. Dans Mews, l'instruction de création de clés est un type de commande d'appareil et vous pouvez suivre sa progression en consultant la File d'attente des commandes de l'appareil.
Vous trouverez ces informations sur le site Mews Operations, à l'adresse suivante : menu principal > Files d'attente > Commandes d'appareils
La file d'attente des commandes d'appareils vous permet de suivre les commandes dans le système pour voir s'il y a des erreurs ou des blocages. En particulier, vous pouvez voir le statut d'une commande individuelle. La progression attendue est de PENDING à PROCESSED ou ERROR, en fonction du résultat renvoyé par le système Vostio.
- EN ATTENTE : la commande se trouve toujours dans la file d'attente, en attente d'exécution.
- TRAITÉ : la commande a été exécutée avec succès.
- ERREUR : Une erreur s'est produite lors de l'exécution de la commande.
⚠️ Format horaire UTC
Veuillez noter que l'horodatage des événements des commandes de l'appareil est au format UTC, ou temps universel coordonné. Temps universel, vous devez donc l'ajuster en fonction de votre fuseau horaire local.
Pour plus d'informations, consultez la file d'attente des commandes d'appareils. Si vous n'avez pas encore résolu certains problèmes, vous pouvez accéder à l' assistant numériqueMews à l'adresse suivante Mews Operations.
Ressources supplémentaires
Pour plus d'informations sur les intégrations d'encodage de clés, consultez les guides suivants :
- Liste de guides relatifs à l'Encodeur de clés pour Mews Operations
- File d'attente Commandes de l'appareil
- Comment configurer une intégration d'encodage de clés avec Mews Kiosk
⚠️ IMPORTANT : intégrations Mews Connector
Veuillez ignorer les références à Mews Connector en ce qui concerne les intégrations Vostio !
L'intégration Assa Abloy Vostio est une intégration cloud-to-cloud, contrairement aux intégrations de verrouillage qui étaient jusqu'ici généralement « cloud-to-premise ». Auparavant, les intégrations de verrouillage de porte étaient "cloud-to-premise".
Cela veut dire que vous connectiez Mews avec le système de verrouillage sur place dans l'établissement via un composant du système nommé Mews Connector. Ce type de verrouillage inclut Assa Abloy Visionline ainsi que les intégrations avec Salto, Haflok et d'autres partenaires de Mews. Veuillez noter que toute référence à Mews Connector dans les guides ne s'applique pas à l'intégration Vostio. Mews met à jour les guides existants progressivement pour y inclure l'intégration Vostio.