Перейти к основному содержимому

Пользователи и API-ключи

Пользователи

Раздел Пользователи доступен администратору.

При создании сотрудника укажите email, временный пароль и роль. При необходимости настройте Telegram-уведомления. Позже администратор может изменить роль, пароль, каналы уведомлений или деактивировать учётную запись.

Администратор не может изменить собственную роль или деактивировать себя. Деактивация сохраняет историю сотрудника, но запрещает вход и отключает принадлежащие ему API-ключи.

Настройки Email и MAX пока не доставляют уведомления.

Что такое API-ключ

API-ключ разрешает внешней системе создавать чаты и отправлять сообщения в AIStudio. Раздел доступен администратору и разработчику.

Один ключ удобно использовать для одного источника. Давайте ключам понятные названия:

  • Сайт;
  • Виджет интернет-магазина;
  • Тестовая интеграция.

Эти названия затем видны в списке и фильтрах чатов.

Как создать ключ

  1. Откройте API-ключи.
  2. Нажмите Создать ключ.
  3. Введите понятное название источника.
  4. Сразу скопируйте полученный секрет и передайте его ответственному за интеграцию безопасным способом.
  5. Нажмите Я сохранил ключ.

:::danger Ключ показывается один раз Если секрет потерян, восстановить его нельзя. Деактивируйте старый ключ и создайте новый. :::

Действие удаления в панели деактивирует ключ, но сохраняет запись. После деактивации внешняя система больше не сможет использовать этот ключ.

Документация для интеграции

Точные адреса запросов и форматы данных находятся в Swagger. Ссылка Документация в панели открывает описание Admin API. Описание внешнего API чатов доступно по адресу /api/docs на сервере Public API.

Обычному оператору API-ключи и Swagger для работы не нужны.