справочник API · v1

Сотрудники

AI-сотрудники компании: кто собирает заявки и ведёт диалоги. Их id — agentId в заявках и диалогах.

get/employees— Список AI-сотрудников

Ресурс `Employee`

Поле	Описание
`id`string	Id сотрудника — agentId в заявках и диалогах.
`name`string	Имя, как его видят клиенты.
`description`string \| null	Чем занимается.
`isActive`boolean	Отвечает ли клиентам сейчас.
`channel`string	Основной канал: `widget`, `telegram`, `max`, `vk`, `whatsapp`, `avito` и др.
`createdAt`string (date-time)	Когда создан.

Список AI-сотрудников

get/api/v1/employees

Все AI-сотрудники компании, включённые и выключенные, в порядке создания.

Право ключа: AI-сотрудники · employees:read

curl https://app.chatneuron.ru/api/v1/employees \
  -H "Authorization: Bearer cn_live_…"

Ответ 200

AI-сотрудники.

JSON

{
  "data": [
    {
      "id": "cmu3f9z7k0002efgh",
      "name": "Алиса",
      "description": "Консультант интернет-магазина",
      "isActive": true,
      "channel": "widget",
      "createdAt": "2026-09-14T08:00:00.000Z"
    }
  ]
}

Ошибки

Статус	code	Когда
401	`unauthorized`	Нет ключа, ключ неверный или отозван.
429	`rate_limited`	Больше 120 запросов в минуту. Повторите через Retry-After секунд.

Дальше

Общие правила — ключи, лимиты, ошибки, страницы — в обзоре API. Узнавать о событиях сразу, без опроса, — через исходящие вебхуки.