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

Передайте інформацію про користувача для персоналізації розмов з Ш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литися.

Як це працює

Увімкніть контекст користувача у налаштуваннях вашої панелі керування
Додайте JavaScript до вашого вебсайту, який встановлює дані користувача
ШI отримує контекст з кожним повiдомленням, яке надсилає користувач
ШI персоналiзує вiдповiдi, використовуючи надану iнформацiю

ШI-асистент

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

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

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

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

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

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

Отримуйте дані користувача лише тоді, коли відкривається чат (найкраще для продуктивності):

// 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джет виявляє fetchUserContext i викликає його автоматично при вiдкриттi чату, тому данi завантажуються лише за потреби.

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

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

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

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

SaaS

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

Підтримка

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

Освіта

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

Гостинність

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

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

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

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

Необов'язково - Чат працює 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ї. Картка статусу покаже:

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

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

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