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

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

Тарифи Standard, Pro та Enterprise

Огляд

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

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

Як це працює

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

ШІ-асистент

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

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

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

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

Реалізація

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

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

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

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

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

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

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

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

SaaS

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

Підтримка

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

Освіта

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

Гостинність

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

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

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

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

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

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

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

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

Це не контроль доступу - User context is set by your page in the visitor's browser, so it must never be what stands between a visitor and restricted content. To restrict which knowledge items a visitor can retrieve at all, use Access Tags (Enterprise) — enforced on our servers with a claim signed by your own back end.

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

After implementing, visit the User Context settings page to verify your integration is working. The status card will show:

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

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

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