Contextul utilizatorului

Pass user information to personalize AI conversations

Planuri Standard și Pro

Prezentare generală

Contextul utilizatorului vă permite să transmiteți informații despre utilizatorii autentificați către AI. Când furnizați contextul utilizatorului, AI-ul poate saluta utilizatorii pe nume, poate face referire la detaliile contului lor și poate oferi răspunsuri personalizate fără a solicita informații pe care le aveți deja.

Aceasta creează o experiență fluidă în care AI-ul deja "cunoaște" utilizatorul - planul de abonament, starea comenzii, punctele de fidelitate sau orice alte date relevante pe care alegeți să le partajați.

Cum funcționează

Enable User Context in your dashboard settings
Add JavaScript to your website that sets user data
AI-ul primește contextul cu fiecare mesaj pe care utilizatorul îl trimite
AI-ul personalizează răspunsurile folosind informațiile furnizate

Asistent AI

Unde este comanda mea?

Bună Sarah! Tocmai am verificat comanda ta #8847 — este în curs de livrare cu FedEx și ar trebui să ajungă astăzi până la ora 17:00.

Pot să-mi actualizez planul?

Bineînțeles! Sunteți în prezent pe planul Basic cu 847 de apeluri API rămase. Vă pot ajuta să faceți upgrade la Pro pentru funcționalități suplimentare și limite mai mari.

Implementare

Alegeți abordarea care se potrivește configurării dumneavoastră:

Afișați datele utilizatorului direct din șablonul 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>

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

Cel mai bun pentru performanță: Widgetul detectează fetchUserContext și îl apelează automat când se deschide chat-ul, astfel încât datele sunt încărcate doar când este necesar.

Dumneavoastră decideți ce să partajați. Transmiteți doar datele relevante pentru cazul dumneavoastră de utilizare - numele clientului, starea comenzii, nivelul abonamentului, conținutul coșului sau orice altă informație care ajută AI-ul să asiste mai bine utilizatorii. Folosiți etichete descriptive pentru ca AI-ul să înțeleagă contextul.

Exemple de utilizare

E-commerce

"Pot vedea că comanda dumneavoastră #4521 este în prezent în tranzit și ar trebui să ajungă până vineri."

SaaS

"Aveți 847 de apeluri API rămase luna aceasta în planul Pro."

Asistență

"Văd că sunteți membru Gold cu 3 tichete deschise. Cu ce vă pot ajuta?"

Educație

"Ați parcurs 78% din cursul JavaScript. Sunteți gata să începeți Modulul 8?"

Ospitalitate

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

Sănătate

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

Note importante

Opțional - Chat-ul funcționează perfect fără contextul utilizatorului. Este o îmbunătățire pentru utilizatorii autentificați.

Timp real - Contextul este trimis cu fiecare mesaj, deci îl puteți actualiza dinamic pe măsură ce datele utilizatorului se schimbă.

Securitate - Nu includeți niciodată parole, numere de card de credit sau alte date sensibile. Transmiteți doar informații nesensibile.

Limite de dimensiune - Contextul utilizatorului este limitat la 2.000 de caractere pe Standard și 10.000 de caractere pe Pro. Dacă este depășit, va fi trunchiat pentru a se potrivi. Păstrați contextul concis.

Starea integrării

După implementare, vizitați pagina de setări Context utilizator pentru a verifica că integrarea funcționează. Cardul de stare va afișa:

Dacă se primește contextul
Ultimul mesaj cu context
Previzualizarea datelor de context trimise

Documentație