Skip to main content
POST
Générer une réponse IA
API Famulor 1.0 (héritée). Cette page concerne uniquement Famulor 1.0 (app.famulor.de) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la référence API Famulor 2.0.
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.
Limite de débit : ce point de terminaison est limité à 5 requêtes par minute et par jeton API afin d’éviter les abus.

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’erreur
string
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 compte
  • INSUFFICIENT_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 :
  1. Recevez un message depuis WhatsApp, Facebook, SMS ou un autre canal
  2. Appelez ce point de terminaison avec le message et l’identifiant client
  3. 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 de assistant_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 variables pour 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_id renvoyé 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