Перейти к содержимому
Delivery API
Прежде чем рассчитывать на какую-либо функцию, проверьте статус возможностей.

РуководстваВзаимодействие

Чат-бот для сайта

Добавьте на сайт чат-бот Atlas со сценариями, ответами ИИ на основе вашего контента и сбором лидов.

Эта страница переведена с английского. При любых расхождениях действует английская версия. Читать на английском

  • Сценарии, созданные в Studio: приветствия, кнопки, вопросы и сбор лидов.
  • Ответы ИИ на основе опубликованного контента вашего сайта, оплачиваемые кредитами ИИ вашего тарифа. Когда кредиты закончились, бот выдаёт резервное сообщение.
  • Внешний вид и триггеры: цвета, изображение кнопки запуска и момент открытия, настраиваются для каждого сайта в Studio.
  • Защита Turnstile, когда разговор похож на автоматический.
  • Лиды: данные, которые посетитель оставил на шаге сбора лида, попадают в Forms & leads → Leads, как обращения из форм.

Живой передачи диалога оператору-человеку пока нет.

Чат-боты попадают в Production внутри релизов. Когда Production включён и действует подписанный релиз, чат-бот из релиза отвечает реальным посетителям, используя знания со страниц этого релиза (до 5 000 фрагментов). Изменения из Development доходят до посетителей только со следующим одобренным релизом.

Пока Production выключен, адреса чат-бота отвечают 404 CP_NOT_FOUND; если Production включён, но действующего релиза нет, — 403 CP_PRODUCTION_LOCKED.

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

    app/atlas-chat.tsx
    'use client';
    import { AtlasChat } from '@atlas/chat-widget';
    import '@atlas/chat-widget/styles.css';
    import { usePathname } from 'next/navigation';
    export function SiteChat() {
    const path = usePathname();
    return (
    <AtlasChat
    apiOrigin="https://delivery.atlas.example"
    environmentId="env_XXXXXXXX"
    botKey="support"
    path={path}
    />
    );
    }
  2. Разрешите Atlas в Content-Security-Policy: добавьте источник API Atlas в connect-src и img-src.

  3. Используйте идентификатор окружения Production в рабочем развёртывании и идентификатор Development везде в остальных местах.

Пакет виджета передаётся подключённым клиентам напрямую; в публичном реестре npm его пока нет. Без React используйте обычный клиент createChatClient({ apiOrigin, environmentId, botKey }), у которого есть методы bot(), start(path) и send(…).

  • Разговоры привязаны к случайному секрету, хранящемуся в session storage посетителя. Файлы cookie не используются.
  • Данные лида сохраняются только тогда, когда посетитель отправляет их на шаге сбора лида.
  • Ограничения частоты действуют по IP-адресу и по разговору; см. Лимиты.