Довідковий центр · Посібник із доступу

Кожному клієнтові — потрібні відповіді

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

1. Під’єднайте верифікований вхід для клієнтів

Власник або адміністратор налаштовує доступ у розділі Канали → ваш канал → Довідковий центр. Розробник вашого застосунку один раз під’єднує ідентифікацію клієнтів. Для вмісту лише для відвідувачів можна вибрати «Відвідувачі» без створення процесу входу.

Відкрийте вкладку каналу Онлайн-чат. Якщо до каналу ще не під’єднано вебсайт, під’єднайте його, а потім знайдіть Захищена ідентифікація відвідувачів.
Виберіть Необов’язкова перевірка або Вимагати підтвердження для ідентифікації, виберіть «Згенерувати секрет підпису» й зберігайте його лише на своєму бекенді. Якщо секрет уже налаштовано, у полі «Режим перевірки» виберіть «Необов’язково — перевіряти, якщо є JWT» або «Обов’язково для identify та атрибутів». Режим «Вимагати підтвердження для ідентифікації» все одно дозволяє анонімний чат; доступ до вмісту визначає аудиторія довідкового центру.
Після того як ваш застосунок автентифікує клієнта, ваш сервер підписує короткочасний токен ідентифікації (JWT) з user_id, email, iat, exp і довіреними атрибутами. Беріть тариф і роль із власної бази даних. Непідписані атрибути з браузера й поля контакту не можуть надавати доступ.
Передайте JWT у віджет і під’єднайте дію входу в довідковий центр для тих, хто відкриває розміщені в Sonny сторінки або ваш власний домен. Точний код наведено в посібнику для розробників за посиланням нижче.

Згенеруйте й надішліть верифіковану ідентифікацію

Для прикладу нижче підписані атрибути такі:

JSON · атрибути в підписаному JWT

{"plan":"pro","role":"admin"}

2. Створіть аудиторію «Клієнти Pro»

Поверніться до розділу Довідковий центр. У блоці Аудиторії виберіть Нова аудиторія (кнопка з плюсом) або Створити аудиторію, якщо це ваша перша група.
У полі «Назва» введіть Клієнти Pro. У рядку «Верифікований клієнт має відповідати» залиште усім правилам.
У полі «Атрибут» введіть plan. Для «Умова» виберіть є одним із, а для «Тип значення» — Текст.
Введіть pro і business в окремих рядках у полі «Значення · по одному в рядку». Виберіть Зберегти аудиторію.
Щоб створити групу «Адміністратори», повторіть кроки з атрибутом role, умовою дорівнює, типом значення Текст і значенням admin.

Як працюють правила: «Усі правила» вимагає виконання кожної умови в цій аудиторії, «Будь-яке правило» — принаймні однієї. Можна додати до 10 правил. Усі успадковані аудиторії однаково мають збігатися, навіть якщо конкретна аудиторія використовує «Будь-яке правило».

Текст чутливий до регістру. Число 5 відрізняється від тексту «5»; для порівнянь на кшталт «щонайменше» вибирайте «Число». Відсутні атрибути ніколи не задовольняють порівнянь, зокрема «не дорівнює». «Має значення» виключає null; «Не має значення» охоплює відсутні значення або null. Ключі атрибутів починаються з літери й містять літери, цифри або підкреслення — до 64 символів; зарезервовані ключі ідентифікації, як-от email, не є атрибутами.

3. Застосуйте аудиторію там, де потрібно

Одна стаття

Відкрийте статтю, у полі «Хто може це читати?» виберіть «Верифіковані клієнти», а потім у полі «Аудиторія клієнтів» виберіть «Клієнти Pro». Для нової статті виберіть «Опублікувати», для вже опублікованої — «Зберегти зміни». Якщо базовий доступ успадковано, його не можна змінити, але можна вибрати додаткову аудиторію клієнтів.

Уся категорія

Виберіть олівець поруч із категорією в розділі «Категорії». Виберіть «Верифіковані клієнти» та аудиторію клієнтів, а потім — «Зберегти». Кожна стаття в цій категорії має відповідати цьому обмеженню, а також власному.

Закритий довідковий центр

У розділі «Доступ до довідкового центру» виберіть Верифіковані клієнти. Для аудиторії клієнтів залиште Усі верифіковані клієнти або виберіть Клієнти Pro, щоб обмежити весь центр цією групою.
Укажіть сторінку входу свого застосунку як URL входу для клієнтів, наприклад https://app.example.com/login. Це сторінка входу вашого застосунку, а не вхід для співробітників у Sonny.
Після входу ваш застосунок має перенаправити клієнта на ендпоінт автентифікації довідкового центру зі свіжим підписаним JWT. Самого URL входу для цього з’єднання недостатньо.
Виберіть Зберегти доступ. Залиште центр у статусі «Опубліковано», щоб авторизовані клієнти могли його відкрити.

Під’єднайте вхід для сторінок у Sonny та власного домену

Обмеження сумуються. Якщо довідковий центр вимагає «Клієнти Pro», а категорія — «Адміністратори», то її статті вимагають обох. Значення «Усі» у статті не скасовує обмеження категорії. Відвідувачі та верифіковані клієнти — взаємовиключні базові аудиторії.

4. Перегляньте попередньо, а потім перевірте реальний сеанс клієнта

Угорі розділу «Довідковий центр» змініть Переглянути як на «Відвідувач», «Верифікований клієнт» або «Клієнт з атрибутами…».
Для «Клієнт з атрибутами…» введіть зразок JSON, наведений вище. Притьмарені рядки приховано від цього читача; лічильник враховує статус публікації та всі успадковані обмеження. «Усі статті» повертає до повного списку для авторів.
Скористайтеся таблицею нижче, щоб перевірити довідковий центр лише для Pro з категорією лише для адміністраторів. Змінюйте тариф і роль у зразку, щоб перевірити кожен результат.
Відкрийте справжній браузер без входу в систему, а потім увійдіть як кожен тестовий клієнт. Перевірте перегляд, пошук, пряме посилання на статтю та вкладку «Довідка» у віджеті. Попередній перегляд атрибутів не виконує вхід і не змінює доступу клієнта.

Очікуваний доступ для центру лише для Pro та категорії лише для адміністраторів
Читач	Довідковий центр	Стаття з категорії для адміністраторів
Відвідувач без входу	Сторінка входу	Приховано
Клієнт Pro, адміністратор	Може читати	Може читати
Клієнт Pro, учасник	Може читати	Приховано
Клієнт безкоштовного тарифу, адміністратор	Повідомлення про доступ	Приховано

Заборонені статті не потрапляють у результати, а прямі URL повертають «не знайдено». Закритий довідковий центр замість вмісту показує брендовану сторінку входу або повідомлення про доступ. Його карта сайту порожня, а індексування заборонено; статті лише для відвідувачів також не потрапляють у публічні карти сайту. Відповіді AI та пошук для Copilot застосовують ті самі правила до верифікованої ідентифікації клієнта в розмові.

URL завантажених зображень публічні. Обмеження доступу до статті не захищає її зображення, якщо хтось уже має їхній URL.

Зміна або видалення аудиторії

Щоб змінити аудиторію, натисніть кнопку з олівцем і виберіть «Зберегти аудиторію». Зміни правил діють з наступного запиту. Для оновлених атрибутів клієнта потрібен новий JWT або повторний вхід у довідковий центр; наявні підписані сеанси читачів зберігають свої атрибути до завершення терміну дії.

Щоб прибрати іменоване обмеження з одного місця, у полі «Аудиторія клієнтів» виберіть «Усі верифіковані клієнти» (або «Усі з успадкованої аудиторії») і збережіть. Щоб зробити цей вміст публічним, також виберіть «Усі» в полі «Хто може це читати?» і переконайтеся, що батьківські елементи дозволяють публічний доступ.

Кнопка видалення аудиторії показує, скільки статей, категорій і довідкових центрів її використовують. Видалення прибирає правила атрибутів цієї групи; пов’язаний вміст залишається доступним лише верифікованим клієнтам і зберігає всі інші успадковані обмеження. Клієнти, які раніше не відповідали видаленому правилу, тепер можуть отримати доступ. Перш ніж підтвердити, перегляньте ці призначення.

Усунення проблем із доступом

Верифікований клієнт бачить сторінку входу: Перевірте «Режим перевірки» на вкладці «Онлайн-чат» цього каналу, термін дії JWT, секрет підпису та URL входу в довідковий центр. Вхід співробітників у панель керування не пов’язаний із входом клієнтів.
Клієнт увійшов, але не може прочитати відповідь: Перевірте кожну успадковану аудиторію, а також точні назви, типи й значення підписаних атрибутів. Клієнт Pro все одно може не пройти правило «Адміністратори» для категорії.
Поле «Хто може це читати?» неактивне: Базову аудиторію задає довідковий центр або категорія. Щоб її змінити, відредагуйте батьківський елемент; щоб ще більше звузити верифікований доступ, використовуйте «Аудиторія клієнтів».
З’являється повідомлення «Немає відповідних читачів»: Обмеження «лише для відвідувачів» і «лише для верифікованих» суперечать одне одному. Використайте успадкований доступ, якщо його запропоновано, або спершу виправте налаштування довідкового центру чи категорії.
Тариф змінився, а доступ — ще ні: Створіть новий JWT з оновленими атрибутами й повторіть ідентифікацію у віджеті. Для сторінок у Sonny або на власному домені знову виконайте вхід у довідковий центр. Наявні файли cookie зберігають свої підписані атрибути до завершення терміну дії.
Статті немає в пошуку або у віджеті: Переконайтеся, що статтю опубліковано, центр має статус «Опубліковано», для результатів пошуку ввімкнено «Пошук», а читач відповідає всім обмеженням. Порожня вкладка «Довідка» приховується.