Обратно към таблото

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

Научете как да използвате Asyntai

Потребителски контекст

Предайте информация за потребителя, за да персонализирате AI разговорите

Конфигуриране на потребителски контекст
Планове Standard и Pro

Преглед

Потребителският контекст ви позволява да предавате информация за влезли потребители на AI. Когато предоставите потребителски контекст, AI може да поздравява потребителите по име, да се позовава на детайлите на техния акаунт и да предоставя персонализирани отговори, без да пита за информация, която вече имате.

Това създава безпроблемно изживяване, при което AI вече "знае" за потребителя - техния абонаментен план, статус на поръчка, точки за лоялност или всякакви други релевантни данни, които изберете да споделите.

Как работи

  1. Enable User Context in your dashboard settings
  2. Add JavaScript to your website that sets user data
  3. AI получава контекста с всяко съобщение, което потребителят изпраща
  4. AI персонализира отговорите, използвайки предоставената информация
ИИ асистент
Къде е моята поръчка?
Здравейте, Сара! Току-що проверих вашата поръчка #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 и го извиква автоматично, когато чатът се отвори, така че данните се зареждат само когато е необходимо.

Вие решавате какво да споделите. Предайте само данните, релевантни за вашия случай - име на клиента, статус на поръчка, ниво на абонамент, съдържание на количка или друга информация, която помага на AI да обслужва вашите потребители по-добре. Използвайте описателни етикети, за да може AI да разбере контекста.

Примери за използване

Електронна търговия

"Виждам, че вашата поръчка #4521 в момента е в транзит и трябва да пристигне до петък."

SaaS

"Имате 847 оставащи API заявки този месец на вашия план Pro."

Поддръжка

"Виждам, че сте член Gold с 3 отворени тикета. Как мога да помогна?"

Образование

"You're 78% through the JavaScript course. Ready to start Module 8?"

Хотелиерство

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

Здравеопазване

"Следващият ви час при д-р Смит е насрочен за вторник в 10:00."

Важни бележки

Незадължително - Чатът работи перфектно без потребителски контекст. Това е подобрение за влезли потребители.
В реално време - Контекстът се изпраща с всяко съобщение, така че можете да го актуализирате динамично при промяна на потребителските данни.
Сигурност - Никога не включвайте пароли, номера на кредитни карти или други чувствителни данни. Предавайте само нечувствителна информация.
Ограничения на размера - Потребителският контекст е ограничен до 2 000 символа на Standard и 10 000 символа на Pro. Ако бъде надвишен, ще бъде съкратен, за да се побере. Поддържайте контекста кратък.

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

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

  • Дали контекстът се получава
  • Последно съобщение с контекст
  • Преглед на изпращаните данни за контекст