Contexto do Usuário

Passe informações do usuário para personalizar conversas com IA

Planos Standard e Pro

Visão Geral

O Contexto do Usuário permite que você passe informações sobre usuários logados para a IA. Quando você fornece contexto do usuário, a IA pode cumprimentar os usuários pelo nome, referenciar detalhes da conta e fornecer respostas personalizadas sem pedir informações que você já possui.

Isso cria uma experiência fluida onde a IA já "conhece" o usuário - seu plano de assinatura, status do pedido, pontos de fidelidade ou quaisquer outros dados relevantes que você escolher compartilhar.

Como Funciona

Enable User Context in your dashboard settings
Add JavaScript to your website that sets user data
A IA recebe o contexto com cada mensagem que o usuário envia
A IA personaliza as respostas usando as informações fornecidas

Assistente IA

Onde está meu pedido?

Olá Sarah! Acabei de verificar seu pedido #8847 — ele está em rota de entrega com a FedEx e deve chegar hoje até às 17h.

Posso fazer upgrade do meu plano?

Claro! Você está atualmente no plano Basic com 847 chamadas de API restantes. Posso ajudá-lo a fazer upgrade para o Pro para recursos adicionais e limites mais altos.

Implementação

Escolha a abordagem que se adequa à sua configuração:

Exiba os dados do usuário diretamente do seu template server-side:

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

Defina o contexto após seu app carregar os dados do usuário:

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

Melhor para desempenho: O widget detecta fetchUserContext e o chama automaticamente quando o chat abre, assim os dados são carregados apenas quando necessário.

Você decide o que compartilhar. Passe apenas os dados relevantes para o seu caso de uso - nome do cliente, status do pedido, nível de assinatura, conteúdo do carrinho ou qualquer outra informação que ajude a IA a atender melhor seus usuários. Use rótulos descritivos para que a IA entenda o contexto.

Exemplos de Casos de Uso

E-commerce

"Posso ver que seu pedido #4521 está atualmente em trânsito e deve chegar até sexta-feira."

SaaS

"Você tem 847 chamadas de API restantes este mês no seu plano Pro."

Suporte

"Vejo que você é membro Gold com 3 tickets abertos. Como posso ajudar?"

Educação

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

Hotelaria

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

Saúde

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

Notas Importantes

Opcional - O chat funciona perfeitamente sem contexto do usuário. É uma melhoria para usuários logados.

Tempo real - O contexto é enviado com cada mensagem, então você pode atualizá-lo dinamicamente conforme os dados do usuário mudam.

Segurança - Nunca inclua senhas, números de cartão de crédito ou outros dados sensíveis. Passe apenas informações não sensíveis.

Limites de Tamanho - O contexto do usuário é limitado a 2.000 caracteres no Standard e 10.000 caracteres no Pro. Se excedido, será truncado para caber. Mantenha seu contexto conciso.

Status da Integração

Após implementar, visite a página de configurações do Contexto do Usuário para verificar se sua integração está funcionando. O cartão de status mostrará:

Se o contexto está sendo recebido
Última mensagem com contexto
Pré-visualização dos dados de contexto sendo enviados

Documentação