Produits et disponibilité
Fournissez les caractéristiques, les prix et la disponibilité pour répondre aux questions sur votre catalogue.
Connecteur externe via API
Connectez les données de votre système à l'agent IA sur WhatsApp.
Autorisez l'agent à consulter les commandes, produits, enregistrements et paramètres pendant la conversation. Votre API fournit les données ; Whatsplaid utilise les informations pertinentes pour aider le client.
Source de connaissance
Assistant sur WhatsApp
De la question à la réponse
01
Le client pose une questionL'agent détecte quand les données système sont nécessaires.
02
L'agent collecte l'identifiantE‑mail, numéro de portable ou code, selon votre configuration.
03
Sua API renvoie les donnéesLe système connecté détermine quelles informations peuvent être consultées.
04
La conversation se poursuit avec contexteL'agent utilise les données pertinentes pour formuler la réponse.
Une source de connaissances avec les données dont votre opération a besoin.
Le connecteur peut recevoir des objets JSON ou des listes avec différentes structures. Vous décidez ce qu'il faut exposer dans l'API et dans quelles situations l'agent doit s'y référer, sans limiter l'intégration à un seul type d'information.
Commandes et livraisons
Renvoyer l'état de la commande, les articles et les informations de livraison autorisées pour le client.
Données d'enregistrement
Mettez à disposition les informations pertinentes de l'inscription pour contextualiser l'assistance.
Paramètres du compte
Aidez l'agent à comprendre le contexte du client grâce aux données de configuration, de consommation ou de limites renvoyées par votre logiciel.
Configure la connexion et définissez quand elle rejoint la conversation.
La configuration technique se trouve dans Développeurs. Après avoir testé et activé le connecteur, choisissez l’API comme source de connaissances dans les paramètres de l’agent IA.
01Connectez votre API
Dans Développeurs, ouvrez Connecteurs externes et sélectionnez Base de connaissances via API. Indiquez l'URL de base HTTPS et le token Bearer, si nécessaire.
02Définissez l'identifiant et testez
Configurez le point de terminaison, l'identifiant de requête et le nom du paramètre attendu par l'API. Testez avec un enregistrement existant avant de continuer.
03Oriente le déclenchement
Lors de l'étape d'activation, décrivez quand le connecteur doit être déclenché dans la conversation. Par exemple : récupérer les données du compte lorsque le client signale un problème technique et demander l'e-mail enregistré si celui-ci n'est pas encore disponible.
04Sélectionnez la source dans l'agent
Activez et enregistrez le connecteur. Dans Agent IA, ouvrez Base de connaissances, sélectionnez Connecteur externe via API, activez son utilisation et enregistrez les modifications.
05Valider le service
Testez les conversations avec et sans identifiant, vérifiez les réponses et suivez les appels dans Activité récente. Adaptez les consignes à l'objectif de votre API.
Votre API contrôle les données. L'agent gère la conversation.
La requête intervient lorsque le contexte et les consignes configurées demandent des informations à une source externe. Les questions générales et les salutations restent prises en charge par l'assistance de l'agent.
Autorisation dans votre systèmeL'identifiant fourni ne prouve pas l'identité du client. Votre API doit appliquer les règles d'accès et ne renvoyer que les données autorisées.
Consultation au moment du serviceL’API renvoie les informations disponibles dans votre système à ce moment-là. La mise à jour et la disponibilité de ces données dépendent de la source connectée.
Une source choisie par l'agentEn sélectionnant API, cet agent utilise le connecteur externe comme base de connaissances. Les fichiers et Google Sheets ne seront plus consultés par lui.
Ce qu'il faut savoir avant de connecter votre API.
Dois-je préparer une API ?
Oui. Votre système doit fournir un endpoint HTTPS public qui reçoit l'identifiant configuré et renvoie un objet ou une liste JSON contenant des données. L'équipe responsable du système prépare l'intégration et ses règles d'accès.
Puis-je renvoyer différents types d'informations ?
Oui. La réponse peut regrouper différentes données autorisées dans une même structure JSON. Chaque agent utilise un connecteur ; vous pouvez étendre les données renvoyées par l'API de votre système.
L'agent consulte-t-il à chaque message ?
Non. Il prend en compte le contexte de la conversation et les directives définies dans Quand le connecteur doit être déclenché dans la conversation. S'il a besoin de l'identifiant et qu'il n'est pas encore disponible, il demande cette information au client.
Le connecteur modifie-t-il les données dans mon système ?
Cette fonctionnalité effectue des requêtes GET pour récupérer des informations. Ce n'est pas un mécanisme pour créer, mettre à jour ou supprimer des enregistrements dans le système connecté.
Quelle est la différence par rapport à l'API publique de Whatsplaid ?
Sans connecteur externe, Whatsplaid interroge votre API pour prendre en charge les conversations. Avec l’API publique, votre système appelle Whatsplaid pour activer les fonctionnalités de la plateforme. Découvrez l’API publique et les webhooks.
Intégrez les données de votre système dans la conversation.
Choisissez la source de connaissance adaptée à votre activité : API externe, feuilles de calcul ou documents. Google Sheets · Importation de documents