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

Ativar Contexto do Usuário nas configurações do seu painel
Adicione JavaScript ao seu site que define os dados do usuário
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;

Busque dados do usuário apenas quando o chat abrir (melhor para desempenho):

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

"Você concluiu 78% do curso de JavaScript. Pronto para iniciar o Módulo 8?"

Hotelaria

"Sua reserva para 17 de setembro está confirmada. O check-in começa às 15h."

Saúde

"Sua próxima consulta com o Dr. Smith está agendada para terça-feira às 10h."

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

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.

Custom / Other Shopify WooCommerce BigCommerce Ecwid OpenCart Magento PrestaShop Odoo WordPress Drupal Joomla Ghost Wix Squarespace Webflow Bubble

Documentação