Визуальное пошаговое руководство

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

Руководство по SEMJAT со скриншотами, созданное на основе реального процесса работы с информационной панелью sem.chat. В каждом руководстве рассказывается, что нажимать, что должно произойти после щелчка, как это проверить, как устранить неполадки и что делать дальше.

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

Начало работы

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

/аутентификацияРегистрация, пробная версия и первый бот
Реальный снимок экрана демонстрационной рабочей области sem.chat
1Начните с регистрации или входа на общедоступном сайте или в приложении.
2Подтвердите адрес электронной почты, прежде чем полагаться на уведомления или сообщения о выставлении счетов.
3Используйте онбординг, чтобы создать первого бота перед открытием панели управления.
/обзорОбзор после входа в систему
Реальный снимок экрана демонстрационной рабочей области sem.chat
1Используйте быстрые действия для создания бота, просмотра ботов, открытия аналитики или управления выставлением счетов.
2Прежде чем вносить изменения, просмотрите активных ботов, conversations, голосовые минуты и уровень удовлетворенности.
3Проверяйте недавнюю активность после каждого теста настройки.
Первый запуск

Зарегистрируйтесь, запустите пробную версию и разберитесь с панелью управления.

Для чего это: Используйте этот рабочий процесс для совершенно нового рабочего пространства или при привлечении товарища по команде, который никогда не использовал sem.chat.

Прежде чем начать
  • Используйте корпоративный адрес электронной почты, на который можно получать электронные письма с подтверждением и выставлением счетов.
  • Решите, кому будет принадлежать рабочее пространство, прежде чем приглашать остальную часть команды.
  • Подготовьте безопасный тестовый веб-сайт или промежуточную страницу для установки виджета.
1

Откройте страницу регистрации приложения

Перейдите в app.sem.chat/auth с сайта, кнопка «Войти/Зарегистрироваться».

Ожидаемый результат: На странице аутентификации показаны параметры входа и создания учетной записи.
2

Создать учетную запись

Введите рабочий адрес электронной почты, создайте пароль и отправьте регистрационную форму.

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

Подтвердите адрес электронной почты

Откройте письмо с подтверждением и нажмите ссылку подтверждения.

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

Полная адаптация

Введите название компании, опишите цель помощника, выберите стартовый цвет и создайте первого бота.

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

Открыть обзор

Нажмите «Обзор» на левой боковой панели.

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

Выберите следующее действие

Используйте «Создать нового бота» для настройки, «Просмотреть всех ботов» для управления, «Аналитику» для производительности или «Выставление счетов» для ограничений плана.

Ожидаемый результат: Вы знаете, куда продолжить, в зависимости от состояния рабочей области.
Как это проверить: Создайте одного частного тестового бота и отправьте тестовое сообщение, прежде чем приглашать товарищей по команде. Подтвердите изменения в обзорной деятельности после теста.
ПроблемаИсправить
Письмо с подтверждением не приходитПроверьте спам, проверьте правильность написания электронного письма, а затем запросите еще одно письмо для подтверждения.
Панель управления открывается в разделе "Оплата"Для рабочей области может потребоваться активная пробная версия или план. Запустите пробную версию или выберите правильный план перед настройкой.
Товарищ по команде не может получить доступ к рабочей областиПригласите их из «Настройки» и «Команда» вместо того, чтобы делиться логином владельца.

Что делать дальше: Создайте первого бота, протестируйте его приватно, а затем установите виджет на промежуточную страницу.

Частный тест запуска

Создайте первый частный тест бота перед запуском в эксплуатацию.

Для чего это: Используйте это для проверки учетной записи, бота, виджета и отслеживания истории, прежде чем клиенты увидят помощника.

Прежде чем начать
  • Подготовьте один пример вопроса клиента.
  • Подготовьте промежуточную страницу или локальную тестовую страницу 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Нажмите «Новый бот», чтобы запустить нового помощника.
2Используйте «Редактировать», «Встроить», «Перенести», «Активировать» или «Удалить» на каждой карточке бота.
3Перед тестированием проверьте активное состояние и время последнего обновления.
/bots/:id/редактироватьBot Builder вкладка «Основы»
Реальный снимок экрана демонстрационной рабочей области sem.chat
1Введите имя бота, аватар, первое сообщение и системные инструкции.
2Используйте предварительный просмотр для тестирования перед публикацией.
3Сохраните и синхронизируйте перед копированием кода для внедрения.
Создать бота

Создайте нового бота из My Bots.

Для чего это: Используйте этот рабочий процесс, когда новому бренду, веб-сайту, очереди поддержки или кампании нужен собственный помощник.

Прежде чем начать
  • Подготовьте имя бота, цель, первое сообщение и два-три примерных вопроса.
  • Соберите общедоступный веб-сайт URL, если вы планируете импортировать контент.
  • Убедитесь, что план позволяет использовать необходимое количество ботов и функций голоса/аватара.
1

Открыть My Bots

Нажмите My Bots на боковой панели.

Ожидаемый результат: Существующие боты и кнопка «Новый бот» видны.
2

Нажмите «Новый бот».

Запустите нового бота со страницы My Bots.

Ожидаемый результат: Bot Builder открывается помощником по черновикам.
3

Установить личность бота

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

Ожидаемый результат: На панели предварительного просмотра отображаются имя помощника, аватар и приветствие.
4

Напишите системные инструкции

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

Ожидаемый результат: У помощника есть четкие правила поведения до добавления знаний.
5

Добавьте базовые знания

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

Ожидаемый результат: Бот может отвечать на распространенные вопросы без необходимости импорта веб-сайта.
6

Сохраните бота

Нажмите «Сохранить» и дождитесь подтверждения сохранения или синхронизации.

Ожидаемый результат: У бота стабильный идентификатор, можно протестировать предварительный просмотр и станут доступны параметры встраивания.
7

Предварительный просмотр результата

Задайте подготовленные примеры вопросов в предварительном просмотре.

Ожидаемый результат: Ответы должны следовать инструкциям и использовать введенные вами знания.
8

Активируйте только тогда, когда будете готовы

Включите бота после прохождения частного теста.

Ожидаемый результат: Бот готов к трафику виджета или канала.
Как это проверить: Задайте как минимум пять реалистичных вопросов. Проверьте, правильный ли ответ, соответствует ли он бренду и просит ли он помощи человека, когда это необходимо.
ПроблемаИсправить
Ответ слишком общийДобавьте более конкретные знания и перепишите инструкции с примерами хороших ответов.
Бот отказывается от вопросов, на которые должен ответитьУдалите слишком строгие инструкции и добавьте проверенные знания по этой теме.
При сохранении не создается код для внедренияПроверьте обязательные поля и сохраните их снова после завершения синхронизации с голосовым провайдером.

Что делать дальше: Настройте параметры виджета, добавьте сведения о веб-сайте, а затем установите бота.

Управление ботами

Редактирование, клонирование рабочего процесса, перенос, деактивация или удаление бота

Для чего это: Используйте этот рабочий процесс, когда боту необходимы обновления, смена владельца, временная приостановка или окончательное удаление.

Прежде чем начать
  • Экспортируйте все разговоры или контактные данные, которые необходимо сохранить перед удалением бота.
  • Перед удалением или переносом убедитесь, что бот не встроен в действующий веб-сайт.
  • Сообщите товарищам по команде, прежде чем деактивировать производственного бота.
1

Открыть My Bots

Найдите карточку бота по имени или статусу.

Ожидаемый результат: На карточке показано текущее состояние и доступные действия.
2

Нажмите Редактировать

Откройте конструктор ботов и внесите необходимые изменения.

Ожидаемый результат: Редактор загружает текущую конфигурацию.
3

Сохраните и повторите тестирование

Нажимайте «Сохранить» после каждого изменения материала, а затем задавайте вопросы для предварительного просмотра.

Ожидаемый результат: Сохраненная конфигурация используется предварительным просмотром и установленным виджетом.
4

Временно деактивировать

Используйте активный переключатель, если бот должен прекратить обработку посетителей на данный момент.

Ожидаемый результат: Бот прекращает обслуживать живой трафик, сохраняя конфигурацию.
5

Передача права собственности

Используйте Transfer, введите адрес электронной почты получателя и подтвердите.

Ожидаемый результат: Выбранная учетная запись получает право собственности в соответствии с процессом передачи приложения.
6

Удалять только после проверок

Используйте «Удалить», прочитайте предупреждение и подтвердите действие только тогда, когда бот больше не нужен.

Ожидаемый результат: Бот и связанная с ним конфигурация будут удалены согласно предупреждению.
Как это проверить: После редактирования откройте установленный виджет и задайте именно тот вопрос, который послужил причиной изменения. Подтвердите, что живой ответ изменился.
ПроблемаИсправить
Старый ответ все еще появляетсяОбновите страницу веб-сайта, подтвердите, что вы сохранили правильного бота, и проверьте, требуется ли синхронизация импортированных знаний.
Передача не удаласьУбедитесь, что адрес электронной почты получателя действителен и что целевая учетная запись может принять бота.
Удалить было нажато по ошибкеОстановитесь перед окончательным подтверждением. Предупреждения об удалении существуют, поскольку действие может навсегда удалить данные бота.

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

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 опция

Используйте «Внешний вид», «Редактор тем», 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

Сохраните и протестируйте

Нажмите «Сохранить», перезагрузите промежуточную страницу и откройте виджет.

Ожидаемый результат: Живой виджет соответствует сохраненным настройкам.
Как это проверить: Откройте виджет на компьютере и мобильном устройстве, отправьте форму для потенциальных клиентов, оставьте оценку и подтвердите, что контакт и разговор записываются.
ПроблемаИсправить
Цвет не обновилсяСохраните бота, обновите веб-сайт и убедитесь, что установленный виджет использует тот же идентификатор бота.
Поля для потенциальных клиентов отсутствуютУбедитесь, что захват отведений включен и выбранное условие триггера выполнено.
Посетители не могут использовать голосПроверьте настройки голоса, разрешение микрофона в браузере, доступ к плану и ограничения на голосовые минуты.

Что делать дальше: Добавьте настройки голоса/аватара и источники знаний перед запуском производства.

05

Голос и аватары

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

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

Настройка голосовых вызовов и расшифровок

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

Прежде чем начать
  • Убедитесь, что план включает голосовые минуты и желаемые параметры голоса/аватара.
  • Используйте тихую браузерную среду для тестирования.
  • Подготовьте один реалистичный вопрос поддержки или продаж для голосового тестирования.
1

Открыть настройки голоса

Откройте конструктор ботов и выберите область «Голос» или «Голос и аватары».

Ожидаемый результат: Голосовое управление и текущий голосовой выбор видны.
2

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

Просмотрите доступные голоса, выберите наиболее подходящий и сохраните выбор.

Ожидаемый результат: Бот использует выбранный голос для звонков.
3

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

Используйте настройки виджета, чтобы выбрать «Голосовой» или «Гибридный», когда голос должен быть доступен посетителям.

Ожидаемый результат: Посетители видят голосовую опцию в виджете.
4

Установить ограничения голоса

Определите ограничения для каждого пользователя или рабочего пространства, если таковые имеются.

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

Включить расшифровки

Включите сохранение расшифровки, если вам нужен просмотр звонков в истории.

Ожидаемый результат: Голосовые вызовы создают читаемые расшифровки после сеанса.
6

Проверить звонок

Откройте виджет, разрешите доступ к микрофону, начните звонок и задайте заранее подготовленный вопрос.

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

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

Откройте Chat History и найдите голосовой разговор.

Ожидаемый результат: В расшифровке показано, что сказали посетитель и бот.
Как это проверить: Выполните один короткий звонок и убедитесь, что голосовые минуты, стенограмма и режим разговора записаны.
ПроблемаИсправить
Браузер блокирует микрофонРазрешите разрешение микрофона в браузере и перезагрузите страницу.
Голосовая опция заблокированаOpen Billing and confirm the workspace plan includes voice features.
Стенограмма пустаУбедитесь, что сохранение расшифровки включено и звонок завершился нормально.

Что делать дальше: Добавляйте или уточняйте знания, чтобы голосовые ответы были точными.

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

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

Для чего это: Используйте это, когда помощнику нужен фирменный голос или говорящий аватар.

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

Открытое клонирование голоса

Нажмите «Клонировать голос» в области «Голос».

Ожидаемый результат: В диалоговом окне загрузки показаны принятые образцы требований.
2

Загрузить образцы

Загрузите от одной до пяти чистых записей и отправьте запрос на клонирование.

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

Назначьте клонированный голос

Выберите клонированный голос в средстве выбора голоса и сохраните его.

Ожидаемый результат: В будущих вызовах используется клонированный голос.
4

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

Выберите включенный аватар, если загрузка собственного аватара не требуется.

Ожидаемый результат: Голосовой опыт имеет визуальную идентичность.
5

Загрузить собственный аватар

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

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

Запустите полный предварительный просмотр

Начните голосовой вызов и одновременно подтвердите поведение голоса, аватара и расшифровки.

Ожидаемый результат: Опыт посетителей соответствует настроенному бренду.
Как это проверить: Задайте короткий вопрос, выбрав клонированный голос, и подтвердите, что в вызове используется ожидаемый голос/аватар.
ПроблемаИсправить
Качество клона плохоеЗаписывайте более чистые сэмплы с помощью одного динамика, стабильной громкости и без музыки.
Загрузка собственного аватара недоступна.Проверьте биллинг, чтобы узнать о лимитах на количество аватаров, ограниченных планом.
Старый голос все еще звучитСохраните бота после выбора нового голоса и перезагрузите страницу виджета.

Что делать дальше: Перейдите к разделу «Знания и данные», чтобы голосовой интерфейс давал точные ответы.

06

Знания и данные

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

Bot Builder / ЗнанияИсточники знаний и тестирование ответов
Реальный снимок экрана демонстрационной рабочей области sem.chat
1Добавьте ручные знания по политике, ценообразованию и правилам бренда.
2Импортируйте страницы веб-сайта и примените результаты сканирования.
3Добавляйте фиды продуктов и синхронизируйте их при изменении запасов.
Источники знаний

Обучите бота ручным знаниям, импорту веб-сайтов и фидам продуктов.

Для чего это: Используйте это, когда помощник дает неполные ответы или ему нужна свежая информация о продукте, политике или веб-сайте.

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

Открытые знания

Откройте Bot Builder и выберите вкладку «Знания» или «Данные».

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

Добавьте ручные знания

Вставьте краткие факты, политику, цены, контактные данные и примечания к стилю ответа.

Ожидаемый результат: У бота есть непосредственный надежный источник высокоприоритетных ответов.
3

Импортировать контент веб-сайта

Вставьте общедоступный веб-сайт URL и начните сканирование/импорт.

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

Просмотрите и примените результаты

Сохраняйте полезные страницы, удаляйте ненужные страницы, а затем применяйте выбранный контент.

Ожидаемый результат: В базу знаний попадает только одобренный контент сайта.
5

Добавьте фид товаров URLs

Вставьте Google Merchant Center или поддерживаемый фид URL и импортируйте.

Ожидаемый результат: Боту становятся доступны товары, цены, наличие и атрибуты.
6

Обновить или удалить каналы

Используйте обновление при изменении данных каталога и удаляйте неиспользуемые каналы.

Ожидаемый результат: Бот избегает устаревших или дублирующихся данных о продукте.
7

Сохранить и синхронизировать

Сохраните бота и дождитесь завершения синхронизации.

Ожидаемый результат: Новейшие знания используются для предварительного просмотра и ответов в виджетах в реальном времени.
8

Задавайте проверочные вопросы

Задайте по одному тестовому вопросу для каждого добавленного вами источника.

Ожидаемый результат: В ответе точно цитируется или отражает обновленный контент.
Как это проверить: Задавайте вопросы о ценах, возвратах, наличии, информации о компании и неподдерживаемых темах. Подтвердите, что бот отвечает на известные темы и не выдумывает неизвестные детали.
ПроблемаИсправить
Краулер импортирует нерелевантные страницыУдалите эти страницы из выбранных результатов и добавьте более четкие инструкции вручную.
Цены на продукцию устаревшиеОбновите фид и убедитесь, что фид URL сам содержит текущие значения.
Бот составляет ответыДобавьте правило, согласно которому бот должен говорить, что он не уверен, и предлагать человеческую поддержку, когда знаний не хватает.

Что делать дальше: Вернитесь в режим предварительного просмотра, протестируйте еще раз, затем установите или обновите виджет.

07

Входящие, Live Support, История, Контакты

Ежедневно обрабатывайте conversations, отправляйте запросы на поддержку в реальном времени, возвращайте управление ИИ, экспортируйте историю, управляйте контактами и синхронизируйте контакты с SendPulse.

/входящиеРабочий процесс беседы в папке «Входящие»
Реальный снимок экрана демонстрационной рабочей области sem.chat
1Фильтровать по боту или каналу.
2Откройте разговор и при необходимости ответьте как человек.
3Осторожно используйте элементы управления переводом, разрешением и передачей управления.
/живая поддержкаУправление передачей обслуживания в режиме реального времени
Реальный снимок экрана демонстрационной рабочей области 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 для аудита.

Живая поддержка

Подайте заявку, ответьте, верните ИИ и разрешите передачу

Для чего это: Используйте это, когда ИИ запрашивает человека или посетителю явно нужен агент.

Прежде чем начать
  • Прежде чем включать поддержку в реальном времени, убедитесь, что у вас есть агент.
  • Определите, когда ИИ должен запросить передачу управления в инструкциях бота.
  • Оставьте настройки уведомлений включенными для оповещений о передаче обслуживания.
1

Открыть Live Support

Нажмите Live Support на боковой панели.

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

Подать заявку на запрос

Нажмите «Заявить» в ожидающем разговоре.

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

Чтение контекста

Прежде чем ответить, открывайте сообщения и сведения о посетителях.

Ожидаемый результат: Агент понимает, почему произошла передача.
4

Отправить человеческий ответ

Отвечайте четко и следите за обновлениями темы.

Ожидаемый результат: Посетитель получает человеческий ответ.
5

Верните ИИ, если это необходимо.

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

Ожидаемый результат: ИИ возобновляет ведение разговора.
6

Решите, когда закончите

Нажмите «Решить» после того, как посетителю больше не нужна помощь.

Ожидаемый результат: Передача обслуживания закрывается и удаляется из активной очереди.
Как это проверить: Создайте тестовую передачу, заявите ее, ответьте один раз, передайте обратно и подтвердите изменение статуса в Live Support и Chat History.
ПроблемаИсправить
Агенты пропускают запросыВключите браузер/электронную почту/push-уведомления и добавьте процесс владения очередью.
ИИ продолжает брать верх слишком раноСкорректируйте инструкции и правила передачи, чтобы человеческий контроль оставался активным до тех пор, пока не будет решено или не возвращено решение.
Внешний 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 в «Интеграциях», а затем вернитесь в «Контакты».

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

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Прежде чем поделиться ссылкой, сохраните мероприятие.
/book/:имя пользователя/:eventSlugСтраница общедоступного бронирования
Реальный снимок экрана демонстрационной рабочей области sem.chat
1Посетители выбирают дату на общедоступной странице бронирования.
2Посетители выбирают доступный временной интервал.
3Посетители подтверждают бронирование и получают подтверждение по электронной почте.
Тип события

Создайте тип мероприятия и опубликуйте ссылку для бронирования.

Для чего это: Используйте это, когда посетители должны заказать демо-версии, консультации, звонки по продажам, адаптацию или сеансы поддержки.

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

Открытое планирование

Нажмите «Планирование» на боковой панели.

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

Создайте тип события

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

Ожидаемый результат: Мероприятие содержит достаточно публичной информации, чтобы посетители могли ее понять.
3

Установить доступность

Настройте часы недели, переопределение даты, окна уведомлений и окно бронирования.

Ожидаемый результат: Посетители видят только то время, которое вы готовы предложить.
4

Добавить вопросы

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

Ожидаемый результат: Резервирования собирают контекст, который нужен вашей команде перед звонком.
5

Подключите календари

Откройте «Календари» и подключите Google, Outlook или iCal, если они доступны.

Ожидаемый результат: Загруженное время можно заблокировать, а подтвержденные бронирования можно записать в календарь.
6

Установите электронную почту и напоминания

Откройте электронную почту и настройте сообщения о подтверждении, напоминании, отмене и перепланировании.

Ожидаемый результат: Посетители получают правильное сообщение о бронировании.
7

Поделитесь и протестируйте общедоступную ссылку

Скопируйте ссылку на мероприятие, откройте ее в личном окне, выберите слот и завершите тестовое бронирование.

Ожидаемый результат: Бронирование появится на вкладке «Бронирования», и будут отправлены подтверждающие сообщения.
Как это проверить: Выполните одно тестовое бронирование, одно перенос и одну отмену. Убедитесь, что каждое событие отображается в расписании и подключенных календарях.
ПроблемаИсправить
На общедоступной странице время не отображаетсяПроверьте часовой пояс, доступность по неделям, переопределение даты, окно уведомлений и конфликты подключенного календаря.
Электронная почта для бронирования отсутствуетПроверьте настройки электронной почты и папку со спамом, а затем отправьте еще одно тестовое бронирование.
Платеж не проходит в платном событииПеред публикацией убедитесь, что настройки интеграции выставления счетов/платежей и валюта действительны.

Что делать дальше: Встраивайте ссылки для бронирования в бота, на веб-сайт или в последующие электронные письма.

Расширенное планирование

Используйте разовые ссылки, аналитику, встраивания и платные события.

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

Прежде чем начать
  • Сначала создайте хотя бы один тип событий.
  • Подключите календари, прежде чем активно использовать одноразовые ссылки.
  • Прежде чем включать платные мероприятия, определите политику возврата/отмены.
1

Создайте одноразовую ссылку

Откройте одноразовые ссылки, выберите предлагаемые слоты или правила, затем сгенерируйте ссылку.

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

Встроить расписание

Используйте опцию встраивания карточки мероприятия, если процесс бронирования должен появиться на вашем веб-сайте.

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

Обзор аналитики планирования

Откройте аналитику внутри планирования.

Ожидаемый результат: Вы можете увидеть бронирования, тенденции завершения и производительность по типам событий.
4

Включить платные мероприятия

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

Ожидаемый результат: Посетители должны выполнить этап оплаты в соответствии с условиями мероприятия.
5

Аудит заказов

Откройте «Бронирования» и просмотрите предстоящие, завершенные, отмененные и перенесенные записи.

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

Что делать дальше: Подключите результаты планирования к отчетам и аналитике.

10

Аналитика и отчеты

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

/аналитикаПанель аналитики
Реальный снимок экрана демонстрационной рабочей области sem.chat
1Выберите диапазоны дат или пользовательские даты.
2Читайте показатели разговора, удовлетворенности, языка, канала и конверсии.
3Экспортируйте CSV для автономного анализа.
Настройки/ОтчетыНастройка отчета по электронной почте
Реальный снимок экрана демонстрационной рабочей области sem.chat
1Выберите ежедневную, еженедельную или ежемесячную периодичность отчетов.
2Добавьте получателей отчета.
3Отправьте мгновенный отчет для проверки доставки.
Обзор аналитики

Чтение аналитики и экспорт данных о производительности

Для чего это: Используйте это для еженедельных обзоров, проверок запуска, проверки качества поддержки и анализа конверсий.

Прежде чем начать
  • Прежде чем читать показатели, выберите диапазон дат.
  • Знайте, какого бота или канал вы оцениваете.
  • Исключайте даты частных испытаний при составлении отчетов о производственных показателях.
1

Открытая аналитика

Нажмите «Аналитика» на боковой панели.

Ожидаемый результат: Показатели информационной панели и панели диаграмм видны.
2

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

Выберите сегодня, 7 дней, 30 дней или произвольные даты.

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

Чтение основных показателей

Просмотрите conversations, голосовые минуты, удовлетворенность, конверсию и сочетание каналов.

Ожидаемый результат: Вы понимаете объем и качество взаимодействия с клиентами.
4

Обзор тенденций

Посмотрите на тенденции разговоров, изменения удовлетворенности, популярные вопросы и шаблоны языка/канала.

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

Экспортировать CSV

Используйте «Экспорт CSV», если команде необходим анализ электронных таблиц.

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

Превратите выводы в изменения

Обновите инструкции для ботов, знания, настройки виджетов или покрытие поддержки на основе данных.

Ожидаемый результат: Аналитика приводит к конкретным улучшениям продукта.
Как это проверить: Экспортируйте небольшую пользовательскую дату CSV и убедитесь, что диапазон дат и показатели соответствуют тем, что показывает панель мониторинга.
ПроблемаИсправить
Показатели кажутся слишком высокимиПроверьте, включены ли промежуточные/тестовые conversations в выбранный диапазон дат.
Удовлетворение пустоВключите оценки в настройках виджета и ждите, пока посетители оставят оценки.
Голосовые минуты не соответствуют ожиданиямУбедитесь, что голосовой режим включен только для нужных ботов.

Что делать дальше: Планируйте отчеты по электронной почте для регулярной видимости.

Отчеты

Настройте повторяющиеся отчеты по электронной почте и проверьте доставку

Для чего это: Используйте это, когда владельцам, менеджерам или клиентам нужны автоматические сводки производительности.

Прежде чем начать
  • Решите, кто должен получать отчеты.
  • Используйте проверенные адреса электронной почты.
  • Выберите ритм, соответствующий ритму бизнес-обзоров.
1

Откройте «Настройки», затем «Отчеты».

Перейдите в «Настройки» и выберите вкладку «Отчеты» или воспользуйтесь перенаправлением «Отчеты», если оно доступно.

Ожидаемый результат: Частота отчетов, получатели и история видны.
2

Выберите частоту вращения педалей

Включите ежедневные, еженедельные или ежемесячные отчеты.

Ожидаемый результат: Расписание отчетов сохраняется для рабочей области.
3

Добавить получателей

Введите адреса электронной почты, на которые должны приходить отчеты.

Ожидаемый результат: Отчеты отправляются соответствующим заинтересованным сторонам.
4

Отправить мгновенный отчет

Нажмите «Отправить сейчас» или аналогичное действие мгновенного отчета.

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

Просмотрите историю отчета

Проверьте панель истории после отправки отчетов.

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

Что делать дальше: Используйте частоту отчетов в качестве рабочего ритма для улучшений ботов.

11

Биллинг, команда, безопасность, настройки, партнер

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

/биллингПланирование и контроль выставления счетов
Реальный снимок экрана демонстрационной рабочей области sem.chat
1Просмотрите текущий план, состояние пробной версии и ограничения usage.
2Сравните возможности плана перед обновлением.
3Откройте портал выставления счетов, чтобы просмотреть счета, способы оплаты, отмену или повторную активацию.
/НастройкиНастройки, команда и безопасность
Реальный снимок экрана демонстрационной рабочей области sem.chat
1Используйте «Общие» для профиля и языка.
2Используйте команду для приглашений и ролей.
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Откройте соответствующую функцию после прочтения предупреждения.
/app-обновленияЛента обновлений приложений
Реальный снимок экрана демонстрационной рабочей области 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

Вызовите action=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 со статусом=запрошено или статусом=все.

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

Получить сообщения

GET действие=live-support-messages с conversationId.

Ожидаемый результат: CRM содержит полный контекст потока и сведения о посетителях.
3

Прежде чем ответить, заявите претензию

POST действие=live-support-claim.

Ожидаемый результат: sem.chat помечает беседу как активно обрабатываемую.
4

Отправить ответ агента

POST action=live-support-reply с conversationId, сообщением и именем агента.

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

Решите или верните назад

POST action=live-support-resolve с разрешением разрешения или возвратом.

Ожидаемый результат: Разговор покидает очередь ожидания, или ИИ возобновляет управление.
6

Статус журнала в CRM

Сохраняйте последний статус передачи обслуживания, идентификатор сообщения и временные метки.

Ожидаемый результат: CRM и sem.chat остаются проверяемыми.
Как это проверить: Создайте безопасную передачу обслуживания, отразите ее на CRM, ответьте с моста и подтвердите обновления потока посетителей.
ПроблемаИсправить
Повторяющиеся заявки CRMИспользуйте conversationId в качестве ключа идемпотентности в вашем мосте CRM.
Ответы приходят не по порядкуСохраняйте временные метки сообщений и избегайте одновременных ответов от нескольких систем.
ИИ отвечает, пока агент работаетСначала запросите передачу и возвращайте ее только тогда, когда агент закончит работу.

Что делать дальше: Зарегистрируйте веб-перехватчики, если опрос выполняется слишком медленно или слишком дорого.

Вебхуки

Зарегистрируйте вебхуки и подтвердите 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 для аудита настроенных конечных точек.

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

Удалить устаревшие вебхуки

POST действие webhook-delete с идентификатором веб-перехватчика.

Ожидаемый результат: Старые конечные точки перестают получать события.
Как это проверить: Зарегистрируйте конечную точку тестирования, инициируйте событие оперативной поддержки, проверьте подпись и убедитесь, что ваш обработчик возвращает 2xx.
ПроблемаИсправить
Подпись не совпадаетИспользуйте необработанное тело, а не проанализированное JSON, и подтвердите правильный секрет веб-перехватчика.
Webhook не получает событийУбедитесь, что список событий включает событие, которое вы тестируете, а конечная точка — 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Отправьте сообщение посетителя боту и верните ответ AI.
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

Запустите инструменты узла/seo-optimize-static-pages.js и инструменты узла/seo-optimize-static-pages.js --check.

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

Запустите очистку и проверку различий

Запустите инструменты узла/static-translation-cleanup.js --audit и git diff --check.

Ожидаемый результат: Статические переводы и пробелы чистые.
7

Проверка браузера

Обслуживайте сайт локально и тестируйте/документацию на настольных компьютерах и мобильных устройствах.

Ожидаемый результат: Изображения загружаются, поиск работает, кнопки копирования работают, содержание выделяется, а макет не перекрывает баннер файлов cookie.
Как это проверить: Найдите измененное имя функции в /documentation и убедитесь, что отображается правильный направляющий блок.
ПроблемаИсправить
Маркеры скриншотов смещаются на мобильных устройствахДержите маркеры внутри изображения снимка экрана или используйте адаптивные координаты маркеров.
Поиск пропускает новое руководствоДобавьте полезные ключевые слова в заголовок данных и укажите точные термины продукта, которые ищут пользователи.
Локализованная документация устареваетПосле редактирования английского руководства обновите каждую локализованную страницу документации, снова запустите SEO-оптимизатор и убедитесь, что sitemap.xml содержит каждый URL документации.

Что делать дальше: Зафиксируйте вместе страницу документации, ресурсы, ссылки верхнего и нижнего колонтитула, файлы .htaccess и карту сайта.

Нужна целенаправленная ссылка на API?

Старая страница /api-docs остается доступной для сведений API на уровне конечной точки.

Открыть документы API