Настройки AI-оператора канала#

Через этот endpoint можно получить и обновить настройки AI-оператора у конкретного канала: включить/выключить AI и выбрать ИИ-агента. На канале указывается один агент — он уже содержит контекст, набор товаров, базу знаний и API-интеграцию.

Токен должен иметь scope channel_ai_agent.

Базовый URL: https://api.apx.chat/api

Структура настроек#

{
  "status": true,
  "agentId": "uuid"
}

• status — включён ли AI-оператор для канала.
• agentId — идентификатор выбранного ИИ-агента. Передайте null, чтобы снять привязку агента.

Получение channelId#

js

Скопировать код

const url = "https://api.apx.chat/api/external/channels";

const response = await fetch(url, {
  method: "GET",
  headers: {
    "X-Api-Token": "tok_xxxxx",
  },
});

const data = await response.json();
console.log(data);

Подробно: /docs/channels

Получить настройки#

GET /api/external/channels/{channelId}/ai-operator

js

Скопировать код

const url = "https://api.apx.chat/api/external/channels/{channelId}/ai-operator";

const response = await fetch(url, {
  method: "GET",
  headers: {
    "X-Api-Token": "tok_xxxxx",
  },
});

const data = await response.json();
console.log(data);

Обновить настройки (частично)#

PATCH /api/external/channels/{channelId}/ai-operator

Передавайте только те поля, которые меняются. agentId валидируется на существование и принадлежность вашей организации.

js

Скопировать код

const url = "https://api.apx.chat/api/external/channels/{channelId}/ai-operator";

const payload = {
"status": true,
"agentId": "b0c6..."
};

const response = await fetch(url, {
  method: "PATCH",
  headers: {
    "X-Api-Token": "tok_xxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify(payload),
});

const data = await response.json();
console.log(data);

Что происходит после смены#

• Смена агента подхватывает его набор товаров и базу знаний — индексация связанных загрузок для канала перезапускается.
• Настройки кешируются: после PATCH кеш канала автоматически сбрасывается.
• Если status = false, AI-оператор не отвечает в виджете.

Коды ответов#

• 200 — успех
• 400 — невалидный JSON или agentId не принадлежит организации
• 401 — невалидный токен или недостаточный scope
• 404 — канал или агент не найден