Retour au tableau de bord

Documentation

Apprenez à utiliser Asyntai

Contexte utilisateur

Pass user information to personalize AI conversations

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 fonctionne

  1. Enable User Context in your dashboard settings
  2. Add JavaScript to your website that sets user data
  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 :

Output user data directly from your server-side template:

<!-- 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>

Set the context after your app loads user data:

// 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;

Fetch user data only when the chat opens (best for performance):

// 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

"I see you're a Gold member with 3 open tickets. How can I help?"

Éducation

"You're 78% through the JavaScript course. Ready to start Module 8?"

Hôtellerie

"Your booking for September 17th is confirmed. Check-in starts at 3 PM."

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