Générer une réponse IA
Réponses IA
Générer une réponse IA
Génère une réponse IA à l’aide d’un assistant, à partir d’un identifiant client
POST
Générer une réponse IA
Ce point de terminaison génère automatiquement une réponse intelligente à un message client à l’aide de votre assistant IA configuré. Le système gère automatiquement le contexte de conversation pour chaque client, de sorte que l’assistant se souvient des messages précédents et peut répondre de façon contextuelle. Idéal pour l’intégration dans des plateformes de messagerie externes, des CRM ou des interfaces de chat personnalisées.
Corps de la requête
integer
requis
L’ID de l’assistant à utiliser pour générer la réponse. Doit appartenir à votre compte.
string
requis
Un identifiant unique pour le client. Il sert à maintenir le contexte de la conversation à travers plusieurs messages.Exemples : numéro de téléphone, adresse e-mail, identifiant de contact CRM, identifiant utilisateur Facebook.Longueur maximale : 255 caractères.Important : utilisez toujours le même format pour un même client afin que le contexte soit correctement associé.
string
requis
Le message du client auquel répondre.
object
Variables de contexte facultatives à transmettre à l’assistant. Elles sont fusionnées avec les variables de conversation existantes.Utile pour transmettre des données client, le contexte de session ou d’autres métadonnées permettant de personnaliser la réponse.
Champs de réponse
boolean
Indique si la requête a réussi
string
L’UUID de la conversation. Utilisez-le pour suivre ou référencer la conversation ultérieurement.
string
L’identifiant client fourni dans la requête
string
La réponse générée par l’IA au message du client
array
Tableau des appels de fonction effectués par l’assistant pendant le traitement du message. Tableau vide si aucune fonction n’a été appelée.
boolean
Indique si les réponses IA sont désactivées pour cette conversation (par ex. en cas de reprise manuelle)
Réponses d’erreur
boolean
Sera
false en cas d’erreurstring
Message d’erreur décrivant le problème rencontré
string
Code d’erreur exploitable par une machine. Valeurs possibles :
ASSISTANT_NOT_FOUND- L’ID de l’assistant est invalide ou n’appartient pas à votre compteINSUFFICIENT_BALANCE- Le solde de votre compte est insuffisant pour traiter le message
Cas d’usage
Réponses IA multicanal
Utilisez ce point de terminaison pour ajouter des réponses IA à n’importe quelle plateforme de messagerie :- Recevez un message depuis WhatsApp, Facebook, SMS ou un autre canal
- Appelez ce point de terminaison avec le message et l’identifiant client
- Renvoyez la réponse IA via le canal d’origine
Intégration CRM
Intégrez les réponses IA à votre CRM ou à votre système d’assistance :- Utilisez l’identifiant de contact CRM comme
customer_identifier - Transmettez les données client sous forme de variables pour personnaliser les réponses
- La conversation persiste entre les sessions tant que le même identifiant est utilisé
Interfaces de chat personnalisées
Créez votre propre interface de chat propulsée par votre assistant Famulor :- Générez un identifiant unique pour chaque session utilisateur
- Envoyez les messages via ce point de terminaison
- Affichez les réponses IA dans votre interface
Persistance de la conversation
Les conversations sont automatiquement enregistrées selon la combinaison deassistant_id et customer_identifier :
- Même identifiant : les messages sont ajoutés à la conversation existante, en conservant le contexte complet
- Nouvel identifiant : une nouvelle conversation est créée pour le client
- Fusion des variables : lorsque des variables sont fournies, elles sont fusionnées avec les variables de conversation existantes
Bonnes pratiques
- Utilisez des identifiants cohérents : conservez toujours le même format pour les identifiants client (par ex. toujours E.164 pour les numéros de téléphone)
- Transmettez un contexte pertinent : utilisez le champ
variablespour fournir des données client qui aident l’IA à personnaliser ses réponses - Gérez les limites de débit : mettez en place une logique de nouvelle tentative avec backoff exponentiel pour les requêtes limitées
- Stockez les ID de conversation : conservez le
conversation_idrenvoyé pour une référence ou un débogage ultérieurs - Surveillez les coûts : suivez l’utilisation pour maîtriser les coûts, en particulier pour les intégrations à fort volume