--- title: "API Virtual Front Desk : aperçu et premiers pas" url: "https://help.virtualfrontdesk.com/fr/article/api-virtual-front-desk-apercu-et-premiers-pas" language: "fr" last_updated: "2026-10-14T14:28:12.776Z" --- # API Virtual Front Desk : aperçu et premiers pas ## Qu'est-ce que l'API Virtual Front Desk? L'API Virtual Front Desk vous permet de relier Virtual Front Desk aux autres logiciels que votre organisation utilise déjà. Au lieu de recopier l'information à la main d'un système à l'autre, vos systèmes peuvent échanger automatiquement de l'information avec Virtual Front Desk. L'API est conçue pour les administrateurs informatiques, les développeurs et les partenaires d'intégration, mais vous n'avez pas besoin d'être développeur pour comprendre ce qu'elle peut faire pour vous. Cet article donne un aperçu général des possibilités et explique comment commencer. L'API est offerte avec les forfaits **Professional** et **Enterprise**. ## Fonctionnement Il existe trois façons de se connecter à Virtual Front Desk : - **L'API :** votre système demande de l'information à Virtual Front Desk, comme vos enregistrements de visiteurs ou votre historique d'appels, et la reçoit immédiatement. - **Les webhooks :** Virtual Front Desk avise automatiquement votre système dès qu'un événement se produit, par exemple lorsqu'un visiteur s'enregistre ou qu'un appel reste sans réponse. - **Les assistants IA :** vous connectez un assistant IA à vos données Virtual Front Desk et posez des questions en langage courant, sans écrire de code. ## Ce que vous pouvez en faire Chaque organisation est différente, donc la meilleure intégration dépend de vos besoins et des systèmes que vous utilisez déjà. Voici quelques idées générales : - **Tenir vos autres systèmes informés :** informez vos propres logiciels de l'arrivée ou du départ des visiteurs, pour que les bonnes personnes et les bons systèmes soient toujours à jour. - **Ramener vos données dans vos propres outils :** utilisez l'information sur vos visiteurs et vos appels dans les outils de rapports ou de veille d'affaires que vous utilisez déjà. - **Devancer les problèmes :** soyez alerté lorsqu'une station passe hors ligne ou lorsque des appels sont manqués. - **Poser des questions sur votre activité :** utilisez un assistant IA pour obtenir des réponses rapides sur vos visiteurs, vos appels et vos stations. Nous vous recommandons de discuter de votre projet avec votre service informatique ou votre partenaire d'intégration. Notre soutien peut aussi vous aider à évaluer ce qui est possible pour votre organisation. ## Avant de commencer - Votre organisation doit avoir le forfait **Professional** ou **Enterprise**. - Seuls les utilisateurs ayant le rôle **Propriétaire** (Owner), **Administrateur** (Admin) ou **Gestionnaire** (Manager) peuvent accéder aux paramètres de l'API dans le tableau de bord Virtual Front Desk. ## Ouvrir la page API Cliquez sur l'icône **Paramètres** (Settings) (l'engrenage) à côté de votre nom, puis, sous **Organisation** (Organization), sélectionnez **API**. La page est divisée en cinq sections, expliquées ci-dessous. ![La page API sous Paramètres > Organisation](https://cdn-assets.productfruits.com/ba2a202a-465d-4f32-a043-bc46026da3cd) *La page API sous Paramètres > Organisation* ## 1\. API Cette section affiche l'**URL de base** (Base URL), l'adresse que vos systèmes utilisent pour se connecter à Virtual Front Desk. Cliquez sur **Copier** (Copy) pour la copier. Le bouton **Référence de l'API** (API reference) ouvre la documentation technique complète, que votre développeur ou votre partenaire d'intégration utilisera pour créer l'intégration. ## 2\. Clés API Une clé API est l'identifiant que votre système utilise pour se connecter à Virtual Front Desk. Chaque clé a ses propres autorisations, appelées **portées** (scopes), pour que chaque intégration n'ait accès qu'à ce dont elle a besoin. Pour chaque clé, la liste affiche son nom, le début de la clé, ses portées, ainsi que la date de sa dernière utilisation et de sa création. Deux boutons sont offerts : - **Remplacer le secret** (Replace secret) : donne un nouveau secret à la clé, par exemple si vous pensez qu'elle a pu être exposée. L'ancien secret cesse de fonctionner immédiatement, alors mettez votre intégration à jour sans tarder. La clé conserve son nom, ses portées et son historique d'utilisation. - **Révoquer** (Revoke) : désactive la clé de façon permanente. Toute intégration qui l'utilise cesse immédiatement de fonctionner. Les clés révoquées et expirées passent dans **Clés inactives** (Inactive keys) au bas de la liste. **Pour créer une clé :** 1. Cliquez sur **Créer une clé** (Create key). 2. Saisissez un **Nom de la clé** (Key name) qui décrit l'intégration. 3. Choisissez les **Portées** (Scopes). Vous pouvez sélectionner **Accès complet** (Full access), **Lecture seule** (Read only) ou **Écriture seule** (Write only), ou sélectionner des autorisations individuelles pour chaque domaine. N'accordez que ce dont l'intégration a besoin. 4. Si vous le souhaitez, définissez une **Date d'expiration** (Expiry date). La clé cesse de fonctionner à la fin de cette journée. Laissez ce champ vide et la clé n'expire jamais. 5. Cliquez sur **Créer une clé**, puis copiez la clé et conservez-la en lieu sûr. ![Création d'une clé API](https://cdn-assets.productfruits.com/176fa09d-1e3e-48ba-ac49-e2b5420dbef9) *Création d'une clé API* La clé complète n'est affichée qu'une seule fois. Si elle est perdue, créez une nouvelle clé et révoquez l'ancienne. ## 3\. Assistants IA (MCP) Cette section vous permet de connecter un assistant IA, comme Claude Code, Cursor ou VS Code, à vos données Virtual Front Desk pour poser des questions en langage courant. - **Lecture seule** (Read-only) : l'adresse à utiliser lorsque l'assistant doit seulement lire votre information. C'est l'option recommandée. - **Avec écriture** (With writes) : l'adresse à utiliser lorsque l'assistant doit aussi pouvoir apporter des modifications, à condition que sa clé API ait les autorisations nécessaires. - Les onglets en dessous affichent une commande de configuration prête à copier pour chaque outil IA. Remplacez la fin de la commande par une clé API créée dans la section précédente. ![La section Assistants IA (MCP)](https://cdn-assets.productfruits.com/1f2c699d-5406-4c83-8526-4f989b6f334a) *La section Assistants IA (MCP)* L'information que l'assistant lit, y compris les renseignements sur les visiteurs, est transmise à votre fournisseur d'IA. Nous vous recommandons de créer une clé dédiée avec une date d'expiration pour votre assistant. ## 4\. Webhooks Les webhooks permettent à Virtual Front Desk d'aviser automatiquement vos systèmes lorsqu'un événement se produit. Cliquez sur **Ajouter un point de terminaison** (Add endpoint) pour saisir l'adresse du système qui doit recevoir les notifications. Chaque notification est signée, pour que votre système puisse vérifier qu'elle provient bien de Virtual Front Desk. ## 5\. Utilisation Pour chacun des 14 derniers jours, cette section affiche le nombre de requêtes API effectuées avec toutes vos clés et le nombre d'erreurs, avec une répartition par point de terminaison. Elle est mise à jour une fois par jour avec les totaux de la veille. ![Les sections Webhooks et Utilisation](https://cdn-assets.productfruits.com/38e3257f-714b-45ce-bfb4-731826bb0591) *Les sections Webhooks et Utilisation* ## Protéger votre intégration - Créez une clé distincte pour chaque intégration, pour pouvoir en révoquer une sans toucher aux autres. - Accordez à chaque clé uniquement les autorisations dont elle a besoin. - Conservez vos clés en lieu sûr et ne les transmettez jamais par courriel ou par clavardage. - Si une clé a pu être exposée, cliquez immédiatement sur **Remplacer le secret** ou **Révoquer** sous **Paramètres > Organisation > API**. ## En savoir plus La documentation technique complète est disponible dans la [**référence de l'API Virtual Front Desk**](https://api.virtualfrontdesk.com/v1/docs) (en anglais). Vous pouvez aussi l'ouvrir avec le bouton **Référence de l'API** sous **Paramètres > Organisation > API**. Besoin d'aide pour planifier une intégration? Communiquez avec notre soutien, nous serons heureux de vous aider.