Наочна покрокова інструкція

sem.chat документація

Посібник SEMJAT зі скріншотами, створений на основі реального процесу інформаційної панелі sem.chat. Кожен посібник розповідає, що клацати, що має статися після клацання, як це перевірити, як усунути несправності та що робити далі.

Відповідних напрямних не знайдено. Спробуйте коротше ключове слово, наприклад віджет, API, голос, оплата, вебхук, WordPress, SendPulse або планування.
Примітка щодо знімків екрана: кожне зображення в цьому посібнику зроблено з реального застосунку sem.chat із використанням демонстраційного робочого простору. Конфіденційні дані акаунта, дані клієнтів, API-ключі, платіжні відомості та вміст приватних розмов маскуються перед публікацією.
01

Початок роботи

Створіть обліковий запис, завершіть адаптацію, ознайомтеся з інформаційною панеллю, створіть першого бота, перевірте його приватно, встановіть і виберіть правильний план.

/authРеєстрація, пробна версія та перший бот
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Почніть із реєстрації або входу з загальнодоступного сайту чи програми.
2Перевірте адресу електронної пошти, перш ніж покладатися на сповіщення або платіжні повідомлення.
3Використовуйте адаптацію, щоб створити першого бота, перш ніж відкривати інформаційну панель.
/оглядОгляд після входу
Реальний знімок екрана демонстраційного робочого простору sem.chat
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
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Натисніть New Bot, щоб створити нового помічника.
2Використовуйте Редагувати, Вставити, Перенести, Активувати або Видалити на кожній картці бота.
3Перед тестуванням перевірте активний стан і час останнього оновлення.
/bots/:id/editBot Builder основна вкладка
Реальний знімок екрана демонстраційного робочого простору sem.chat
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

Тимчасово вимкнути

Використовуйте активний перемикач, якщо бот має наразі припинити обробку відвідувачів.

Очікуваний результат: Бот припиняє обслуговувати живий трафік, зберігаючи конфігурацію.
5

Передача права власності

Скористайтеся передачею, введіть електронну адресу одержувача та підтвердьте.

Очікуваний результат: Вибраний обліковий запис отримує право власності відповідно до потоку передачі програми.
6

Видаляти тільки після перевірок

Використовуйте Delete, прочитайте попередження та підтверджуйте лише тоді, коли бот більше не потрібен.

Очікуваний результат: Бот і пов’язану з ним конфігурацію видаляються відповідно до попередження.
Як це перевірити: Після редагування відкрийте встановлений віджет і задайте точне запитання, яке спонукало до зміни. Підтвердьте зміну прямої відповіді.
проблемаВиправити
Стара відповідь все ще відображаєтьсяОновіть сторінку веб-сайту, підтвердьте, що ви зберегли правильного бота, і перевірте, чи потребують імпортовані знання синхронізації.
Помилка передачіПереконайтеся, що адреса електронної пошти одержувача дійсна та що цільовий обліковий запис може прийняти бота.
Видалити було натиснуто помилковоЗупиніться перед остаточним підтвердженням. Попередження про видалення існують, оскільки ця дія може остаточно видалити дані бота.

Що робити далі: Перегляньте аналітику та історію після змін у реальному часі, щоб переконатися, що відвідувачі покращили роботу.

03

Встановіть віджет

Скопіюйте правильний код вбудовування, установіть його в HTML, WordPress, React або розширеному контексті SDK, а потім перевірте поведінку комп’ютера та мобільного пристрою.

Вставити модальнийСкопіюйте фрагмент інсталяції веб-сайту
Реальний знімок екрана демонстраційного робочого простору sem.chat
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 з потрібним ботом.
Віджет перекриває елементи керування сторінкиЗмініть положення або розмір у налаштуваннях віджета та перевірте ще раз на мобільному пристрої.

Що робити далі: Налаштуйте параметри віджета та захоплення відведення після встановлення.

HTML вставити
<!-- sem.chat Voice & Text Widget -->
<script
  src="https://app.sem.chat/widget-v2.js?v=16"
  data-bot-id="YOUR_BOT_ID"
></script>
Встановлення платформи

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

Що робити далі: Перейдіть до налаштувань віджетів, щоб контролювати поведінку, брендинг і захоплення потенційних клієнтів.

WordPress фрагмент нижнього колонтитула
<!-- sem.chat Widget (WordPress Compatible) -->
<script>
window.SEMCHAT_CONFIG = { botId: "YOUR_BOT_ID" };
</script>
<script src="https://app.sem.chat/widget-v2.js?v=16"></script>
React компонент
import { useEffect, useRef } from 'react';

export function ChatWidget() {
  const loaded = useRef(false);

  useEffect(() => {
    if (loaded.current) return;
    loaded.current = true;

    const script = document.createElement('script');
    script.src = 'https://app.sem.chat/widget-v2.js?v=16';
    script.setAttribute('data-bot-id', 'YOUR_BOT_ID');
    script.async = true;
    document.body.appendChild(script);

    return () => {
      const container = document.getElementById('semchat-widget-container');
      if (container) container.remove();
      script.remove();
    };
  }, []);

  return null;
}
Розширений голос 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 / ВіджетЗовнішній вигляд віджета та поведінка відвідувача
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Виберіть chat, голосовий або гібридний режим.
2Встановіть тему, колір, положення, розмір, брендинг, згоду та звук.
3Налаштуйте захоплення потенційних клієнтів, оцінки, реакції та подальшу поведінку.
Поведінка віджета

Налаштувати поведінку віджета для відвідувачів

Для чого це: Використовуйте це після першого встановлення або будь-коли, коли віджет має відповідати веб-сайту та залучати кращих потенційних клієнтів.

Перш ніж почати
  • Встановіть віджет на проміжну сторінку.
  • Дізнайтеся, чи мають відвідувачі починати з chat, голосу чи обох.
  • Підготуйте згоду та копію для захоплення потенційних клієнтів, якщо це потрібно для регіону.
1

Відкрийте конструктор ботів

Відкрийте My Bots, натисніть «Редагувати», а потім виберіть вкладку «Віджети».

Очікуваний результат: Для вибраного бота з’являться елементи керування віджетом.
2

Виберіть режим

Виберіть «Чат», «Голосовий зв’язок» або «Гібрид» відповідно до бажаного досвіду відвідувачів.

Очікуваний результат: Попередній перегляд змінюється, щоб показати вибраний режим.
3

Зовнішній вигляд комплекту

Виберіть тему, колір, розмір, розташування кнопок і варіанти брендування.

Очікуваний результат: Віджет відповідає сайту, не охоплюючи важливого вмісту.
4

Увімкнути елементи керування відвідувачами

Увімкніть або вимкніть реакції, звук, оцінки та підказки щодо згоди.

Очікуваний результат: Відвідувачі бачать лише ті елементи керування, які ви бажаєте їм використовувати.
5

Налаштувати захоплення відведення

Виберіть обов’язкові поля, необов’язкове поле опису та коли з’явиться форма.

Очікуваний результат: Контакти збираються до або під час conversations відповідно до ваших налаштувань.
6

Налаштуйте подальшу електронну пошту

Налаштуйте поведінку подальших електронних листів, якщо це передбачено вашим планом.

Очікуваний результат: Відвідувачі можуть отримувати подальші повідомлення після вирішення conversations.
7

Збережіть і протестуйте

Натисніть «Зберегти», перезавантажте початкову сторінку та відкрийте віджет.

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

Що робити далі: Додайте налаштування голосу/аватара та джерела знань перед запуском виробництва.

05

Голос і Аватари

Вибирайте стандартні голоси, налаштовуйте голосовий режим і обмеження, читайте стенограми, клонуйте голоси, призначайте клоновані голоси та керуйте стандартними або власними аватарами.

Bot Builder / ГолосГолос, ліміти, стенограми та аватари
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Виберіть стандартний голос або збережений клонований голос.
2Встановіть обмеження на хвилину голосу та збереження розшифровки.
3Виберіть стандартні аватари або завантажте власний аватар, якщо це дозволяє план.
Налаштування голосу

Налаштуйте голосові виклики та розшифровку

Для чого це: Використовуйте це, коли відвідувачі повинні спілкуватися з ботом, а не просто вводити текст.

Перш ніж почати
  • Підтвердьте, що план включає хвилини голосового зв’язку та бажані параметри голосу/аватара.
  • Для тестування використовуйте тихе середовище браузера.
  • Підготуйте одне реалістичне запитання служби підтримки чи продажів для голосового тестування.
1

Відкрийте налаштування голосу

Відкрийте конструктор ботів і виберіть область «Голос» або «Голос і аватари».

Очікуваний результат: Видно голосове керування та поточний вибір голосу.
2

Виберіть стандартний голос

Перегляньте доступні голоси, виберіть найкращий варіант і збережіть вибір.

Очікуваний результат: Бот використовує обраний голос для дзвінків.
3

Налаштувати голосовий режим

Використовуйте параметри віджетів, щоб вибрати голос або гібрид, коли голос має бути доступним для відвідувачів.

Очікуваний результат: Відвідувачі бачать опцію голосу у віджеті.
4

Встановіть обмеження голосу

Визначте обмеження для кожного користувача або робочого простору, якщо доступно.

Очікуваний результат: Довгі або повторювані дзвінки не можуть займати більше хвилин, ніж заплановано.
5

Увімкнути стенограми

Увімкніть збереження розшифровки, якщо вам потрібно переглянути розмову в історії.

Очікуваний результат: Голосові дзвінки створюють читабельні стенограми після сеансу.
6

Перевірте дзвінок

Відкрийте віджет, надайте доступ до мікрофона, почніть дзвінок і задайте підготовлене запитання.

Очікуваний результат: Бот відповідає голосом, і дзвінок закінчується чисто.
7

Прочитайте стенограму

Відкрийте Chat History і знайдіть голосову розмову.

Очікуваний результат: Стенограма показує, що сказали відвідувач і бот.
Як це перевірити: Здійсніть один короткий дзвінок і переконайтеся, що хвилини голосу, стенограма та режим розмови записані.
проблемаВиправити
Браузер блокує мікрофонНадайте доступ до мікрофона в браузері та перезавантажте сторінку.
Опцію голосу заблокованоВідкрийте Billing і підтвердьте, що план робочого простору включає голосові функції.
Стенограма порожняПереконайтеся, що збереження розшифровки ввімкнено, і дзвінок завершився нормально.

Що робити далі: Додайте або уточніть знання, щоб голосові відповіді були точними.

Голосовий клон і аватар

Клонуйте голос і призначте власний аватар

Для чого це: Використовуйте це, коли помічникові потрібен фірмовий голос або розмовний аватар.

Перш ніж почати
  • Використовуйте лише аудіо та зображення, на використання яких ви маєте дозвіл.
  • Записуйте зразки чистого голосу з низьким фоновим шумом.
  • Підтвердьте обмеження плану для клонованих голосів і власних аватарів.
1

Відкрити клонування голосу

Натисніть «Клонувати голос» в області «Голос».

Очікуваний результат: У діалоговому вікні завантаження показано прийняті зразки вимог.
2

Завантажте зразки

Завантажте від одного до п’яти чистих записів і надішліть запит на клонування.

Очікуваний результат: Склонований голос з’являється після обробки або діалогове вікно показує наступну вимогу.
3

Призначте клонований голос

Виберіть клонований голос у виборі голосу та збережіть.

Очікуваний результат: У майбутніх дзвінках використовуватиметься клонований голос.
4

Виберіть стандартний аватар

Виберіть доданий аватар, якщо завантаження власного аватара не потрібне.

Очікуваний результат: Голосовий досвід має візуальну ідентифікацію.
5

Завантажте власний аватар

Завантажте чітке зображення обличчя або коротке відео, якщо ваш план це підтримує.

Очікуваний результат: Аватар обробляється і стає доступним для вибору.
6

Запустіть повний попередній перегляд

Почніть голосовий дзвінок і разом підтвердьте голос, аватар і транскрипцію.

Очікуваний результат: Взаємодія з відвідувачем відповідає налаштованому бренду.
Як це перевірити: Поставте коротке запитання, вибравши клонований голос, і підтвердьте, що виклик використовує очікуваний голос/аватар.
проблемаВиправити
Якість клону поганаЗаписуйте чистіші зразки з одним динаміком, стабільною гучністю та без музики.
Завантаження власного аватара недоступнеПеревірте платіжну інформацію щодо обмежень щодо обмежень для аватарів.
Старий голос все ще граєЗбережіть бота після вибору нового голосу та перезавантажте сторінку віджета.

Що робити далі: Перейдіть до знань і даних, щоб голосовий досвід мав точні відповіді.

06

Знання та дані

Додайте ручні знання, імпортуйте вміст веб-сайту, застосовуйте результати сканування, синхронізуйте імпортований вміст, додайте канал продуктів URLs, оновлюйте або видаляйте канали та перевіряйте відповіді за допомогою тестових запитань.

__СЕМЧАТ_0__ / ЗнанняДжерела знань і тестування відповідей
Реальний знімок екрана демонстраційного робочого простору sem.chat
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.

/вхідніРобочий процес розмови в папці "Вхідні".
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Фільтрувати за ботом або каналом.
2Відкрийте розмову та за потреби дайте відповідь як людина.
3Обережно використовуйте елементи керування перекладом, розв’язуванням і передачею.
/live-supportКонтроль передачі живої підтримки
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Швидко вимагайте передачі в очікуванні.
2Відповідайте як агент або поверніть розмову до ШІ.
3Вирішіть, коли відвідувач більше не потребує людської допомоги.
/chat-історіяІсторія розмов і експорт
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Шукайте за відвідувачем, ботом, каналом або датою.
2Відкрийте повні стенограми для текстових і голосових сеансів.
3За потреби експортуйте CSV або JSON.
/контактиКонтакти та експорт SendPulse
Реальний знімок екрана демонстраційного робочого простору sem.chat
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 та підключення електронною поштою
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Виберіть канал або картку інтеграції CRM.
2Дотримуйтесь кроків OAuth або облікових даних для кожного постачальника.
3Від’єднайте або повторно протестуйте інтеграцію з тієї ж сторінки.
Підключіть канали

Підключіть канал обміну повідомленнями або інтеграцію CRM

Для чого це: Використовуйте це, коли sem.chat має отримати conversations за межами віджета веб-сайту або надіслати контакти іншим інструментам.

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

Відкриті інтеграції

Натисніть «Інтеграції» на бічній панелі.

Очікуваний результат: Відображаються доступні канали, інструменти CRM, SendPulse та параметри віджетів веб-сайту.
2

Виберіть інтеграцію

Натисніть «Підключитися» на 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

Планування

Створюйте типи подій, налаштовуйте доступність, підключайте календарі, керуйте бронюваннями, створюйте одноразові посилання, налаштовуйте електронні листи для бронювання, переглядайте аналітику, установлюйте платні події та тестуйте загальнодоступні посилання для бронювання.

/ плануванняПланування робочого простору
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Використовуйте вкладки для типів подій, бронювань, аналітики, одноразових посилань, календарів, електронних листів і налаштувань.
2Редагувати, копіювати, вбудовувати, активувати або призупиняти типи подій.
3Скопіюйте загальнодоступне посилання та запустіть тест приватного бронювання.
Редактор подійКонфігурація типу події
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Введіть назву, опис, тривалість, розташування та буфери.
2Встановіть доступність, вікна бронювання, запитання, варіанти оплачуваної події та правила скасування.
3Збережіть подію, перш ніж ділитися посиланням.
/книга/:ім’я користувача/:eventSlugПублічна сторінка бронювання
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Відвідувачі обирають дату на публічній сторінці бронювання.
2Відвідувачі вибирають доступний часовий інтервал.
3Відвідувачі підтверджують бронювання та отримують підтвердження електронною поштою.
Тип події

Створіть тип події та опублікуйте посилання на бронювання

Для чого це: Використовуйте це, коли відвідувачам потрібно замовити демонстрації, консультації, дзвінки з продажу, ознайомлення або сеанси підтримки.

Перш ніж почати
  • Виберіть назву події, тривалість, тип зустрічі та власника.
  • Перш ніж ділитися посиланнями, встановіть часовий пояс і доступність.
  • Підключіть календарі, якщо подвійне бронювання має значення.
1

Відкрийте планування

Натисніть «Планування» на бічній панелі.

Очікуваний результат: Робоча область планування показує вкладки для типів подій, бронювань, аналітики, одноразових посилань, календарів, електронних листів і налаштувань.
2

Створіть тип події

Натисніть «Створити», а потім додайте назву, опис, тривалість, місце розташування, буфер і правила бронювання.

Очікуваний результат: Подія має достатньо публічної інформації, щоб її зрозуміли відвідувачі.
3

Встановити наявність

Налаштуйте тижневі години роботи, зміни дати, вікна повідомлень і вікно бронювання.

Очікуваний результат: Відвідувачі бачать лише час, який ви готові запропонувати.
4

Додайте запитання

Додайте необхідні запитання, як-от телефон, компанія, веб-сайт або ціль зустрічі.

Очікуваний результат: Бронювання збирає контекст, потрібний вашій команді, перед дзвінком.
5

Підключіть календарі

Відкрийте Календарі та підключіть Google, Outlook або iCal, якщо доступно.

Очікуваний результат: Час зайнятості можна заблокувати, а підтверджені бронювання можна записати в календар.
6

Налаштуйте електронні листи та нагадування

Відкрийте Електронну пошту та налаштуйте повідомлення про підтвердження, нагадування, скасування та перепланування.

Очікуваний результат: Відвідувачі отримують коректне повідомлення про бронювання.
7

Поділіться та протестуйте загальнодоступне посилання

Скопіюйте посилання на подію, відкрийте її в приватному вікні, виберіть слот і завершіть тестове бронювання.

Очікуваний результат: Бронювання з’являється на вкладці «Бронювання» та надсилаються повідомлення з підтвердженням.
Як це перевірити: Завершіть одне тестове бронювання, одне перенесення та одне скасування. Переконайтеся, що кожна подія відображається в плануванні та підключених календарях.
проблемаВиправити
Час не відображається на загальнодоступній сторінціПеревірте часовий пояс, щотижневу доступність, зміни дати, вікно сповіщень і конфлікти підключених календарів.
Відсутня електронна адреса для бронюванняПеревірте налаштування електронної пошти та папку зі спамом, а потім надішліть ще одне тестове бронювання.
Платіж не відбувається під час платної подіїПеред публікацією переконайтеся, що параметри інтеграції виставлення рахунків/платежів і валюта дійсні.

Що робити далі: Вставте посилання на бронювання в бота, на веб-сайт або в електронні листи.

Розширене планування

Використовуйте одноразові посилання, аналітику, вбудовування та платні події

Для чого це: Використовуйте це, коли для планування потрібна тимчасова доступність, звітність, вбудоване бронювання або оплата.

Перш ніж почати
  • Спершу створіть принаймні один тип події.
  • З’єднайте календарі, перш ніж часто використовувати одноразові посилання.
  • Визначте політику відшкодування/скасування перед активацією платних подій.
1

Створіть одноразове посилання

Відкрийте одноразові посилання, виберіть запропоновані слоти або правила, а потім згенеруйте посилання.

Очікуваний результат: Одержувач може забронювати лише вибрану доступність.
2

Вставити планування

Скористайтеся опцією вставлення картки події, якщо потік бронювання має з’явитися на вашому веб-сайті.

Очікуваний результат: Інтерфейс бронювання можна розмістити на сторінці, де відвідувачі здійснюють конверсію.
3

Перегляньте аналітику планування

Відкрийте Analytics у плануванні.

Очікуваний результат: Ви можете переглянути бронювання, тенденції завершення та ефективність типу події.
4

Увімкнути платні події

Відкрийте редактор подій, установіть ціну, валюту та спосіб оплати.

Очікуваний результат: Відвідувачі повинні пройти етап оплати відповідно до налаштування події.
5

Аудит бронювання

Відкрийте Бронювання та перегляньте майбутні, завершені, скасовані та переплановані записи.

Очікуваний результат: Команда може керувати відвідуваністю та подальшим спостереженням.
Як це перевірити: Забронюйте через публічну сторінку та через вбудовану сторінку, якщо вона використовується. Переконайтеся, що обидва створюють запис про бронювання одного типу.
проблемаВиправити
Одноразове посилання виявляє неправильні слотиВідновіть посилання з меншим набором слотів або строгішим діапазоном дат.
Вбудоване бронювання занадто вузькеРозмістіть вбудований вміст у ширшому контейнері й перевірте мобільний макет.
Аналітика виглядає порожньоюСтворити або дочекатися реальних бронювань; аналітика залежить від записів бронювання.

Що робити далі: Підключіть результати планування до звітів і аналітики.

10

Аналітика та звіти

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

/analyticsІнформаційна панель аналітики
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Виберіть діапазони дат або спеціальні дати.
2Перегляньте показники розмови, задоволення, мови, каналу та конверсії.
3Експортуйте CSV для автономного аналізу.
Налаштування / ЗвітиНалаштування звіту електронною поштою
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Виберіть щоденну, щотижневу або щомісячну частоту звітів.
2Додайте одержувачів звіту.
3Надішліть миттєвий звіт для перевірки доставки.
Аналітичний огляд

Читайте аналітику та експортуйте дані про продуктивність

Для чого це: Використовуйте це для щотижневих оглядів, перевірок запуску, перевірки якості підтримки та аналізу переходів.

Перш ніж почати
  • Перш ніж читати показники, виберіть діапазон дат.
  • Знайте, якого бота чи канал ви оцінюєте.
  • Виключіть приватні дати випробувань, повідомляючи про продуктивність.
1

Відкрийте Analytics

Натисніть Аналітика на бічній панелі.

Очікуваний результат: Відображаються показники інформаційної панелі та панелі діаграм.
2

Виберіть діапазон дат

Виберіть сьогодні, 7 днів, 30 днів або спеціальні дати.

Очікуваний результат: Усі діаграми оновлюються до вибраного періоду.
3

Читайте основні показники

Перегляньте conversations, голосові хвилини, задоволення, конверсію та мікс каналів.

Очікуваний результат: Ви розумієте обсяг і якість взаємодії з клієнтами.
4

Перегляньте тенденції

Подивіться на тенденції розмов, зміни в задоволенні, найпопулярніші запитання та моделі мови/каналу.

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

Експортувати CSV

Використовуйте Export CSV, коли команді потрібен аналіз електронної таблиці.

Очікуваний результат: CSV містить вибраний діапазон дат і показники.
6

Перетворіть висновки на зміни

Оновіть інструкції бота, знання, налаштування віджетів або покриття підтримки на основі даних.

Очікуваний результат: Аналітика веде до конкретних покращень продукту.
Як це перевірити: Експортуйте невелику спеціальну дату CSV і перевірте, що діапазон дат і показники відповідають тим, що показано на інформаційній панелі.
проблемаВиправити
Показники здаються занадто високимиПеревірте, чи постановка/тест conversations включено у вибраний діапазон дат.
Задоволення пустеУвімкніть оцінки в налаштуваннях віджетів і зачекайте, поки відвідувачі залишать оцінки.
Голосові хвилини не відповідають очікуваннямПідтвердьте, що голосовий режим увімкнено лише для призначених ботів.

Що робити далі: Плануйте звіти електронною поштою для регулярної видимості.

Звіти

Налаштуйте періодичні звіти електронною поштою та тестову доставку

Для чого це: Використовуйте це, коли власникам, менеджерам або клієнтам потрібні автоматичні підсумки ефективності.

Перш ніж почати
  • Вирішіть, хто має отримувати звіти.
  • Використовуйте перевірені електронні адреси.
  • Виберіть ритм, який відповідає ритму огляду бізнесу.
1

Відкрийте «Налаштування», потім «Звіти».

Перейдіть до «Налаштувань» і виберіть вкладку «Звіти» або скористайтеся переспрямуванням «Звіти», якщо воно доступне.

Очікуваний результат: Відображаються каденція звіту, одержувачі та історія.
2

Виберіть каденцію

Увімкніть щоденні, щотижневі або місячні звіти.

Очікуваний результат: Розклад звіту зберігається для робочої області.
3

Додайте одержувачів

Введіть електронні адреси, на які мають надходити звіти.

Очікуваний результат: Звіти надсилаються належним зацікавленим сторонам.
4

Надсилати миттєвий звіт

Натисніть Надіслати зараз або еквівалентну дію миттєвого звіту.

Очікуваний результат: Електронний лист зі звітом негайно надсилається для перевірки.
5

Переглянути історію звітів

Перевірте панель історії після надсилання звітів.

Очікуваний результат: Ви можете підтвердити статус і час доставки.
Як це перевірити: Миттєво надішліть звіт тестовому одержувачу та підтвердьте отримання та форматування.
проблемаВиправити
Електронна пошта звіту не надходитьПеревірте правопис одержувача, папку спаму та статус історії звітів.
Звіти отримують не ті людиОновіть одержувачів і збережіть перед наступним запланованим надсиланням.
Повідомити про шум у вмістіНалаштуйте очікуваний діапазон дат і використовуйте Analytics для детальнішого ручного перегляду.

Що робити далі: Використовуйте каденцію звіту як робочий ритм для вдосконалення бота.

11

Платежі, Команда, Безпека, Налаштування, Партнер

Розпочніть або оновіть плани, керуйте платіжним порталом, запрошуйте товаришів по команді, установлюйте ролі, редагуйте профіль/мову, налаштовуйте сповіщення, увімкніть 2FA, використовуйте дії в небезпечній зоні та запускайте робочий процес партнера.

/рахунківКонтроль плану та виставлення рахунків
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Перегляньте поточний план, пробний стан і обмеження usage.
2Порівняйте функції плану перед оновленням.
3Відкрийте платіжний портал, щоб переглянути рахунки-фактури, способи оплати, скасування чи повторну активацію.
/налаштуванняНалаштування, команда та безпека
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Використовуйте Загальні для профілю та мови.
2Використовуйте Team для запрошень і ролей.
3Використовуйте безпеку для 2FA, ключів API і дій у небезпечній зоні.
/філіяЕлементи керування партнерською програмою
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Приєднайтеся до програми, щоб створити реферальне посилання.
2Скопіюйте реферальне посилання для кампаній.
3Налаштуйте електронну адресу для виплат і надішліть запит на відповідні виплати.
Виставлення рахунків

Почніть, оновіть, скасуйте або повторно активуйте план

Для чого це: Використовуйте це, коли робочому простору потрібна пробна активація, додаткові ліміти, рахунки-фактури, оновлення платежів або зміни в підписці.

Перш ніж почати
  • Власник облікового запису або адміністратор платежів має виконувати дії щодо виставлення рахунків.
  • Перевірте, які функції обмежені планом: голос, клоновані голоси, власні аватари, API, команда, CRM та канали.
  • Використовуйте захищений платіжний портал, щоб змінити спосіб оплати та рахунок-фактуру.
1

Відкрийте Білінг

Натисніть Платежі на бічній панелі.

Очікуваний результат: Відображаються поточний план, пробний стан, ліміти usage і картки планів.
2

Порівняйте плани

Перегляньте chat, голос, команду, API, аватар, інтеграцію, планування та обмеження підтримки.

Очікуваний результат: Ви знаєте, який план розблокує потрібну функцію.
3

Виберіть платіжний інтервал

Виберіть щомісяця або щороку, якщо перемикач доступний.

Очікуваний результат: Оновлення цін і заощаджень для вибраного інтервалу.
4

Оновіть або почніть перевірку

Виберіть потрібний план і завершіть оформлення замовлення.

Очікуваний результат: Підписка стає активною після підтвердження оплати.
5

Відкрити портал клієнтів

Використовуйте платіжний портал для способу оплати, рахунків-фактур, скасування або повторної активації.

Очікуваний результат: Делікатні дії з виставлення рахунків відбуваються на захищеному порталі постачальника.
6

Перевірте доступ до функції

Поверніться до заблокованої функції та перезавантажте програму.

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

Що робити далі: Запросіть товаришів по команді та захистіть обліковий запис власника.

Команда та безпека

Запрошуйте товаришів по команді, встановлюйте ролі, редагуйте профіль, увімкніть 2FA та керуйте налаштуваннями

Для чого це: Використовуйте це, коли робочий простір переходить від індивідуальної настройки до командної роботи.

Перш ніж почати
  • Перш ніж надсилати запрошення, дізнайтеся кожну роль члена команди.
  • Використовуйте мінімальний доступ: власник, адміністратор, редактор, переглядач.
  • Підготуйте програму автентифікації для 2FA.
1

Відкрийте налаштування

Натисніть Налаштування на бічній панелі.

Очікуваний результат: Відображаються загальні, сповіщення, команда, звіти, розробники, безпека та пов’язані вкладки.
2

Редагувати профіль і мову

Оновіть відображуване ім’я, інформацію профілю та бажану мову в цілому.

Очікуваний результат: Додаток правильно ідентифікує користувача та використовує вибрану мову, де доступно.
3

Запросіть членів команди

Відкрийте команду, введіть електронну адресу, виберіть роль і надішліть запрошення.

Очікуваний результат: Член команди отримує посилання на запрошення та відображається як очікує на розгляд, доки не буде прийнято.
4

Встановити дозволи ролі

Використовуйте власника для повного контролю, адміністратора для керування, редактора для змін вмісту та переглядача для доступу лише для читання.

Очікуваний результат: Кожен користувач має доступ відповідно до його відповідальності.
5

Налаштувати сповіщення

Виберіть електронну пошту, браузер, push-повідомлення, живу підтримку, виставлення рахунків і сповіщення про звіти.

Очікуваний результат: Потрібні люди отримують сповіщення без зайвого шуму.
6

Увімкніть 2FA

Відкрийте Безпеку, увімкніть двофакторну автентифікацію, відскануйте код і збережіть дані відновлення.

Очікуваний результат: Для облікового запису потрібен другий фактор після входу в систему.
7

Використовуйте дії в небезпечній зоні обережно

Експортуйте необхідні дані та підтвердьте активні віджети/інтеграції перед деструктивними діями облікового запису.

Очікуваний результат: Робоча область дозволяє уникнути випадкової втрати даних.
Як це перевірити: Запросіть тестового члена команди, прийміть запрошення в окремому браузері та підтвердьте роль, відкриваючи лише заплановані функції.
проблемаВиправити
Відсутня електронна адреса запрошенняПеревірте спам, повторно надішліть запрошення та підтвердьте адресу.
Товариш по команді бачить занадто багатоЗнизьте їх роль і перегляньте налаштування доступу ботів.
Помилка налаштування 2FAПеревірте час пристрою, повторно відскануйте QR-код і збережіть дані відновлення, перш ніж покладатися на нього.

Що робити далі: Налаштуйте ключі API лише для користувачів і служб, яким вони потрібні.

Філіал

Приєднайтеся до афілійованого партнера, скопіюйте реферальне посилання, встановіть електронну адресу для виплати та подайте запит на виплату

Для чого це: Використовуйте це, коли партнер або клієнт хоче запропонувати нових користувачів sem.chat і відстежувати комісійну діяльність.

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

Відкрийте Партнерську програму

Натисніть «Партнерство» на бічній панелі або відкрийте вкладку «Партнерство» в налаштуваннях, якщо там є посилання.

Очікуваний результат: На сторінці партнерської програми показано зони приєднання, рефералів, виплат та історії.
2

Приєднуйтесь до програми

Натисніть «Приєднатися», якщо обліковий запис ще не приєднано.

Очікуваний результат: Створюється реферальний код і реферальне посилання.
3

Копіювати реферальне посилання

Скопіюйте унікальне посилання та використовуйте його в контенті, кампаніях або повідомленнях партнерів.

Очікуваний результат: Реєстрацію за посиланням можна віднести до афілійованого облікового запису.
4

Налаштуйте електронну адресу для виплат

Введіть електронну адресу виплати та збережіть її.

Очікуваний результат: Відповідні виплати можна правильно направляти.
5

Перегляд рекомендацій і комісій

Перевірте список рефералів, статус комісії та історію виплат.

Очікуваний результат: Ви знаєте, що очікує на розгляд, що відповідає вимогам або вже оплачено.
6

Запит на виплату

Натисніть Запит на виплату, коли правила програми та мінімуми будуть виконані.

Очікуваний результат: Запит на виплату записується для обробки.
Як це перевірити: Відкрийте реферальне посилання в приватному браузері та переконайтеся, що воно потрапляє в очікуваний потік реєстрації з відстеженням рефералів.
проблемаВиправити
Відсутнє реферальне посиланняПриєднайтеся до програми спочатку або оновіть партнерську сторінку після приєднання.
Запит на виплату недоступнийПеревірте мінімальний поріг виплати, відповідний стан комісії та електронну пошту про виплату.
Реферал не вказаноПереконайтеся, що відвідувач використав точне реферальне посилання та не видалив параметри відстеження.

Що робити далі: Використовуйте аналітику та звіти, щоб відстежувати вплив запрошених клієнтів, якщо це можливо.

12

Сповіщення та App Updates

Переглядайте сповіщення, позначайте сповіщення прочитаними, фільтруйте важливі події та використовуйте оновлення додатків, щоб зрозуміти нові зміни продукту.

/повідомленняЦентр сповіщень
Реальний знімок екрана демонстраційного робочого простору sem.chat
1Використовуйте Позначити як прочитане після перегляду непрочитаних сповіщень.
2Фільтруйте за непрочитаними, платіжними, живою підтримкою або системними подіями.
3Відкрийте відповідну функцію, прочитавши сповіщення.
/оновлення програмиСтрічка оновлень програми
Реальний знімок екрана демонстраційного робочого простору sem.chat
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 вкладок
Реальний знімок екрана демонстраційного робочого простору sem.chat
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, щоб отримати деталі та приклади кінцевих точок.

Зареєструвати вебхук
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": "webhook-register",
    "url": "https://your-crm.example.com/semchat/webhook",
    "events": ["handoff.requested", "message.user", "handoff.resolved"]
  }'
Перевірте підпис вебхуку
import crypto from 'node:crypto';

function verifySemChatSignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature || ''),
    Buffer.from(expected)
  );
}
Карта кінцевої точки

Використовуйте публічний API на основі дій правильно

Для чого це: Використовуйте це, коли вибираєте правильну дію для функції.

Перш ніж почати
  • Кожен запит використовує ту саму функцію public-api URL.
  • Дії GET використовують параметри запиту. Дії POST використовують тіло JSON.
  • Надсилайте x-api-key на всі запити.
Як це перевірити: Виклик usage та list-bots як димовий тест після будь-якої зміни ключа API або кінцевої точки.
проблемаВиправити
Невідповідність методуВикористовуйте метод, наведений у таблиці кінцевих точок. Деякі дії є лише GET або POST.
Відсутнє необхідне значенняПеревірте botId, conversationId, ідентифікатор вебхука та правопис дії.

Що робити далі: Використовуйте Quick Start для перших запитів, потім /api-docs для повного посилання.

методДіяпризначення
GETlist-botsСписок усіх ботів, доступних для власника ключа API.
GETget-botОтримати одну конфігурацію бота за ідентифікатором бота.
POSTchatНадішліть повідомлення відвідувача боту та поверніть відповідь ШІ.
GETconversationsСписок останніх conversations для бота, до 100 записів.
GETusageПлан повернення, кредити, кількість ботів, conversations та API ключ usage.
GETlive-support-listСписок conversations, який очікує або обробляється агентом-людиною.
GETlive-support-messagesОтримайте потік передачі з повідомленнями та інформацією про відвідувачів.
POSTlive-support-replyНадіслати відповідь людини-агента із зовнішньої системи.
POSTlive-support-claimЗаявка на розмову передачі в очікуванні.
POSTlive-support-resolveРозв’яжіть передачу або поверніть керування ШІ.
POSTwebhook-registerЗареєструйте кінцеву точку вебхуку HTTPS.
GETwebhook-listСписок реєстрацій вебхуків без повернення секретів.
POSTwebhook-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 на рівні кінцевої точки.

Відкрийте API Документи