Volver al panel

Documentación

Aprende a usar Asyntai

Contexto de usuario

Pass user information to personalize AI conversations

Configurar contexto de usuario
Planes Standard y Pro

Descripción general

El contexto de usuario le permite pasar información sobre usuarios con sesión iniciada a la IA. Cuando proporcionas contexto de usuario, la IA puede saludar a los usuarios por nombre, hacer referencia a los detalles de su cuenta y proporcionar respuestas personalizadas sin pedir información que ya tiene.

Esto cree una experiencia fluida donde la IA ya "conoce" al usuario - su plan de suscripción, estado del pedido, puntos de fidelidad o cualquier otro dato relevante que elijas compartir.

Cómo funciona

  1. Enable User Context in your dashboard settings
  2. Add JavaScript to your website that sets user data
  3. La IA recibe el contexto con cada mensaje que el usuario envía
  4. La IA personalice las respuestas usando la información proporcionada
Asistente IA
¿Dónde está mi pedido?
¡Hola Sarah! Acabo de verificar su pedido #8847 — está en camino de entrega con FedEx y debería llegar hoy antes de las 5 PM.
¿Puedo mejorar mi plan?
¡Por supuesto! Actualmente estás en el plan Basic con 847 llamadas API restantes. Puedo ayudarte a mejorar al plan Pro para funciones adicionales y límites más altos.

Implementación

Elija el enfoque que se adapte a su configuración:

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

Mejor para rendimiento: El widget detecta fetchUserContext y lo llama automáticamente cuando se abra el chat, por lo que los datos se cargan solo cuando se necesitan.

Tú decides qué compartir. Pasa solo los datos relevantes para su caso de uso - nombre del cliente, estado del pedido, nivel de suscripción, contenido del carrito o cualquier otra información que ayude a la IA a asistir mejor a sus usuarios. Use etiquetas descriptivas para que la IA entienda el contexto.

Ejemplos de casos de uso

Comercio electrónico

"Puedo ver que su pedido #4521 está actualmente en tránsito y debería llegar el viernes."

SaaS

"Le quedan 847 llamadas API este mes en su plan Pro."

Soporte

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

Educación

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

Hospitalidad

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

Salud

"Your next appointment with Dr. Smith is scheduled for Tuesday at 10 AM."

Notas importantes

Opciónal - El chat funciona perfectamente sin contexto de usuario. Es una mejora para usuarios con sesión iniciada.
Tiempo real - El contexto se envíe con cada mensaje, por lo que puede actualizarlo dinámicamente a medida que cambian los datos del usuario.
Seguridad - Nunca incluyas contraseñas, números de tarjetas de crédito u otros datos sensibles. Solo pasa información no sensible.
Límites de tamaño - El contexto de usuario está limitado a 2,000 caracteres en Standard y 10,000 caracteres en Pro. Si se excede, se truncará para ajustarse. Mantén su contexto conciso.

Estado de integración

Después de implementar, visite la página de configuración de contexto de usuario para verificar que su integración está funcionando. La tarjeta de estado mostrará:

  • Si se está recibiendo el contexto
  • Último mensaje con contexto
  • Vista previa de los datos de contexto enviados