Статья для разработчиков вашего продукта. Если вы просто ставите чат на сайт, вам нужен только код из раздела «Чат на сайте».
Ключи 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 и секрет виджета.