API и MCP | Chatsy

Управляйте проектами, виджетами чата и ИИ-ботами из Cursor, Claude или своего сервиса. Ключ выпускается в кабинете, в разделе API / MCP.

REST API

Базовый адрес https://chatsy.ru/api/v1. В каждом запросе заголовок Authorization: Bearer csy_…. Ключ работает от имени аккаунта, который его создал. Права задаются при создании: чтение и запись проектов, виджетов и ИИ-ботов.

Кто я

GET /api/v1 — сервис, адрес MCP и права этого ключа.

curl -sS https://chatsy.ru/api/v1 \
  -H "Authorization: Bearer csy_ВАШ_КЛЮЧ"

Проекты

GET /api/v1/projects — список. POST — создать: name обязателен, description нет. PATCH /projects/:id меняет название и описание. DELETE удаляет проект вместе с виджетами и ботами. Группа Telegram из API не создаётся.

curl -sS https://chatsy.ru/api/v1/projects \
  -H "Authorization: Bearer csy_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"name":"Магазин","description":"Чат поддержки"}'

Виджеты

GET /api/v1/widgets и ?projectId=. POST создаёт виджет: projectId обязателен, name можно не передавать — подставится имя проекта. В ответе есть embed. PATCH /widgets/:id принимает name, description и settings (поверх текущих). DELETE удаляет виджет.

curl -sS https://chatsy.ru/api/v1/widgets \
  -H "Authorization: Bearer csy_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"ID_ПРОЕКТА"}'

ИИ-бот целиком

GET /api/v1/bots/:id возвращает все настройки: промпт, текст, файлы, вопросы-ответы, ссылки и цель. PATCH принимает те же поля. files, qaData и links заменяют списки целиком.

curl -sS -X PATCH https://chatsy.ru/api/v1/bots/ID \
  -H "Authorization: Bearer csy_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"globalPrompt":"Отвечай кратко","kbOnly":true}'

Файл инструкций

POST /api/v1/bots/:id/files с name и content создаёт файл или заменяет его, если имя совпало. DELETE /api/v1/bots/:id/files/имя-файла удаляет. Это текст, не бинарный PDF.

curl -sS https://chatsy.ru/api/v1/bots/ID/files \
  -H "Authorization: Bearer csy_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"name":"instructions.txt","content":"Цены и условия..."}'

Вопросы и ответы

POST /api/v1/bots/:id/qa добавляет блок. Тело: question или questions и answer. DELETE /api/v1/bots/:id/qa/ID удаляет один блок. Чтобы заменить все сразу, передайте qaData в PATCH.

curl -sS https://chatsy.ru/api/v1/bots/ID/qa \
  -H "Authorization: Bearer csy_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"question":"Сколько стоит?","answer":"От 990 ₽"}'

Переписки

Нужно право inbox:read. GET /api/v1/conversations?projectId= или ?widgetId=. GET /api/v1/conversations/:id — диалог и до 200 сообщений.

curl -sS 'https://chatsy.ru/api/v1/conversations?projectId=ID' \
  -H "Authorization: Bearer csy_ВАШ_КЛЮЧ"

Ошибки и права

401 — нет ключа или он отозван. 403 — у ключа нет нужного права, например projects:write. 404 — объект не ваш или его нет. Запись включает чтение той же сущности.