Natrag na nadzornu ploču

Dokumentacija

Naučite kako koristiti Asyntai

Korisnički kontekst

Proslijedite korisničke podatke za personalizaciju AI razgovora

Konfigurirajte korisnički kontekst
Standard i Pro planovi

Pregled

Korisnički kontekst omogućuje vam prosljeđivanje informacija o prijavljenim korisnicima AI-ju. Kada pružite korisnički kontekst, AI može pozdraviti korisnike po imenu, referencirati detalje njihovog računa i pružiti personalizirane odgovore bez traženja informacija koje već imate.

To stvara besprijekorno iskustvo gdje AI već "zna" o korisniku - njihov plan pretplate, status narudžbe, bodove lojalnosti ili bilo koje druge relevantne podatke koje odlučite podijeliti.

Kako funkcionira

  1. Omogućite korisnički kontekst u postavkama nadzorne ploče
  2. Add JavaScript to your website that sets user data
  3. AI prima kontekst sa svakom porukom koju korisnik pošalje
  4. AI personalizira odgovore koristeći pružene informacije
AI asistent
Gdje je moja narudžba?
Bok Sarah! Upravo sam provjerio/la vašu narudžbu #8847 — poslana je na dostavu s FedExom i trebala bi stići danas do 17h.
Mogu li nadograditi svoj plan?
Naravno! Trenutno ste na Basic planu s preostalih 847 API poziva. Mogu vam pomoći s nadogradnjom na Pro za dodatne značajke i veće limite.

Implementacija

Odaberite pristup koji odgovara vašem postavljanju:

Output user data directly from your server-side template:

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

Postavite kontekst nakon što vaša aplikacija učita korisničke podatke:

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

Najbolje za performanse: Widget otkriva fetchUserContext i automatski ga poziva kada se chat otvori, tako da se podaci učitavaju samo kada su potrebni.

Vi odlučujete što ćete podijeliti. Proslijedite samo podatke relevantne za vaš slučaj korištenja - ime kupca, status narudžbe, razinu pretplate, sadržaj košarice ili bilo koje druge informacije koje pomažu AI-ju da bolje pomaže vašim korisnicima. Koristite opisne oznake kako bi AI razumio kontekst.

Primjeri korištenja

E-trgovina

"Vidim da je vaša narudžba #4521 trenutno u tranzitu i trebala bi stići do petka."

SaaS

"Imate preostalih 847 API poziva ovog mjeseca na vašem Pro planu."

Podrška

"Vidim da ste Gold član s 3 otvorena zahtjeva. Kako vam mogu pomoći?"

Obrazovanje

"Završili ste 78% JavaScript tečaja. Spremni za početak Modula 8?"

Ugostiteljstvo

"Vaša rezervacija za 17. rujna je potvrđena. Prijava počinje u 15h."

Zdravstvo

"Vaš sljedeći termin s dr. Smithom zakazan je za utorak u 10h."

Važne napomene

Neobavezno - Chat savršeno funkcionira bez korisničkog konteksta. To je poboljšanje za prijavljene korisnike.
U stvarnom vremenu - Kontekst se šalje sa svakom porukom, tako da ga možete dinamički ažurirati kako se korisnički podaci mijenjaju.
Sigurnost - Nikada ne uključujte lozinke, brojeve kreditnih kartica ili druge osjetljive podatke. Prosljeđujte samo neosjetljive informacije.
Ograničenja veličine - Korisnički kontekst ograničen je na 2.000 znakova na Standard i 10.000 znakova na Pro planu. Ako se prekorači, bit će skraćen. Držite svoj kontekst sažetim.

Status integracije

Nakon implementacije, posjetite stranicu postavki korisničkog konteksta kako biste provjerili da vaša integracija funkcionira. Kartica statusa će prikazati:

  • Je li kontekst primljen
  • Najnovija poruka s kontekstom
  • Pregled podataka konteksta koji se šalju