> ## Documentation Index > Fetch the complete documentation index at: https://docs.bookivox.com/llms.txt > Use this file to discover all available pages before exploring further. # Intégration : Mews > Connectez votre PMS Mews via l’API Connector pour que vos agents consultent l’établissement, les réservations, les fiches clients et les services pendant l’appel. ## À quoi ça sert L'intégration **Mews** relie votre logiciel d'hôtellerie à vos agents vocaux. Pendant l'appel, l'agent peut **retrouver une réservation**, **reconnaître un client** et **lister les services vendables**, sans jamais modifier votre PMS. Comme pour les autres intégrations, vous branchez **votre propre système** : Bookivox ne fournit aucun identifiant. Vous saisissez **deux tokens** (le `ClientToken` de l'application et l'`AccessToken` de l'établissement), puis vous choisissez les actions à activer. > [!NOTE] > > L'intégration utilise l'**API Connector** de Mews. Elle est **strictement en lecture > seule** : aucune réservation, aucune fiche client et aucun tarif ne sont modifiés > pendant l'appel. ## Ce qu'il faut préparer | Élément | D'où il vient | Format attendu | | - | - | - | | **ClientToken** | Token de votre application Connector, délivré par Mews lors de la demande d'accès | Chaîne fournie par Mews (GUID), sans espace ni guillemet | | **AccessToken** | Token de l'établissement, rattaché à votre application | Chaîne fournie par Mews (GUID) | | **Environnement** | `Production` pour votre établissement réel, `Démo` pour les tests | `api.mews.com` ou `api.mews-demo.com` | **1. Récupérer les deux tokens** Le `ClientToken` identifie l'application qui appelle l'API ; l'`AccessToken` identifie l'établissement et détermine les données visibles. Les deux sont délivrés par Mews : copiez-les tels quels, sans espace ni guillemet. **2. Choisir l'environnement** Les tokens de **démonstration** ne fonctionnent que sur `api.mews-demo.com` ; les tokens de production ne fonctionnent que sur `api.mews.com`. Un token démo saisi en production est refusé, et inversement. **3. Connecter dans Bookivox** Dans **Intégrations → Mews**, collez les deux tokens, cochez les actions voulues, puis cliquez sur **Enregistrer la connexion**. Bookivox crée la **credential** chiffrée et un **outil par action cochée**. **4. Vérifier la connexion** Un bandeau **vert** confirme la création et indique le nombre d'outils créés (`2 outil(s) Mews créé(s) et prêts à être associés à un agent.`). Les tokens disparaissent du formulaire : ils restent chiffrés et ne sont plus affichés. **5. Compléter les actions manquantes** La carte **Connexions Mews** liste les configurations de l'organisation avec leur environnement et leur état (`Complet` ou `Partiel`). Le bouton **Créer** ajoute une action manquante à une connexion existante, sans ressaisir les tokens. > [!NOTE] > > La carte Mews de la page **Intégrations** et la colonne latérale de la fiche affichent un > lien **Documentation** vers la page que vous lisez. ## Ce que l'agent peut faire | Action | Usage | Exemple de demande | | - | - | - | | **Informations de l'établissement** | Nom, devise, fuseau horaire, heure serveur | « À quelle heure fermez-vous la réception ? » | | **Rechercher des réservations** | Par numéro, état ou période | « Ma réservation est-elle bien confirmée pour samedi ? » | | **Rechercher un client** | Par nom de famille (obligatoire), avec l'e-mail en option | « Vous avez déjà dormi chez nous ? » | | **Lister les services** | Chambres, petit-déjeuner, spa… | « Proposez-vous le petit-déjeuner ? » | Chaque action crée un **outil distinct** : vous pouvez n'en activer qu'une partie, et n'attacher à un agent que celles dont il a besoin. > [!NOTE] > > Les **disponibilités** ne sont volontairement pas exposées. L'API Mews exige pour cela un > identifiant de service et une date de début alignée sur le début d'unité de temps de > l'hôtel (minuit local converti en UTC). Un agent vocal ne peut produire ni l'un ni > l'autre de façon fiable : l'outil aurait échoué sur la majorité des appels. Pour une > demande de type « avez-vous une chambre jeudi ? », l'agent peut s'appuyer sur les > services et renvoyer vers la réception. ## Cas d'usage | Cas d'usage | Ce que fait l'agent | Résultat pour le client | | - | - | - | | **Confirmer une réservation** | L'agent lance la recherche de réservations par numéro, état ou période. | Le client sait si son séjour est bien confirmé, sans être mis en attente. | | **Reconnaître un client déjà venu** | L'agent lance la recherche de client avec le nom de famille, obligatoire, et l'e-mail s'il est donné. | L'agent adapte son accueil à l'historique du client. | | **Décrire les services de l'établissement** | L'agent appelle la liste des services : chambres, petit-déjeuner, spa. | Le client obtient une réponse juste sur l'offre réelle. | | **Donner les informations pratiques** | L'agent lit les informations de l'établissement : devise, fuseau horaire, heure serveur. | L'agent annonce les bonnes heures et la bonne devise. | ## Comment ça marche 1. Bookivox crée une **credential** chiffrée contenant le `ClientToken` et l'`AccessToken`. 2. Mews s'authentifie par **champs du corps JSON**, jamais par un en-tête HTTP. Bookivox injecte donc les deux tokens directement dans le corps de chaque requête, à côté des paramètres de l'action. 3. Chaque action appelle un endpoint documenté de l'API Connector, en `POST` : `/configuration/get`, `/reservations/getAll/2023-06-06`, `/customers/getAll`, `/services/getAll`. 4. Un paramètre fixe `Client` (`Bookivox/1.0`) accompagne chaque requête : Mews l'exige pour identifier la version du contrat d'API utilisée. 5. Les listes sont **bornées** par le preset (`Limitation` : 20 réservations, 10 clients, 100 services) pour que l'agent reçoive une réponse courte et exploitable. > [!NOTE] > > Pendant l'appel, l'agent entend une phrase courte avant que Mews réponde (« Je vérifie les > réservations, un instant. », « Je consulte la fiche client, un instant. », « Je regarde > les services disponibles, un instant. ») : l'attente est expliquée au client plutôt que > silencieuse. ## Rédiger la description de l'outil La description de l'outil est ce qui décide **quand** l'agent appelle Mews. Rédigez-la comme une consigne : ``` Utiliser cet outil quand le client demande le statut d'une réservation, les services proposés par l'hôtel, ou s'il est déjà venu. ``` > [!WARNING] > > Un agent qui dispose des quatre actions peut hésiter entre « rechercher des réservations » > et « rechercher un client ». Si c'est le cas, gardez l'action la plus utile et désactivez > les autres : moins d'outils, moins d'erreurs. ## Sécurité | Risque | Ce que fait le preset | | - | - | | **Tokens exposés** | Ils vivent dans une **credential** chiffrée, jamais dans la définition de l'outil ni dans un prompt. Ils ne sont jamais réaffichés après l'enregistrement. | | **Écritures non voulues** | Aucune action n'écrit : le preset ne propose que des endpoints de lecture. | | **Confusion d'environnement** | L'environnement est choisi explicitement et figé dans l'URL de l'outil ; les tokens démo sont refusés en production. | | **Réponses trop longues** | Les listes sont bornées par `Limitation` : l'agent ne reçoit jamais l'intégralité du PMS. | > [!WARNING] > > **Créez un `AccessToken` dédié à l'IA** si votre organisation Mews le permet, et > **révoquez-le** en cas de doute. Un token partagé avec un autre usage ne peut pas être > révoqué sans interrompre cet autre usage. ## Ce qui est déconseillé | Usage | Pourquoi | | - | - | | **Modifier des tarifs ou des réservations** | Hors périmètre : cette intégration est en lecture seule. | | **Exports en masse** | Les endpoints sont bornés ; un usage volumique sera refusé par Mews (`429`). | | **Chiffres officiels de comptabilité** | Confrontez toujours les montants dans Mews. | | **Tâches planifiées** | Un outil d'agent s'exécute **pendant l'appel**, pas en tâche de fond. | ## Limites et dépannage | Symptôme | Cause probable | Correction | | - | - | - | | Erreur `401` | Token erroné, expiré, ou droits insuffisants sur l'établissement. | Recopier les deux tokens, vérifier qu'ils sont actifs, puis recréer la connexion. | | Erreur `400` | Requête incomplète (paramètre obligatoire manquant). | Vérifier la description de l'outil et les paramètres saisis par l'agent. | | Erreur `400` « Invalid JSON » sur la recherche client | L'agent a envoyé le nom sous forme de texte au lieu d'un tableau JSON. | Reformuler la description de l'outil : « noms de famille sous forme de tableau JSON, ex. \["Dupont"] ». | | Erreur `400` « Please specify at least one of the filters » | Recherche client lancée sans nom de famille. | Le nom de famille est obligatoire pour cette action ; indiquer à l'agent de le demander au client avant d'appeler l'outil. | | Erreur `408` | Mews n'a pas répondu dans le délai. | Relancer ; si le problème persiste, vérifier l'état du service Mews. | | Erreur `429` | Trop de requêtes (`Retry-After` fourni par Mews). | Espacer les appels ; ne pas attacher plusieurs agents très actifs au même établissement. | | Erreur `500` | Incident côté Mews. | Réessayer plus tard ; contacter Mews si cela dure. | | L'agent ne trouve pas les disponibilités | L'action n'existe pas dans cette intégration. | Elle est volontairement absente : Mews exige un identifiant de service et une borne alignée sur le fuseau de l'hôtel. Faire confirmer par la réception. | | « Format de token invalide » | Espace, guillemet ou retour à la ligne collé avec le token. | Recopier la valeur brute, sans espace ni guillemet. | | L'agent répond « de tête » | L'outil n'est pas attaché à l'agent, ou il est inactif. | L'activer et l'attacher au nœud agent. | | « Créer » ne fait rien | L'action est déjà créée pour cette connexion. | Elle porte la mention **Déjà créé** ; rien à faire. | > [!NOTE] > > Mews ne publie pas de **serveur MCP** public. Cette intégration passe donc par l'API > HTTP Connector, avec un outil par action, ce qui permet à l'agent de choisir une > action précise plutôt que d'appeler un serveur générique. > [card] [Intégrations](https://docs.bookivox.com/integrations/overview.md) > > Toutes les intégrations et les catégories d'outils. > [card] [API HTTP](https://docs.bookivox.com/integrations/http-api.md) > > Comprendre les outils HTTP : paramètres, presets, credentials. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.