С помощью API можно работать с проектом ChatPlace без интерфейса: из своих сервисов и скриптов или через ИИ-ассистентов вроде Claude и ChatGPT.

Какой инструмент нужен для вашей задачи

Задача	Что использовать
Управлять проектом из Claude или ChatGPT: собирать воронки, смотреть статистику, отвечать в чатах	API (MCP) через коннектор в ассистенте
Из своей программы читать данные ChatPlace или что-то в нём менять	API (MCP) с API-ключом
Отправлять данные из ChatPlace в CRM, таблицу или Make/Zapier, когда клиент проходит автоматизацию	Действие «Интеграция с API» в автоматизации
Подтянуть в диалог данные из внешней системы: цену, статус заказа, наличие	Действие «Интеграция с API» с сохранением ответа в переменные
Принимать оплату и проверять её в автоматизации	Встроенные платёжные интеграции
Запускать автоматизацию по сигналу из стороннего сервиса (входящий вебхук)	Не поддерживается

Что можно сделать

Через API доступна большая часть того, что вы делаете в интерфейсе ChatPlace: аккаунты, автоматизации, чаты, рассылки, ИИ-менеджер, Virale, теги, переменные, медиафайлы, продукты, ответы на комментарии и реферальные ссылки. Те же разделы вы выбираете в правах доступа при создании API-ключа.

Через ИИ-ассистента можно писать запросы обычным языком, например:

«Покажи, какие автоматизации принесли больше всего новых клиентов за неделю»
«Собери воронку: по кодовому слову ГАЙД проверь подписку и отправь ссылку на гайд»
«Найди чаты, где клиенты спрашивали про цену, и покажи последние сообщения»
«Добавь в базу знаний ИИ-менеджера ответ про сроки доставки»
«Подготовь рассылку для клиентов с тегом "оплатил" на завтра в 10:00»

Ассистент сам разобьёт задачу на запросы к API и покажет результат.

Из своих систем. Несколько примеров, как это используют:

Агентство с многими клиентами: разворачивать одну и ту же автоматизацию из шаблона на новых аккаунтах.
Своя CRM или дашборд: по расписанию забирать статистику автоматизаций и рассылок.
Внешняя база ответов: пополнять базу знаний ИИ-менеджера из своего FAQ или CRM.
Ответ из своей системы: найти чат клиента и отправить ему сообщение как оператор.

Полный список доступных действий возвращает сам API, подробнее в разделе «Подключение из своих сервисов».

Тарифы

API доступен на тарифах Pro, Creator и Premium.

Как получить API-ключ

Откройте Настройки → MCP (или Virale → MCP).
Нажмите «Создать API-ключ» и укажите название, например «Моя CRM».
Отметьте разделы, к которым нужен доступ, и тип доступа: чтение или запись. Важно: если не выбрать ни один раздел, то ключ создастся, но не будет иметь доступ ни к одному из разделов.
При необходимости задайте срок действия.
Скопируйте ключ. Он показывается только один раз.

Список созданных ключей находится ниже карточки коннектора на той же странице. Там ключ можно посмотреть или удалить.

Храните ключ так же надёжно, как пароль. С ним можно управлять вашим проектом в пределах выданных прав. Не публикуйте его и не отправляйте в переписке. Если ключ мог попасть к посторонним, удалите его и создайте новый.

Подключение к ИИ-ассистентам

На странице MCP есть пошаговые инструкции для Claude, ChatGPT, Claude Code и других ассистентов. В ChatGPT и Claude подключение идёт через OAuth: API-ключ вводится не в настройках ассистента, а на странице входа ChatPlace, которая откроется при подключении.

Возможности зависят и от самого ассистента. Например, в ChatGPT на тарифе Pro через MCP доступно только чтение, а создание автоматизаций доступно на тарифах Business, Enterprise и Edu.

Подключение из своих сервисов

API ChatPlace работает по протоколу MCP. Этот протокол чаще всего используют для подключения к ChatGPT, Claude и другим ассистентам, но он подходит и для обычной разработки внешних интеграций.

Все запросы отправляются на один адрес с ключом авторизации:

POST https://mcp.chatplace.io/mcp
Authorization: Bearer <ваш_API_ключ>
Content-Type: application/json

Все доступные действия в MCP называются tools. Tool — это отдельный метод, который можно вызвать с параметрами.

Посмотреть список доступных методов:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

В ответе будут все методы, доступные вашему ключу, с описанием параметров. Набор методов постепенно расширяется, поэтому ориентируйтесь на этот ответ, а не на сохранённый список.

Вызвать метод:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "automations_list",
    "arguments": {}
  }
}

Пример: отправить сообщение в чат

1. Узнайте ID чата. Получите список чатов:

{
  "jsonrpc": "2.0",
  "id": 10,
  "method": "tools/call",
  "params": {
    "name": "chats_list",
    "arguments": {}
  }
}

Из ответа возьмите ID нужного чата. Список возвращается постранично. Параметры для перехода на следующую страницу описаны в ответе tools/list.

2. Отправьте сообщение:

{
  "jsonrpc": "2.0",
  "id": 11,
  "method": "tools/call",
  "params": {
    "name": "chats_send_message",
    "arguments": {
      "chatId": "ID чата",
      "text": "Текст сообщения"
    }
  }
}

Важно:

Через API действуют те же правила платформ, что и в интерфейсе. Например, в Instagram написать клиенту можно только в течение 24 часов после его последнего сообщения.

Лимиты запросов

Тариф	Лимит
Pro	60 запросов в минуту на проект
Creator	90 запросов в минуту на проект
Premium	90 запросов в минуту на каждый аккаунт и 90 на общие запросы; общий потолок — 30 × число аккаунтов, но не меньше 300

Лимит общий для всех ключей и сотрудников проекта. При превышении запрос не выполняется и ничего не меняет, а сервер возвращает ошибку «Rate limit exceeded». Повторите запрос через минуту.

API-запросы не расходуют ИИ-лимит. Исключение — генерации: создание контента в Virale или сборка автоматизации с помощью ИИ списывают ИИ-баланс так же, как в интерфейсе.

Чего API не делает

Не принимает произвольные входящие вебхуки. Запустить автоматизацию запросом из стороннего сервиса нельзя. Уведомления об оплате от подключённых платёжных систем приходят через встроенные интеграции.
Не отправляет данные наружу сам при событиях, например при каждой новой заявке. Для этого используйте действие «Интеграция с API» в автоматизации.
Не подключает платёжные системы и CRM. Они настраиваются в разделе «Настройки → Интеграции».

Частые проблемы

В ChatGPT или Claude нет поля для API-ключа. Выберите аутентификацию OAuth. Ключ вводится на странице ChatPlace, которая откроется при подключении.
Ассистент читает данные, но не создаёт и не меняет. Проверьте права ключа: возможно, выдано только чтение. В ChatGPT на тарифе Pro запись через MCP недоступна.
Ошибка «Rate limit exceeded». Превышен лимит запросов в минуту. Подождите минуту или разбейте задачу на части.
Ошибка авторизации. Ключ удалён, истёк срок действия или скопирован не полностью. Создайте новый ключ.

API ChatPlace: как управлять проектом из своих сервисов и ИИ-ассистентов