Centre d'Assistance
Accueil Office

Réceptionniste IA : Configurer les intégrations API

Pour Réceptionniste IA 

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 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 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 > Réceptionniste IA.
  • Ouvrez 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.

  • Cliquez sur Copier le prompt pour LLM externe. Le prompt est enregistré dans le presse-papiers.
  • Ouvrez un outil d'IA externe de votre choix et collez le prompt depuis le presse-papiers. Répondez aux questions de confirmation concernant l'API souhaitée.
  • Copiez le bloc JSON généré par l'IA et collez-le dans la boîte de dialogue IONOS 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).

  • 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.

Contenu