Посібник SEMJAT зі скріншотами, створений на основі реального процесу інформаційної панелі sem.chat. Кожен посібник розповідає, що клацати, що має статися після клацання, як це перевірити, як усунути несправності та що робити далі.
Примітка щодо знімків екрана: кожне зображення в цьому посібнику зроблено з реального застосунку sem.chat із використанням демонстраційного робочого простору. Конфіденційні дані акаунта, дані клієнтів, API-ключі, платіжні відомості та вміст приватних розмов маскуються перед публікацією.
01
Початок роботи
Створіть обліковий запис, завершіть адаптацію, ознайомтеся з інформаційною панеллю, створіть першого бота, перевірте його приватно, встановіть і виберіть правильний план.
/authРеєстрація, пробна версія та перший бот
1Почніть із реєстрації або входу з загальнодоступного сайту чи програми.
2Перевірте адресу електронної пошти, перш ніж покладатися на сповіщення або платіжні повідомлення.
3Використовуйте адаптацію, щоб створити першого бота, перш ніж відкривати інформаційну панель.
/оглядОгляд після входу
1Використовуйте швидкі дії для створення бота, перегляду ботів, відкриття аналітики або керування платежами.
2Перш ніж вносити зміни, перегляньте активних ботів, conversations, голосові хвилини та задоволення.
3Перевіряйте останні дії після кожного тесту налаштування.
Перший запуск
Зареєструйтеся, почніть пробну версію та ознайомтеся з інформаційною панеллю
Для чого це: Використовуйте цей робочий процес для абсолютно нового робочого простору або під час залучення напарника, який ніколи не використовував sem.chat.
Перш ніж почати
Використовуйте корпоративну електронну адресу, яка може отримувати електронні листи для підтвердження та рахунків.
Перш ніж запросити решту команди, вирішіть, кому належатиме робочий простір.
Підготуйте безпечний тестовий веб-сайт або проміжну сторінку до встановлення віджета.
1
Відкрийте сторінку реєстрації в програмі
Перейдіть до app.sem.chat/auth на веб-сайті Кнопка входу/реєстрації.
Очікуваний результат: На сторінці автентифікації показано параметри входу та створення облікового запису.
2
Створіть обліковий запис
Введіть корпоративну електронну адресу, створіть пароль і надішліть форму реєстрації.
Очікуваний результат: Додаток запитує підтвердження або переходить до реєстрації після того, як обліковий запис прийнято.
3
Підтвердьте електронну адресу
Відкрийте електронний лист із підтвердженням і натисніть посилання для підтвердження.
Очікуваний результат: Обліковий запис може отримувати повідомлення про виставлення рахунків, запрошення, звіти та сповіщення.
4
Завершити адаптацію
Введіть назву компанії, опишіть ціль помічника, виберіть початковий колір і створіть першого бота.
Очікуваний результат: Робоча область відкривається з чернеткою бота та активним пробним станом.
5
Відкрийте Огляд
Натисніть Огляд на лівій бічній панелі.
Очікуваний результат: Інформаційна панель показує картки usage, швидкі дії та останні дії.
6
Виберіть наступну дію
Використовуйте «Створити нового бота» для налаштування, «Переглянути всіх ботів» для керування, «Аналітика» для продуктивності або «Оплата» для обмежень плану.
Очікуваний результат: Ви знаєте, куди продовжити, залежно від стану робочої області.
Як це перевірити: Створіть одного приватного тестового бота та надішліть тестове повідомлення, перш ніж запрошувати товаришів по команді. Підтвердьте зміни активності огляду після тесту.
проблема
Виправити
Електронна пошта для підтвердження не надходить
Перевірте спам, підтвердьте правопис електронної пошти, а потім надішліть запит на інший електронний лист для підтвердження.
Інформаційна панель відкривається в Billing
Для робочого простору може знадобитися активна пробна версія або план. Почніть пробну версію або виберіть правильний план перед налаштуванням.
Напарник не може отримати доступ до робочої області
Запросіть їх із налаштувань, команди замість того, щоб повідомляти ім’я власника.
Що робити далі: Створіть першого бота, перевірте його приватно, а потім встановіть віджет на початковій сторінці.
Приватний тест запуску
Створіть перший приватний тест бота перед тим, як почати роботу
Для чого це: Використовуйте це, щоб підтвердити відстеження облікового запису, бота, віджета та історії, перш ніж клієнти побачать помічника.
Перш ніж почати
Підготуйте зразок запитання клієнта.
Підготуйте проміжну сторінку або локальну тестову сторінку HTML.
Не використовуйте реальні дані клієнтів у першому тесті.
1
Відкрити My Bots
Натисніть My Bots на бічній панелі або скористайтеся «Переглянути всіх ботів» із огляду.
Очікуваний результат: Ви можете побачити бота, створеного під час реєстрації, або порожній стан за допомогою кнопки «Новий бот».
2
Відкрийте конструктор ботів
Натисніть Новий бот або Редагувати на існуючому боті.
Очікуваний результат: Bot Builder відкривається з елементами керування Основами, Віджетами, Знаннями, Голосом та інтеграцією.
3
Збережіть бота один раз
Введіть необхідне ім’я бота та перше повідомлення, а потім натисніть «Зберегти».
Очікуваний результат: Бот отримує дійсний ідентифікатор і може генерувати код для вбудовування.
4
Попередній перегляд приватно
Скористайтеся панеллю попереднього перегляду та поставте свій зразок запитання.
Очікуваний результат: Відповідь має відповідати вашим інструкціям або показувати, яких знань не вистачає.
5
Встановити на сцені
Відкрийте Embed, скопіюйте фрагмент HTML і вставте його перед кінцевим тегом body на початковій сторінці.
Очікуваний результат: Віджет з’являється в налаштованому кутку на комп’ютері та мобільному пристрої.
6
Підтвердити відстеження
Відкрийте папку "Вхідні" або Chat History після тестової розмови.
Очікуваний результат: Тестова бесіда з’являється з правильним ботом, каналом і історією повідомлень.
Як це перевірити: Надішліть одне текстове повідомлення та один голосовий тест, якщо голос увімкнено. Переконайтеся, що обидва з’являються в Chat History.
проблема
Виправити
Код вбудовування недоступний
Спочатку збережіть бота. Якщо голосова синхронізація все ще очікує, зачекайте на синхронізацію або збережіть знову після заповнення необхідних полів.
Віджет показує не того бота
Переконайтеся, що data-bot-id у фрагменті відповідає ідентифікатору бота з модального вставлення.
Жодна розмова не відображається в історії
Оновіть Chat History, підтвердьте, що бот активний, і переконайтеся, що перевірка виконана на встановленому віджеті, а не на застарілій сторінці.
Що робити далі: Перейдіть до налаштування Bot Builder і навчання знанням.
02
Створення та налаштування бота
Створюйте, редагуйте, переглядайте, активуйте, передавайте або видаляйте ботів із My Bots та Bot Builder.
/панель приладівЦентр управління My Bots
1Натисніть New Bot, щоб створити нового помічника.
2Використовуйте Редагувати, Вставити, Перенести, Активувати або Видалити на кожній картці бота.
3Перед тестуванням перевірте активний стан і час останнього оновлення.
/bots/:id/editBot Builder основна вкладка
1Введіть назву бота, аватар, перше повідомлення та системні інструкції.
2Використовуйте попередній перегляд для перевірки перед публікацією.
3Збережіть і синхронізуйте перед копіюванням коду вбудовування.
Створити бота
Створити нового бота з My Bots
Для чого це: Використовуйте цей робочий процес, коли новому бренду, веб-сайту, черзі підтримки чи кампанії потрібен власний помічник.
Перш ніж почати
Підготуйте ім’я бота, ціль, перше повідомлення та два-три приклади запитань.
Зберіть загальнодоступний веб-сайт URL, якщо ви плануєте імпортувати вміст.
Підтвердьте, що план дозволяє використовувати необхідну кількість ботів і голосових функцій/аватарів.
1
Відкрити My Bots
Натисніть My Bots на бічній панелі.
Очікуваний результат: Відображаються наявні боти та кнопка «Новий бот».
2
Натисніть Новий бот
Запустіть нового бота зі сторінки My Bots.
Очікуваний результат: Bot Builder відкривається з помічником для чернеток.
3
Встановити ідентифікатор бота
Введіть назву бота, завантажте або виберіть аватар і напишіть перше повідомлення, яке побачать відвідувачі.
Очікуваний результат: Панель попереднього перегляду відображає ім’я помічника, аватар і привітання.
4
Напишіть системні інструкції
Опишіть, що бот повинен робити, як він повинен говорити, чого він повинен уникати та коли він повинен просити допомоги людини.
Очікуваний результат: Помічник має чіткі правила поведінки перед тим, як додавати знання.
5
Додати базові знання
Вставте важливу компанію, продукт, підтримку, ціни та контактну інформацію в область знань.
Очікуваний результат: Бот може відповідати на типові запитання, поки не потребуючи імпорту веб-сайту.
6
Збережіть бота
Натисніть «Зберегти» та дочекайтеся підтвердження збереження або синхронізації.
Очікуваний результат: Бот має стабільний ідентифікатор, можна протестувати попередній перегляд і доступні опції вбудовування.
7
Перегляньте результат
Поставте підготовлені зразки запитань у Preview.
Очікуваний результат: Відповіді повинні відповідати інструкціям і використовувати знання, які ви ввели.
8
Активуйте лише тоді, коли будете готові
Увімкніть бота після проходження приватного тесту.
Очікуваний результат: Бот готовий до трафіку віджетів або каналів.
Як це перевірити: Задайте принаймні п'ять реалістичних питань. Перевірте, чи правильна відповідь, чи залишається вона на бренді та чи запитує людину, коли це необхідно.
проблема
Виправити
Відповідь занадто загальна
Додайте більше конкретних знань і перепишіть інструкції з прикладами хороших відповідей.
Бот відмовляється від питань, на які повинен відповідати
Видаліть надто суворі інструкції та додайте надійні знання для цієї теми.
Збереження не генерує код вбудовування
Перевірте обов’язкові поля та збережіть знову після завершення синхронізації голосового провайдера.
Що робити далі: Налаштуйте параметри віджета, додайте знання веб-сайту, а потім встановіть бота.
Керуйте ботами
Редагувати, клонувати робочий процес, передавати, деактивувати або видаляти бота
Для чого це: Використовуйте цей робочий процес, коли боту потрібні оновлення, зміни власника, тимчасова пауза або остаточне видалення.
Перш ніж почати
Експортуйте будь-яку розмову або контактні дані, які потрібно зберегти перед видаленням бота.
Переконайтеся, що бот не вбудовано в активний веб-сайт, перш ніж видаляти або передавати його.
Повідомте товаришів по команді, перш ніж дезактивувати робочого бота.
1
Відкрити My Bots
Знайдіть картку бота за назвою або статусом.
Очікуваний результат: Картка показує поточний стан і доступні дії.
2
Натисніть Редагувати
Відкрийте конструктор ботів і внесіть необхідні зміни.
Очікуваний результат: Редактор завантажує поточну конфігурацію.
3
Збережіть і протестуйте повторно
Натисніть «Зберегти» після кожної зміни матеріалу, а потім запустіть запитання попереднього перегляду.
Очікуваний результат: Збережена конфігурація використовується для попереднього перегляду та встановленого віджета.
4
Тимчасово вимкнути
Використовуйте активний перемикач, якщо бот має наразі припинити обробку відвідувачів.
Скористайтеся передачею, введіть електронну адресу одержувача та підтвердьте.
Очікуваний результат: Вибраний обліковий запис отримує право власності відповідно до потоку передачі програми.
6
Видаляти тільки після перевірок
Використовуйте Delete, прочитайте попередження та підтверджуйте лише тоді, коли бот більше не потрібен.
Очікуваний результат: Бот і пов’язану з ним конфігурацію видаляються відповідно до попередження.
Як це перевірити: Після редагування відкрийте встановлений віджет і задайте точне запитання, яке спонукало до зміни. Підтвердьте зміну прямої відповіді.
проблема
Виправити
Стара відповідь все ще відображається
Оновіть сторінку веб-сайту, підтвердьте, що ви зберегли правильного бота, і перевірте, чи потребують імпортовані знання синхронізації.
Помилка передачі
Переконайтеся, що адреса електронної пошти одержувача дійсна та що цільовий обліковий запис може прийняти бота.
Видалити було натиснуто помилково
Зупиніться перед остаточним підтвердженням. Попередження про видалення існують, оскільки ця дія може остаточно видалити дані бота.
Що робити далі: Перегляньте аналітику та історію після змін у реальному часі, щоб переконатися, що відвідувачі покращили роботу.
03
Встановіть віджет
Скопіюйте правильний код вбудовування, установіть його в HTML, WordPress, React або розширеному контексті SDK, а потім перевірте поведінку комп’ютера та мобільного пристрою.
1Виберіть HTML, WordPress, React або NPM/SDK на основі стека сайту.
2Скопіюйте код після збереження та синхронізації бота.
3Вставте фрагмент перед закриваючим тегом body або в структуру макета.
HTML встановити
Встановіть віджет на стандартний веб-сайт HTML
Для чого це: Використовуйте це, коли ви можете редагувати шаблон сторінки, нижній колонтитул теми або глобальний макет HTML.
Перш ніж почати
Спершу збережіть бота, щоб модаль вбудовування мала справжній ідентифікатор бота.
Використовуйте проміжний сайт перед виробництвом.
Збережіть точну версію сценарію та data-bot-id з модального.
1
Відкрити My Bots
Знайдіть бота, якого хочете встановити, і натисніть «Вставити».
Очікуваний результат: Модаль «Вставлення» відкривається з вкладками встановлення.
2
Виберіть HTML
Виберіть вкладку HTML і натисніть «Копіювати код».
Очікуваний результат: Сценарій віджета копіюється з доданим ідентифікатором бота.
3
Відкрийте шаблон сайту
Відредагуйте глобальний нижній колонтитул або файл макета, який відображається на кожній сторінці, де має відображатися віджет.
Очікуваний результат: Ви редагуєте спільну оболонку сайту, а не окрему ізольовану сторінку, якщо це не зроблено навмисно.
4
Вставте перед закриттям тіла
Вставте фрагмент безпосередньо перед кінцевим тегом body.
Очікуваний результат: Сценарій завантажується після вмісту сторінки та може монтувати контейнер віджетів.
5
Опублікувати або розгорнути
Збережіть шаблон і розгорніть сайт.
Очікуваний результат: Сценарій віджета працює на цільових сторінках.
6
Перевірте комп’ютер і мобільний пристрій
Відкрийте сайт у новому вікні браузера та у вікні перегляду мобільного пристрою.
Очікуваний результат: Віджет з’являється у налаштованому положенні та відкривається без помилок консолі.
Як це перевірити: Надішліть повідомлення зі сторінки в реальному часі, потім відкрийте папку "Вхідні" та Chat History, щоб підтвердити, що розмова належить правильному боту.
проблема
Виправити
Віджет відсутній
Переконайтеся, що код знаходиться перед закриваючим тегом body, сценарії не блокуються розробником сайтів і бот активний.
З'являється не той бот
Скопіюйте фрагмент ще раз і порівняйте data-bot-id з потрібним ботом.
Віджет перекриває елементи керування сторінки
Змініть положення або розмір у налаштуваннях віджета та перевірте ще раз на мобільному пристрої.
Що робити далі: Налаштуйте параметри віджета та захоплення відведення після встановлення.
Встановіть у потоках WordPress, React або розширеному голосовому SDK
Для чого це: Використовуйте це, якщо веб-сайтом керує CMS, програма React або спеціальна голосова інтеграція.
Перш ніж почати
Дізнайтеся, якому стеку належить спільний макет.
Використовуйте точний фрагмент, показаний у sem.chat для вибраного бота.
Для розширеного використання SDK підтвердьте, що у вас є необхідний відкритий ключ Vapi та ідентифікатор помічника.
1
WordPress варіант
Використовуйте Appearance, Theme Editor, footer.php або надійний плагін для верхніх і нижніх колонтитулів.
Очікуваний результат: Фрагмент завантажується на загальнодоступних сторінках WordPress.
2
React варіант
Створіть невеликий компонент ChatWidget, додайте сценарій у useEffect і відтворіть його в кореневому макеті.
Очікуваний результат: Віджет завантажується один раз і очищається, якщо макет відключається.
3
Розширений параметр SDK
Використовуйте вкладку NPM/SDK лише тоді, коли вам потрібні користувацькі засоби керування голосовими викликами, окрім стандартного віджета.
Очікуваний результат: Ваша програма контролює голосовий сеанс, тоді як sem.chat залишається налаштованим джерелом помічника.
4
Перевірте ідентифікатор бота
Переконайтеся, що встановлений код посилається на ідентифікатор бота з модального вставлення.
Очікуваний результат: Живий віджет підключається до призначеного помічника.
5
Перевірте консоль
Відкрийте інструменти розробника браузера та перезавантажте.
Очікуваний результат: Немає заблокованих сценаріїв, дублікатів контейнерів або помилок мережі.
Як це перевірити: Заповніть одне тестове повідомлення зі встановленого сайту, а потім переконайтеся, що воно з’являється у папці «Вхідні» з очікуваною сторінкою URL.
проблема
Виправити
React завантажує дублікати віджетів
Захистіть вставку сценарію з посиланням або відтворіть компонент лише в кореневому макеті.
WordPress видаляє теги сценарію
Використовуйте плагін для введення нижнього колонтитула або файл теми, який дозволяє сценарії.
Виклик SDK не може розпочатися
Перевірте відкритий ключ, ідентифікатор помічника, дозволи браузера та голосовий доступ до плану.
Що робити далі: Перейдіть до налаштувань віджетів, щоб контролювати поведінку, брендинг і захоплення потенційних клієнтів.
npm install @vapi-ai/web
import Vapi from '@vapi-ai/web';
const vapi = new Vapi('YOUR_VAPI_PUBLIC_KEY');
await vapi.start('YOUR_ASSISTANT_ID');
vapi.on('call-start', () => console.log('Call started'));
vapi.on('call-end', () => console.log('Call ended'));
04
Налаштування віджета
Налаштуйте режим, тему, розмір, позицію, колір, брендинг, реакції, звук, згоду, захоплення потенційних клієнтів, рейтинги, подальшу електронну пошту та стан активації.
Bot Builder / ВіджетЗовнішній вигляд віджета та поведінка відвідувача
1Виберіть chat, голосовий або гібридний режим.
2Встановіть тему, колір, положення, розмір, брендинг, згоду та звук.
3Налаштуйте захоплення потенційних клієнтів, оцінки, реакції та подальшу поведінку.
Поведінка віджета
Налаштувати поведінку віджета для відвідувачів
Для чого це: Використовуйте це після першого встановлення або будь-коли, коли віджет має відповідати веб-сайту та залучати кращих потенційних клієнтів.
Перш ніж почати
Встановіть віджет на проміжну сторінку.
Дізнайтеся, чи мають відвідувачі починати з chat, голосу чи обох.
Підготуйте згоду та копію для захоплення потенційних клієнтів, якщо це потрібно для регіону.
1
Відкрийте конструктор ботів
Відкрийте My Bots, натисніть «Редагувати», а потім виберіть вкладку «Віджети».
Очікуваний результат: Для вибраного бота з’являться елементи керування віджетом.
2
Виберіть режим
Виберіть «Чат», «Голосовий зв’язок» або «Гібрид» відповідно до бажаного досвіду відвідувачів.
Очікуваний результат: Попередній перегляд змінюється, щоб показати вибраний режим.
3
Зовнішній вигляд комплекту
Виберіть тему, колір, розмір, розташування кнопок і варіанти брендування.
Очікуваний результат: Віджет відповідає сайту, не охоплюючи важливого вмісту.
4
Увімкнути елементи керування відвідувачами
Увімкніть або вимкніть реакції, звук, оцінки та підказки щодо згоди.
Очікуваний результат: Відвідувачі бачать лише ті елементи керування, які ви бажаєте їм використовувати.
5
Налаштувати захоплення відведення
Виберіть обов’язкові поля, необов’язкове поле опису та коли з’явиться форма.
Очікуваний результат: Контакти збираються до або під час conversations відповідно до ваших налаштувань.
6
Налаштуйте подальшу електронну пошту
Налаштуйте поведінку подальших електронних листів, якщо це передбачено вашим планом.
Очікуваний результат: Відвідувачі можуть отримувати подальші повідомлення після вирішення conversations.
7
Збережіть і протестуйте
Натисніть «Зберегти», перезавантажте початкову сторінку та відкрийте віджет.
Очікуваний результат: Живий віджет відповідає збереженим налаштуванням.
Як це перевірити: Відкрийте віджет на комп’ютері та мобільному пристрої, надішліть форму потенційного клієнта, залиште оцінку та підтвердьте, що контакт і розмова записані.
проблема
Виправити
Колір не оновлювався
Збережіть бота, жорстко оновіть веб-сайт і переконайтеся, що встановлений віджет використовує той самий ідентифікатор бота.
Відсутні свинцеві поля
Переконайтеся, що захоплення електроду ввімкнено та вибрана умова тригера виконана.
Відвідувачі не можуть використовувати голос
Перевірте налаштування Voice, дозвіл мікрофона браузера, доступ до тарифного плану та ліміти голосових хвилин.
Що робити далі: Додайте налаштування голосу/аватара та джерела знань перед запуском виробництва.
05
Голос і Аватари
Вибирайте стандартні голоси, налаштовуйте голосовий режим і обмеження, читайте стенограми, клонуйте голоси, призначайте клоновані голоси та керуйте стандартними або власними аватарами.
Bot Builder / ГолосГолос, ліміти, стенограми та аватари
1Виберіть стандартний голос або збережений клонований голос.
2Встановіть обмеження на хвилину голосу та збереження розшифровки.
3Виберіть стандартні аватари або завантажте власний аватар, якщо це дозволяє план.
Налаштування голосу
Налаштуйте голосові виклики та розшифровку
Для чого це: Використовуйте це, коли відвідувачі повинні спілкуватися з ботом, а не просто вводити текст.
Перш ніж почати
Підтвердьте, що план включає хвилини голосового зв’язку та бажані параметри голосу/аватара.
Для тестування використовуйте тихе середовище браузера.
Підготуйте одне реалістичне запитання служби підтримки чи продажів для голосового тестування.
1
Відкрийте налаштування голосу
Відкрийте конструктор ботів і виберіть область «Голос» або «Голос і аватари».
Очікуваний результат: Видно голосове керування та поточний вибір голосу.
2
Виберіть стандартний голос
Перегляньте доступні голоси, виберіть найкращий варіант і збережіть вибір.
Очікуваний результат: Бот використовує обраний голос для дзвінків.
3
Налаштувати голосовий режим
Використовуйте параметри віджетів, щоб вибрати голос або гібрид, коли голос має бути доступним для відвідувачів.
Очікуваний результат: Відвідувачі бачать опцію голосу у віджеті.
4
Встановіть обмеження голосу
Визначте обмеження для кожного користувача або робочого простору, якщо доступно.
Очікуваний результат: Довгі або повторювані дзвінки не можуть займати більше хвилин, ніж заплановано.
5
Увімкнути стенограми
Увімкніть збереження розшифровки, якщо вам потрібно переглянути розмову в історії.
Очікуваний результат: Голосові дзвінки створюють читабельні стенограми після сеансу.
6
Перевірте дзвінок
Відкрийте віджет, надайте доступ до мікрофона, почніть дзвінок і задайте підготовлене запитання.
Очікуваний результат: Бот відповідає голосом, і дзвінок закінчується чисто.
7
Прочитайте стенограму
Відкрийте Chat History і знайдіть голосову розмову.
Очікуваний результат: Стенограма показує, що сказали відвідувач і бот.
Як це перевірити: Здійсніть один короткий дзвінок і переконайтеся, що хвилини голосу, стенограма та режим розмови записані.
проблема
Виправити
Браузер блокує мікрофон
Надайте доступ до мікрофона в браузері та перезавантажте сторінку.
Опцію голосу заблоковано
Відкрийте Billing і підтвердьте, що план робочого простору включає голосові функції.
Стенограма порожня
Переконайтеся, що збереження розшифровки ввімкнено, і дзвінок завершився нормально.
Що робити далі: Додайте або уточніть знання, щоб голосові відповіді були точними.
Голосовий клон і аватар
Клонуйте голос і призначте власний аватар
Для чого це: Використовуйте це, коли помічникові потрібен фірмовий голос або розмовний аватар.
Перш ніж почати
Використовуйте лише аудіо та зображення, на використання яких ви маєте дозвіл.
Записуйте зразки чистого голосу з низьким фоновим шумом.
Підтвердьте обмеження плану для клонованих голосів і власних аватарів.
1
Відкрити клонування голосу
Натисніть «Клонувати голос» в області «Голос».
Очікуваний результат: У діалоговому вікні завантаження показано прийняті зразки вимог.
2
Завантажте зразки
Завантажте від одного до п’яти чистих записів і надішліть запит на клонування.
Очікуваний результат: Склонований голос з’являється після обробки або діалогове вікно показує наступну вимогу.
3
Призначте клонований голос
Виберіть клонований голос у виборі голосу та збережіть.
Очікуваний результат: У майбутніх дзвінках використовуватиметься клонований голос.
4
Виберіть стандартний аватар
Виберіть доданий аватар, якщо завантаження власного аватара не потрібне.
Очікуваний результат: Голосовий досвід має візуальну ідентифікацію.
5
Завантажте власний аватар
Завантажте чітке зображення обличчя або коротке відео, якщо ваш план це підтримує.
Очікуваний результат: Аватар обробляється і стає доступним для вибору.
6
Запустіть повний попередній перегляд
Почніть голосовий дзвінок і разом підтвердьте голос, аватар і транскрипцію.
Очікуваний результат: Взаємодія з відвідувачем відповідає налаштованому бренду.
Як це перевірити: Поставте коротке запитання, вибравши клонований голос, і підтвердьте, що виклик використовує очікуваний голос/аватар.
проблема
Виправити
Якість клону погана
Записуйте чистіші зразки з одним динаміком, стабільною гучністю та без музики.
Завантаження власного аватара недоступне
Перевірте платіжну інформацію щодо обмежень щодо обмежень для аватарів.
Старий голос все ще грає
Збережіть бота після вибору нового голосу та перезавантажте сторінку віджета.
Що робити далі: Перейдіть до знань і даних, щоб голосовий досвід мав точні відповіді.
06
Знання та дані
Додайте ручні знання, імпортуйте вміст веб-сайту, застосовуйте результати сканування, синхронізуйте імпортований вміст, додайте канал продуктів URLs, оновлюйте або видаляйте канали та перевіряйте відповіді за допомогою тестових запитань.
__СЕМЧАТ_0__ / ЗнанняДжерела знань і тестування відповідей
1Додайте ручні знання щодо політики, ціноутворення та правил бренду.
2Імпорт сторінок веб-сайту та застосування результатів сканування.
3Додайте канали продуктів і синхронізуйте їх, коли змінюється асортимент.
Джерела знань
Навчіть бота знанням інструкцій, імпорту веб-сайтів і каналів продуктів
Для чого це: Використовуйте це щоразу, коли помічник дає неповні відповіді або потребує свіжої інформації про продукт, політику чи веб-сайт.
Перш ніж почати
Підготуйте джерело URLs і канал продукту URLs.
Вирішіть, які сторінки не слід імпортувати, наприклад сторінки адміністратора чи приватні.
Створіть тестові запитання для кожної доданої теми.
1
Відкриті знання
Відкрийте Bot Builder і виберіть вкладку «Знання» або «Дані».
Очікуваний результат: Відображаються ручні знання, імпорт веб-сайту та інструменти каналу продуктів.
2
Додайте ручні знання
Вставте стислі факти, правила, ціни, контактні дані та примітки щодо стилю відповіді.
Очікуваний результат: Бот має безпосереднє надійне джерело для високопріоритетних відповідей.
3
Імпорт вмісту веб-сайту
Вставте загальнодоступний веб-сайт URL і почніть сканування/імпорт.
Очікуваний результат: Результати сканування показують виявлені сторінки або статус імпорту.
4
Перегляньте та застосуйте результати
Зберігайте корисні сторінки, видаліть невідповідні сторінки, а потім застосуйте вибраний вміст.
Очікуваний результат: Лише затверджений вміст веб-сайту входить до бази знань.
5
Додайте фід продукту URLs
Вставте Google Merchant Center або підтримуваний канал URL та імпортуйте.
Очікуваний результат: Товари, ціни, наявність і атрибути стають доступними для бота.
6
Оновіть або видаліть канали
Використовуйте оновлення, коли дані каталогу змінюються, і видаляйте канали, які більше не використовуються.
Очікуваний результат: Бот уникає застарілих або повторюваних даних про продукт.
7
Зберегти та синхронізувати
Збережіть бота та дочекайтеся завершення синхронізації.
Очікуваний результат: Останні знання використовуються для попереднього перегляду та відповідей у віджетах у реальному часі.
8
Ставте контрольні запитання
Поставте одне тестове запитання для кожного джерела, яке ви додали.
Очікуваний результат: Відповідь цитує або точно відображає оновлений вміст.
Як це перевірити: Ставте запитання про ціни, повернення, наявність, інформацію про компанію та непідтримувані теми. Переконайтеся, що бот відповідає на відомі теми і не вигадує невідомі подробиці.
проблема
Виправити
Сканер імпортує невідповідні сторінки
Видаліть ці сторінки з вибраних результатів і додайте чіткіші інструкції вручну.
Ціни на продукцію несвіжі
Оновіть канал і підтвердьте, що сам канал URL містить поточні значення.
Бот складає відповіді
Додайте правило, згідно з яким бот повинен повідомляти, що він не впевнений, і пропонувати підтримку людини, якщо знання відсутні.
Що робити далі: Поверніться до попереднього перегляду, перевірте ще раз, а потім установіть або оновіть віджет.
07
Вхідні, Live Support, Історія, Контакти
Щодня обробляйте conversations, вимагайте запитів на підтримку в реальному часі, повертайте ручне керування до AI, експортуйте історію, керуйте контактами та синхронізуйте контакти з SendPulse.
/вхідніРобочий процес розмови в папці "Вхідні".
1Фільтрувати за ботом або каналом.
2Відкрийте розмову та за потреби дайте відповідь як людина.
3Обережно використовуйте елементи керування перекладом, розв’язуванням і передачею.
/live-supportКонтроль передачі живої підтримки
1Швидко вимагайте передачі в очікуванні.
2Відповідайте як агент або поверніть розмову до ШІ.
3Вирішіть, коли відвідувач більше не потребує людської допомоги.
/chat-історіяІсторія розмов і експорт
1Шукайте за відвідувачем, ботом, каналом або датою.
2Відкрийте повні стенограми для текстових і голосових сеансів.
3За потреби експортуйте CSV або JSON.
/контактиКонтакти та експорт SendPulse
1Фільтруйте контакти за ботом або джерелом.
2Відкрийте контактні дані та контекст розмови.
3Експортуйте або синхронізуйте вибрані контакти в SendPulse.
Відповідь у вхідних
Відкрийте розмову та надішліть людську відповідь
Для чого це: Використовуйте це, коли оператору потрібно відповісти клієнту з sem.chat замість того, щоб дозволити штучному інтелекту продовжувати роботу самостійно.
Перш ніж почати
Переконайтеся, що оператор має доступ до бота або робочої області.
Перш ніж відповісти, прочитайте розмову.
Дізнайтеся, чи очікує відвідувач ту саму мову.
1
Відкрийте папку "Вхідні".
Натисніть «Вхідні» на бічній панелі.
Очікуваний результат: Останні conversations відображаються з ботом, каналом, відвідувачем, статусом і часом.
2
При необхідності відфільтрувати
Використовуйте фільтри каналу, бота, непрочитаного або статусу, щоб знайти розмову.
Очікуваний результат: Список звужується до потрібного вам набору розмов.
3
Відкрийте бесіду
Натисніть рядок відвідувача.
Очікуваний результат: Відображаються повний ланцюжок, інформація про відвідувача та елементи керування відповідями.
4
Перекладіть, якщо потрібно
Використовуйте засоби керування перекладом, якщо мова відвідувача відрізняється від мови агента.
Очікуваний результат: Агент може зрозуміти та відповісти належним чином.
5
Надіслати відповідь
Напишіть відповідь людини та надішліть її.
Очікуваний результат: Повідомлення додається до ланцюжка як відповідь агента/людини.
6
Вирішити або залишити відкритим
Вирішіть розмову, якщо вона завершена, або залиште її відкритою для подальших дій.
Очікуваний результат: Статус папки "Вхідні" відповідає дійсному стану клієнта.
Як це перевірити: Надішліть безпечну тестову відповідь на тестову розмову та переконайтеся, що вона відображається у віджеті відвідувача та Chat History.
проблема
Виправити
Не вдалося надіслати відповідь
Перевірте стан мережі, статус розмови та чи була заявлена підтримка в реальному часі.
Неправильна мова відвідувача
Скористайтеся перекладом або оновіть налаштування мови бота, перш ніж відповідати.
Бесіди немає в папці "Вхідні".
Виконайте пошук Chat History і підтвердьте, що тест віджета використовував правильного бота.
Що робити далі: Використовуйте Live Support для активних черг передачі та Chat History для перевірок.
Жива підтримка
Вимагайте, відповідайте, повертайте ШІ та вирішуйте передачу
Для чого це: Використовуйте це, коли AI запитує людину або відвідувач явно потребує агента.
Перш ніж почати
Перш ніж увімкнути живу підтримку, попросіть агента.
Визначте, коли ШІ повинен запитувати передачу в інструкціях бота.
Увімкніть налаштування сповіщень для сповіщень про передачу.
1
Відкрити Live Support
Натисніть Live Support на бічній панелі.
Очікуваний результат: Очікування та активна передача conversations видимі.
2
Вимагати запит
Натисніть «Подати заявку» на розмову, що очікує.
Очікуваний результат: Інші агенти бачать, що розмова активно обробляється.
3
Прочитайте контекст
Перш ніж відповісти, відкрийте повідомлення та відомості про відвідувача.
Очікуваний результат: Агент розуміє, чому відбулася передача.
4
Надішліть людську відповідь
Відповідайте чітко та оновлюйте тему.
Очікуваний результат: Відвідувач отримує людську відповідь.
5
Поверніть ШІ, якщо потрібно
Скористайтеся рукою назад, коли питання буде вирішено, і ШІ зможе продовжити.
Очікуваний результат: AI відновлює розмову.
6
Вирішіть, коли закінчите
Натисніть Вирішити, коли відвідувач більше не потребуватиме допомоги.
Очікуваний результат: Передача обслуговування закрита та видалена з активної черги.
Як це перевірити: Створіть тестову передачу, вимагайте її, дайте відповідь один раз, поверніть її та підтвердьте зміни статусу в Live Support та Chat History.
проблема
Виправити
Агенти пропускають запити
Увімкніть браузер/електронну пошту/push-сповіщення та додайте процес володіння чергою.
AI продовжує захоплювати надто рано
Налаштуйте інструкції та правила передачі таким чином, щоб контроль людини залишався активним, доки не буде вирішено чи не повернуто.
Зовнішній CRM не синхронізований
Використовуйте веб-хуки або опитування з розділу «Рецепти розробника».
Що робити далі: Підключіть CRM/webhooks, якщо групи підтримки працюють за межами sem.chat.
Історія та контакти
Шукайте, експортуйте та використовуйте записи розмов/контактів
Для чого це: Використовуйте це для перевірок, перегляду потенційних клієнтів, CSV експорту та SendPulse синхронізації.
Перш ніж почати
Вирішіть, чи потрібен вам conversations, контакти чи обидва.
Застосуйте правильний діапазон дат перед експортом.
Не експортуйте більше особистих даних, ніж потрібно.
1
Відкрити Chat History
Натисніть Chat History на бічній панелі.
Очікуваний результат: Відображаються фільтри розмов, статистика та список розшифровок.
2
Пошук і фільтр
Фільтруйте за ботом, каналом, режимом, відвідувачем або діапазоном дат.
Очікуваний результат: Відображаються лише відповідні conversations.
3
Відкрийте стенограму
Клацніть розмову, щоб прочитати повний ланцюжок повідомлень.
Очікуваний результат: Відображаються повний контекст, контактні дані та метадані бесіди.
4
Експортувати conversations
Натисніть «Експорт» і виберіть необхідний формат, якщо він доступний.
Очікуваний результат: Експорт містить відфільтровані дані бесіди.
5
Відкрийте Контакти
Натисніть Контакти на бічній панелі.
Очікуваний результат: Записи потенційних клієнтів/контактів відображаються з джерелом, ботом і статусом.
6
Фільтрувати та експортувати контакти
Знайдіть контакти, виберіть потрібні записи, а потім експортуйте або синхронізуйте з SendPulse.
Очікуваний результат: Вибрані контакти доступні за межами sem.chat відповідно до вибраної дії.
Як це перевірити: Експортуйте невеликий відфільтрований CSV і відкрийте його локально, щоб переконатися, що стовпці та діапазон дат правильні.
проблема
Виправити
У списку контактів відсутній контакт
Переконайтеся, що захоплення потенційних клієнтів увімкнено, і відвідувач подав форму.
Експорт занадто великий
Перед експортом звузьте діапазон дат або бот-фільтр.
Синхронізація SendPulse недоступна
Спочатку підключіть SendPulse в Інтеграціях, а потім поверніться до Контактів.
Що робити далі: Перегляньте Analytics, щоб зрозуміти тенденції продуктивності після виконання операцій.
08
Канали та інтеграції
Підключіть Slack, Facebook, Instagram, WhatsApp, Telegram через BotFather, облікові дані вручну, альтернативні посилання chat, інтеграцію SendPulse та CRM.
/інтеграціїКанали, CRM та підключення електронною поштою
1Виберіть канал або картку інтеграції CRM.
2Дотримуйтесь кроків OAuth або облікових даних для кожного постачальника.
3Від’єднайте або повторно протестуйте інтеграцію з тієї ж сторінки.
Підключіть канали
Підключіть канал обміну повідомленнями або інтеграцію CRM
Для чого це: Використовуйте це, коли sem.chat має отримати conversations за межами віджета веб-сайту або надіслати контакти іншим інструментам.
Перш ніж почати
Мати доступ адміністратора до зовнішньої платформи.
Дізнайтеся, який бот має отримувати повідомлення каналу.
Використовуйте тестові канали перед підключенням робочих облікових записів.
Натисніть «Підключитися» на Slack, мета-каналах, Telegram, SendPulse, CRM або ручних облікових даних.
Очікуваний результат: Відкриється діалогове вікно налаштування або потік OAuth.
3
Повне налаштування провайдера
Для каналів OAuth схваліть запитувані дозволи. Для ручних каналів вставте потрібний маркер, секрет, ідентифікатор облікового запису або вебхук URL.
Очікуваний результат: sem.chat зберігає підключення та показує інтеграцію як підключену.
4
Призначити бота
Виберіть, який бот має обробляти повідомлення з цього каналу, коли з’явиться запит.
Очікуваний результат: Вхідні повідомлення направляються до правильного помічника.
5
Перевірте канал
Надіслати тестове повідомлення із зовнішнього каналу.
Очікуваний результат: Повідомлення з’являється в папці «Вхідні» або Chat History під правильним каналом.
6
Від’єднайте, якщо потрібно
Використовуйте «Відключити від інтеграційної карти», коли канал має припинитися.
Очікуваний результат: sem.chat припиняє отримання або надсилання через цю інтеграцію.
Як це перевірити: Надішліть одне тестове повідомлення через підключений канал і підтвердьте відповідь бота, рядок папки "Вхідні" та запис історії.
проблема
Виправити
Помилка маркера Telegram
Створіть або скиньте маркер у BotFather і вставте його знову.
Slack повідомлень не приходить
Перевірте область дії програми, підписку на подію URL, маркер бота, секретний підпис і членство в каналі.
Помилка підключення метаканалу
Переконайтеся, що обліковий запис Facebook/Instagram/WhatsApp має права адміністратора та необхідний бізнес-доступ.
Помилка синхронізації SendPulse
Повторно підключіть SendPulse і підтвердьте, що контактні поля зіставлені.
Що робити далі: Документуйте канал власності для команди та відстежуйте папку "Вхідні" після запуску.
09
Планування
Створюйте типи подій, налаштовуйте доступність, підключайте календарі, керуйте бронюваннями, створюйте одноразові посилання, налаштовуйте електронні листи для бронювання, переглядайте аналітику, установлюйте платні події та тестуйте загальнодоступні посилання для бронювання.
/ плануванняПланування робочого простору
1Використовуйте вкладки для типів подій, бронювань, аналітики, одноразових посилань, календарів, електронних листів і налаштувань.
2Редагувати, копіювати, вбудовувати, активувати або призупиняти типи подій.
3Скопіюйте загальнодоступне посилання та запустіть тест приватного бронювання.
Редактор подійКонфігурація типу події
1Введіть назву, опис, тривалість, розташування та буфери.
2Встановіть доступність, вікна бронювання, запитання, варіанти оплачуваної події та правила скасування.
3Відвідувачі підтверджують бронювання та отримують підтвердження електронною поштою.
Тип події
Створіть тип події та опублікуйте посилання на бронювання
Для чого це: Використовуйте це, коли відвідувачам потрібно замовити демонстрації, консультації, дзвінки з продажу, ознайомлення або сеанси підтримки.
Перш ніж почати
Виберіть назву події, тривалість, тип зустрічі та власника.
Перш ніж ділитися посиланнями, встановіть часовий пояс і доступність.
Підключіть календарі, якщо подвійне бронювання має значення.
1
Відкрийте планування
Натисніть «Планування» на бічній панелі.
Очікуваний результат: Робоча область планування показує вкладки для типів подій, бронювань, аналітики, одноразових посилань, календарів, електронних листів і налаштувань.
2
Створіть тип події
Натисніть «Створити», а потім додайте назву, опис, тривалість, місце розташування, буфер і правила бронювання.
Очікуваний результат: Подія має достатньо публічної інформації, щоб її зрозуміли відвідувачі.
3
Встановити наявність
Налаштуйте тижневі години роботи, зміни дати, вікна повідомлень і вікно бронювання.
Очікуваний результат: Відвідувачі бачать лише час, який ви готові запропонувати.
4
Додайте запитання
Додайте необхідні запитання, як-от телефон, компанія, веб-сайт або ціль зустрічі.
Очікуваний результат: Бронювання збирає контекст, потрібний вашій команді, перед дзвінком.
5
Підключіть календарі
Відкрийте Календарі та підключіть Google, Outlook або iCal, якщо доступно.
Очікуваний результат: Час зайнятості можна заблокувати, а підтверджені бронювання можна записати в календар.
6
Налаштуйте електронні листи та нагадування
Відкрийте Електронну пошту та налаштуйте повідомлення про підтвердження, нагадування, скасування та перепланування.
Очікуваний результат: Відвідувачі отримують коректне повідомлення про бронювання.
7
Поділіться та протестуйте загальнодоступне посилання
Скопіюйте посилання на подію, відкрийте її в приватному вікні, виберіть слот і завершіть тестове бронювання.
Очікуваний результат: Бронювання з’являється на вкладці «Бронювання» та надсилаються повідомлення з підтвердженням.
Як це перевірити: Завершіть одне тестове бронювання, одне перенесення та одне скасування. Переконайтеся, що кожна подія відображається в плануванні та підключених календарях.
проблема
Виправити
Час не відображається на загальнодоступній сторінці
Перевірте часовий пояс, щотижневу доступність, зміни дати, вікно сповіщень і конфлікти підключених календарів.
Відсутня електронна адреса для бронювання
Перевірте налаштування електронної пошти та папку зі спамом, а потім надішліть ще одне тестове бронювання.
Платіж не відбувається під час платної події
Перед публікацією переконайтеся, що параметри інтеграції виставлення рахунків/платежів і валюта дійсні.
Що робити далі: Вставте посилання на бронювання в бота, на веб-сайт або в електронні листи.
Розширене планування
Використовуйте одноразові посилання, аналітику, вбудовування та платні події
Для чого це: Використовуйте це, коли для планування потрібна тимчасова доступність, звітність, вбудоване бронювання або оплата.
Перш ніж почати
Спершу створіть принаймні один тип події.
З’єднайте календарі, перш ніж часто використовувати одноразові посилання.
Визначте політику відшкодування/скасування перед активацією платних подій.
1
Створіть одноразове посилання
Відкрийте одноразові посилання, виберіть запропоновані слоти або правила, а потім згенеруйте посилання.
Очікуваний результат: Одержувач може забронювати лише вибрану доступність.
2
Вставити планування
Скористайтеся опцією вставлення картки події, якщо потік бронювання має з’явитися на вашому веб-сайті.
Очікуваний результат: Інтерфейс бронювання можна розмістити на сторінці, де відвідувачі здійснюють конверсію.
3
Перегляньте аналітику планування
Відкрийте Analytics у плануванні.
Очікуваний результат: Ви можете переглянути бронювання, тенденції завершення та ефективність типу події.
4
Увімкнути платні події
Відкрийте редактор подій, установіть ціну, валюту та спосіб оплати.
Очікуваний результат: Відвідувачі повинні пройти етап оплати відповідно до налаштування події.
5
Аудит бронювання
Відкрийте Бронювання та перегляньте майбутні, завершені, скасовані та переплановані записи.
Очікуваний результат: Команда може керувати відвідуваністю та подальшим спостереженням.
Як це перевірити: Забронюйте через публічну сторінку та через вбудовану сторінку, якщо вона використовується. Переконайтеся, що обидва створюють запис про бронювання одного типу.
проблема
Виправити
Одноразове посилання виявляє неправильні слоти
Відновіть посилання з меншим набором слотів або строгішим діапазоном дат.
Вбудоване бронювання занадто вузьке
Розмістіть вбудований вміст у ширшому контейнері й перевірте мобільний макет.
Аналітика виглядає порожньою
Створити або дочекатися реальних бронювань; аналітика залежить від записів бронювання.
Що робити далі: Підключіть результати планування до звітів і аналітики.
10
Аналітика та звіти
Вибирайте діапазони дат, використовуйте спеціальні дати, читайте основні показники, експортуйте CSV, переглядайте задоволеність і тенденції спілкування, налаштовуйте звіти електронною поштою та перевіряйте доставку.
/analyticsІнформаційна панель аналітики
1Виберіть діапазони дат або спеціальні дати.
2Перегляньте показники розмови, задоволення, мови, каналу та конверсії.
1Виберіть щоденну, щотижневу або щомісячну частоту звітів.
2Додайте одержувачів звіту.
3Надішліть миттєвий звіт для перевірки доставки.
Аналітичний огляд
Читайте аналітику та експортуйте дані про продуктивність
Для чого це: Використовуйте це для щотижневих оглядів, перевірок запуску, перевірки якості підтримки та аналізу переходів.
Перш ніж почати
Перш ніж читати показники, виберіть діапазон дат.
Знайте, якого бота чи канал ви оцінюєте.
Виключіть приватні дати випробувань, повідомляючи про продуктивність.
1
Відкрийте Analytics
Натисніть Аналітика на бічній панелі.
Очікуваний результат: Відображаються показники інформаційної панелі та панелі діаграм.
2
Виберіть діапазон дат
Виберіть сьогодні, 7 днів, 30 днів або спеціальні дати.
Очікуваний результат: Усі діаграми оновлюються до вибраного періоду.
3
Читайте основні показники
Перегляньте conversations, голосові хвилини, задоволення, конверсію та мікс каналів.
Очікуваний результат: Ви розумієте обсяг і якість взаємодії з клієнтами.
4
Перегляньте тенденції
Подивіться на тенденції розмов, зміни в задоволенні, найпопулярніші запитання та моделі мови/каналу.
Очікуваний результат: Ви можете визначити, де можна покращити інструкції для ботів або персонал.
5
Експортувати CSV
Використовуйте Export CSV, коли команді потрібен аналіз електронної таблиці.
Очікуваний результат: CSV містить вибраний діапазон дат і показники.
6
Перетворіть висновки на зміни
Оновіть інструкції бота, знання, налаштування віджетів або покриття підтримки на основі даних.
Очікуваний результат: Аналітика веде до конкретних покращень продукту.
Як це перевірити: Експортуйте невелику спеціальну дату CSV і перевірте, що діапазон дат і показники відповідають тим, що показано на інформаційній панелі.
проблема
Виправити
Показники здаються занадто високими
Перевірте, чи постановка/тест conversations включено у вибраний діапазон дат.
Задоволення пусте
Увімкніть оцінки в налаштуваннях віджетів і зачекайте, поки відвідувачі залишать оцінки.
Голосові хвилини не відповідають очікуванням
Підтвердьте, що голосовий режим увімкнено лише для призначених ботів.
Що робити далі: Плануйте звіти електронною поштою для регулярної видимості.
Звіти
Налаштуйте періодичні звіти електронною поштою та тестову доставку
Для чого це: Використовуйте це, коли власникам, менеджерам або клієнтам потрібні автоматичні підсумки ефективності.
Перш ніж почати
Вирішіть, хто має отримувати звіти.
Використовуйте перевірені електронні адреси.
Виберіть ритм, який відповідає ритму огляду бізнесу.
1
Відкрийте «Налаштування», потім «Звіти».
Перейдіть до «Налаштувань» і виберіть вкладку «Звіти» або скористайтеся переспрямуванням «Звіти», якщо воно доступне.
Очікуваний результат: Відображаються каденція звіту, одержувачі та історія.
2
Виберіть каденцію
Увімкніть щоденні, щотижневі або місячні звіти.
Очікуваний результат: Розклад звіту зберігається для робочої області.
3
Додайте одержувачів
Введіть електронні адреси, на які мають надходити звіти.
Натисніть Надіслати зараз або еквівалентну дію миттєвого звіту.
Очікуваний результат: Електронний лист зі звітом негайно надсилається для перевірки.
5
Переглянути історію звітів
Перевірте панель історії після надсилання звітів.
Очікуваний результат: Ви можете підтвердити статус і час доставки.
Як це перевірити: Миттєво надішліть звіт тестовому одержувачу та підтвердьте отримання та форматування.
проблема
Виправити
Електронна пошта звіту не надходить
Перевірте правопис одержувача, папку спаму та статус історії звітів.
Звіти отримують не ті люди
Оновіть одержувачів і збережіть перед наступним запланованим надсиланням.
Повідомити про шум у вмісті
Налаштуйте очікуваний діапазон дат і використовуйте Analytics для детальнішого ручного перегляду.
Що робити далі: Використовуйте каденцію звіту як робочий ритм для вдосконалення бота.
11
Платежі, Команда, Безпека, Налаштування, Партнер
Розпочніть або оновіть плани, керуйте платіжним порталом, запрошуйте товаришів по команді, установлюйте ролі, редагуйте профіль/мову, налаштовуйте сповіщення, увімкніть 2FA, використовуйте дії в небезпечній зоні та запускайте робочий процес партнера.
/рахунківКонтроль плану та виставлення рахунків
1Перегляньте поточний план, пробний стан і обмеження usage.
2Порівняйте функції плану перед оновленням.
3Відкрийте платіжний портал, щоб переглянути рахунки-фактури, способи оплати, скасування чи повторну активацію.
/налаштуванняНалаштування, команда та безпека
1Використовуйте Загальні для профілю та мови.
2Використовуйте Team для запрошень і ролей.
3Використовуйте безпеку для 2FA, ключів API і дій у небезпечній зоні.
/філіяЕлементи керування партнерською програмою
1Приєднайтеся до програми, щоб створити реферальне посилання.
2Скопіюйте реферальне посилання для кампаній.
3Налаштуйте електронну адресу для виплат і надішліть запит на відповідні виплати.
Виставлення рахунків
Почніть, оновіть, скасуйте або повторно активуйте план
Для чого це: Використовуйте це, коли робочому простору потрібна пробна активація, додаткові ліміти, рахунки-фактури, оновлення платежів або зміни в підписці.
Перш ніж почати
Власник облікового запису або адміністратор платежів має виконувати дії щодо виставлення рахунків.
Перевірте, які функції обмежені планом: голос, клоновані голоси, власні аватари, API, команда, CRM та канали.
Використовуйте захищений платіжний портал, щоб змінити спосіб оплати та рахунок-фактуру.
Перегляньте chat, голос, команду, API, аватар, інтеграцію, планування та обмеження підтримки.
Очікуваний результат: Ви знаєте, який план розблокує потрібну функцію.
3
Виберіть платіжний інтервал
Виберіть щомісяця або щороку, якщо перемикач доступний.
Очікуваний результат: Оновлення цін і заощаджень для вибраного інтервалу.
4
Оновіть або почніть перевірку
Виберіть потрібний план і завершіть оформлення замовлення.
Очікуваний результат: Підписка стає активною після підтвердження оплати.
5
Відкрити портал клієнтів
Використовуйте платіжний портал для способу оплати, рахунків-фактур, скасування або повторної активації.
Очікуваний результат: Делікатні дії з виставлення рахунків відбуваються на захищеному порталі постачальника.
6
Перевірте доступ до функції
Поверніться до заблокованої функції та перезавантажте програму.
Очікуваний результат: Розблокована функція тепер доступна, якщо її включає план.
Як це перевірити: Після оновлення відкрийте раніше заблоковану функцію, наприклад голосовий клон або клавіші API, і переконайтеся, що блокування знято.
проблема
Виправити
Функція залишається заблокованою після оновлення
Оновіть програму, трохи зачекайте, поки підписка синхронізується, а потім знову перевірте Платежі.
Виписку скасовано
Поверніться до виставлення рахунків і почніть оплату знову; після скасування виписки план не змінюється.
Потрібна зміна рахунку або картки
Відкрийте портал для клієнтів, а не редагуйте платіжні дані в додатку.
Що робити далі: Запросіть товаришів по команді та захистіть обліковий запис власника.
Команда та безпека
Запрошуйте товаришів по команді, встановлюйте ролі, редагуйте профіль, увімкніть 2FA та керуйте налаштуваннями
Для чого це: Використовуйте це, коли робочий простір переходить від індивідуальної настройки до командної роботи.
Перш ніж почати
Перш ніж надсилати запрошення, дізнайтеся кожну роль члена команди.
Використовуйте мінімальний доступ: власник, адміністратор, редактор, переглядач.
Оновіть відображуване ім’я, інформацію профілю та бажану мову в цілому.
Очікуваний результат: Додаток правильно ідентифікує користувача та використовує вибрану мову, де доступно.
3
Запросіть членів команди
Відкрийте команду, введіть електронну адресу, виберіть роль і надішліть запрошення.
Очікуваний результат: Член команди отримує посилання на запрошення та відображається як очікує на розгляд, доки не буде прийнято.
4
Встановити дозволи ролі
Використовуйте власника для повного контролю, адміністратора для керування, редактора для змін вмісту та переглядача для доступу лише для читання.
Очікуваний результат: Кожен користувач має доступ відповідно до його відповідальності.
5
Налаштувати сповіщення
Виберіть електронну пошту, браузер, push-повідомлення, живу підтримку, виставлення рахунків і сповіщення про звіти.
Очікуваний результат: Потрібні люди отримують сповіщення без зайвого шуму.
6
Увімкніть 2FA
Відкрийте Безпеку, увімкніть двофакторну автентифікацію, відскануйте код і збережіть дані відновлення.
Очікуваний результат: Для облікового запису потрібен другий фактор після входу в систему.
7
Використовуйте дії в небезпечній зоні обережно
Експортуйте необхідні дані та підтвердьте активні віджети/інтеграції перед деструктивними діями облікового запису.
Очікуваний результат: Робоча область дозволяє уникнути випадкової втрати даних.
Як це перевірити: Запросіть тестового члена команди, прийміть запрошення в окремому браузері та підтвердьте роль, відкриваючи лише заплановані функції.
проблема
Виправити
Відсутня електронна адреса запрошення
Перевірте спам, повторно надішліть запрошення та підтвердьте адресу.
Товариш по команді бачить занадто багато
Знизьте їх роль і перегляньте налаштування доступу ботів.
Помилка налаштування 2FA
Перевірте час пристрою, повторно відскануйте QR-код і збережіть дані відновлення, перш ніж покладатися на нього.
Що робити далі: Налаштуйте ключі API лише для користувачів і служб, яким вони потрібні.
Філіал
Приєднайтеся до афілійованого партнера, скопіюйте реферальне посилання, встановіть електронну адресу для виплати та подайте запит на виплату
Для чого це: Використовуйте це, коли партнер або клієнт хоче запропонувати нових користувачів sem.chat і відстежувати комісійну діяльність.
Перш ніж почати
Використовуйте обліковий запис, який повинен володіти реферальною атрибуцією.
Перш ніж запитувати виплату, підготуйте електронний лист про виплату.
Перевірте правила програми перед публікацією реферальних кампаній.
1
Відкрийте Партнерську програму
Натисніть «Партнерство» на бічній панелі або відкрийте вкладку «Партнерство» в налаштуваннях, якщо там є посилання.
Очікуваний результат: На сторінці партнерської програми показано зони приєднання, рефералів, виплат та історії.
2
Приєднуйтесь до програми
Натисніть «Приєднатися», якщо обліковий запис ще не приєднано.
Очікуваний результат: Створюється реферальний код і реферальне посилання.
3
Копіювати реферальне посилання
Скопіюйте унікальне посилання та використовуйте його в контенті, кампаніях або повідомленнях партнерів.
Очікуваний результат: Реєстрацію за посиланням можна віднести до афілійованого облікового запису.
4
Налаштуйте електронну адресу для виплат
Введіть електронну адресу виплати та збережіть її.
Очікуваний результат: Відповідні виплати можна правильно направляти.
5
Перегляд рекомендацій і комісій
Перевірте список рефералів, статус комісії та історію виплат.
Очікуваний результат: Ви знаєте, що очікує на розгляд, що відповідає вимогам або вже оплачено.
6
Запит на виплату
Натисніть Запит на виплату, коли правила програми та мінімуми будуть виконані.
Очікуваний результат: Запит на виплату записується для обробки.
Як це перевірити: Відкрийте реферальне посилання в приватному браузері та переконайтеся, що воно потрапляє в очікуваний потік реєстрації з відстеженням рефералів.
проблема
Виправити
Відсутнє реферальне посилання
Приєднайтеся до програми спочатку або оновіть партнерську сторінку після приєднання.
Запит на виплату недоступний
Перевірте мінімальний поріг виплати, відповідний стан комісії та електронну пошту про виплату.
Реферал не вказано
Переконайтеся, що відвідувач використав точне реферальне посилання та не видалив параметри відстеження.
Що робити далі: Використовуйте аналітику та звіти, щоб відстежувати вплив запрошених клієнтів, якщо це можливо.
12
Сповіщення та App Updates
Переглядайте сповіщення, позначайте сповіщення прочитаними, фільтруйте важливі події та використовуйте оновлення додатків, щоб зрозуміти нові зміни продукту.
/повідомленняЦентр сповіщень
1Використовуйте Позначити як прочитане після перегляду непрочитаних сповіщень.
2Фільтруйте за непрочитаними, платіжними, живою підтримкою або системними подіями.
1Прочитайте примітки до випуску, щоб дізнатися про нові функції та виправлення.
2Використовуйте деталі для навчання товаришів по команді перед змінами робочого процесу.
3Перевіряйте оновлення після того, як помітили зміни інтерфейсу або поведінки.
Сповіщення
Переглядайте сповіщення та реагуйте на сповіщення
Для чого це: Використовуйте це, коли програма повідомляє про передачі, платіжний стан, системні події, доставку звітів або важливу діяльність у робочому просторі.
Перш ніж почати
Переконайтеся, що параметри сповіщень вибрано в налаштуваннях.
Отримайте пряму трансляцію підтримки, якщо ввімкнено сповіщення про передачу.
Перегляньте непрочитані сповіщення, перш ніж позначати їх як прочитані.
1
Відкрийте сповіщення
Клацніть «Сповіщення» на бічній панелі або в заголовку програми.
Очікуваний результат: Центр сповіщень містить список останніх сповіщень.
2
Фільтр сповіщень
Використовуйте фільтри непрочитаних або категорій, щоб зосередитися на виставленні рахунків, живій підтримці, роботах, звітах або системних подіях.
Очікуваний результат: Лише відповідні сповіщення залишаються видимими.
3
Відкрийте відповідну сторінку
Натисніть сповіщення або скористайтеся його контекстом, щоб відкрити Платежі, Live Support, Звіти або відповідного бота.
Очікуваний результат: Ви дієте відповідно до сповіщення, а не просто читаєте його.
4
Марк прочитаний
Позначте одне сповіщення прочитаним або скористайтеся Позначити всі прочитаними після перегляду.
Очікуваний результат: Кількість непрочитаних падає, а переглянуті елементи більше не підсвічуються.
5
Налаштуйте параметри
Відкрийте «Налаштування», «Сповіщення», якщо надходить занадто багато або замало сповіщень.
Очікуваний результат: Потік сповіщень відповідає потребам команди.
Як це перевірити: Створіть безпечну тестову подію, як-от запит на підтримку в реальному часі або миттєвий звіт, а потім підтвердьте, що сповіщення з’являється та може бути позначено як прочитане.
проблема
Виправити
Повідомлення не надходить
Перевірте параметри сповіщень у налаштуваннях, дозвіл веб-переглядача та перевірте, чи справді відбулася подія.
Забагато сповіщень
Вимкніть галасливі категорії або надішліть їх лише відповідальним членам команди.
Здається, кількість непрочитаних зависла
Оновіть програму після позначення всіх прочитаних і переконайтеся, що фільтри не приховують непрочитані елементи.
Що робити далі: Перегляньте App Updates, коли зміниться поведінка або з’являться нові елементи керування.
Оновлення програми
Використовуйте оновлення програм, щоб зрозуміти зміни продукту
Для чого це: Використовуйте це, коли членам команди потрібно дізнатися, що змінилося, перш ніж використовувати нову функцію.
Перш ніж почати
Відкривайте оновлення після основних випусків або коли змінюється інтерфейс користувача.
Поділіться відповідними примітками щодо оновлення з користувачами служби підтримки та продажів.
Перевірте критичні робочі процеси після серйозних змін.
1
Відкрити App Updates
Натисніть App Updates на бічній панелі.
Очікуваний результат: Стрічка оновлень показує нові функції, виправлення та примітки до випуску.
2
Прочитайте останнє оновлення
Відкрийте картку останнього оновлення або детальний перегляд.
Очікуваний результат: Ви бачите, що змінилося та на який робочий процес це вплинуло.
3
Зіставте зміни у ваш робочий процес
Визначте, чи впливає оновлення на ботів, віджет, підтримку, планування, виставлення рахунків або розробників.
Очікуваний результат: Правильні члени команди знають, що перевіряти.
4
Перетестуйте критичні шляхи
Якщо оновлення впливає на робочий процес виробництва, повторіть відповідні дії вручну з цієї документації.
Очікуваний результат: Команда підтверджує, що змінений робочий процес все ще працює.
5
Поділіться внутрішньо
Надішліть підсумок оновлення користувачам, які володіють ураженою територією.
Очікуваний результат: Прийняття команди відбувається плавніше, а питання підтримки відпадають.
Як це перевірити: Після відповідного оновлення повторіть посібник для відповідної функції та переконайтеся, що знімки екрана чи назви кроків усе ще збігаються.
проблема
Виправити
Оновлення згадує заблоковану функцію
Відкрийте «Платежі», щоб перевірити, чи включено це в поточний план.
Команда пропустила заміну
Додайте огляд App Updates до випуску або щотижневих операцій.
Після оновлення документація виглядає застарілою
Використовуйте Посібник інженера, щоб оновити знімки екрана та кроки.
Що робити далі: Підтримуйте актуальну публічну документацію в міру розвитку функцій.
13
Рецепти розробника
Генеруйте ключі API, використовуйте автентифікацію x-api-key, викликайте кінцеві точки на основі дій, підключіть живу підтримку до CRM, реєструйте веб-хуки, перевіряйте підписи та вставляйте віджет у код.
Налаштування / РозробникиAPI клавіш, швидкий старт і usage вкладок
1Згенеруйте та відкликайте ключі API на вкладці «Ключі API».
2Використовуйте Quick Start для перших прикладів завитків.
3Перегляньте використання, перш ніж увімкнути автоматизацію великих обсягів.
API швидкий початок
Згенеруйте ключ API і зробіть перші виклики API
Для чого це: Використовуйте це для сценаріїв звітів, спеціальних програм, мостів CRM, зовнішньої підтримки в реальному часі або автоматизації.
Перш ніж почати
Використовуйте серверне середовище. Не відкривайте ключі API у браузері JavaScript.
Згенеруйте окремий ключ для кожної інтеграції.
Скопіюйте ключ негайно, тому що секрети показуються один раз.
1
Відкрийте Розробники
Відкрийте «Налаштування» та виберіть «Розробники» або скористайтеся переспрямуванням «Розробники», якщо воно доступне.
Очікуваний результат: Видно вкладки API Ключі, Quick Start, Документація та Використання.
2
Згенеруйте ключ
Натисніть «Створити ключ», дайте йому чітку позначку та негайно скопіюйте його.
Очікуваний результат: Ключ починається з sk_live_ і доступний для запитів на стороні сервера.
3
Надіслати заголовок x-api-key
Додайте x-api-key до кожного публічного запиту API.
Очікуваний результат: Загальнодоступний API може автентифікувати запит і передати його власнику.
4
Список ботів
Викличте action=list-bots, щоб знайти потрібний ідентифікатор бота.
Очікуваний результат: Відповідь повертає ідентифікатори ботів, імена, активний стан і підсумок конфігурації.
5
Надіслати chat повідомлення
POST дія chat з botId і повідомлення.
Очікуваний результат: Відповідь повертає інформацію про відповідь, модель і usage.
6
Перевірте usage
Викличте дію=usage перед виконанням завдань великого обсягу.
Очікуваний результат: Ви знаєте поточний план і стан usage перед запуском автоматизації.
7
Повертайте ключі, коли це необхідно
Відкликайте невикористані ключі та створіть нові для змінених постачальників або служб.
Очікуваний результат: Старі служби не можуть продовжувати використовувати застарілі облікові дані.
Як це перевірити: Запустіть list-bots і chat з локального терміналу або серверного середовища, а потім підтвердьте, що розмова з’являється в Chat History, якщо chat було надіслано.
проблема
Виправити
401 або несанкціонована відповідь
Перевірте правопис x-api-key, скопіюйте повний ключ і підтвердьте, що його не було скасовано.
Бот не знайдено
Скористайтеся list-bots ще раз і підтвердьте, що бот належить власнику ключа API.
Проблема браузера CORS
Перемістіть виклик API на серверну частину; Ключі API призначені для використання на стороні сервера.
Що робити далі: Використовуйте /api-docs для цілеспрямованого посилання на кінцеву точку та збережіть цю сторінку як інструкцію щодо робочого процесу.
Список ботів
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
-H "x-api-key: sk_live_your_key_here"
Надіслати chat повідомлення
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
-H "x-api-key: sk_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"action": "chat",
"botId": "YOUR_BOT_ID",
"message": "What can you help me with?"
}'
Жива підтримка CRM міст
Опитуйте або надсилайте запити на підтримку в реальному часі в CRM
Для чого це: Використовуйте це, коли агенти працюють в іншій системі, але sem.chat отримує розмову відвідувача.
Перш ніж почати
Створіть спеціальний ключ API з іменем мосту CRM.
Вирішіть, чи підходять вашій інфраструктурі опитування чи веб-хуки.
Переконайтеся, що CRM зберігає ідентифікатори розмов для майбутніх відповідей/вирішень.
1
Список очікування передачі
GET action=live-support-list зі status=requested або status=all.
Очікуваний результат: CRM отримує відкритий conversations, який потребує уваги людини.
2
Отримати повідомлення
GET дія=live-support-messages з conversationId.
Очікуваний результат: CRM містить повний контекст ланцюжка та відомості про відвідувачів.
3
Претензія перед відповіддю
POST дія=live-support-claim.
Очікуваний результат: sem.chat позначає розмову як активну.
4
Надіслати відповідь агенту
POST дія=live-support-reply з conversationId, повідомленням і іменем агента.
Очікуваний результат: Відвідувач отримує відповідь людини та оновлення ланцюжка.
5
Вирішіть або віддайте назад
POST action=live-support-resolve із вирішенням або поверненням.
Очікуваний результат: Розмова виходить із черги очікування або AI відновлює керування.
6
Статус входу в CRM
Зберігайте останній статус передачі, ідентифікатор повідомлення та мітки часу.
Очікуваний результат: CRM і sem.chat залишаються доступними для перевірки.
Як це перевірити: Створіть безпечну передачу, віддзеркаліть її на CRM, дайте відповідь із мосту та підтвердьте оновлення потоку відвідувачів.
проблема
Виправити
Дублікати квитків CRM
Використовуйте conversationId як ключ ідемпотентності у своєму мосту CRM.
Відповіді надходять не по порядку
Зберігайте часові позначки повідомлень і уникайте одночасних відповідей від кількох систем.
AI відповідає, поки агент працює
Спершу вимагайте передачу і повертайте лише тоді, коли агент закінчить.
Що робити далі: Зареєструйте веб-хуки, якщо опитування надто повільне або занадто дороге.
Веб-хуки
Зареєструйте вебхуки та перевірте X-SemChat-Signature
Для чого це: Використовуйте це, коли вашій системі потрібні події в реальному часі для передачі, повідомлень і оновлень дозволу.
Перш ніж почати
Вебхук URL має бути HTTPS і доступний із загальнодоступного Інтернету.
Негайно збережіть секрет вебхука; це показано один раз.
Перевіряйте підписи перед обробкою подій.
1
Зареєструйте вебхук
POST дія webhook-register з URL-адресою та подіями.
Очікуваний результат: Відповідь містить деталі вебхуку та одноразовий секрет підпису.
2
Зберігайте секрет
Збережіть секрет у серверному середовищі або в менеджері секретів.
Очікуваний результат: Майбутні поставки можна перевірити.
3
Перевірити підпис
Прочитайте X-SemChat-Signature і порівняйте його з HMAC SHA-256 поверх необробленого тіла запиту.
Очікуваний результат: Приймаються лише оригінальні поставки sem.chat.
4
Обробляти повторні спроби ідемпотентно
Використовуйте ідентифікатор події або ідентифікатор розмови/повідомлення, щоб уникнути повторної обробки.
Очікуваний результат: Повторні спроби не створюють повторюваних записів CRM.
5
Список вебхуків
GET дія webhook-list для аудиту налаштованих кінцевих точок.
Очікуваний результат: Ви можете переглянути URLs, події, увімкнений стан і останній стан доставки.
6
Видалити застарілі вебхуки
POST дія webhook-delete з ідентифікатором вебхуку.
Очікуваний результат: Старі кінцеві точки перестають отримувати події.
Як це перевірити: Зареєструйте тестову кінцеву точку, запустіть подію підтримки в реальному часі, перевірте підпис і підтвердьте, що ваш обробник повертає 2xx.
проблема
Виправити
Підпис не збігається
Використовуйте необроблене тіло, не проаналізований JSON, і підтвердьте правильний секрет вебхуку.
Вебхук не отримує подій
Переконайтеся, що список подій містить подію, яку ви тестуєте, і кінцевою точкою є HTTPS.
Вебхук закінчився
Швидке підтвердження та асинхронна обробка тривалої роботи.
Що робити далі: Зв’яжіть інженерів з /api-docs, щоб отримати деталі та приклади кінцевих точок.
Використовуйте публічний API на основі дій правильно
Для чого це: Використовуйте це, коли вибираєте правильну дію для функції.
Перш ніж почати
Кожен запит використовує ту саму функцію public-api URL.
Дії GET використовують параметри запиту. Дії POST використовують тіло JSON.
Надсилайте x-api-key на всі запити.
Як це перевірити: Виклик usage та list-bots як димовий тест після будь-якої зміни ключа API або кінцевої точки.
проблема
Виправити
Невідповідність методу
Використовуйте метод, наведений у таблиці кінцевих точок. Деякі дії є лише GET або POST.
Відсутнє необхідне значення
Перевірте botId, conversationId, ідентифікатор вебхука та правопис дії.
Що робити далі: Використовуйте Quick Start для перших запитів, потім /api-docs для повного посилання.
метод
Дія
призначення
GET
list-bots
Список усіх ботів, доступних для власника ключа API.
GET
get-bot
Отримати одну конфігурацію бота за ідентифікатором бота.
POST
chat
Надішліть повідомлення відвідувача боту та поверніть відповідь ШІ.
GET
conversations
Список останніх conversations для бота, до 100 записів.
GET
usage
План повернення, кредити, кількість ботів, conversations та API ключ usage.
GET
live-support-list
Список conversations, який очікує або обробляється агентом-людиною.
GET
live-support-messages
Отримайте потік передачі з повідомленнями та інформацією про відвідувачів.
POST
live-support-reply
Надіслати відповідь людини-агента із зовнішньої системи.
POST
live-support-claim
Заявка на розмову передачі в очікуванні.
POST
live-support-resolve
Розв’яжіть передачу або поверніть керування ШІ.
POST
webhook-register
Зареєструйте кінцеву точку вебхуку HTTPS.
GET
webhook-list
Список реєстрацій вебхуків без повернення секретів.
POST
webhook-delete
Видалити реєстрацію вебхуку за ідентифікатором.
14
Посібник інженера: додайте функції
Додайте маршрути, навігацію на інформаційній панелі, налаштування бот-конструктора, Supabase таблиці/функції/міграції, API документи, загальнодоступну документацію, перевірки SEO та локальну перевірку.
Робочий процес функції програми
Додайте маршрут програми, сторінку, елемент навігації та запис документів
Для чого це: Використовуйте це під час додавання нової функції інформаційної панелі для клієнтів.
Перш ніж почати
Створіть гілку перед редагуванням.
Визначте, чи належить функція до репозиторію програми чи загальнодоступного репозиторію sem.chat інтерфейсу.
Перш ніж додавати нову структуру, перевірте існуючі шаблони маршруту, бічної панелі, i18n і параметрів.
1
Додайте маршрут
Оновіть src/App.tsx із захищеним маршрутом для сторінок клієнтів або загальнодоступним маршрутом, лише якщо сторінка має бути публічною.
Очікуваний результат: URL вирішується в програмі без натискання NotFound.
2
Створіть або оновіть компонент сторінки
Використовуйте існуючі шаблони сторінок, завантаження даних, порожні стани, стани завантаження та дозволи.
Очікуваний результат: Функція працює узгоджено з інформаційною панеллю.
3
Додати панель навігації
Оновіть джерело бічної панелі/навігації, додавши мітку, піктограму, маршрут і ворота плану, якщо потрібно.
Очікуваний результат: Користувачі можуть відкрити нову сторінку з оболонки програми.
4
Додайте вкладку або налаштування для створення ботів
Якщо функція належить боту, додайте її всередину вкладок Bot Builder і зберігайте в існуючих потоках збереження.
Очікуваний результат: Конфігурація конкретного бота зберігається разом із ботом, а не в локальному стані.
5
Додайте Supabase зміни схеми/функції
Створюйте міграції для таблиць/політик і крайових функцій для роботи на сервері.
Очікуваний результат: Поведінку бази даних і сервера можна розгортати неодноразово.
6
Оновіть форму API, якщо вона загальнодоступна
Додайте або розширте обробку дій у supabase/functions/public-api/index.ts і задокументуйте поведінку x-api-key.
Очікуваний результат: Інтеграції можуть безпечно використовувати цю функцію.
7
Оновіть документи програми та загальнодоступну документацію
Оновіть документи для розробників програми та цю сторінку /documentation за допомогою знімків екрана та покрокових кроків.
Очікуваний результат: Користувачі та інженери бачать цю функцію в обох місцях.
8
Виконайте перевірки
Запустіть тестування/збірку програм, оптимізатор SEO на загальнодоступному сайті, перевірку карти сайту та перевірку браузера.
Очікуваний результат: Функція працює локально, і загальнодоступний сайт залишається доступним для сканування.
Як це перевірити: Відкрийте новий маршрут, скористайтеся наскрізною функцією, перевірте помилки консолі/мережі та перевірте будь-які зміни бази даних з інтерфейсу користувача.
проблема
Виправити
Маршрут працює, але навігація не підсвічується
Перевірте відповідність маршрутів на бічній панелі та шляхи перенаправлення.
Дані працюють локально, але не розгортаються
Підтвердьте міграцію, політики RLS і змінні середовища крайових функцій.
На карті сайту відсутні загальнодоступні документи
Запустіть оптимізатор SEO та перевірте sitemap.xml на наявність канонічного URL.
Що робити далі: Робіть або повторно створюйте знімки екрана документації щоразу, коли змінюється інтерфейс користувача.
Процес обслуговування документів
Оновіть цю загальнодоступну сторінку документації після змін продукту
Для чого це: Використовуйте це, коли змінюються знімки екрана, робочі процеси, поведінка API або навігація.
Перш ніж почати
Використовуйте лише безпечні демонстраційні дані.
Ніколи не розголошуйте реальних клієнтів, електронні листи, платіжні дані, ключі API або приватні conversations.
Спочатку оновіть англійський посібник, а потім оновіть кожну локалізовану сторінку документації перед перевірками SEO.
1
Перевірте змінений маршрут
Відкрийте маршрут програми та визначте, що змінилося візуально та процедурно.
Очікуваний результат: Ви знаєте, які посібники, знімки екрана та рядки з усуненням неполадок потребують редагування.
2
Зробіть або створіть безпечний знімок екрана
Використовуйте демонстраційну робочу область і маскуйте секрети, перш ніж зберігати ресурси WebP у розділі активів/документації.
Очікуваний результат: Скріншот точний і безпечний для публікації.
3
Оновіть посібник
Відредагуйте відповідні розділи «Для чого це», «Перед початком», «Кроки», «Очікувані результати», «Тест», «Усунення несправностей» і «Далі».
Очікуваний результат: Посібник розповідає користувачам, що натискати та що має відбуватися після кожного натискання.
4
За потреби оновіть навігацію
Додайте розділ до закріпленого змісту, засобу вибору мобільного розділу та візуального покажчика, якщо це основна сторінка.
Очікуваний результат: Читачі можуть швидко знайти новий вміст.
5
Запустіть інструменти SEO
Запустіть node tools/seo-optimize-static-pages.js і node tools/seo-optimize-static-pages.js --check.
Очікуваний результат: Канонічні дані, метадані, карта сайту та вихідні дані роботів залишаються правильними.
6
Запустіть очищення та перевірку відмінностей
Запустіть node tools/static-translation-cleanup.js --audit і git diff --check.
Очікуваний результат: Статичні переклади та пробіли чисті.
7
Перевірити браузер
Обслуговуйте сайт локально та тестуйте/документуйте на комп’ютері та мобільному пристрої.
Очікуваний результат: Зображення завантажуються, пошук працює, кнопки копіювання працюють, зміст виділяється, а макет не перекриває банер cookie.
Як це перевірити: Знайдіть змінену назву функції в /documentation і переконайтеся, що з’явився правильний блок посібника.
проблема
Виправити
Маркери знімків екрана дрейфують на мобільному телефоні
Зберігайте маркери всередині зображення знімка екрана або використовуйте адаптивні координати маркера.
Пошук пропускає новий посібник
Додайте корисні ключові слова до data-title і включіть точні терміни продукту, які шукають користувачі.
Локалізована документація застаріває
Після редагування англійського посібника оновіть кожну локалізовану сторінку документації, повторно запустіть SEO-оптимізатор і переконайтеся, що sitemap.xml містить кожен URL документації.
Що робити далі: Зафіксуйте разом зміни сторінки документів, ресурсів, посилань на верхній/нижній колонтитули, .htaccess і карти сайту.
Потрібна цілеспрямована довідка API?
Старіша сторінка /api-docs залишається доступною для деталей API на рівні кінцевої точки.