Réceptionniste IA : Configurer les intégrations API
Veuillez utiliser la fonction « Imprimer » au bas de la page pour créer un PDF.
Valable pour Réceptionniste IA (Momentum AI).
Cet article explique comment configurer des intégrations d'API dans le Réceptionniste IA afin de connecter des systèmes externes via une interface REST et d'échanger des données ou d'effectuer des actions pendant un appel.
La fonctionnalité API du Réceptionniste IA permet de connecter des systèmes tiers via des interfaces REST. Cela permet un échange de données bidirectionnel (par ex. requêtes CRM, création de tickets) pendant un appel actif.
Remarque
La configuration des intégrations API nécessite des connaissances avancées en programmation (REST, JSON). Si vous n'êtes pas familier avec ces notions, nous vous recommandons de procéder à la configuration avec votre administrateur informatique ou votre développeur Web.
Conditions préalables
- Vous êtes client(e) IONOS.
- Vous disposez d'un contrat :
Réceptionniste IA L
Réceptionniste IA All-Flat Advanced.
Exemples d'application et avantages
Grâce aux intégrations API, votre Réceptionniste IA peut effectuer des actions en temps réel et personnaliser les appels sur la base des données actuelles. Il passe ainsi du statut de simple fournisseur d'informations à celui de collaborateur actif dans vos processus commerciaux.
| Cas d'utilisation | Exemples de systèmes | Vos avantages |
|---|---|---|
| Gestion de la clientèle (CRM) | Salesforce, HubSpot, Pipedrive | Le Réceptionniste IA peut identifier immédiatement les appelants grâce à leur numéro de téléphone, consulter les données des clients (par ex. l'état des commandes) et fournir une assistance personnalisée. |
| Outils de calendrier et de réservation | Google Calendar, Calendly, Outlook | Le Réceptionniste IA peut réserver, reporter ou annuler des rendez-vous en vérifiant la disponibilité en temps réel. |
| Marketing | HubSpot (mailings), Mailchimp | Après un appel, Le Réceptionniste IA peut ajouter automatiquement l'appelant à une liste de diffusion (par ex. pour une newsletter) ou créer un lead dans votre système. |
| Support et Ticketing | Zendesk, Freshdesk | Le Réceptionniste IA peut créer automatiquement un nouveau ticket lors d'une demande de support ou demander le statut d'un ticket existant. |
Conditions préalables et exigences techniques
La configuration nécessite des connaissances techniques et un accès au système cible. Veuillez vérifier les points suivants au préalable :
- Point final de l'API : Vous devez avoir accès à un système externe qui peut recevoir des demandes via une API REST publique.
- Authentification : Préparez vos données d'accès (par ex. clé API, token Bearer, Basic Auth). Remarque : les flux OAuth interactifs (fenêtres de connexion) ne sont actuellement pas pris en charge.
- Connaissance des API : Une compréhension de base des API REST, des méthodes HTTP (GET, POST) et des formats JSON est nécessaire pour la configuration.
- Responsabilité : Vous êtes vous-même responsable de la gestion, de la sécurité et de la disponibilité (uptime) de l'API connectée. Des points de terminaison défectueux peuvent entraîner l'interruption de la conversation par le Réceptionniste IA.
Fonctionnement technique
Le Réceptionniste IA fonctionne comme un client HTTP. Sa configuration se compose de deux éléments principaux :
- "Parameters" (schéma JSON) : Définit les informations que l'assistant doit demander à l'appelant avant d'envoyer la demande (p. ex. numéro de client, date).
- "Request Definition" (HAR JSON) : C'est ici que l'appel API proprement dit est défini. Les paramètres collectés sont alors injectés dans l'URL, l'en-tête ou le corps de la requête.
Configuration de l'interface
- Connectez-vous à votre compte IONOS.
- Dans la barre de titre, cliquez sur Menu > AI Frontdesk.
- Si une liste des contrats s'affiche, cliquez sur Administrer sur la tuile du contrat souhaité.
- Dans l'interface de configuration, développez la section Intégrations API et cliquez sur + Ajouter une intégration. Une fenêtre pop-up s'ouvre.
Vous avez maintenant deux options pour créer la définition :
Option A : Configuration basée sur le LLM
Pour gagner du temps lors de la création de la syntaxe du format HAR, vous pouvez utiliser l'invite fournie pour faire générer le code par un Large Language Model (LLM) externe (par ex. ChatGPT, Claude), ou simplement demander à Dora, la spécialiste du code de l'équipe IONOS Momentum.
Attention
Ne divulguez pas de données d'accès secrètes dans les outils d'IA externes. Saisissez les clés ou les jetons exclusivement dans la boîte de dialogue IONOS.
- Dans la fenêtre contextuelle de l'étape 1, sélectionnez votre outil d'IA préféré dans le menu déroulant (icône en forme de flèche), puis cliquez sur le bouton correspondant.
- Le site Web du fournisseur sélectionné s'ouvre dans un nouvel onglet du navigateur. En règle générale, la consigne nécessaire à la création est automatiquement transférée dans le champ de saisie du chat.
Astuce : selon l’outil d’IA choisi, il se peut que la requête ne soit pas exécutée automatiquement. Dans ce cas, appuyez manuellement sur la touche Entrée pour l’envoyer. Si le champ de saisie reste vide, vous pouvez simplement coller la requête depuis votre presse-papiers en cliquant avec le bouton droit de la souris (ou en appuyant sur Ctrl+V / Cmd+V). - Répondez aux questions de confirmation concernant l'API souhaitée.
- Copiez le bloc JSON généré par l'IA
- Revenez ensuite à la fenêtre de dialogue IONOS et collez-le dans le champ de texte prévu à cet effet (étape 2).
- Cliquez sur Appliquer, puis sur Enregistrer les modifications (en haut).
Option B : Mode expert (manuel)
C'est la voie directe pour les développeurs qui disposent déjà du code nécessaire (format JSON).
- Dans la fenêtre contextuelle de l'étape 1, cliquez sur Mode expert en haut à droite de la fenêtre pop-up. Une autre fenêtre pop-up s'ouvre.
- Remplissez les champs requis :
- Nom : Attribuez un nom unique.
- Description : Indiquez au LLM quand cet outil doit être déclenché.
- Paramètres : Définissez les paramètres que l'assistant doit demander à l'appelant. La saisie doit se faire au format JSON.
- Requête : Définissez votre requête API au format HAR. Utilisez {{ variableName }} pour faire référence aux paramètres définis ci-dessus. La saisie doit se faire au format JSON.
- Cliquez sur Appliquer, puis sur Enregistrer les modifications en haut.