Настройка и публикация чата на сайт

Чат A5X — AI-агент на вашем сайте или во внутреннем кабинете: отвечает по звонкам, документам базы знаний или по обоим источникам сразу. Ниже — полный путь от настроек в кабинете до рабочего кода на странице.

С августа 2026 у одного аккаунта может быть несколько конфигураций чата: у каждой — свой сценарий, пространства базы знаний, стиль и отдельный код вставки.

Что такое чат и где он живёт

Чат — это небольшой скрипт на странице и диалоговое окно поверх вашего интерфейса. Пользователь задаёт вопрос текстом; агент ищет ответ в данных вашего аккаунта (звонки, документы) по правилам выбранного сценария.

Что подготовить перед запуском

1. Аккаунт с включённым чатом (модуль Speech / чат в тарифе).
2. Хотя бы несколько расшифрованных звонков — если нужен режим «Звонки».
3. Пространства и документы в «Базе знаний» — если нужен режим «База знаний».
4. Раздел «Сценарии» (раздел сценариев) — чтобы выбрать готовый сценарий или собрать свой.
5. Адрес сайта (origin), с которого будет открываться чат — для ограничения доступа.

Конфигурация в кабинете

Откройте Настройки → вкладка «Чат». При первом заходе создаётся конфигурация «По умолчанию» — её же использует агент внутри кабинета.

• ИмяПонятное название для себя: «Сайт», «ЛК клиентов», «Внутренний HR».
• СценарийЛогика агента: какие отделы и инструменты доступны. Выберите готовый или свой из списка сценариев.
• Режимы«Звонки», «База знаний» или оба. От этого зависит, к каким данным агент обращается.
• Пространства базы знанийБелый список пространств. Пустой список = все пространства аккаунта; отмеченные = только они.
• СтильЦвета и заголовок шапки — превью рядом с формой показывает, как чат впишется в интерфейс.
• OriginРазрешённый адрес сайта (например https://example.com). Запросы с других доменов не пройдут.

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

Сценарии и база знаний

В разделе «Сценарии» при первом открытии появляются готовые варианты с короткими подписями — для чего каждый нужен.

Пространства базы знаний задаются на чате, а не в сценарии: один и тот же сценарий «База знаний» на публичном сайте может смотреть только в FAQ, а во внутреннем ЛК — в HR и регламенты.

Несколько чатов на один аккаунт

Кнопка «Добавить» создаёт новую конфигурацию. У каждой — свой код вставки. Типичная схема:

• Публичный сайт — сценарий «Поддержка» или «База знаний», режим документов, пространство FAQ, origin сайта.
• Личный кабинет клиента — те же документы плюс при необходимости ограниченный набор звонков.
• Внутренний портал — «Аналитика звонков» или «Для сотрудников», origin внутреннего домена.

Конфигурация с флагом «По умолчанию» используется агентом в кабинете A5X. Для сайта копируйте код вставки из нужной вкладки — в нём уже свой data-widget-key.

Публикация: код вставки на сайт

Внизу карточки чата — блок «Код вставки». Выберите режим «Кнопка» или «Встроенный», скопируйте код и вставьте на страницу перед закрывающим тегом body (или в контейнер для встроенного режима).

В коде обязателен только data-widget-key (public_key чата, wk_…) — ключ уже привязан к конкретной конфигурации:

• data-widget-key — из блока «Код вставки» или из GET /v1/chats/list → public_key;
• для другого чата на другой странице — свой ключ из нужной вкладки.

Для встроенного режима в коде будет контейнер (по умолчанию блок с id a5x-agent) и атрибуты data-display="inline" и data-target. Задайте контейнеру нужную высоту в CSS страницы.

• Один чат на страницуНа одной странице монтируется один экземпляр. Для разных разделов сайта используйте разные страницы или разные конфигурации на разных URL.
• Сервер чатаВ data-server указан публичный хост чата (например https://w.s2t.a5x.pro). Не подменяйте его адресом кабинета.

Проверка и безопасность

1. Откройте страницу с кодом в том же origin, что указан в настройках.
2. Убедитесь, что появляется кнопка или встроенный чат.
3. Задайте тестовый вопрос по FAQ или по звонку — ответ должен опираться на ваши данные.
4. Проверьте цитаты и источники под ответом (звонки, документы).
5. Откройте сайт с другого домена — запрос должен отклоняться, если origin ограничен.

Чек-лист запуска

Частые вопросы