Встраивание в продукт и ключи API

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

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

Ключи API

«Настройки» → «Для разработчиков» → «API-ключи». Создайте ключ с минимальными правами:

  • widget.identity — выдача токенов личности для чата;
  • tickets.write — создание и чтение обращений;
  • knowledge.write — загрузка статей в знания.

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

Чат без повторного входа

Если пользователь уже вошёл в ваш продукт, чат может узнать его сразу. Сервер вашего продукта запрашивает у AiDaChat одноразовый токен личности (POST /api/v1/widget/identity-tokens) и передаёт его в код виджета как data-identity. Токен живёт 5 минут и используется один раз. Для неавторизованных пользователей токен не нужен: они открываются как анонимные посетители.

Своя кнопка вместо кружка

Чат можно открывать из вашей кнопки помощи. Добавьте в код атрибут data-launcher="none", и круглая кнопка чата спрячется, а вашей кнопке достаточно вызвать window.AiDaChat.open(). Можно передать параметры, чтобы чат выдвинулся на место вашего окна помощи: open({rect: {left, top, width, height}, onBack: функция}). Тогда в шапке появится кнопка «← Центр помощи», которая вызовет вашу функцию.

Тема

Чат подстраивается под тему продукта: window.AiDaChat.setTheme("dark"), "light" или "auto". Можно передать и цвета: setTheme({theme:"dark", primary:"#7C3AED", accent:"#6D28D9"}). Вызывайте при каждом переключении темы.

Создание обращений

Ваш продукт может создавать заявки: POST /api/v1/tickets с заголовком Idempotency-Key (чтобы повтор не создал дубль). Обязательное поле — subject. Можно передать описание, приоритет, ссылку на карточку у вас (external_url). О смене статуса вы узнаете через подписанные вебхуки.

Загрузка знаний

POST /api/v1/knowledge/articles: до 200 статей за запрос. Повторная загрузка с тем же external_id обновляет статью, а не дублирует.

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

  • Чат работает только на сайтах из списка разрешённых. В политике безопасности страниц (CSP) разрешите домен AiDaChat для скриптов и соединений.
  • Чат не использует iframe и изолирован от стилей страницы.
  • Не публикуйте ключи API и секрет виджета.

Вопросы и ответы

Как узнать пользователя в чате без повторного ввода данных?

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

Где создать ключ API?

В Настройках → «Для разработчиков». Ключ показывается один раз, права выдавайте минимальные.