Volver al panel

Documentación

Aprende a usar Asyntai

Contexto de usuario

Pasa información del usuario para personalizar las conversaciones de IA

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 crea 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. Habilitar contexto de usuario en la configuración de tu panel
  2. Agrega JavaScript a tu sitio web que establece los datos del usuario
  3. La IA recibe el contexto con cada mensaje que el usuario envía
  4. La IA personaliza 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:

Genera los datos del usuario directamente desde tu plantilla del lado del servidor:

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

Establece el contexto después de que tu app cargue los datos del usuario:

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

Obtén los datos del usuario solo cuando se abre el chat (mejor para rendimiento):

// 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 abre el chat, por lo que los datos se cargan solo cuando se necesitan.

Usted decide 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

"Veo que eres miembro Gold con 3 tickets abiertos. ¿Cómo puedo ayudarte?"

Educación

"Llevas un 78% del curso de JavaScript. ¿Listo para empezar el Módulo 8?"

Hospitalidad

"Tu reserva para el 17 de septiembre está confirmada. El check-in comienza a las 3 PM."

Salud

"Tu próxima cita con el Dr. Smith está programada para el martes a las 10 AM."

Notas importantes

Opcional - El chat funciona perfectamente sin contexto de usuario. Es una mejora para usuarios con sesión iniciada.
Tiempo real - El contexto se envía 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

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.