@retensy/mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 1 of 5 tools tried
Contacts while installing and starting: nothing
Its tool definitions changed since version 0.62.0. If you approved the earlier ones, read them again.
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y @retensy/mcp@0.64.2
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
5 tools that take no input and look read-only were called once with nothing. 1 returned a result.
account_list | Returned a result under 0.1 s · 20 characters |
list_bots | No usable answer tool reported an error: ❌ Нет доступа к retensy /bots — не настроена авторизация. Как подключить (помоги пользователю по шагам): 1) Открой https://bots.retensy |
catalog_category_list | No usable answer tool reported an error: ❌ Нет доступа к retensy /bots — не настроена авторизация. Как подключить (помоги пользователю по шагам): 1) Открой https://bots.retensy |
list_integrations | No usable answer tool reported an error: ❌ Нет доступа к retensy /bots — не настроена авторизация. Как подключить (помоги пользователю по шагам): 1) Открой https://bots.retensy |
list_files | No usable answer tool reported an error: ❌ Нет доступа к retensy /bots — не настроена авторизация. Как подключить (помоги пользователю по шагам): 1) Открой https://bots.retensy |
During the calls it contacted nothing it had not already contacted.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
4 tools with commands in capitals or very long text
- Very long description in
site_edit:3000 characters or more
- Gives the agent orders in
kb_add_site:внутренняя сеть), schedule — расписание повторного обхода: NEVER|DAILY|WEEKLY|MONTHLY (по умолчанию NEVER). Обход уходит в фон; документ появится в kb_docs со стату
- Very long description in
broadcast_send:3000 characters or more
- Very long description in
chain_create:3000 characters or more
Common and usually harmless: it is how many makers stress how a tool should be used.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
setup
Показать статус авторизации и пошаговую инструкцию подключения. Вызывай первым, если пользователь не знает, что делать, или при ошибке доступа. Токен (zmcp_...) определяет АККАУНТ, а не один проект: доступ к каждому боту/сайту — это твоя текущая роль в нём (владелец или приглашённый соредактор), и она проверяется заново при каждом вызове.
set_token token
Сохранить персональный токен (zmcp_...), который пользователь создал на /bots/mcp-tokens. Применяется сразу, без рестарта. Токен определяет аккаунт целиком, не один проект — список доступных проектов (свои + те, куда пригласили) виден в list_bots/site_list. Если владелец проекта уберёт тебя из соредакторов, доступ к этому проекту исчезнет сразу же, без повторной настройки токена.
account_add name, token
Подключить дополнительный аккаунт Retensy: сохранить его токен (zmcp_...) под именем. Токен проверяется, неверный не сохраняется; тем же именем токен заменяется. Аккаунт по умолчанию не меняется. Дальше передавай retensyAccount:<имя> в нужные инструменты.
account_list
Подключённые аккаунты: имя и число доступных ботов (или ошибка токена). Токены не показываются.
account_remove name
Убрать подключённый аккаунт из этого MCP (локально; сам токен на сервере не отзывается).
195 more tools
list_bots retensyAccount
Список ботов (id, имя, статус). Включает и свои боты, и боты, в которые тебя пригласили соредактором — у каждого есть accessRole (OWNER/ADMIN/EDITOR/VIEWER); у чужих (не OWNER) есть ownerName — имя владельца проекта. Конфликт токена (тот же Telegram-токен подключён ещё в BotHelp/Salebot/своём скрипте, 10+ минут): pausedReason=TOKEN_CONFLICT (+ pausedAt, pausedConflictHost) — другой сервис держит вебхук, бот active=false (ничего не удалено); pausedChannels[] — у работающего мультиканального бота выключены только эти каналы; conflictWarning=TOKEN_CONFLICT_POLLING (+ conflictWarningUsername) — токен опрашивает кто-то ещё, бот НЕ остановлен, но теряет часть сообщений (снимается само). Чинится вне Retensy (отключить бота там или /revoke в @BotFather + bot_change_token), затем bot_resume для паузы. Доступ = твоя текущая роль в проекте, проверяется на каждый вызов; владелец мог отозвать её без предупреждения.
list_graphs botId, retensyAccount
Список сценариев САМОГО бота (без узлов). Вебхук-сценарии, которые лишь отвечают через этого бота, сюда не входят — их публикуют в вебе, в «Сценариях» автора.
list_channels botId, retensyAccount
Список каналов/групп, подключённых к боту (chatId, title, type, статус бота, дата). chatId — числовой id для условия SUBSCRIBED («Подписан на канал»).
catalog_item_upsert id, sku, name, description, price, stock, active, images, categoryIds, categoryNames, confirm, retensyAccount
Создать или обновить товар магазина (POST /api/bots/commerce/items/upsert): по id, иначе по артикулу sku. Для нового товара обязательны name и price (в рублях). images — до 10 https-ссылок на фото (первое — главное). categoryIds — id категорий из catalog_category_list; categoryNames — названия категорий: найдутся по имени или создадутся. stock — остаток (-1 — не учитывать), active — показывать в витрине. Меняет витрину: только по явной просьбе, с confirm:true.
catalog_category_list retensyAccount
Категории магазина владельца (GET /api/bots/commerce/categories): id, name, parentId. Только чтение.
catalog_category_upsert id, name, parentId, confirm, retensyAccount
Создать или переименовать категорию магазина: с id — обновить (PUT /api/bots/commerce/categories/{id}), без id — создать (POST /api/bots/commerce/categories). parentId — id родительской категории; без него категория верхнего уровня. При обновлении без parentId текущий родитель сохраняется. Меняет витрину: только по явной просьбе, с confirm:true.integration_catalog retensyAccount
Каталог сервисов Integration Core (GET /api/integrations/catalog): [{provider, name, category, authType, configSchema: [{key, label, hint, secret}] — поля подключения, actions: [{kind, label, inputs}] — действия для сценария и coreDelivery, healthCheck — умеет ли integration_test, inbound: {events: [{key, label, vars: [{key, label, example}], paymentSucceeded}]} | null — провайдер умеет только исходящие действия}]. inbound.events — события для узла TRIGGER_WEBHOOK с заполненным config.provider (см. integration_ingress_url): events[].key идёт в config.event, vars[].key — переменные {{body.<key>}} в сценарии. paymentSucceeded:true — событие сверх обычного вебхука ещё и заводит узел «Оплата прошла» (headless или в чате подписчика, если платёжная ссылка была привязана к нему действием *_link). 404 — Integration Core выключен в сервисе. Read-only.integration_status connectionId, retensyAccount
Статус подключения (GET /api/integrations/{id}/status): {status: UNKNOWN | OK | NEEDS_REAUTH (ключ отозван/устарел — обнови через connect_integration) | ERROR, lastCheckedAt, lastError, supported}. Только своё подключение (чужое — 403). Read-only, внешний сервис не вызывает.integration_test connectionId, retensyAccount
Проверить подключение (POST /api/integrations/{id}/test): выполняет ЖИВУЮ проверку ключа во внешнем сервисе от имени владельца (без побочных эффектов — ничего не создаёт) и обновляет статус. Ответ как у integration_status; supported:false — сервис проверку не умеет. Только своё подключение (чужое — 403); 404 — Integration Core выключен.channel_post botId, chatId, text, mediaUrl, retensyAccount
Разовый пост от имени бота в канал/группу Telegram или MAX (раздел «Публикации», POST /api/bots/{botId}/linked-chats/{chatId}/post). Бот должен быть администратором канала (list_channels). text и/или mediaUrl — файл из upload_file (тип фото/видео/документ берётся из файла; чужие ссылки не принимаются). Лимиты: Telegram — 4096 символов текста, 1024 подписи к файлу; MAX — 4000. Ответ {ok, messageId?}. Публикует сразу — подтверди текст с пользователем.list_integrations retensyAccount
Список подключённых сервисов пользователя (GET /api/bots/integrations): {id, provider, title, hint, createdAt}. **id отсюда — это `connectionId`**, обязательное поле действий amocrm_send/amocrm_update/bitrix24_call/getcourse_send/getcourse_order/yametrika_event. Без него действие упадёт «не выбрано подключение». Креды не отдаются — только маскированный hint. Подключить новый — connect_integration. Read-only.get_graph graphId, summary, saveToFile, retensyAccount
Получить граф по graphId. Для БОЛЬШИХ графов (десятки узлов JSON может превысить лимит токенов) используй summary:true (компактная сводка: id/type/title/позиции + рёбра) или saveToFile (записать полный граф на диск и вернуть сводку+путь — потом правь файл и заливай через update_graph/edit_graph_live с graphFile).
create_graph botId, name, retensyAccount
Создать пустой граф (DRAFT) в боте. Возвращает граф с id.
update_graph graphId, graphFile, graph, nodes, edges, canvasMeta, name, retensyAccount
Залить узлы/рёбра в граф (PUT, сырой replace без бэкапа). Для правок СУЩЕСТВУЮЩЕГО/живого сценария используй edit_graph_live. Активный (PUBLISHED) граф сервер проверяет как публикацию: при ошибках HTTP 422 со всеми code@nodeId, граф НЕ сохранён. Черновик сохраняется без проверок публикации, кроме размера: граф больше 4 МБ → HTTP 422 GRAPH_TOO_LARGE, не сохранён. Принимает graphFile (путь к локальному файлу — НЕ нужно слать граф инлайном, удобно для больших графов), graph-контейнер или nodes/edges.
edit_graph_live graphId, graph, nodes, edges, canvasMeta, name, graphFile, backup, retensyAccount
РЕКОМЕНДОВАННЫЙ способ правки СУЩЕСТВУЮЩЕГО (часто живого/опубликованного) сценария: редактирует ТОТ ЖЕ graphId НА МЕСТЕ (id не меняется) и сначала снимает авто-бэкап текущего состояния в один rolling-граф «🔙 Авто-бэкап». НЕ клонирует и НЕ создаёт новый активный граф. Открытые редакторы перечитают граф вживую (external_update), бот применит изменения сразу (читает активный граф заново из БД). Используй ВМЕСТО clone+publish, когда нужно поправить сценарий, который уже открыт/в проде. ВАЖНО: правку активного графа сервер проверяет как публикацию (валидатор, платные блоки, лимит блоков тарифа, платформа) — при ошибках HTTP 422 со всеми code@nodeId, граф НЕ изменён, бот работает на прежней версии. Прогоняй offline validate.mjs и dry_run заранее, чтобы не ловить 422. Живой граф бота — с isActive:true в list_graphs — для бот-сценария (после publish_graph черновика — publishedGraphId, не id черновика); правка черновика до бота не доходит.
patch_graph graphId, replacements, preview, backup, retensyAccount
Точечная правка БОЛЬШОГО/живого графа без отправки графа целиком: сервер сам берёт граф по graphId, делает строковые замены в его JSON, проверяет валидность и заливает обратно НА МЕСТЕ (с авто-бэкапом). Идеально, когда граф слишком велик, чтобы передавать его целиком через update_graph/edit_graph_live — напр. сменить id канала в условиях SUBSCRIBED, ссылки кнопок, тексты. replacements: [{find, replace}] — заменяются ВСЕ вхождения; делай find максимально специфичным, чтобы не задеть лишнее. preview=true — только показать число совпадений, ничего не сохраняя. Бот применит изменения сразу только у опубликованного графа (читает активный граф заново из БД); патч черновика до бота не доходит. Результат для активного графа сервер проверяет как публикацию: ошибки → HTTP 422 со всеми code@nodeId, граф не изменён.dry_run graphId, kind, value, fromUsername, presetVariables, presetTags, retensyAccount
Прогнать сценарий без публикации. kind: command|callback|text. Внешние действия (HTTP, CRM, таблицы, письма, ИИ) пропускаются (skipped: dry-run). Статус прогона: OK, FAILED (прерван) или PARTIAL — «завершён с ошибками»: дошёл до конца, но хотя бы одно действие упало (у шага ok:false, error «КОД: …»).
publish_graph graphId, secondary, confirmToken, retensyAccount
Опубликовать граф. У бота ОДИН активный сценарий: публикация черновика заменяет содержимое активного (id живого графа сохраняется); прежняя активная версия, которой нет ни в одном черновике бота (правки вживую), сохраняется черновиком «… (была активной до дата время)». Вернёт publishedGraphId; при отказе проверок — ошибка HTTP 422 со всеми причинами построчно (code@nodeId: message). Сценарий-вебхук (источник WEBHOOK) этим инструментом не публикуется — HTTP 409, его публикуют в вебе. secondary:true — «опубликовать как ДОПОЛНИТЕЛЬНЫЙ сценарий»: граф становится живым НА МЕСТЕ (publishedGraphId = graphId, снимка нет) рядом с основным, основной сценарий и activeGraphId НЕ меняются; его запускают только VK-лендинги (targetGraphId) и ссылки link_create с targetGraphId. Те же проверки (422), у бота должен быть основной (SECONDARY_NO_MAIN), основной сам дополнительным не делается (SECONDARY_IS_MAIN); триггеры расписания/заявки с сайта/событий канала/комментариев/Instagram/вебхука — 422 SECONDARY_TRIGGER_UNSUPPORTED; режим decoupled — SECONDARY_UNSUPPORTED. У клона основного совпавшие id узлов при первой такой публикации меняются — перечитай граф. Снять — unpublish_graph.
graph_versions_list graphId, version, compareTo, retensyAccount
История версий сценария (GET /api/bots/graphs/{graphId}/versions): снимки узлов/рёбер, новые первыми — number, reason (PUBLISH публикация | MANUAL сохранено вручную | AUTO снимок состояния ДО правки живого сценария, не чаще раза в 10 мин | ROLLBACK откат), authorName, createdAt, note, restoredFrom, nodeCount, edgeCount, sizeBytes. Версии ведёт ОПУБЛИКОВАННЫЙ (живой) граф — для бот-сценария это publishedGraphId / граф с isActive:true из list_graphs, у черновика история пуста. Хранится последние 50 версий + все публикации и откаты за 90 дней. С version:N вернёт сравнение версии N с текущим графом (compareTo:'current', по умолчанию) или с другой версией (compareTo: номер): сколько узлов added/removed/changed, изменились ли рёбра, и список затронутых узлов — полный снимок не отдаётся, его смотрят в редакторе («История» → «Просмотр»). Нужно право read.graph_version_rollback graphId, version, retensyAccount
Откатить сценарий на версию (POST /api/bots/graphs/{graphId}/versions/{version}/rollback). Откат = публикация снимка: у ЖИВОГО графа бот переходит на ту версию сразу, и она проходит те же проверки, что edit_graph_live (валидатор, платные блоки, лимит блоков, платформа) — при ошибках HTTP 422 со всеми code@nodeId, граф НЕ изменён. Состояние ДО отката сервер сам сохраняет отдельной версией (savedCurrentAs), результат — версией reason ROLLBACK (newVersion), так что откат обратим тем же инструментом. Узлы получают ТЕ ЖЕ id, что были в снимке. Это действие на живом боте: перед вызовом покажи пользователю graph_versions_list (version:N — что изменится) и получи согласие. Нужно право write:bots.unpublish_graph graphId, retensyAccount
Снять ДОПОЛНИТЕЛЬНЫЙ сценарий с публикации (POST /api/bots/graphs/{graphId}/unpublish): он снова черновик, лендинги и ссылки на него ведут в основной сценарий, подписчики в нём возвращаются в основной, его задержки отменяются. Основной сценарий так не снимается — HTTP 409.import_funnel botId, name, graph, graphFile, dryRun, publish, retensyAccount
Всё за раз: создать граф, залить узлы/рёбра, (опц.) dry-run /start, опубликовать. Граф можно передать инлайном (graph) или файлом (graphFile).
list_templates niche, channel, query, retensyAccount
Список готовых шаблонов воронок (id, имя, описание, ниша, каналы, nameEn/descriptionEn, hasAi). Около 30 шаблонов под русские ниши (запись в салон и клинику, квалификация в недвижимости, лид-магнит школы, заказ в магазине, бронь в ресторане, сбор отзывов и др.) плюс универсальные. Можно сузить: niche (beauty, medical, realty, education, ecommerce, fitness, restaurant, auto, legal, reviews, universal), channel (TELEGRAM, MAX, VK), query (подстрока в названии и описании). Те же шаблоны открыты публично на /templates.
create_graph_from_template botId, templateId, name, retensyAccount
Создать граф (DRAFT) из шаблона (см. list_templates). Возвращает граф с id — дальше правь через update_graph.
rename_graph graphId, name, retensyAccount
Переименовать сценарий (работает и для опубликованных — имя не влияет на исполнение).
clone_graph graphId, retensyAccount
Склонировать граф в новый DRAFT «… (copy)» — безопасно итерировать поверх опубликованного. Клон сценария-вебхука получает собственный путь и секрет вебхука.
copy_graph graphId, targetBotId, preview, retensyAccount
Скопировать граф в ДРУГОГО бота (в т.ч. на другую платформу). Возвращает {graphId, sourcePlatform, targetPlatform, notes[]}. notes[] помечают, что адаптировано (severity=TRANSFORM, напр. вопрос-контакт → ввод телефона текстом), что требует ручной правки (MANUAL, напр. условие SUBSCRIBED в MAX) и особенности платформы (INFO). Авто-адаптация узлов реализована для Telegram⇄MAX; при копировании в/из Instagram-бота граф копируется без трансформаций — несовместимые узлы будут отмечены при публикации (IG-allowlist). preview=true — только проверка совместимости, без копирования. Тот же бот запрещён (для дублирования есть clone_graph). Копия сценария-вебхука становится обычным сценарием бота-получателя (вход по вебхуку не переносится).delete_graph graphId, confirmToken, retensyAccount
Удалить граф (DELETE /api/bots/graphs/{id}) — тот же эндпоинт удаляет и вебхук-сценарий (scenarioId из scenario_list/scenario_create — это id того же графа). Активный (опубликованный и назначенный боту) удалить нельзя — будет 409; сначала переключи активный через set_active_graph. Необратимо.set_active_graph botId, graphId, retensyAccount
Назначить, какой опубликованный граф активен у бота (переключение живого сценария без перепубликации). HTTP 409 — граф не опубликован или это сценарий-вебхук (источник WEBHOOK — такой включается своей публикацией в вебе).
upload_file path, url, filename, retensyAccount
Загрузить файл в библиотеку /bots/files (POST /api/bots/media) и получить публичный URL для вставки в сценарий. Передай path (локальный файл) ИЛИ url (перезалить файл по ссылке в своё хранилище). Возвращает {id, url, mediaType, sizeBytes, originalName}. Полученный url ставь в медиа-карточку SEND_MESSAGE (image/video/audio/file/voice/videonote → поле url; gallery → urls[]) или в SEND_PHOTO.photoUrl. Лимит 50 МБ; типы: image/video/audio/pdf/zip/doc(x)/xlsx/pptx/txt (SVG запрещён); при нехватке места — HTTP 402.list_files retensyAccount
Список файлов в библиотеке /bots/files (GET /api/bots/media) + использовано/лимит байт. Бери готовые url отсюда, чтобы не загружать одно и то же повторно.
delete_file id, retensyAccount
Удалить файл из библиотеки /bots/files по id (DELETE /api/bots/media/{id}). Освобождает место в хранилище тарифа.graph_analytics graphId, retensyAccount
Аналитика прохождения сценария по узлам (GET /api/bots/graphs/{graphId}/analytics): сколько пользователей дошло до каждого узла — видно, где отваливается воронка. Read-only.list_bot_users botId, page, size, query, retensyAccount
Пользователи (подписчики/лиды) бота, постранично (GET /api/bots/{botId}/users). Опц. page (с 0), size (по умолч. 25), query (поиск по имени/username/id). Read-only.list_links botId, retensyAccount
Стартовые (трекинговые) ссылки бота с UTM (GET /api/bots/{botId}/links): code, метки, число стартов. Это точки входа в воронку. Read-only.site_list retensyAccount
Сайты (раздел «Страницы», GET /api/bots/pages): id, title, mode (BLOCKS — сайт из блоков, CODE — файлы/Mini App), url (основной адрес), publishedRevision, status (ACTIVE | BLOCKED — заблокирован модерацией: посетители видят HTTP 451, удалить такой сайт нельзя — 409) и blockedReason. Включает и свои сайты, и сайты команды проекта (привязанные к боту, где тебя пригласили) — у каждого accessRole (OWNER/ADMIN/EDITOR/VIEWER), у чужих — ownerName. Доступ проверяется на каждый вызов. Read-only.
site_create title, slug, template, retensyAccount
Создать сайт из блоков (POST /api/bots/pages, mode=BLOCKS). Возвращает id. Дальше: site_edit (init=starter — стартовый лендинг, init=blank — пустая главная, init=mini-landing — мини-лендинг с кнопками мессенджеров, init=shop-starter — многостраничный магазин: главная, каталог, о нас, доставка, контакты, политика конфиденциальности, оферта, корзина; общие шапка и подвал) → site_publish. template (starter|blank|mini-landing|shop-starter) — сразу создать черновик из шаблона (как «Мини-лендинг» в редакторе), в ответе revision. slug — «название» в адресе pages.retensy.com/<id>/<slug>/ (необязательно, по умолчанию транслит title). Число сайтов ограничено тарифом (free — 1, «Старт» — 3, «Про» — 10, с «Бизнеса» — без лимита): сверх лимита — HTTP 402 с причиной и upgradeUrl (смена тарифа только в браузере, передай ссылку пользователю). Заблокированный модерацией сайт в site_list имеет status=BLOCKED и blockedReason, посетители видят HTTP 451.
site_get siteId, saveToFile, retensyAccount
Модель сайта из блоков (GET /api/bots/pages/{siteId}/document): revision, draft (SiteModel: theme, globals.header/footer, pages[].blocks[], popups[]) — id страниц/блоков/попапов нужны для site_edit. draft=null — сайт пуст (первый site_edit создаст его). saveToFile — записать модель на диск и вернуть путь.site_schema full, retensyAccount
Компактный справочник модели сайта и операций правки (ops) — какие блоки и поля бывают (GET /api/bots/pages/schema, ~10 КБ). Читай перед первой правкой. full:true — полная JSON Schema (GET ?full=true), большая.
site_edit siteId, ops, revision, init, reset, confirmToken, retensyAccount
Правка сайта операциями — всё или ничего (POST /api/bots/pages/{siteId}/document/ops). Страницы: add_page{title} · update_page{pageId,patch: {title?, path?, seo?{title,description,noindex,ogTitle,ogDescription,ogImage}, showHeader?, showFooter?, folder?}} · remove_page{pageId} · move_page{pageId,delta}. Папки страниц: add_folder{name} (id в results) · rename_folder{folderId,name} · remove_folder{folderId}; страница в папку — update_page{pageId, patch:{folder: folderId}}. Дизайны (отдельные экраны-макеты из Zero-кадров): add_design{name} (id в results) · update_design{designId,name} · remove_design{designId} · add_design_frame{designId,name,w,h} → в results blockId Zero-кадра, дальше с ним работают операции Zero-элементов. Шаблоны: add_template{container, templateId, after?} — вставить шаблон из библиотеки (site_templates). Блоки: add_block{container: id страницы|попапа, type, after?, variant?, props?, style?} · update_block{blockId, props?, style?, variant?} · move_block{blockId,delta} · duplicate_block{blockId} · remove_block{blockId}. Код блока: get_block_code{blockId} (results[i].code: Zero — разметка <zero>…</zero>, остальные — JSON) · set_block_code{blockId,code} · add_block_code{container,code,after?}. Zero-блок (type zero, свободная вёрстка как в Tilda): add_element{blockId, kind: text|image|button|shape|video|html|group|form|product-list|product, frame?{d:{x,y,w,h,container?,axisX?,axisY?}, t?, m?}, props?, style?, hover?, anim?, link?, parent?, name?, fixed?} · update_element{blockId,elementId, …те же поля, hidden?, locked?, link:null — убрать} · remove_element · move_element{delta: +1 — слой выше} · group_elements{blockId,elementIds[],name?} · ungroup_element. Zero-kinds form/product-list/product: form — props.form как у блока form (fields, submitText); product-list — props: categoryId?, limit, columns (значения по экранам {d, t?, m?}); product — productId обязателен (товар из каталога). Новые Zero-блоки создаются с артбордами 1440/768/390 (d/t/m). Сайт: set_global{slot: header|footer, on} · set_theme{theme} · set_settings{settings} · add_popup{name} · update_popup{popupId,name?,width?} · remove_popup{popupId}. props/style/theme/frame — JSON Merge Patch (null удаляет ключ, массивы заменяются целиком). Типы блоков: header, cover, text, image, gallery, buttons, features, form, video, html, spacer, footer, zero, messengers. Значения по экранам: {d, t?, m?} (десктоп/планшет/телефон). revision — защита от перезаписи (409, если сайт изменили); init (starter|blank|mini-landing|shop-starter) — с чего начать пустой сайт (на сайте с черновиком игнорируется); shop-starter — многостраничный магазин (главная, каталог, о нас, доставка, контакты, политика, оферта, корзина; общие шапка и подвал); только init без ops — создать черновик из шаблона. reset:true (с init и revision) — пересобрать существующий черновик из шаблона init, ДЕСТРУКТИВНО (текущий черновик заменяется). Ответ: новая revision и results[] с id созданного (и code у get_block_code). Ошибsite_publish siteId, confirmToken, retensyAccount
Опубликовать черновик сайта (POST /api/bots/pages/{siteId}/publish): рендер в статику, адрес начинает отдавать новую версию. Ошибки проверки — HTTP 422 с путями. Возвращает publishedRevision и url.site_upload_asset siteId, path, url, retensyAccount
Загрузить картинку/видео в сайт (POST /api/bots/pages/{siteId}/upload, папка assets). Передай path (локальный файл) ИЛИ url. Возвращает asset — строку вида assets/<имя> для полей image/logo/icon/style.bg.image.site_rollback siteId, revision, confirmToken, retensyAccount
Вернуть прошлую публикацию сайта (POST /api/bots/pages/{siteId}/publish/rollback): revision — номер из истории публикаций (site_get → versions[]). Черновик заменяется этой версией и сразу публикуется. Возвращает publishedRevision и url.site_domains siteId, action, host, withWww, domainId, retensyAccount
Свои домены сайта (/api/bots/pages/{siteId}/domains). action: list — домены, статусы и dnsTarget (IP для A-записи); add {host, withWww?} — привязать (withWww у корневого домена добавляет www-пару); check {domainId} — перепроверить DNS и сертификат; remove {domainId} — отвязать. Число доменов ограничено тарифом (HTTP 402 с upgradeUrl). Каждое действие возвращает актуальный список.site_lead_settings siteId, settings, retensyAccount
Куда доставлять заявки из форм сайта (/api/bots/pages/{siteId}/lead-settings). Без settings — прочитать: {settings, scenarios (вебхук-сценарии), amoConnections, coreConnections: [{id, name, provider}] — подключения для доставки «Интеграция», без кредов}. С settings — сохранить ЦЕЛИКОМ (сначала прочитай и поменяй нужное): {notifyBot: в бот уведомлений из профиля, notifyEmail: письмо на почту аккаунта, webhookUrl?: POST JSON на ваш адрес, scenarioId?: вебхук-сценарий, который запускает заявка, amoConnectionId?: сделка в amoCRM, coreDelivery?: {connectionId: id из coreConnections, kind: действие сервиса из integration_catalog (actions[].kind, например amocrm_send), params?: {поле действия: шаблон}} | null}. Пустые params заполнятся из заявки (имя, телефон, почта, текст); в шаблонах — {{var.name}}, {{var.phone}}, {{var.email}}, {{var.<имя поля>}}, {{var.lead_text}} (текст заявки). Чужое подключение или неизвестный kind — 400. Запуск сценариев по заявке — триггер TRIGGER_SITE_FORM (скилл build-bot-funnel).site_leads siteId, page, size, status, retensyAccount
Заявки из форм сайта (GET /api/bots/pages/{siteId}/leads): поля, UTM, статус доставки и обработки. page (с 0), size (до 100), status — фильтр NEW|IN_PROGRESS|DONE|REJECTED. Read-only.article_list retensyAccount
Список СВОИХ статей блога retensy (GET /api/articles/my): id, slug, title, viewCount, даты. id нужен для article_update, slug — публичный адрес /articles/{slug}. Read-only.article_get slug, retensyAccount
Получить статью блога по slug (GET /api/articles/by-slug/{slug}) — публичное чтение, в т.ч. чужие. Возвращает title, content (Markdown), excerpt, coverImage, viewCount.article_publish title, content, cover, excerpt, retensyAccount
Опубликовать НОВУЮ статью блога retensy (POST /api/articles). content — Markdown (как README на GitHub: заголовки, списки, таблицы, код, картинки по URL). title необязателен: если не передать, заголовком станет первая строка вида «# Заголовок», и она убирается из текста. Обложку можно задать явно через cover (URL картинки) — иначе берётся первая картинка из текста; excerpt (SEO-описание) тоже можно задать явно, иначе генерируется из текста. Возвращает статью с id и slug + публичный URL.
article_update id, title, content, retensyAccount
Обновить СВОЮ статью по id (PUT /api/articles/{id}; id бери из article_list). content — Markdown; title необязателен (как в article_publish, иначе берётся из «# ...»). Только владелец — чужую вернёт 403.agent_list retensyAccount
Список ИИ-агентов пользователя (GET /api/bots/agents): карточки — id, имя, статус. Read-only.
agent_get agentId, retensyAccount
ИИ-агент по id (GET /api/bots/agents/{agentId}): настройки (имя, язык, тон, длина/формат ответа, инструкции, запретные/передаточные темы, kbId базы знаний, статус). Чужой агент — 404. Read-only.agent_create name, description, retensyAccount
Создать ИИ-агента (POST /api/bots/agents): name, description — необязательны. Вместе с агентом создаётся его база знаний (kbId в ответе) — дальше kb_add_qa/kb_add_text/kb_add_site.
agent_update agentId, patch, confirmToken, retensyAccount
Изменить настройки агента (PATCH /api/bots/agents/{agentId}): patch — объект с полями для правки (name, description, language: RU|EN|AUTO, tone: FRIENDLY|NEUTRAL|FORMAL, answerLength: SHORT|MEDIUM|LONG, format: PLAIN|LIST_FRIENDLY, instructions, forbiddenTopics[], handoffTopics[], fallback, citeSources: boolean, guardrail: boolean, tools[]). guardrail:true — перед отправкой ответ проверяется: цена, процент или обещание (гарантия, возврат, бесплатно), которых нет в базе знаний и данных инструментов, клиенту не уходят — ход идёт по «не знаю» (фолбэк агента, в том числе передача оператору); причина видна в agent_unanswered/логе хода. Применяется частично — передавай только то, что меняешь. tools[] заменяет список целиком (до 10). Инструменты ЧТЕНИЯ: AMO_LOOKUP {amoConnectionId}, SHEETS_LOOKUP {sheetsEmail,sheetsSpreadsheetId,sheetsLookupColumn,…}, HTTP_API {httpUrlTemplate,httpParams}. Инструменты ЗАПИСИ (включаются явно по одному, id a-z0-9_): AMO_CREATE_LEAD {amoConnectionId, amoLeadName, amoContactName?, amoPhone?, amoEmail?, amoPrice?, amoPipelineId?, amoStatusId?}, AMO_UPDATE_LEAD {amoLeadId + что обновлять}, AMO_UPDATE_CONTACT {amoContactId, amoContactName?|amoPhone?|amoEmail?}, SHEETS_APPEND {sheetsEmail,sheetsSpreadsheetId,sheetsSheetName?, sheetsRowTemplate:[ячейки]}, HTTP_POST {httpUrlTemplate, httpBodyTemplate? (JSON-шаблон), httpHeaders?:[{name,value}], httpJsonPath?}, SET_FIELD {allowedFields[]}, ADD_TAG {allowedTags[]}, HANDOFF. Для записи (кроме SET_FIELD/ADD_TAG/HANDOFF) обязательна argsSchema — плоская JSON-схема {properties:{имя:{type:string|number|integer|boolean, description?, enum?, pattern?, maxLength?, minLength?, minimum?, maximum?}}, required?:[]}; в шаблонах {имя} подставляет аргумент, {now} — время. Общие поля записи: confirmBeforeRun (по умолчанию true для внешних записей — агент сначала спрашивает согласие пользователя), limitPerConversation (по умолч. 3, макс 20), limitPerDay (по умолч. 100, макс 1000). В публичном веб-чате инструменты записи не работают. Перед отправкой tools[] проверяются локально, ошибки схем возвращаются списком.agent_publish agentId, confirmToken, retensyAccount
Опубликовать агента (POST /api/bots/agents/{agentId}/publish): агент начинает отвечать в подключённых сценариях. HTTP 409 CHECKLIST_FAILED с чеклистом, если агент ещё не готов (нет базы знаний, пустые инструкции и т.п.) — агент не меняется.agent_health agentId, retensyAccount
Здоровье базы знаний агента (GET /api/bots/agents/{agentId}/health): счётчики документов/фрагментов по запросу, без кэша. Read-only.agent_test_chat agentId, question, history, retensyAccount
Проверить ответ агента в песочнице без отправки клиенту (POST /api/bots/agents/{agentId}/test-chat): question (1–1000 символов), history — необязательная история диалога [{role: client|agent, text}], до 12 реплик. ТРАТИТ бюджет ИИ, как настоящий ответ — не вызывай массово.kb_docs kbId, retensyAccount
Документы базы знаний агента (GET /api/bots/kb/{kbId}/docs): источник (FILE/QA/SITE), статус индексации, число фрагментов. Только верхний уровень — у сайта страницы видны счётчиком. Read-only.kb_add_qa kbId, pairs, retensyAccount
Добавить пары вопрос-ответ в базу знаний (POST /api/bots/kb/{kbId}/docs/qa): pairs — [{question, answer}], до 200 пар за раз (вопрос ≤500 символов, ответ ≤4000). Каждая пара — отдельный фрагмент для поиска.kb_add_text kbId, title, text, retensyAccount
Добавить источник «Текст/инструкция» в базу знаний (POST /api/bots/kb/{kbId}/docs/text): title (≤120 символов), text (≤100 000 символов). Индексация уходит в фон — документ появится в kb_docs со статусом PENDING → READY. Агент видит найденные фрагменты (~800 знаков; текст до 2500 знаков хранится одним куском), а не документ целиком; чтобы выдавать текст дословно, используй узел сценария RANDOM_TEXT.kb_add_site kbId, url, schedule, confirmToken, retensyAccount
Добавить сайт в базу знаний обходом страниц (POST /api/bots/kb/{kbId}/docs/site): url (http/https, не внутренняя сеть), schedule — расписание повторного обхода: NEVER|DAILY|WEEKLY|MONTHLY (по умолчанию NEVER). Обход уходит в фон; документ появится в kb_docs со статусом PENDING.kb_reindex kbId, docId, headerRow, retensyAccount
Переиндексировать документ-файл базы знаний из сохранённого оригинала (POST /api/bots/kb/{kbId}/docs/{docId}/reindex) — «Повторить» после ошибки. headerRow — необязательно, для табличных файлов: номер строки с шапкой (1..50), если автоопределение ошиблось. Только для источника FILE.analytics_ask question, retensyAccount
Вопрос к аналитике обычным русским языком (POST /api/bots/analytics/ask): question ≤ 300 символов, например «сколько новых подписчиков за неделю» или «выручка по источникам за месяц». Бэкенд сам переводит вопрос в вызов белого списка готовых запросов (метрика/бот/период/источник/группировка) только по данным владельца; произвольных запросов к базе нет. Ответ: ok, answer (число), table, method («как посчитано»), plan; ok:false + message, если вопрос не про статистику. Тратит квоту ИИ (ASSIST), лимит 20 вопросов за 10 минут (429).
faq_suggestions agentId, action, suggestionId, question, answer, retensyAccount
Авто-FAQ агента (/api/bots/agents/{agentId}/faq): action — list (ожидающие предложения: question, answer-черновик из базы знаний, count, samples), generate (найти частые вопросы за 30 дней; тратит квоту ИИ), approve (suggestionId, опц. question/answer с правками; добавляет пару в базу знаний как QA, ответ обязателен), dismiss (suggestionId). Предложения никогда не попадают в базу без approve.agent_unanswered agentId, days, retensyAccount
Вопросы без ответа агента за период (GET /api/bots/agents/{agentId}/unanswered): days — 7|30|90 (по умолчанию 30). Группы вопросов, на которые агент не нашёл ответ в базе знаний — подсказка, что туда добавить. Read-only.agent_tests_run agentId, confirm, caseIds, generate, wait, timeoutSec, retensyAccount
Проверка агента ИИ-клиентами (POST /api/bots/agents/{agentId}/ai-tests/runs): ИИ играет клиентов по сохранённым тест-кейсам (персона + цель + критерии), ведёт диалог с агентом в песочнице, ИИ-судья ставит PASS/FAIL с причиной и цитатой; результат сравнивается с прошлым прогоном (регрессии). ТРАТИТ бюджет ИИ (до 120 вызовов на прогон, до 10 кейсов, до 30 прогонов в сутки; пробные ответы не используются) — поэтому нужен confirm:true. caseIds — какие кейсы гнать (по умолчанию все, максимум 10). wait (по умолчанию true) — дождаться конца прогона (до timeoutSec, по умолчанию 240) и вернуть итог; wait:false вернёт id прогона сразу — дальше agent_tests_list с runId. Кейсы создаёт владелец во вкладке «Проверка» или generate:N (1–10): сначала создаст N кейсов с ИИ (ещё один вызов ИИ), потом прогонит.agent_tests_list agentId, runId, retensyAccount
Кейсы проверки ИИ-клиентами и история прогонов агента (GET /api/bots/agents/{agentId}/ai-tests/cases, /runs, /runs/{runId}): cases — кейсы, history — последние 20 прогонов (итоги без диалогов), run — полный прогон (runId или последний): по каждому кейсу verdict PASS/FAIL/ERROR, reason, quote, диалог, previousVerdict и regression (раньше проходил, теперь нет). Ничего не тратит. Read-only.create_bot platform, token, groupId, name, inactive, confirmToken, retensyAccount
Подключить бота по токену (POST /api/bots): platform TELEGRAM (токен от @BotFather) или MAX (токен от MasterBot в MAX). Вебхук настраивается сам; name — отображаемое имя (иначе @username). Возвращает бота с id. Число ботов ограничено тарифом — HTTP 402 со ссылкой на смену тарифа. platform WEB — чат-виджет для сайта без токена (POST /api/bots/web): вернёт botId, key и snippet — код вставки на сайт (у существующего виджета — web_widget_snippet). platform INSTAGRAM по токену не подключается — только входом через Instagram (OAuth) в кабинете (/bots/instagram), нужен Instagram-аккаунт Business или Creator — инструмент вернёт ссылку на кабинет вместо ошибки. platform VK — сообщество как полноценный канал (Callback API, НЕ путать с vk_connect — тот для публикаций на стену): token — токен СООБЩЕСТВА (Управление сообществом → Работа с API → Создать ключ, доступ «Сообщения сообщества»), groupId — числовой id сообщества (обязателен). После подключения нужно вручную включить Callback API в настройках сообщества — см. webhookSecret в ответе и URL /vk/hooks/{botId} (подробный чек-лист у разработчика). inactive (только TELEGRAM/MAX) — создать бота остановленным: токен проверяется безопасным getMe, вебхук/поллинг НЕ трогаются — живой вебхук бота в другом конструкторе (BotHelp и т.п.) не снимается. Нужно при переносе бота из другого сервиса: создай inactive:true, перенеси сценарии/подписчиков (migration_preview/migration_commit), потом bot_resume — это и есть переключение (cutover).vk_landing_list retensyAccount
Список VK-лендингов (Mini App, GET /api/growth/vk-landings): контент, сценарий-цель, авто-режим, готовые ссылки links.{base,auto}, статистика views/clicks/subscribes. Read-only.vk_landing_get id, retensyAccount
Один VK-лендинг по id (GET /api/growth/vk-landings/{id}). 404 — не найден/чужой.vk_landing_create botId, title, subtitle, imageUrl, buttonText, targetGraphId, tags, autoSubscribe, bothelpLandingId, retensyAccount
Создать VK-лендинг (POST /api/growth/vk-landings): botId — VK-бот (create_bot platform VK), title обязателен, остальное опционально — subtitle, imageUrl, buttonText, targetGraphId (сценарий ЭТОГО бота из list_graphs, иначе HTTP 400: пусто или основной — подписчик идёт в основной сценарий по /start; опубликованный как ДОПОЛНИТЕЛЬНЫЙ (publish_graph secondary:true) — стартует в нём; черновик — пока основной; ответ показывает targetGraphStatus MAIN|SECONDARY|NOT_PUBLISHED|MISSING), tags (добавляются подписчику при переходе), autoSubscribe (true = &auto=1, подписка сразу при открытии), bothelpLandingId (маппинг старой ссылки BotHelp). Возвращает лендинг с готовыми ссылками links.base/links.auto вида vk.com/app<id>_-<groupId>#l=<id>[&auto=1] — публикуй их в сообществе.
vk_landing_update id, botId, title, subtitle, imageUrl, buttonText, targetGraphId, tags, autoSubscribe, bothelpLandingId, retensyAccount
Изменить VK-лендинг (PUT /api/growth/vk-landings/{id}) — те же поля, что vk_landing_create, полностью заменяют текущие (не частичный патч).vk_landing_delete id, retensyAccount
Удалить VK-лендинг (DELETE /api/growth/vk-landings/{id}) — ссылки перестают работать.bot_stop botId, confirmToken, retensyAccount
Остановить бота (POST /api/bots/{botId}/stop): снимает вебхук, бот перестаёт отвечать, сценарии и подписчики сохраняются. Запуск обратно — bot_resume.bot_resume botId, retensyAccount
Запустить остановленного бота или бота, приостановленного лимитом тарифа или конфликтом токена (POST /api/bots/{botId}/resume). Снимает pausedReason; у работающего бота с pausedChannels включает обратно только эти каналы. Если вебхук другого сервиса остался, через 10 минут пауза повторится — сначала попроси пользователя отключить бота там. Если лимит ботов тарифа исчерпан — HTTP 402 со ссылкой на смену тарифа.connect_integration provider, title, creds, connectionId, retensyAccount
Подключить сервис (POST /api/bots/integrations) — дальше его id (= connectionId) ставится в действия сценария и в site_lead_settings. provider и creds: AMOCRM {subdomain, longToken} · BITRIX24 {webhookUrl} · GETCOURSE {account, apiKey} · YAMETRIKA {counterId, oauthToken} · YOOKASSA {shopId, secretKey}. Остальные ~25 сервисов (smsru, retailcrm, cloudpayments, rest_api, yandex_market и т.д.) берутся из каталога Integration Core (integration_catalog) — provider передавай его provider-ключом в НИЖНЕМ регистре, нужные creds — из configSchema каждого провайдера (hint подскажет, где взять; поле с «необязательно»/optional в hint можно не слать). Без нужных creds вернёт, какие поля и где их взять. connectionId — обновить креды/название существующего подключения (PUT). Сервисы со входом через браузер не падают, а возвращают ссылку для пользователя: GOOGLE_SHEETS → ссылка согласия Google (OAuth; после неё таблицы выбираются в узле «Google Таблицы»), INSTAGRAM → ссылка на кабинет /bots/instagram (вход через Instagram, нужен Instagram-аккаунт Business/Creator). TELEGRAM/MAX — это боты: используй create_bot. Провайдер каталога со статусом COMING_SOON/IN_DEVELOPMENT подключить нельзя (вернёт ошибку). Если каталог недоступен (офлайн/выключен) — работают только 5 легаси-провайдеров выше. Креды хранятся в сервисе зашифрованными и НИКОГДА не возвращаются — ни здесь, ни в list_integrations (только маска hint); в отчёты не попадают. Проверить ключ после подключения — integration_test.disconnect_integration connectionId, retensyAccount
Удалить подключение сервиса по id из list_integrations (DELETE /api/bots/integrations/{id}). Действия сценария с этим connectionId перестанут работать.integration_ingress_url connectionId, rotate, retensyAccount
URL ингресса для триггера «Внешние события» (POST /api/bots/integrations/{id}/ingress-url, лениво создаёт токен при первом вызове; rotate:true — /ingress-url/rotate: старый URL сразу перестаёт принимать запросы). Вставь этот URL в сервис провайдера (CRM/кассу/форму) как webhook/notification/result URL, чтобы его события доходили до сценария. В сценарии добейся узла TRIGGER_WEBHOOK с config = {provider: provider-ключ в нижнем регистре (из integration_catalog), connectionId: id из list_integrations, event: events[].key из inbound.events того же provider в каталоге} — именно эти три поля конструктор и бэкенд читают для триггера интеграции (GraphValidator.validateWebhookTrigger / IngressFanout); без provider+connectionId узел ведёт себя как обычный TRIGGER_WEBHOOK с произвольным адресом. Только своё подключение (чужое — 403).broadcast_list botId, group, page, size, retensyAccount
Рассылки. Без botId — по всем ботам постранично (GET /api/bots/broadcasts): {counts: {drafts, scheduled, sent, recurring}, page: {content: [{id, botId, botUsername, name, status, direct, totalJobs, sentJobs, failedJobs, skippedByQuota, scheduledAt, createdAt}], totalElements…}}; group: scheduled (ещё не начали) | sent (идут/завершены). С botId — полная история одного бота. status: EXPANDING/MATERIALIZING/READY (ждёт) → RUNNING → DONE | CANCELLING → CANCELLED | FAILED. Read-only.broadcast_get broadcastId, retensyAccount
Рассылка целиком по id (GET /api/bots/broadcasts/{id}): статус, счётчики отправки, фильтр аудитории, сообщения, время. При failedJobs > 0 — ещё errors: топ-5 причин ошибок [{error, count}] (GET …/{id}/errors; детали живут 30 дней). Read-only.broadcast_preview botIds, botId, tagsAll, tagsNone, audienceFilter, segmentId, retensyAccount
Оценить охват до отправки: сколько подписчиков получат рассылку (POST /api/bots/{botId}/broadcasts/preview) — по каждому боту и всего. Фильтр: tagsAll — есть ВСЕ эти теги, tagsNone — нет НИ ОДНОГО; без тегов — все подписчики бота; либо полный audienceFilter; либо segmentId — сохранённый сегмент (audience_segments). Лимит — 50 000 получателей на бота. blockedExcluded — сколько подписчиков заблокировали бота (в охват не входят, рассылка им не уходит; метка снимается, когда человек снова пишет боту). Ничего не отправляет.broadcast_send name, botIds, botId, messages, tagsAll, tagsNone, audienceFilter, scheduledAt, graphId, entryNodeId, draftId, segmentId, localTime, dedup, stagger, retensyAccount
Отправить рассылку сейчас или запланировать (scheduledAt). ПЕРВЫЙ же корректный вызов СРАЗУ создаёт рассылку: токена подтверждения нет. ДО вызова ты обязан показать человеку получателей (уникальных и всего), текст и ФАКТИЧЕСКОЕ время старта из broadcast_group {action:"preview"} с теми же botIds/фильтром/dedup/stagger/scheduledAt (plannedStartAt первого и последнего бота, МСК) и получить явное согласие; без согласия не вызывай. Время старта в preview и в созданной рассылке считается одним кодом. Прямая (по умолчанию, POST /api/bots/broadcasts/direct): name, botIds[] (1–100 ботов ОДНОГО владельца в одном вызове и с одним подтверждением; без dedup/stagger по каждому создаётся своя рассылка), messages[] (1–5), tagsAll?/tagsNone? (фильтр по тегам). Сообщение: {type, text?, mediaUrl?, mediaUrls?, buttons?}; type: TEXT (text обязателен, до 4096) · PHOTO | VIDEO | AUDIO | FILE | VOICE (mediaUrl обязателен, text — подпись до 1024) · VIDEONOTE (кружок: mediaUrl, без текста) · GALLERY (mediaUrls: 2–10 картинок, подпись, БЕЗ кнопок). text — Telegram-HTML: <b> <i> <u> <s> <code> <pre> <blockquote> <tg-spoiler> <a href="https://…">, перенос строки — \n (не <br>); прочее экранируется. buttons — до 8 URL-кнопок [{text, url}] (callback-кнопок в рассылке нет). Можно строкой — это TEXT. Медиа — сначала upload_file, потом его url. По сценарию (graphId): POST /api/bots/{botId}/broadcasts — один botId, сценарий самого бота, entryNodeId? — с какого узла начать. draftId — отправить черновик (поля черновика, переданные аргументы их перекрывают); после отправки черновик удаляется. scheduledAt — ISO 8601 (без пояса — московское время); пусто — сразу. Немедленная резервирует квоту получателей тарифа, отложенная считает аудиторию в момент отправки. Рассылки только на платном тарифе — HTTP 402 со ссылкой. У Instagram-ботов рассылок нет. audienceFilter — полный фильтр аудитории вместо tagsAll/tagsNone (см. свойство ниже; если задан, tagsAll/tagsNone игнорируются). dedup:true — «отправить каждому человеку только один раз» среди нескольких botIds (ключ — platform+userId/chatId приватного чата; человек уходит ПЕРВОМУ боту по порядку botIds, где у него активная сессия). stagger — «распределить по ботам» (см. свойство ниже). Любое из dedup/stagger → вместо {broadcastIds, totalAudience} ответ-сводка {isGroup:true, group:{id, name, status, bots, statusCounts}, firstStartAt, lastStartAt (МСК), recipientsPlanned, warning?} — без списка ботов; детали по ботам и прогресс — broadcast_group {action:"get", groupId}. scheduledAt задаёт старт группы и с одним dedup (без stagger); если заданы и scheduledAt, и stagger.startAt и они расходятся — ошибка 400; сервер не создаст группу, если первый старт отличается от scheduledAt больше чем на минуту. Без dedup/stagger: {broadcastIds, totalAudience, startsAt, warning?}. При немедленном старте в ответе warning. segmentId — сохранённый сегмент аудитории вместо audienceFilter (audience_segments). localTime "HH:mm" — слать КАЖДОМУ подписчику в это времяaudience_segments action, botId, name, audienceFilter, tagsAll, tagsNone, segmentId, retensyAccount
Сохранённые сегменты аудитории рассылок (имя + фильтр; /api/bots/{botId}/segments; общие для всех ботов владельца, до 50). action: list — сегменты {id, name, filter}; create {name, audienceFilter | tagsAll/tagsNone} — сохранить фильтр под именем (до 60 символов); delete {segmentId}. Использовать: broadcast_send / broadcast_preview {segmentId}. botId — любой твой бот.bot_delivery_window action, botId, enabled, quietFrom, quietTo, timezone, retensyAccount
Тихие часы бота (/api/bots/{botId}/delivery-window): в окно quietFrom..quietTo (HH:mm, может переходить через полночь, например 22:00..09:00) рассылки не уходят, а переносятся на конец окна. Время считается по поясу подписчика (переменная timezone/tz), если неизвестен — по поясу бота timezone (IANA или UTC+3, пусто = Москва). По умолчанию выключено. action: get · set {enabled, quietFrom?, quietTo?, timezone?} (enabled:true требует quietFrom и quietTo, они должны различаться; enabled:false выключает, время сохраняется).bot_access botId, action, privateBot, deniedMessage, items, text, entryId, confirm, q, page, size, retensyAccount
Закрытый бот и список доступа (/api/bots/{botId}/access). action: get {q?, page?, size?} - настройки (privateBot, deniedMessage) и записи; settings {privateBot, deniedMessage?} - включить/выключить закрытый режим и текст отказа; add {items:[{kind:"TG_ID"|"USERNAME"|"PHONE", value, note?}]} или {text} (многострочный импорт, по записи в строке) - добавить; remove {entryId} - удалить запись; clear {confirm:true} - очистить весь список (без confirm не выполняется). Проверка в сценарии - узел ACCESS_GATE (правило ALLOWLIST смотрит этот список).preset_list botId, retensyAccount
Пресеты блоков (сохранённые настройки узла: /api/block-presets). Без botId - пресеты аккаунта; с botId - ещё и пресеты этого бота. Секретные значения заголовков (Authorization, токены, ключи) хранятся зашифрованно и возвращаются только ссылками "preset-secret:<id>:<Header>" - такую ссылку можно подставлять как значение заголовка в headersJson узла графа, но не открытым текстом.
preset_save presetId, name, description, nodeType, config, botId, retensyAccount
Сохранить пресет блока: POST /api/block-presets (новый) или PUT /api/block-presets/{presetId} (обновить). name, nodeType (тип узла, напр. CALL_WEBHOOK), config (настройки узла), description?, botId? (пусто = пресет аккаунта, иначе только этого бота). Секретные заголовки в config.headersJson (Authorization, токены, ключи) сервер шифрует и отдаёт только ссылками "preset-secret:<id>:<Header>"; ссылку используй как значение заголовка в headersJson графа, не открытый текст. Инструмент не печатает секреты в своём выводе.preset_delete presetId, retensyAccount
Удалить пресет блока (DELETE /api/block-presets/{presetId}). Графы, где уже вставлен блок, не меняются.webhook_requests graphId, action, confirm, retensyAccount
Входящие запросы сценария-вебхука (/api/bots/graphs/{graphId}/webhook-requests): последние 50 за 7 дней, секреты замаскированы. action: list (по умолчанию) - показать; listen - включить режим прослушивания (POST .../webhook-listen): открывается тестовый URL /api/webhooks/t/<path>, запрос на него сохраняется и не запускает сценарий; stop - выключить прослушивание (DELETE .../webhook-listen); clear {confirm:true} - стереть журнал. Используй, чтобы увидеть реальное тело запроса и составить TRIGGER_WEBHOOK config.mappings [{path,saveTo}].http_test url, method, headersJson, bodyTemplate, timeoutMs, vars, retensyAccount
Тестовый HTTP-запрос с сервера (POST /api/http-test; защита от SSRF, таймаут до 15 с, ответ до 1 МБ). url, method? (GET по умолчанию), headersJson? (JSON-строка), bodyTemplate?, timeoutMs?, vars? (подстановки {{var.x}}). Возвращает status, headers, body и fields - список JsonPath-полей ответа: их подставляй в extract:[{path,saveTo}] действия external_request (ACTIONS) или в mappings вебхука. Секреты заголовков в ответе не печатаются.broadcast_test botId, messages, chatId, retensyAccount
Отправить тест рассылки себе (POST /api/bots/{botId}/broadcasts/test): те же сообщения, что у broadcast_send, на твой привязанный Telegram (бот должен быть Telegram, а ты — нажать /start у этого бота; иначе 422 owner_chat_not_linked или 502 от Telegram) либо в чат подписчика chatId этого бота (так тестируют MAX/VK). Мимо квоты, очереди и тихих часов, подписчикам ничего не уходит.broadcast_undo broadcastId, action, opId, confirm, placeholderForExpired, retensyAccount
Отменить УЖЕ ОТПРАВЛЕННУЮ рассылку у получателей — удалить сообщения (фоновая операция с прогрессом и лимитами). Окна: Telegram 48 ч (старше — заглушка «Сообщение удалено», если placeholderForExpired не false), VK 24 ч, MAX без срока. action: preview (по умолчанию; сколько сообщений удалится/просрочено, ничего не меняет) | start (запустить, нужен confirm:true; 202 {opId}) | status (opId; прогресс done/failed/expired/gone/blocked) | pause|resume|cancel (opId). Запланированную/идущую рассылку останавливает broadcast_cancel.broadcast_cancel broadcastId, confirmToken, retensyAccount
Отменить рассылку (POST /api/bots/broadcasts/{id}/cancel): запланированная не уйдёт, идущая остановится (статус CANCELLING → CANCELLED). Уже завершённую отменить нельзя — HTTP 409. Для группы (dedup/stagger) — broadcast_group {action:"cancel"}.broadcast_recurring action, ruleId, name, botIds, botId, messages, tagsAll, tagsNone, audienceFilter, recurrence, firstRunAt, dedup, stagger, retensyAccount
Повторяющиеся рассылки (/api/bots/broadcasts/recurring). action: list — правила (активные и остановленные); create {name, botIds[], messages[], tagsAll?/tagsNone? или audienceFilter?, recurrence: DAILY|MONTHLY|YEARLY, firstRunAt, dedup?, stagger?} — сообщения и фильтр как в broadcast_send; dedup/stagger заданы — КАЖДЫЙ прогон правила порождает свою отдельную группу (своя дедупликация с нуля, аудитория у повтора может быть другой); firstRunAt — первый запуск в будущем (ISO 8601, без пояса — московское), дальше в то же время суток/число (Москва); stop {ruleId} — остановить правило (уже отправленные прогоны не трогаются). Нужен платный тариф (402 со ссылкой).broadcast_drafts action, draftId, name, botIds, messages, tagsAll, tagsNone, scheduledAt, retensyAccount
Черновики рассылок (/api/bots/broadcasts/drafts) — те же, что в мастере кабинета. action: list · get {draftId} · create {name?, botIds?, messages?, tagsAll?, tagsNone?, scheduledAt?} · update {draftId, …те же поля — переданные заменяют, остальные остаются} · delete {draftId}. Черновик не проверяется на полноту; отправить — broadcast_send {draftId}. Лимит — 200 черновиков.broadcast_duplicate broadcastId, draftId, retensyAccount
Копия как новый черновик «<имя> (копия)»: исходник не меняется, время отправки и статистика не переносятся. broadcastId — прямая рассылка (POST /api/bots/broadcasts/{id}/duplicate: бот, фильтр, сообщения; по сценарию — HTTP 409); draftId — черновик (POST /api/bots/broadcasts/drafts/{id}/duplicate). Дальше broadcast_drafts update / broadcast_send {draftId}.broadcast_group action, groupId, botIds, tagsAll, tagsNone, audienceFilter, dedup, stagger, scheduledAt, retensyAccount
Мульти-бот группа рассылки (dedup/stagger, создаётся broadcast_send/broadcast_recurring). action: preview {botIds[] (1–100), tagsAll?/tagsNone? или audienceFilter?, dedup?, stagger?, scheduledAt?} — POST /api/bots/broadcasts/group-preview, read-only: {totalRecipients, uniqueRecipients, perBot:[{botId, username, rawCount, dedupedCount, waves, lastWaveStartAt, plannedStartAt}], limit, scheduleEndsAt}; list — твои группы (новые сверху); get {groupId} — GET .../group/{id}: полная BroadcastGroup {id, status: SCHEDULED|RUNNING|PAUSED|DISPATCHED|CANCELLED, perBot:[{botId, waveIndex, totalWaves, status: PENDING|CLAIMED|DISPATCHED|FAILED|SKIPPED, broadcastId, recipientsRaw, recipientsSkippedDedup, recipientsPlanned, error}]...} — перBot[].broadcastId (после DISPATCHED) смотри прогресс через broadcast_get; pause {groupId} — новые запуски не стартуют, уже идущие (DISPATCHED) боты продолжают слать; resume {groupId} — снимает паузу у просроченных PENDING; cancel {groupId} — PENDING становятся SKIPPED, уже DISPATCHED переводятся в CANCELLING как обычная рассылка. pause/resume/cancel — 409, если группа не в подходящем состоянии; 403 — чужая группа.web_widget_snippet botId, retensyAccount
Код вставки чат-виджета на сайт (GET /api/bots/web/{botId}/snippet) — для бота с platform WEB (create_bot {platform:"WEB"}). Read-only.kb_list retensyAccount
Базы знаний пользователя (GET /api/bots/kb): id, name, chunkCount. id — knowledgeBaseId для узла AI_REPLY mode:"agent". Read-only.
kb_create name, retensyAccount
Создать пустую базу знаний (POST /api/bots/kb, name ≤ 120 символов). Возвращает id. Наполнение — kb_add_qa / kb_add_site; подключение к сценарию — knowledgeBaseId в узле AI_REPLY mode:"agent". Повторный вызов создаёт ВТОРУЮ базу — сначала проверь kb_list.
kb_delete_doc kbId, docId, retensyAccount
Удалить документ из базы знаний вместе с его фрагментами (DELETE /api/bots/kb/{kbId}/docs/{docId}). Необратимо.bot_user_get botId, chatId, retensyAccount
Карточка подписчика (GET /api/bots/{botId}/users/{chatId}): теги, переменные (поля, ответы, ai_summary), блокировка, счётчики. chatId — из list_bot_users. Read-only.bot_user_runs botId, chatId, page, size, retensyAccount
Журнал запусков сценариев подписчика (GET /api/bots/{botId}/users/{chatId}/runs): триггер, статус, шаги с результатом (ветка ИИ-агента, ok/ошибка каждого действия — CRM, уведомление, HTTP). Так проверяют, что сценарий реально сделал нужное. Статус прогона: OK, FAILED (прерван) или PARTIAL — «завершён с ошибками»: дошёл до конца, но хотя бы одно действие упало (у шага ok:false, error «КОД: …»). Read-only.dialog_messages botId, chatId, page, size, retensyAccount
Переписка с подписчиком, свежие сверху (GET /api/bots/{botId}/users/{chatId}/messages, page/size). Поле sender: null — бот, OPERATOR — человек, AI — ответ модели ИИ-агента, HANDOFF — передача оператору; corrected:true — ответ ИИ исправлен оператором (правильный ответ уже в базе знаний). Read-only.dialog_reply botId, chatId, text, confirmToken, retensyAccount
ОТПРАВИТЬ сообщение подписчику от имени оператора (POST /api/bots/{botId}/users/{chatId}/messages) — как ответ из раздела «Диалоги». Уходит РЕАЛЬНОМУ человеку: только по явной просьбе пользователя. Бот при этом не останавливается.integration_calls connectionId, ok, limit, retensyAccount
Журнал вызовов внешних сервисов из сценариев (GET /api/bots/integrations/calls): время, подключение, действие, ok/ошибка, код, попытки, correlationId (= runId прогона). Фильтры: connectionId (из list_integrations), ok (true — только успешные, false — только упавшие), limit (1–200). Так проверяют, что CRM/таблица/HTTP реально получили данные. Read-only.
dialog_handoff botId, chatId, active, retensyAccount
Передача диалога оператору (POST /api/bots/{botId}/users/{chatId}/handoff {active}): active:true — бот и ИИ молчат, входящие копятся в «Диалогах», отвечает человек (dialog_reply); active:false — «Вернуть боту». Текущее состояние — поле handoff в bot_user_get.site_lead_status siteId, leadId, status, retensyAccount
Статус заявки сайта (PATCH /api/bots/pages/{siteId}/leads/{leadId} {status}): NEW → IN_PROGRESS → DONE | REJECTED. leadId — из site_leads. Недопустимый переход → ошибка 409.integration_update connectionId, title, creds, retensyAccount
Изменить подключение (PUT /api/bots/integrations/{connectionId}): title — новое название; creds — новые ключи доступа (заменяют старые; поля — как в connect_integration для этого провайдера). Передай хотя бы одно.web_widget_settings botId, settings, retensyAccount
Вид чат-виджета сайта (бот platform WEB). Без settings — прочитать (GET /api/bots/web/{botId}/settings: settings, brandingRemovable, snippet). С settings — изменить (PUT): переданные поля накладываются на текущие, остальные сохраняются; сервер проверяет значения (уходят в разметку чужих сайтов).bot_users_import botId, rows, retensyAccount
Добавить/обновить подписчиков пачкой JSON (POST /api/bots/{botId}/users/import): rows — [{chatId, username?, tags?: [строки], variables?: {ключ: значение}, subscribedAt?: ISO-дата, source?: строка, status?: ACTIVE|UNSUBSCRIBED|BLOCKED}], до 10 000 строк за вызов. Метки ДОБАВЛЯЮТСЯ; переменная/username/subscribedAt/source пишутся, только если у подписчика их ещё нет (существующие не перезаписываются — так переносится дата подписки/источник из BotHelp без порчи того, что уже накопил рантайм); новый chatId создаёт подписчика (в пределах лимита тарифа), дедуп — по (botId, chatId). status=UNSUBSCRIBED|BLOCKED односторонне помечает подписчика заблокированным (сценарий/рассылка ему больше ничего не шлют) — снять эту метку через импорт нельзя, ACTIVE её не снимает.bot_runs botId, runId, page, size, retensyAccount
Журнал прогонов сценариев бота. Без runId — список свежих прогонов (GET /api/bots/{botId}/runs, page/size); с runId — один прогон с шагами (GET /api/bots/runs/{runId}, в т.ч. headless-прогоны вебхук-сценариев и расписаний). По подписчику — bot_user_runs, по сценарию — scenario_runs. Статус прогона: OK, FAILED (прерван) или PARTIAL — «завершён с ошибками»: дошёл до конца, но хотя бы одно действие упало (у шага ok:false, error «КОД: …»). Read-only.scenario_runs graphId, page, size, retensyAccount
Журнал прогонов одного сценария (GET /api/bots/graphs/{graphId}/runs, page/size), включая headless-прогоны без чата — вебхук-сценарии, заявки сайта, TRIGGER_SCHEDULE. Доступ — как к просмотру графа. Шаги прогона — bot_runs {runId}. Статус прогона: OK, FAILED (прерван) или PARTIAL — «завершён с ошибками»: дошёл до конца, но хотя бы одно действие упало (у шага ok:false, error «КОД: …»). Read-only.bot_delete botId, confirm, confirmToken, retensyAccount
УДАЛИТЬ бота навсегда (DELETE /api/bots/{botId}) вместе с каналами, сценариями, подписчиками, журналами, рассылками и ссылками. Только владелец. Необратимо: вызывай только по явной просьбе пользователя и с confirm:true. Временно выключить — bot_stop.booking_calendar_list retensyAccount
Календари записи пользователя (GET /api/bots/booking/calendars): id, name, zone, slotMinutes, hours, exceptions, botId. id — calendarId для действий сценария booking_slots/booking_book/booking_cancel. Read-only.
booking_calendar_get calendarId, retensyAccount
Календарь записи по id (GET /api/bots/booking/calendars/{calendarId}). Read-only.booking_calendar_create name, zone, slotMinutes, hours, exceptions, botId, description, breaks, meetingTypes, bufferBeforeMinutes, bufferAfterMinutes, minNoticeMinutes, horizonDays, intakeFields, confirmationMode, pendingHoldHours, notifyOwner, slug, enabled, retensyAccount
Создать календарь записи (POST /api/bots/booking/calendars): сетка слотов по рабочим часам в зоне календаря, в слоте — одна бронь. Без hours свободных слотов не будет. Доп. поля (буферы, горизонт, типы встреч, форма клиента, подтверждение владельцем, публичная ссылка /book/<slug>) — см. свойства ниже.
booking_calendar_update calendarId, name, zone, slotMinutes, hours, exceptions, botId, description, breaks, meetingTypes, bufferBeforeMinutes, bufferAfterMinutes, minNoticeMinutes, horizonDays, intakeFields, confirmationMode, pendingHoldHours, notifyOwner, slug, enabled, retensyAccount
Изменить календарь (PUT /api/bots/booking/calendars/{calendarId}): переданные поля заменяют текущие (hours/exceptions/breaks/meetingTypes/intakeFields — целиком), остальные сохраняются. Существующие брони не трогаются.booking_calendar_delete calendarId, confirm, retensyAccount
УДАЛИТЬ календарь записи (DELETE /api/bots/booking/calendars/{calendarId}). Сценарии с его calendarId перестанут записывать. Только по явной просьбе, с confirm:true.booking_slots calendarId, from, to, limit, meetingTypeId, retensyAccount
Свободные слоты календаря (GET /api/bots/booking/calendars/{calendarId}/slots): [{at — ISO-8601 с зоной, label — «пн 12.10 15:00»}]. from/to — даты ГГГГ-ММ-ДД в зоне календаря (по умолчанию сегодня … +6 дней), limit — 1–500 (по умолчанию 50). meetingTypeId — у календаря с типами встреч выбрать нужный (меняет шаг сетки); неизвестный id — как без него (slotMinutes). Read-only.booking_list calendarId, from, pendingOnly, retensyAccount
Брони календаря от даты from (ГГГГ-ММ-ДД, по умолчанию сегодня), включая отменённые, до 500 (GET /api/bots/booking/calendars/{calendarId}/bookings). pendingOnly:true — игнорирует from, только брони MANUAL-календаря, ждущие confirm/reject (без потолка 500). Read-only.booking_create calendarId, slotAt, name, phone, email, comment, customAnswers, meetingTypeId, retensyAccount
Записать вручную на слот (POST /api/bots/booking/calendars/{calendarId}/bookings): slotAt — at из booking_slots (ISO-8601 с зоной). Слот занят → понятная ошибка «занят», слота нет в сетке → ошибка 400. email/comment/customAnswers — доп. поля формы клиента (intakeFields календаря — только подсказка для UI, не ограничивает, что можно передать здесь); meetingTypeId — у календаря с типами встреч. MANUAL confirmationMode — бронь создаётся с confirmed:false, слот уже занят; подтвердить/отклонить — booking_confirm/booking_reject.booking_cancel calendarId, bookingId, confirmToken, retensyAccount
Отменить бронь и освободить слот (POST /api/bots/booking/calendars/{calendarId}/bookings/{bookingId}/cancel). Повторная отмена — без ошибки. bookingId — из booking_list.booking_confirm calendarId, bookingId, retensyAccount
Подтвердить бронь, ждущую решения владельца (MANUAL confirmationMode) — POST .../bookings/{bookingId}/confirm. Клиенту уходит уведомление, если бронь пришла из чата бота. HTTP 404 — бронь не этого календаря, 409 — уже не ждёт решения (подтверждена/отменена/истёк pendingHoldHours).booking_reject calendarId, bookingId, retensyAccount
Отклонить бронь, ждущую решения владельца (MANUAL confirmationMode) — POST .../bookings/{bookingId}/reject: освобождает слот, клиенту уходит «отклонено владельцем» (в отличие от booking_cancel — то работает на любой активной брони и ничего не присылает клиенту). HTTP 404/409 — как у booking_confirm.event_list retensyAccount
События с билетами (GET /api/bots/tickets/events): id, title, startsAt, status, sold, checkedIn, revenue, publicUrl. Read-only.
event_get eventId, retensyAccount
Событие с типами билетов (GET /api/bots/tickets/events/{eventId}). Read-only.event_create title, description, startsAt, endsAt, timezone, venueType, venue, onlineUrl, coverUrl, capacity, status, retensyAccount
Создать событие (POST /api/bots/tickets/events), по умолчанию черновик; опубликовать — status:"published". Типы билетов — ticket_type_upsert.
event_update eventId, title, description, startsAt, endsAt, timezone, venueType, venue, onlineUrl, coverUrl, capacity, status, retensyAccount
Изменить событие (PUT /api/bots/tickets/events/{eventId}), переданные поля заменяют текущие. status:"cancelled" — отмена события.ticket_type_upsert eventId, id, name, price, limit, salesStart, salesEnd, retensyAccount
Создать/изменить тип билета (POST /api/bots/tickets/events/{eventId}/types): без id — новый, с id — правка. price 0 = бесплатный; limit — число билетов типа.tickets_list eventId, q, status, page, size, retensyAccount
Билеты/участники события (GET /api/bots/tickets/events/{eventId}/tickets): q — поиск по имени/номеру, status, page с 0, size. Read-only.ticket_checkin eventId, ticketId, confirmToken, retensyAccount
Отметить билет использованным вручную (POST .../tickets/{ticketId}/checkin). Необратимо, нужен confirmToken. Ответ: status VALID | ALREADY_USED | CANCELLED | NOT_PAID.ticket_cancel eventId, ticketId, refund, confirmToken, retensyAccount
Отменить билет и освободить место (POST .../tickets/{ticketId}/cancel). refund:true — пометить возврат (деньги в ЮKassa возвращаются вручную). Необратимо, нужен confirmToken.site_templates category, retensyAccount
Библиотека шаблонов блоков сайта (GET /api/bots/pages/templates): {categories: [{id, title, description?}], templates: [{id, category, title, description?, blocks: сколько блоков вставится}]}. Вставка — site_edit add_template {container, templateId, after?} (results.id — первый блок, results.ids — все); дальше блоки правятся как обычные. category — фильтр по id категории. Ответ также содержит siteTemplates — стартовые шаблоны сайта (starter, blank, mini-landing, shop-starter) с описаниями: для site_create template / site_edit init.bot_rename botId, name, retensyAccount
Переименовать бота (PATCH /api/bots/{botId} {name}): отображаемое имя в кабинете, до 250 символов. Пустое name сбрасывает имя на @username. Имя в самом Telegram/MAX не меняется.bot_change_token botId, token, retensyAccount
Сменить токен бота (POST /api/bots/{botId}/token {token}): сервер проверяет токен и перезапускает приём сообщений; сценарии, подписчики и ссылки остаются. Нужен, если токен перевыпущен в @BotFather (/revoke) или MAX. Неверный или чужой токен → ошибка с причиной. Владелец или ADMIN.bot_channel_list botId, retensyAccount
Дополнительные Telegram-боты (мультиканальность) этого бота (GET /api/bots/{botId}/channels): id, username, name, active. Это НЕ каналы/группы для постинга — те в list_channels. Read-only.bot_channel_add botId, token, name, retensyAccount
Добавить к боту ещё одного Telegram-бота как канал (POST /api/bots/{botId}/channels {token, name?}): он отвечает теми же сценариями. Токен проверяется в Telegram; токен, уже подключённый где-то ещё, не принимается.bot_channel_delete botId, channelId, confirm, retensyAccount
Отключить дополнительного Telegram-бота от бота (DELETE /api/bots/{botId}/channels/{channelId}). channelId — из bot_channel_list. Только по явной просьбе, с confirm:true.link_create botId, name, targetNodeId, targetGraphId, retensyAccount
Создать стартовую ссылку бота (POST /api/bots/{botId}/links {name, targetNodeId?}): code для t.me/<бот>?start=<code>, счётчик стартов. targetNodeId — узел сценария, на который ведёт диплинк; для одного узла повторный вызов вернёт существующую ссылку. targetGraphId — дополнительный сценарий этого бота (publish_graph secondary:true), в котором стартует подписчик (targetNodeId тогда — узел в нём); не опубликован как дополнительный — ведёт в основной; чужой граф — HTTP 400.link_delete linkId, confirm, retensyAccount
Удалить стартовую ссылку (DELETE /api/bots/links/{linkId}); id — из list_links. Разосланные ссылки перестанут считаться. Только по явной просьбе, с confirm:true.utm_sources botId, retensyAccount
UTM-источники подписчиков бота (GET /api/bots/{botId}/utm-sources): по каким меткам utm_* люди входили в сценарии и сколько их. Read-only.source_revenue botId, from, to, retensyAccount
Отчёт источник -> выручка по боту (GET /api/bots/{botId}/analytics/source-revenue): по каждому источнику (UTM или стартовая ссылка) подписчики периода, покупатели, выручка (RUB копейки revenueKop + Stars revenueStars), конверсия. Когорта: подписчики за from..to и все их оплаты. Даты YYYY-MM-DD, окно до 92 дней. Read-only.funnel_report days, retensyAccount
Воронка владельцев ботов по когорте регистраций за период (GET /api/admin/funnel?days): {days, cohort, steps:[{stage,users,pctOfCohort,pctOfPrevious}] (registered, verified, bot_created, graph_published, first_subscriber, broadcast_sent, payment_succeeded), bySource, canceledPayments, remindersSent, stepEvents:[{name,events,users,top:[{code,count}]}]} - события шагов: подсказка первой рассылки, тест себе, отказы сохранения сценария (коды), ошибки подключения бота, отказы по лимитам тарифа, клики по апгрейду. Только агрегаты, без личных данных. Нужны права администратора платформы. days 1..365, по умолчанию 30. Read-only.bot_health botId, retensyAccount
Здоровье бота: статус OK/WARN/CRIT и список проблем с подсказками что делать (GET /api/bots/{botId}/health, свежий расчёт). Коды: TOKEN_REVOKED (токен отозван), TOKEN_CONFLICT (409, токен занят другим сервисом), POLLING_FAILURE (сбои getUpdates), SCENARIO_ERRORS (много упавших прогонов за сутки), PAYMENT_WEBHOOK_FAILURE (сбой обработки платежа), CONVERSION_DROP (конверсия старт->оплата ниже половины недельной нормы), AGENT_UNANSWERED_SPIKE (всплеск вопросов без ответа у ИИ-агента). Без botId - сохранённый статус всех ботов (GET /api/bots/health). Read-only.unsubscribe_reasons botId, days, retensyAccount
Причины отписки подписчиков бота за период (GET /api/bots/{botId}/unsubscribe-reasons?days): {total, answered, byCode:[{code,count}] (blocked, unspecified, too_often, not_relevant, not_interested, found_other, other), clusters:[{label,count,samples}] (темы свободных ответов, группирует ИИ раз в неделю), recentTexts}. Спрос причины включается в настройках бота (Здоровье и отписки). days 1..365, по умолчанию 30. Read-only.ab_results graphId, branchNodeId, period, retensyAccount
Результаты A/B-теста (GET /api/bots/graphs/{graphId}/ab-results?branchNodeId&period): статистика по вариантам узла-развилки. branchNodeId — id узла A/B в графе; period — «24h», «7d», «30d» (по умолчанию 7d). Read-only.kb_delete kbId, confirm, retensyAccount
УДАЛИТЬ базу знаний целиком со всеми документами (DELETE /api/bots/kb/{kbId}). База ИИ-агента так не удаляется (ошибка KB_OWNED_BY_AGENT) — удаляй агента. Необратимо: только по явной просьбе, с confirm:true.agent_unpublish agentId, retensyAccount
Снять ИИ-агента с публикации (POST /api/bots/agents/{agentId}/unpublish): агент возвращается в черновик и перестаёт отвечать. В ответе — agent и сценарии, которые сейчас на нём работают (их стоит проверить).agent_delete agentId, confirm, retensyAccount
УДАЛИТЬ ИИ-агента (DELETE /api/bots/agents/{agentId}). Пока агент или его база подключены к сценариям — ошибка AGENT_IN_USE со списком сценариев: сначала отключи его там. Необратимо: только по явной просьбе, с confirm:true.site_leads_mark_read siteId, retensyAccount
Отметить все заявки сайта прочитанными (POST /api/bots/pages/{siteId}/leads/read): обнуляет счётчик unread из site_leads. Статусы обработки не меняются (это site_lead_status).site_lead_delete siteId, leadId, confirm, retensyAccount
УДАЛИТЬ заявку сайта (DELETE /api/bots/pages/{siteId}/leads/{leadId}); leadId — из site_leads. Необратимо: только по явной просьбе, с confirm:true.site_leads_export siteId, savePath, retensyAccount
Все заявки сайта в CSV (GET /api/bots/pages/{siteId}/leads.csv). savePath — сохранить в локальный файл и вернуть путь (для больших выгрузок); без него CSV возвращается текстом. Read-only.bot_users_export botId, format, savePath, retensyAccount
Выгрузка всех подписчиков бота (GET /api/bots/{botId}/users/export?format=csv|json): chatId, имя, метки, переменные. savePath — сохранить в локальный файл и вернуть путь; без него данные возвращаются текстом. Read-only.bot_user_reset botId, chatId, confirm, retensyAccount
Сбросить сессию подписчика (DELETE /api/bots/{botId}/sessions/{chatId}): стираются его позиция в сценарии, метки и переменные, и он пропадает из list_bot_users; при следующем сообщении начнёт как новый. Для повторного прохождения воронки при тесте. Необратимо: только по явной просьбе, с confirm:true.audience_fields botId, search, limit, retensyAccount
Поля для построителя фильтра (GET /api/bots/{botId}/audience/fields): variables — [{key, type: TEXT|NUMBER|DATE|BOOL}] (тип выведен по значению в сэмпле из последних 500 сессий — не точная схема), tags — список тегов. search — подстрока (и по ключам переменных, и по тегам), limit — до 200 каждого списка. Read-only.audience_search botId, botIds, filter, q, sort, dir, page, size, retensyAccount
Фильтр+сортировка+поиск подписчиков (замена постраничного перебора list_bot_users под сложный фильтр). botId — один бот (POST /api/bots/{botId}/users/search); без botId — кросс-бот по всем доступным (POST /api/bots/subscribers/search, опц. botIds[] — подмножество, чужие id тихо отбрасываются). filter — AudienceFilter (см. свойство ниже), q — текстовый поиск (имя/username/id), sort ∈ updatedAt|activity|lastActivity|chatId|username|tgUsername|createdAt|subscribedAt|status|blocked|botId|bot, dir — asc|desc, page (с 0), size (до 200, по умолч. 25). Кросс-бот ответ — те же поля + botId/botName. Read-only.audience_tag_edit botId, chatIds, add, remove, retensyAccount
Массово добавить/снять теги у выбранных подписчиков бота (POST /api/bots/{botId}/users/tags): chatIds[] (до 10000, из audience_search/list_bot_users), add?/remove? — списки тегов; remove применяется ДО add (тег в обоих спискaх — останется). Возвращает {matched}.audience_variable_edit botId, chatIds, set, unset, retensyAccount
Массово установить/снять custom-переменные у выбранных подписчиков (POST /api/bots/{botId}/users/variables): chatIds[] (до 1000 — читается документ целиком, потолок ниже, чем у audience_tag_edit), set? — {ключ: значение}, unset? — список ключей. Служебные ключи и ключи с «.»/ведущим «$» отклоняются (400). Каждая запись проходит тот же потолок переменных подписчика (одно значение ≤65536, сумма ≤262144 символов) — отклонённые видны в ответе {matched, rejected[] (до 50 по имени), rejectedCount}, остальные записи применяются как обычно.audience_export botId, botIds, filter, q, format, savePath, retensyAccount
Потоковая выгрузка ТЕКУЩЕЙ отфильтрованной выборки подписчиков (не только одной страницы) — CSV или XLSX. botId — один бот (POST /api/bots/{botId}/users/export); без botId — кросс-бот (POST /api/bots/subscribers/export, опц. botIds[], доп. колонка «бот»). filter — AudienceFilter, q — текстовый поиск. Потолок 100000 строк — больше → HTTP 422 (сузь фильтр). format csv — текст (savePath необязателен, иначе вернётся строкой); format xlsx — ВСЕГДА требует savePath (бинарный формат, в чат не возвращается).graph_build_from_spec botId, spec, graphId, allowMissingIntegrations, retensyAccount
Собрать ЛЮБОЙ сценарий бота из спецификации (POST /api/bots/{botId}/graphs/from-spec): сервер сам раскладывает шаги в блоки, проверяет валидатором и сохраняет ЧЕРНОВИК (живой бот не меняется; публикация - graph_publish). spec={name?, trigger?:{command}|{node:TRIGGER_*, config}, triggers?:[ещё триггеры], steps:[...]}. Простые шаги (type): message{text, id?, buttons?:[{text,url}|{text,goto:id шага}], replyButtons?:[[текст|{text,goto:id шага}]] (кнопки под полем ввода Telegram, ряды; нажатие = текст боту, goto сам создаёт вход TRIGGER_TEXT на шаг; не вместе с buttons), replyOneTime?, replyPlaceholder?, removeReplyKeyboard?}; ask{text, saveTo (латиница, нижний регистр), answer: text|number|phone|email|photo|file|choice, options (для choice), label?, retry?}; if{var, op: eq|ne|contains|gt|lt|ge|le|empty|notempty, value, then:[], else:[]}; tag{tag}; notify{text}; save{tag?, title?} (метка + уведомление владельцу со всеми ответами и ссылками на фото); end{text?}. ЛЮБОЙ другой блок конструктора (оплата, запись, HTTP, ИИ-агент, таймеры и ожидания, A/B и случайный выбор, переключатели, магазин и каталог, билеты, медиа, виджеты, ephemeral, кнопки webapp, заявки на вступление, CRM, Google Таблицы и т.д.): {type:"node", node:ТИП, config:{...}, id?, branches?:{выход:[шаги] | {goto:id}}}; действие: {type:"action", kind, ...поля} (или actions:[...]); возврат или цикл: {type:"jump", to:id}. Типы и поля НЕ угадывай: node_types_list (короткий каталог), затем node_type_schema(type). Нужные подключения сервер проверяет сам и подставляет id (подключение, календарь, таблица, ИИ-агент); нет подключения - HTTP 409 с integrations.missing (what/why/connectUrl; расскажи владельцу и подключи, connect_integration), либо allowMissingIntegrations=true - черновик с блоком, который ждёт подключения (публикация его не пропустит). integrations_for_spec проверяет заранее. Подстановки в простых шагах: {{var.<saveTo>}}. Адреса кнопок - только http/https. graphId - дописать ветку в существующий сценарий (нужен свой trigger; старые блоки не меняются; опубликованный - правки в копии-черновике). Ответ: id, steps (пересказ), fields, warnings, integrations; 400 с problems при ошибках spec, 422 если граф не прошёл проверку.graph_edit graphId, ops, allowMissingIntegrations, retensyAccount
Правка ЛЮБОГО блока существующего сценария (POST /api/bots/graphs/{graphId}/edit), в черновике; опубликованный сценарий не меняется - правки идут в его копию-черновик. Сначала graph_structure (id, типы, настройки, связи) или graph_texts. ops[] (до 20): add_button{nodeId, text, url|gotoNodeId|newStep:{text,buttons?}}; set_button_action{nodeId, index, url|gotoNodeId|newStep}; insert_step{afterNodeId, handle?, steps:[как в graph_build_from_spec, включая node/action/jump]}; update_node{nodeId, config:{поле:значение, null удаляет}} (поля - node_type_schema); delete_node{nodeId, reconnect?=true}; connect{nodeId, handle, toNodeId}; disconnect{nodeId, handle}; move_branch{nodeId, handle, toNodeId, toHandle}; add_trigger{node:TRIGGER_*, config, toNodeId}. Все правки проходят валидатор; нет подключения для вставленных блоков - 409 integrations.missing (или allowMissingIntegrations=true). Затем graph_publish.node_types_list kind, q, retensyAccount
Короткий каталог ВСЕХ блоков конструктора (GET /api/bots/node-types): type, kind (node|trigger|action), name, purpose, requires (какая интеграция нужна). Фильтры: kind, q (слово из запроса: оплата, запись, таймер, crm). Вызывай перед нестандартным сценарием, затем node_type_schema. Read-only.
node_types_pick task, limit, retensyAccount
Подбор блоков по описанию задачи (GET /api/bots/node-types/pick?task=): сервер ищет по каталогу и возвращает схемы 6 самых подходящих блоков (поля, выходы, requires, example) и имена ещё нескольких. ОДИН вызов вместо обзора каталога перед нестандартным сценарием. Read-only.
node_type_schema type, retensyAccount
Подробная схема блока, триггера или действия (несколько типов через запятую: type: DELAY,TRIGGER_SCHEDULE, до 8 за вызов) (GET /api/bots/node-types/{type}): fields (имя, тип, обязательность, допустимые значения), outputs (выходы для branches), continue, requires/connectionField (интеграция), example (рабочий config), notes. type из node_types_list (YOOKASSA_PAYMENT, TRIGGER_BOOKING, amocrm_send...). Read-only.integrations_for_spec botId, spec, retensyAccount
Какие подключения нужны spec и что уже подключено у владельца (POST /api/bots/{botId}/graphs/spec-integrations): оплата ЮKassa/T-Bank, amoCRM, Битрикс24, Google Таблицы, календарь записи, ИИ-агент, база знаний, каналы. Ответ: ready, summary, integrations.required/missing (name, why, connectUrl, alternatives), steps. Ничего не сохраняет.graph_structure graphId, nodeId, retensyAccount
Устройство сценария для правки (GET /api/bots/graphs/{graphId}/structure): блоки (id, type, config с сокращёнными текстами) и связи (from, handle, to). nodeId - полная настройка одного блока. Нужно перед graph_edit (update_node, connect, delete_node, move_branch). Read-only.dialog_recent botId, limit, cursor, retensyAccount
Последние диалоги с подписчиками по всем твоим ботам или по одному (GET /api/bots/dialogs/recent): items[{botId, botName, chatId, username, lastText, lastFrom (subscriber|bot), photo, lastAt, unread}], свежие сверху; следующая страница - cursor=nextCursor. limit 1-50 (по умолчанию 20). Переписка одного диалога - dialog_messages. Read-only.dialog_search q, limit, retensyAccount
Кросс-бот поиск по «Диалогам» (GET /api/bots/dialogs/search): q ищет по имени/username/id подписчика, названию бота И тексту сообщений (а не только карточке подписчика, в отличие от list_bot_users). limit — 1–60 (по умолчанию 40), объединённые результаты, свежие сверху, не постраничный — для большой выгрузки используй audience_search/audience_export. Только боты, доступные тебе. Read-only.
publications_usage botId, retensyAccount
Месячная квота публикаций (GET /api/bots/{botId}/publications/usage) — ОДНА на владельца бота, общая для всех его ботов и платформ (Telegram/MAX channel_post, Instagram, VK — любой публикующий путь списывает её же). {used, limit, unlimited, planCode}; limit=-1/unlimited:true — без лимита. Read-only.vk_status retensyAccount
Подключённые VK-сообщества/страницы аккаунта (GET /api/bots/vk/status) — подключение АККАУНТА, не бота: видно во всех ботах владельца. {connected, accounts: [{id, platform:"vk", label, enabled, isDefault, hasCredentials}]}. Read-only.vk_connect communityId, accessToken, retensyAccount
Подключить VK-сообщество вручную токеном (POST /api/bots/vk/connect-token): communityId, accessToken — токен сообщества с правами wall (и photos, если нужны фото-посты). Токен проверяется живым вызовом VK API перед сохранением — невалидный/без прав → HTTP 422 с причиной от VK, токен не сохраняется и не эхуется. Альтернатива — вход через VK ID (OAuth) в кабинете «Публикации»: по API недоступен, это браузерный флоу.
vk_disconnect accountId, retensyAccount
Отключить VK-сообщество/страницу (DELETE /api/bots/vk/{accountId}); accountId — из vk_status. 404 — не найден/чужой.vk_post accountId, text, mediaUrl, retensyAccount
Опубликовать пост на стену подключённого VK-сообщества/страницы (POST /api/bots/vk/post): accountId (vk_status), text и/или mediaUrl (ТОЛЬКО фото — JPEG/PNG из upload_file; видео/другие типы отклоняются HTTP 422). Списывает publications_usage (резерв до отправки, откат при провале VK). HTTP 402 — квота исчерпана; 422 — VK отклонил (текст ошибки VK как есть).
migration_presets retensyAccount
Каталог поддерживаемых источников миграции (GET /api/bots/migration/presets): BOTHELP|SALEBOT|SENLER|LEADTEH|SMARTSENDER|MANYCHAT|GENERIC — у каждого note (как экспортировать оттуда) и guessed*Headers (подсказки для автосопоставления колонок). Переносятся ТОЛЬКО подписчики (funnelImportSupported всегда false — ни один из этих билдеров не публикует документированный формат экспорта сценария; свои воронки переносятся через import_funnel/create_graph с retensy-bot-graph JSON, это другой формат). Read-only.
migration_preview botId, path, platform, mapping, retensyAccount
Пробный прогон CSV-импорта подписчиков, НИЧЕГО не пишет в базу (POST /api/bots/{botId}/migration/subscribers/preview, multipart). path — локальный CSV (≤10 МБ, ≤20000 строк данных), platform — id из migration_presets. Без mapping — режим определения: headers, sampleRaw (до 5 строк), suggestedMapping (угадан по подсказкам пресета — только подсказка, не контракт). С mapping ({userIdColumn (обязательно — заголовок колонки с числовым chatId), usernameColumn?, tagsColumn?, tagsDelimiter? (по умолч. "|;,"), variableColumns?}) — полный dry-run: validRows, invalidRows (причины, до 20), newSubscribers/existingSubscribers (дедуп по chatId против текущих подписчиков бота), overCapacity (сверх лимита тарифа), remainingCapacity (-1 — безлимит), sample (до 10 строк как они импортируются), totalRowsInFile/truncated.migration_commit botId, path, platform, mapping, retensyAccount
Реальный импорт подписчиков из CSV тем же mapping, что подтвердил migration_preview (POST /api/bots/{botId}/migration/subscribers/commit, multipart) — тот же путь дедупа по chatId/лимита тарифа/«никогда не перезаписывать существующее», что у bot_users_import. Возвращает {totalRowsInFile, processedRows, truncated, result: ImportUsersResponse}.bothelp_scenario_preview botId, scenarioFile, externalRequestsDir, retensyAccount
Dry-run конвертации ОДНОГО сценария BotHelp в граф Retensy (POST /api/bots/{botId}/migration/bothelp/scenario/preview) — НИЧЕГО не пишет в базу. scenarioFile — локальный JSON-дамп bots/<channel>/scenarios/<id>.json (как есть, с полями complexBot/steps); externalRequestsDir — опционально, папка bots/<channel>/external_requests/ (каждый *.json грузится под своим uuid — нужно для шагов make_external_request/send_lead_webhook). Возвращает {bothelpScenarioId, nodeCount, edgeCount, unsupportedCount, partialCount, notes: [{stepId, bothelpKind, severity, message}]} — notes с severity=UNSUPPORTED/PARTIAL перечисляют всё, что сконвертировано приближённо или узлом-заглушкой (см. docs/migration/bothelp/02-mapping.md, 03-gaps.md), прочитай их перед commit.bothelp_scenario_commit botId, scenarioFile, externalRequestsDir, retensyAccount
Реальный импорт: конвертирует сценарий BotHelp (как bothelp_scenario_preview) и сохраняет граф (POST /api/bots/{botId}/migration/bothelp/scenario/commit). Идемпотентно по (botId, bothelpScenarioId=scenario.complexBot.id) — повторный вызов с тем же файлом ОБНОВЛЯЕТ тот же граф вместо дубля (created=false, тот же graphId). Граф создаётся в статусе DRAFT — опубликуй его отдельно (publish_graph) после ручной сверки notes. Возвращает тот же отчёт, что preview, плюс {graphId, created}.zaytsv_migration_preview bundleFile, retensyAccount
Пробный прогон переноса ботов конструктора zaytsv.com в Retensy, НИЧЕГО не пишет (POST /api/bots/migration/zaytsv/preview, только администратор Retensy). bundleFile - локальный JSON-файл выгрузки (docs/migration/zaytsv/export.mongosh.js в репозитории retensy-bots, только чтение из Mongo zaytsv; для preview без токенов, только tokenHash). По каждому боту: найден ли владелец и существующий бот Retensy (совпадение по tokenHash, по одному @username - только NEEDS_REVIEW), сценарии/узлы/рёбра, план по каждому графу (CREATE / REPLACE_STUB / ADD_DRAFT / SKIP_IDENTICAL / ALREADY_IMPORTED), вердикт по существующим графам Retensy (EMPTY_STUB / IDENTICAL / SIMILAR / DIFFERENT по содержимому, не по числу узлов), подписчики (всего, новых, слитых по chatId, заблокированных, сверх лимита), число запусков, которые не переносятся, и список непереносимого (CALL_WEBHOOK, Google Таблицы, медиа zaytsv.ru, состояние ожидания, Instagram, неизвестные узлы).
zaytsv_migration_commit bundleFile, retensyAccount
Реальный перенос ботов zaytsv.com в Retensy тем же планом, что показал zaytsv_migration_preview (POST /api/bots/migration/zaytsv/commit, только администратор). Идемпотентен. Импортирует в существующий бот (по tokenHash), заменяет только пустые заглушки, рядом с настроенным владельцем сценарием кладёт неопубликованный черновик, сливает подписчиков по chatId, перезаливает медиа zaytsv.ru, новые боты создаёт ОСТАНОВЛЕННЫМИ (нужен токен в выгрузке). Ботов не запускает и не останавливает: cutover вручную - стоп бота в zaytsv, затем bot_resume в Retensy. Вызывать только после явного подтверждения владельца по результату preview.
chain_list retensyAccount
Цепочки публикаций пользователя (GET /api/bots/chains): автоматический репост source → граф обработки/назначений. Цепочка привязана к владельцу, не к конкретному боту. Read-only.
chain_get chainId, retensyAccount
Цепочка по id целиком, как хранится в базе — легаси-поля (source/steps/destinations) ИЛИ нативный граф (nodes/edges), смотря что заполнено (GET /api/bots/chains/{id}). Для гарантированно графовой формы (в т.ч. у старых линейных цепочек) используй chain_graph_get. 404 — не своя/не найдена. Read-only.chain_graph_get chainId, retensyAccount
Граф цепочки В ЛЮБОМ случае (GET /api/bots/chains/{id}/graph): {nodes, edges} — если цепочка легаси (линейная), бэкенд синтезирует эквивалентный граф на лету (ничего не сохраняет). Используй это вместо самостоятельной сборки графа из steps/destinations. Read-only.chain_create chain, retensyAccount
Создать цепочку публикаций (POST /api/bots/chains): chain — PublishChain draft, {name, enabled?, approvalMode?: NONE|AI_ONLY|ALL, source: {type: TELEGRAM|VK|RSS, botId?, chatId?, accountId?, rssUrl?}, utmDefaults?, И ЛИБО легаси-поля (steps?, destinations?) ЛИБО нативный граф (nodes?, edges?)}. `source` ВСЕГДА отдельное top-level поле — даже в графовом режиме узел SOURCE в nodes его не дублирует, это просто маркер-корень графа. ГРАФ (nodes непустой — приоритетнее steps/destinations, которые тогда игнорируются): nodes — [{id, type: SOURCE|FILTER|TEXT_TRANSFORM|AI_ADAPT|UTM|DELAY|DESTINATION, x?, y?, step?: {...поля шага, форма как у steps[] в legacy, см. chain_update}, destination?: {id, type: TELEGRAM|MAX|VK|INSTAGRAM|BOT_SUBSCRIBERS, botId?, chatId?, accountId?, segmentId?, notifyPrefix?, minIntervalHours?, utmOverride?, aiOverride?} — только для type=DESTINATION}], edges — [{fromNodeId, toNodeId}]. `x`/`y` (number, опционально) — координаты узла для отрисовки на холсте «Схема»; чисто UI-подсказка, бэкенд их не интерпретирует и не валидирует. Опусти (или оставь null) — фронтенд сам раскладывает узлы BFS-авто-layout'ом по столбцам/строкам; не нужно придумывать координаты самостоятельно. `destination.aiOverride` (опционально, та же форма и в легаси destinations[], см. ниже) — персональная адаптация ИИ ТОЛЬКО для этого назначения: {enabled: bool, aiMode: NONE|LIGHT|FULL, tone?: string, instructions?: string}. null/enabled:false (по умолчанию) — ничего не меняется, применяется только общий узел AI_ADAPT на пути к этому назначению (если он есть), как обычно. enabled:true — ПОСЛЕ результата общего узла (или сырого текста источника, если общего AI_ADAPT на пути нет) вызывается ЕЩЁ ОДНА адаптация ИИ с параметрами override, результат идёт ТОЛЬКО в это назначение — соседние назначения под тем же общим узлом не затрагиваются (означает лишний вызов ИИ и лишнее списание только за это назначение). Используй, когда нужен один общий тон для большинства каналов, но для одного-двух — особый (напр. более формальный) без заведения отдельного AI_ADAPT узла в графе. Модель — дерево-с-ветвлением (out-tree), НЕ произвольный DAG: у любого не-SOURCE узла ровно ОДНО входящее ребро; ветвление — через НЕСКОЛЬКО исходящих у одного родителя (напр. один общий AI_ADAPT → много DESTINATION = «1 источник → общий ИИ → N каналов»); слияния путей (несколько родителей) нет. Перед сохранением сложного графа прогони chain_validate (клиентское зеркало серверных правил) и chain_destinations_catalog (список доступных назначений). Для быстрого создания черновика без источника/назначений (поток «создать → сразу в Схему») используй chain_create_draft вместо этого инструмента. ЛЕГАСИ (nodes пуст): destinations: [{type: TELEGRAM|MAX|VK|INSTAGRAM|BOT_SUBSCRIBERS, botId?, chatId?, accountId?, segmentId?, notifyPrefix?, minIntervalHours?, utmOverride?, aiOverride?}], steps?: [{type: FILTER|TEXT_TRANSFORM|AI_ADAPT|UTM|DELAY, ...поля шага}]. `aiOverride` работает в легаси-режиме так же, как в графоchain_create_draft name, sourceBotId, sourceChatId, instagramAccountId, retensyAccount
Создать минимальный черновик цепочки (POST /api/bots/chains/draft) по имени: {name}. Возвращает PublishChain с enabled=false, source={type:TELEGRAM} БЕЗ конкретного botId/chatId, без steps/destinations/nodes/edges — обходит обычную валидацию chain_create (которая потребовала бы источник и ≥1 назначение). Только для потока «новая цепочка → сразу открыть на холсте „Схема“ и донастроить источник/назначения там» — черновик не может случайно уйти в работу недонастроенным (enabled всегда false, обычный chain_update с теми же правилами валидации, что и chain_create, не даст сохранить его без источника и назначений). Для обычного создания цепочки сразу с источником и назначениями используй chain_create.instagram_status retensyAccount
Статус Instagram для цепочек (GET /api/bots/chains/instagram-status): enabled на сервере, подключённые аккаунты {accountId, username}, connectPath для подключения (только по ссылке; пока бета — ник нужно добавить в тестеры через поддержку). В Instagram уходят только посты с фото или видео. Read-only.chain_update chainId, chain, retensyAccount
Изменить цепочку целиком (PUT /api/bots/chains/{id}): chain — PublishChain draft (та же форма, что в chain_create, легаси ИЛИ граф), заменяет текущую конфигурацию полностью — сначала прочитай chain_get (или chain_graph_get, если нужен гарантированно графовый вид) и поменяй нужное. Те же 400/409, что у chain_create (включая x?/y? на узлах и aiOverride? на destination — см. chain_create).chain_delete chainId, confirm, retensyAccount
УДАЛИТЬ цепочку публикаций (DELETE /api/bots/chains/{id}). История заданий (chain_runs) теряется вместе с ней. Необратимо: только по явной просьбе, с confirm:true.chain_enable chainId, confirmToken, retensyAccount
Включить цепочку (POST /api/bots/chains/{id}/enable) — начинает принимать новые посты источника (TELEGRAM — сразу по событию, VK/RSS — со следующего опроса, раз в 3 мин).chain_pause chainId, retensyAccount
Поставить цепочку на паузу (POST /api/bots/chains/{id}/pause) — перестаёт принимать новые посты источника (VK/RSS — опрос останавливается, TELEGRAM — события игнорируются); история и настройки сохраняются.chain_runs chainId, page, size, retensyAccount
История заданий цепочки (GET /api/bots/chains/{id}/runs), новые сверху: [{id, status: PENDING|RUNNING|DONE|FAILED|AWAITING_APPROVAL|SKIPPED, originId, destinationId, lastError, reviewedBy, reviewedAt…}]. Бэкенд отдаёт всю историю без постраничной выдачи на сервере — page (с 0)/size (по умолчанию 20) режут список уже здесь, в MCP, чтобы не упираться в лимит токенов на цепочке с долгой историей; без них — список целиком. Read-only.chain_approve jobId, retensyAccount
Согласовать задание, ждущее подтверждения (approvalMode AI_ONLY/ALL) — POST /api/bots/chains/jobs/{jobId}/approve: AWAITING_APPROVAL → PENDING, подхватится ближайшим тиком исполнения (раз в 15 сек). jobId — из chain_runs. HTTP 400 — задание сейчас не ждёт согласования.chain_reject jobId, retensyAccount
Отклонить задание, ждущее подтверждения — POST /api/bots/chains/jobs/{jobId}/reject: AWAITING_APPROVAL → SKIPPED, публикации не будет. jobId — из chain_runs. HTTP 400 — задание сейчас не ждёт согласования.chain_retry jobId, retensyAccount
Повторить проваленное задание вручную, минуя бэкофф (POST /api/bots/chains/jobs/{jobId}/retry): сбрасывает lastError, задание подхватится ближайшим тиком исполнения. jobId — из chain_runs (status FAILED).Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Files it wrote
/tmp/ .retensy-bot-graph/ update-check.json
Paths inside its sandbox, where its home folder is /tmp and its own folder cannot be written to.
Install facts
| License | MIT |
|---|---|
| Needs | node >=18 |
| Source | github.com/retensy/retensy-mcp |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-ocyAqwhjoxjvkj7ZYxtN0ZvTJ5NydugAmGkHcp/pK4CiQlqwk4kMBBtd/xCqVHbY9ajN95a929JV6Do23lCjiQ== |
Versions reported
| Version | Run | Result | Tools |
|---|---|---|---|
| 0.64.2 | 2026-11-16 | Starts with no setup | 200 |
| 0.62.0 | 2026-11-12 | Starts with no setup | 200 |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/%40retensy/mcp)
New version out? Ask for a fresh report.