Retour au tableau de bord

Documentation

Apprenez à utiliser Asyntai

Contexte utilisateur

Transmettez les informations utilisateur pour personnaliser les conversations de l'IA

Configurer le contexte utilisateur
Forfaits Standard et Pro

Aperçu

Le contexte utilisateur vous permet de transmettre des informations sur les utilisateurs connectés à l'IA. Lorsque vous fournissez un contexte utilisateur, l'IA peut accueillir les utilisateurs par leur nom, référencer les détails de leur compte et fournir des réponses personnalisées sans demander des informations que vous possédez déjà.

Cela crée une expérience fluide où l'IA "connaît" déjà l'utilisateur - son plan d'abonnement, le statut de sa commande, ses points de fidélité, ou toute autre donnée pertinente que vous choisissez de partager.

Comment ça marche

  1. Activer le contexte utilisateur dans les paramètres de votre tableau de bord
  2. Ajoutez du JavaScript à votre site web qui définit les données utilisateur
  3. L'IA reçoit le contexte avec chaque message envoyé par l'utilisateur
  4. L'IA personnalise les réponses en utilisant les informations fournies
Assistant IA
Où est ma commande ?
Bonjour Sarah ! Je viens de vérifier votre commande #8847 — elle est en cours de livraison avec FedEx et devrait arriver aujourd'hui avant 17 h.
Puis-je mettre à niveau mon plan ?
Bien sûr ! Vous êtes actuellement sur le forfait Basic avec 847 appels API restants. Je peux vous aider à passer au forfait Pro pour des fonctionnalités supplémentaires et des limites plus élevées.

Mise en œuvre

Choisissez l'approche qui correspond à votre configuration :

Affichez les données utilisateur directement depuis votre modèle côté serveur :

<!-- After your Asyntai widget script -->
<script>
window.Asyntai = window.Asyntai || {};
window.Asyntai.userContext = {
    "Customer name": "<?php echo $user->name; ?>",
    "Email": "<?php echo $user->email; ?>",
    "Subscription plan": "<?php echo $user->plan; ?>",
    "Order status": "<?php echo $user->latest_order_status; ?>"
};
</script>

Définissez le contexte après le chargement des données utilisateur par votre application :

// After user logs in or data loads
window.Asyntai = window.Asyntai || {};
window.Asyntai.userContext = {
    "Customer name": currentUser.name,
    "Email": currentUser.email,
    "Subscription plan": currentUser.subscription.planName,
    "Cart total": cart.total,
    "Loyalty points": currentUser.loyaltyPoints
};

// You can update it anytime - changes apply to the next message
window.Asyntai.userContext["Cart total"] = newTotal;

Récupérez les données utilisateur uniquement lorsque le chat s'ouvre (optimal pour les performances) :

// Define a function to fetch user context
window.Asyntai = window.Asyntai || {};
window.Asyntai.fetchUserContext = function() {
    return fetch('/api/your-user-context-endpoint/')
        .then(function(response) { return response.json(); })
        .then(function(data) {
            window.Asyntai.userContext = data;
        });
};

// The widget automatically calls this when the chat opens

Idéal pour la performance : Le widget détecte fetchUserContext et l'appelle automatiquement lorsque le chat s'ouvre, de sorte que les données ne sont chargées que lorsque c'est nécessaire.

Vous décidez ce que vous partagez. Transmettez uniquement les données pertinentes pour votre cas d'utilisation — nom du client, statut de la commande, niveau d'abonnement, contenu du panier ou toute autre information qui aide l'IA à mieux assister vos utilisateurs. Utilisez des libellés descriptifs pour que l'IA comprenne le contexte.

Exemples de cas d'utilisation

E-commerce

"Je vois que votre commande #4521 est actuellement en cours de livraison et devrait arriver d'ici vendredi."

SaaS

"Il vous reste 847 appels API ce mois-ci sur votre forfait Pro."

Support

"Je vois que vous êtes un membre Gold avec 3 tickets ouverts. Comment puis-je vous aider ?"

Éducation

"Vous avez terminé 78% du cours JavaScript. Prêt à commencer le module 8 ?"

Hôtellerie

"Votre réservation pour le 17 septembre est confirmée. L'enregistrement commence à 15h."

Santé

"Votre prochain rendez-vous avec le Dr Smith est prévu mardi à 10h00."

Notes importantes

Facultatif - Le chat fonctionne parfaitement sans contexte utilisateur. C'est une amélioration pour les utilisateurs connectés.
Temps réel - Le contexte est envoyé avec chaque message, vous pouvez donc le mettre à jour dynamiquement lorsque les données de l'utilisateur changent.
Sécurité - N'incluez jamais de mots de passe, numéros de carte bancaire ou autres données sensibles. Transmettez uniquement des informations non sensibles.
Limites de taille - Le contexte utilisateur est limité à 2 000 caractères sur Standard et 10 000 caractères sur Pro. En cas de dépassement, il sera tronqué. Gardez votre contexte concis.

Statut de l'intégration

Après l'implémentation, visitez la page de paramètres du contexte utilisateur pour vérifier que votre intégration fonctionne. La carte de statut affichera :

  • Si le contexte est bien reçu
  • Dernier message avec contexte
  • Aperçu des données de contexte envoyées

Platform Guides

Using a specific CMS or e-commerce platform? We have step-by-step setup instructions for each — pick yours below to jump straight to the guide.