Контекст користувача

Передайте iнформацiю про користувача для персоналiзацiї розмов з ШI

Тарифи Standard та Pro

Огляд

Контекст користувача дозволяє передавати iнформацiю про авторизованих користувачiв до ШI. Коли ви надаєте контекст користувача, ШI може вiтати користувачiв на iм'я, посилатися на деталi їхнього облiкового запису та надавати персоналiзованi вiдповiдi без запиту iнформацiї, яку ви вже маєте.

Це створює безперервний досвiд, де ШI вже "знає" про користувача - їхнiй план пiдписки, статус замовлення, бали лояльностi або будь-якi iншi релевантнi данi, якими ви вирiшите подiлитися.

Як це працює

Enable User Context in your dashboard settings
Add JavaScript to your website that sets user data
ШI отримує контекст з кожним повiдомленням, яке надсилає користувач
ШI персоналiзує вiдповiдi, використовуючи надану iнформацiю

ШI-асистент

Де моє замовлення?

Привiт, Сара! Я щойно перевiрив ваше замовлення #8847 — воно вiдправлено на доставку через FedEx i має прибути сьогоднi до 17:00.

Чи можу я покращити свiй план?

Звiсно! Наразi ви на планi Basic з 847 залишками API-запитiв. Я можу допомогти вам перейти на Pro для додаткових функцiй та вищих лiмiтiв.

Реалiзацiя

Оберiть пiдхiд, який вiдповiдає вашому налаштуванню:

Виведiть данi користувача безпосередньо з вашого серверного шаблону:

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

Встановiть контекст пiсля завантаження додатком даних користувача:

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

Найкраще для продуктивностi: Вiджет виявляє fetchUserContext i викликає його автоматично при вiдкриттi чату, тому данi завантажуються лише за потреби.

Ви вирiшуєте, чим дiлитися. Передавайте лише данi, релевантнi для вашого випадку використання - iм'я клiєнта, статус замовлення, рiвень пiдписки, вмiст кошика або будь-яку iншу iнформацiю, яка допомагає ШI краще обслуговувати ваших користувачiв. Використовуйте описовi мiтки, щоб ШI розумiв контекст.

Приклади використання

Електронна комерцiя

"Я бачу, що ваше замовлення #4521 наразi в дорозi i має прибути до п'ятницi."

SaaS

"У вас залишилося 847 API-запитiв цього мiсяця на планi Pro."

Пiдтримка

"Я бачу, що ви учасник Gold з 3 вiдкритими тiкетами. Чим можу допомогти?"

Освiта

"Ви пройшли 78% курсу JavaScript. Готовi розпочати Модуль 8?"

Гостиннiсть

"Ваше бронювання на 17 вересня пiдтверджено. Заселення починається о 15:00."

Охорона здоров'я

"Ваш наступний прийом у доктора Смiта заплановано на вiвторок о 10:00."

Важливi примiтки

Необов'язково - Чат працює iдеально без контексту користувача. Це покращення для авторизованих користувачiв.

В реальному часi - Контекст надсилається з кожним повiдомленням, тому ви можете оновлювати його динамiчно при змiнi даних користувача.

Безпека - Нiколи не включайте паролi, номери кредитних карток або iншi конфiденцiйнi данi. Передавайте лише неконфiденцiйну iнформацiю.

Обмеження розмiру - Контекст користувача обмежений 2 000 символами на Standard та 10 000 символами на Pro. У разi перевищення вiн буде обрiзаний. Тримайте контекст стислим.

Статус iнтеграцiї

Пiсля впровадження вiдвiдайте сторiнку налаштувань Контексту користувача, щоб перевiрити працездатнiсть вашої iнтеграцiї. Картка статусу покаже:

Чи отримується контекст
Останнє повiдомлення з контекстом
Попереднiй перегляд даних контексту, що надсилаються

Документацiя