Contesto utente

Passa informazioni sull'utente per personalizzare le conversazioni IA

Piani Standard e Pro

Panoramica

Il Contesto Utente ti consente di passare informazioni sugli utenti connessi all'IA. Quando fornisci il contesto utente, l'IA può salutare gli utenti per nome, fare riferimento ai dettagli del loro account e fornire risposte personalizzate senza chiedere informazioni che hai già.

Questo crea un'esperienza fluida in cui l'IA già "conosce" l'utente - il suo piano di abbonamento, lo stato dell'ordine, i punti fedeltà o qualsiasi altro dato rilevante che scegli di condividere.

Come Funziona

Enable User Context in your dashboard settings
Add JavaScript to your website that sets user data
L'IA riceve il contesto con ogni messaggio inviato dall'utente
L'IA personalizza le risposte utilizzando le informazioni fornite

Assistente IA

Dov'è il mio ordine?

Ciao Sarah! Ho appena controllato il tuo ordine #8847 — è in consegna con FedEx e dovrebbe arrivare oggi entro le 17:00.

Posso aggiornare il mio piano?

Certo! Sei attualmente sul piano Basic con 847 chiamate API rimanenti. Posso aiutarti ad aggiornare al piano Pro per funzionalità aggiuntive e limiti più elevati.

Implementazione

Scegli l'approccio più adatto alla tua configurazione:

Restituisci i dati utente direttamente dal tuo template lato server:

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

Imposta il contesto dopo che la tua app ha caricato i dati utente:

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

Migliore per le prestazioni: Il widget rileva fetchUserContext e lo chiama automaticamente quando la chat si apre, quindi i dati vengono caricati solo quando necessario.

Tu decidi cosa condividere. Passa solo i dati rilevanti per il tuo caso d'uso - nome del cliente, stato dell'ordine, livello di abbonamento, contenuto del carrello o qualsiasi altra informazione che aiuti l'IA ad assistere meglio i tuoi utenti. Usa etichette descrittive affinché l'IA comprenda il contesto.

Esempi di utilizzo

E-commerce

"Vedo che il tuo ordine #4521 è attualmente in transito e dovrebbe arrivare entro venerdì."

SaaS

"Hai 847 chiamate API rimanenti questo mese sul tuo piano Pro."

Supporto

"Vedo che sei un membro Gold con 3 ticket aperti. Come posso aiutarti?"

Istruzione

"Sei al 78% del corso JavaScript. Pronto per iniziare il Modulo 8?"

Ospitalità

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

Sanità

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

Note Importanti

Facoltativo - La chat funziona perfettamente senza contesto utente. È un miglioramento per gli utenti connessi.

Tempo reale - Il contesto viene inviato con ogni messaggio, quindi puoi aggiornarlo dinamicamente quando i dati utente cambiano.

Sicurezza - Non includere mai password, numeri di carte di credito o altri dati sensibili. Passa solo informazioni non sensibili.

Limiti di Dimensione - Il contesto utente è limitato a 2.000 caratteri su Standard e 10.000 caratteri su Pro. Se superato, verrà troncato per adattarsi. Mantieni il tuo contesto conciso.

Stato dell'Integrazione

Dopo l'implementazione, visita la pagina delle impostazioni del Contesto Utente per verificare che la tua integrazione funzioni. La scheda di stato mostrerà:

Se il contesto viene ricevuto
Ultimo messaggio con contesto
Anteprima dei dati di contesto inviati

Documentazione