Интеграция по API

Управляйте платформой из своей системы

Всё, что делается в кабинете, доступно по REST: собрать аудиторию, обновить сценарий, запустить кампанию, забрать статистику и переписку. Ключ выпускается в кабинете, права отмечаются по разделам — CRM, n8n или ваш бэкенд получают ровно то, что вы разрешили.

Выпустить ключ Какие права бывают

Доступ к API входит в аренду аккаунтов — отдельно платить за него не нужно.

Что доступно по API

Не отдельный урезанный интерфейс, а те же разделы платформы, что вы видите в кабинете. Интеграция по API нужна там, где кампании должны заводиться из вашей системы, а результат — возвращаться в неё же.

Аудитории

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

Сценарии

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

Кампании

Завести кампанию, связать её с аудиторией, сценарием и аккаунтами, запустить и остановить. Плюс статистика по дням, история прогонов и отчёт по каждому контакту.

Диалоги

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

Аккаунты

Состояние арендованных аккаунтов: что готово к работе, что готовится, что под ограничением. Удобно, когда объём планируется на вашей стороне.

Кошелёк

Баланс и история операций. Нужен, если вы следите за расходом из своей системы или перепродаёте объём клиентам.

Права отмечаете сами

У ключа нет режима «всё разрешено по умолчанию». Права выдаются по разделам и отдельно на чтение и на запись — интеграция получает ровно тот кусок, который ей нужен.

Ключей можно выпустить сколько угодно: отдельный для CRM, отдельный для сценария в n8n, отдельный для подрядчика. Любой отзывается в кабинете, и доступ пропадает сразу — остальные интеграции продолжают работать.

campaigns:read campaigns:write flows:read flows:write audience:read audience:write accounts:read accounts:actions wallet:read

Зачем это обычно нужно

Четыре связки, ради которых к API приходят чаще всего.

Лиды сразу в CRM

Как только в диалоге появилась нужная конверсия, ваш бэкенд забирает переписку и контакт и заводит сделку — без ручного переноса и без «забыли выгрузить».

Кампании из вашей системы

Новый список клиентов появился в базе — запускается кампания. Платформа здесь исполнитель, а решение принимает ваш процесс.

Сценарий из вашего репозитория

Тексты и ветки лежат у вас и доезжают до платформы автоматически. Правка делается один раз — в вашем репозитории.

Отчётность рядом с другими каналами

Статистика по дням и история прогонов уезжают в BI, где Telegram стоит в одном ряду с рекламой и почтой — и считается по тем же правилам.

Три способа управлять платформой

Выбирайте по тому, кто принимает решения: человек, ИИ-агент или ваш код.

Кабинет — всё то же самое руками, если интеграция вам не нужна.

MCP-сервер — подключаете платформу к Claude или ChatGPT и ставите задачи словами. Тот же ключ, те же права.

REST API — когда нужно встроить платформу в чужой процесс и решения принимает он, а не человек.

Права у всех трёх общие: что запрещено ключу, то не сделает ни агент, ни скрипт.

Как подключиться

Отдельной регистрации для разработчика не нужно — ключ выпускается в том же кабинете.

Выпустите ключ

Раздел API в кабинете. Один ключ на одну интеграцию — так его потом не страшно отозвать.

Отметьте права

Только те разделы, которые нужны этой интеграции, и только чтение, если запись ей ни к чему.

Передайте заголовком

Ключ едет в заголовке Authorization обычным Bearer-токеном. Никаких подписей запроса и обмена сертификатами.

Вызывайте методы

Из CRM, из n8n, из своего бэкенда — отовсюду, откуда можно отправить HTTP-запрос.

Выпустить ключ Методы работы с аккаунтом

Частые вопросы об API

Отдельной платы нет — API входит в аренду аккаунтов. Платите вы за то же, что и в кабинете: работу аккаунтов и обращения к ИИ.

Здесь вы управляете платформой: аудиториями, сценариями, кампаниями, отчётами. Userbot API — этажом ниже: он дёргает сам Telegram-аккаунт, чтобы собрать участников чата или написать конкретному человеку. Для второго нужно отдельное право accounts:actions.

Да, и так правильнее: свой ключ на CRM, свой на автоматизацию, свой на подрядчика. У каждого свой набор прав, и любой отзывается отдельно, не задевая остальные интеграции.

Запрос отклоняется, а не выполняется частично. Права проверяются на каждом методе, поэтому ключ «только на чтение» не сможет ничего изменить даже случайно.

Нет, ключ один и тот же — MCP-сервер ходит в платформу с ним же и подчиняется тем же правам. Разница только в том, кто вызывает методы: ваш код или ИИ-агент.

Платформа отвечает обычным REST, поэтому подходит стандартный HTTP-узел: ключ в заголовке, адрес метода, тело запроса. Отдельного плагина ставить не нужно.