Контекст пользователя

Передавайте информацию о пользователе для персонализации бесед с ИИ

Тарифы 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 и вызывает его автоматически при открытии чата, так что данные загружаются только по необходимости.

Вы сами решаете, чем делиться. Передавайте только те данные, которые нужны для вашего случая: имя клиента, статус заказа, уровень подписки, содержимое корзины или любую другую информацию, которая поможет ИИ лучше обслуживать ваших пользователей. Используйте описательные метки, чтобы ИИ понимал контекст.

Примеры использования

Электронная коммерция

"Я вижу, что ваш заказ №4521 сейчас в пути и должен прибыть к пятнице."

SaaS

"На вашем тарифе Pro осталось 847 API-вызовов в этом месяце."

Поддержка

"Я вижу, что у вас статус 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

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