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

Подключения

Каналы и системы, из которых собираются AI-сотрудники, и подключены ли они у компании.

get/connectors— Каналы и системы

Ресурс `Connector`

Поле	Описание
`id`string	`channel:<id>`, `system:<id>` или `custom:<slug>` — своя система компании.
`kind`string	Канал (через него AI-сотрудник общается) или система (куда уходят заявки, записи, оплаты). · одно из: channel, system
`name`string	Название.
`connected`boolean	Подключено ли у компании.

Каналы и системы

get/api/v1/connectors

Весь каталог «Подключений» с отметкой, подключено ли у компании, и свои системы компании (custom:<slug>). Реквизиты и ключи не отдаются.

Право ключа: Подключённые системы · connectors:read

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

Ответ 200

Каналы и системы.

JSON

{
  "data": [
    {
      "id": "channel:telegram",
      "kind": "channel",
      "name": "Telegram",
      "connected": true
    },
    {
      "id": "system:amocrm",
      "kind": "system",
      "name": "amoCRM",
      "connected": false
    },
    {
      "id": "custom:warehouse",
      "kind": "system",
      "name": "Склад",
      "connected": true
    }
  ]
}

Ошибки

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

Дальше

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