Agents IA - Avancé envoie des demandes HTTP de serveur à serveur à votre système backend. Les demandes sont initiées quand un chemin utilisateur déclenche une intégration dans leur boîte de dialogue et les données renvoyées mappées sont stockées et disponibles pendant toute la durée de la session Agents IA - Avancé.
Configuration technique requise pour votre API Backend
Types d’API
Votre API doit avoir l’une des architectures suivantes :
- REST
- GraphQL
Réponse
Votre réponse API doit suivre les exigences générales :
- Fournissez une réponse API dans un délai de 30 secondes
- De préférence, retourner au format JSON
Authentification
Du côté d'Agents IA - avancé, nous pouvons effectuer l’authentification en utilisant l’une des options suivantes :
- Clé API
- Token du porteur
- Token d’expiration
- Authentification de base
- OAuth 2.0
- Listes sécurisées IP/liste autorisée
Liste de contrôle personnelle
La liste de contrôle personnelle ci-dessous contient des questions et des informations qui vous aideront à développer une API solide :
- L’API peut-elle effectuer des recherches avec des données que connaîtrait un utilisateur typique ou avec des données provenant de votre CRM ?
- Les données de la réponse API contiennent-elles des informations qui satisfont votre utilisation ?
- Si votre cas d’utilisation nécessite les données de plusieurs systèmes, pouvez-vous les regrouper en une seule couche ?
- Est-il connu quand l’API envoie un code de statut HTTP 200, 400 et 404 ?
- Que renvoie l’API si l’entrée n’est pas valide ou incorrecte ?
- Votre système définit-il une limite de débit de l’API ?
- Combien de temps faut-il à votre système pour envoyer une réponse ?
Soyez prêt à fournir :
• Documentation : Authentification, requête de demande API / corps et schéma de réponse
• (Facultativement une collection Postman.)
• Données test pour les résultats les plus courants.
Pour en savoir plus au sujet de ce plan d’intégration, consultez l’article précédent Intégration personnalisée - Préparation.