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

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

Тарифы Standard и Pro

Обзор

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

Это создаёт бесшовный опыт, при котором ИИ уже «знает» о пользователе — его тарифный план, статус заказа, баллы лояльности или любые другие данные, которыми вы решите поделиться.

Как это работает

Enable User Context in your dashboard settings
Add JavaScript to your website that sets user data
ИИ получает контекст с каждым сообщением пользователя
ИИ персонализирует ответы на основе предоставленной информации

ИИ-ассистент

Где мой заказ?

Привет, Сара! Я только что проверил ваш заказ №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>

Set the context after your app loads user data:

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

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

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

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

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

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

SaaS

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

Поддержка

"Я вижу, что вы Gold-участник с 3 открытыми тикетами. Чем могу помочь?"

Образование

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

Гостеприимство

"Your booking for September 17th is confirmed. Check-in starts at 3 PM."

Здравоохранение

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

Важные замечания

Необязательно - Чат прекрасно работает и без пользовательского контекста. Это дополнительная возможность для авторизованных пользователей.

В реальном времени - Контекст передаётся с каждым сообщением, поэтому вы можете обновлять его динамически по мере изменения данных пользователя.

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

Ограничения по размеру - Пользовательский контекст ограничен 2 000 символами на тарифе Standard и 10 000 символами на Pro. При превышении лимита он будет обрезан. Старайтесь формулировать контекст кратко.

Статус интеграции

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

Принимается ли контекст
Последнее сообщение с контекстом
Предпросмотр отправляемых контекстных данных

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