Руководства

Веб-виджет

Настройте встраиваемый JS-виджет —— брендинг, идентификация и события.

Веб-виджет — это небольшой JS-бандл (~30 kB после gzip), который размещает чат-пузырь в нижнем углу любой страницы.

Загрузка

<script src="https://cs.askais.com/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://cs.askais.com"></script>

Идентификация вошедших пользователей

Для анонимных посетителей виджет автоматически создаёт контакт. Для вошедших пользователей вызовитеSingChat.identify() с информацией о вашем пользователе:

window.SingChat.identify({
  externalId: "user_123",
  name: "Ada Lovelace",
  email: "ada@example.com",
  customAttributes: { plan: "pro", signupAt: "2025-01-12" },
});

Программное открытие / закрытие

SingChat.open();
SingChat.close();
SingChat.toggle();

Прослушивание событий

SingChat.on("message:new", (msg) => {
  console.log("new message", msg);
});

SingChat.on("ai:stream:end", ({ messageId }) => {
  // AI finished streaming
});

Настройка темы

В разделе Settings → Inboxesвы можете настроить основной цвет виджета, его положение и текст приветствия. White-label (скрытие "Powered by AskAIs Customer Service") доступен на тарифе Pro и выше.

Безопасность

app-id является публичным — его можно безопасно размещать в HTML
Секретный ключ предназначен только для сервера — никогда не раскрывайте его в коде браузера
Для сценариев с высоким уровнем доверия подписывайте полезные данные пользователя на стороне сервера секретным ключом (HMAC-SHA256) — см. Аутентификация API

НазадIntegration overview ДалееБаза знаний (RAG)