Что можно использовать при сборке: виды узлов сценария с полным составом их настроек, заготовки сценариев, виды ИИ-сервисов с нужными ключами и каталог прав. Смотрите node_kinds перед тем, как собирать или править сценарий: config каждого узла описан именно там.

Открывает окно входа в панель operbots прямо здесь: адрес, почта и пароль. Пароль вводит человек, он уходит прямо на его панель и в переписку не попадает; на диск ложится только токен обновления. Вызывайте, когда другие инструменты сообщают, что вход не выполнен или сессия больше не действует.

Завершает сессию этого клиента в панели и стирает сохранённый доступ с машины. Чтобы работать дальше, придётся войти заново.

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

Все действующие сессии учётной записи: браузеры и MCP-клиенты. Показывает устройство, адрес и срок. Позволяет заметить лишнее подключение и отозвать его.

Завершает сессию по идентификатору из sessions_list. Отозванный клиент теряет доступ при следующем обновлении токена. Отозвав собственную сессию, придётся входить заново.

Меняет ФИО, телефон и часовой пояс учётной записи. Передавайте только те поля, которые нужно изменить: остальные останутся как есть.

Все дела, к которым есть доступ, с ролью, правами и счётчиками ботов и непрочитанного.

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

Без указания дела создаёт новое (вы становитесь владельцем, разворачиваются пять ролей: владелец, администратор, конструктор, оператор, наблюдатель). С указанием — меняет название, описание, знак и оформление или убирает дело в архив.

Удаляет дело целиком: боты, сценарии, переписка, участники и роли. Восстановить нельзя. Чтобы просто убрать дело из списка, используйте cases_save с archived=true.

Убирает вас из числа участников дела. Владелец выйти не может — сначала нужно передать дело другому участнику (case_transfer).

Кто состоит в деле, с какой ролью и какими итоговыми правами; какие роли заведены в деле и какие ссылки-приглашения действуют. Разделы, на которые не хватает прав, помечаются как недоступные.

Без параметра member добавляет в дело уже зарегистрированного человека по почте. С параметром member меняет его роль и точечные права поверх роли. Если человек ещё не зарегистрирован, создайте ссылку-приглашение через invites_create.

Убирает человека из дела. Он теряет доступ ко всем ботам, сценариям и переписке дела. Владельца исключить нельзя.

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

Заводит в деле свою роль с нужным набором прав или меняет существующую. Готовые роли (владелец, администратор, конструктор, оператор, наблюдатель) правке не поддаются — укажите copy_of, чтобы сделать копию пресета и настроить её.

Удаляет роль дела. Готовые роли удалить нельзя, и роль с участниками — тоже: сначала переведите людей на другую роль.

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

Гасит ссылку-приглашение: перейти по ней больше не получится.

Боты дела: состояние, режим работы, число диалогов и непрочитанного.

Бот целиком: настройки, меню команд, переменные контента и список сценариев. Значения переменных, отмеченных как секретные, скрыты.

Без параметра bot подключает нового бота по токену от @BotFather — токен проверяется живым запросом к Telegram и хранится зашифрованным. С параметром bot меняет настройки. Смена токена или режима перезапускает работающего бота.

Запускает, останавливает или перезапускает бота, а также отправляет меню команд в Telegram. Запуск сам синхронизирует меню; отдельная синхронизация нужна после правки команд у уже работающего бота.

Приводит меню команд бота к переданному списку: недостающие команды добавляет, существующие обновляет, порядок расставляет по порядку в списке. Команды, которых нет в списке, сохраняются — чтобы удалить их, передайте remove_missing=true. Само меню в Telegram обновляется, только если sync=true или бот перезапущен.

Задаёт переменные, которые подставляются в тексты сценария: цены, адреса, ссылки. Существующие ключи обновляются, новые создаются. Отмеченные секретными не показываются обратно. Ключ: латиница, цифры, подчёркивание и точка.

Возвращает токен Telegram в открытом виде. Токен даёт полное управление ботом — запрашивайте его, только если пользователь прямо об этом попросил, и не пересказывайте без надобности.

Выдаёт боту новый секретный адрес вебхука. Прежний перестаёт работать навсегда — это нужно, если старый адрес утёк. Работающий бот перезапускается.

Убирает бота из дела вместе с командами и переменными. Диалоги и переписка удаляются. Восстановить нельзя. Чтобы временно выключить, используйте bots_save enabled=false.

Какие сценарии заведены у бота, какой из них в работе и сколько в них узлов.

Сценарий целиком: все узлы с их параметрами, все связи и замечания к графу — связи в никуда, отсутствие триггера, недостижимые узлы.

Без параметра flow создаёт сценарий — из заготовки (template) или из переданного графа. С параметром flow перезаписывает его. Граф передаётся ЦЕЛИКОМ: чтобы поправить один узел, сначала прочитайте сценарий через flows_get и пришлите изменённый список полностью. Новая редакция создаётся, только если граф действительно изменился. Сохранение не включает сценарий в работу — для этого есть flows_publish.

Включает сценарий в работу — остальные сценарии бота при этом выключаются, активным может быть только один. Перед включением граф проверяется: связи на несуществующие узлы не дадут опубликовать. Выключение оставляет бота без полотна, и он перестаёт отвечать.

Все сохранённые редакции сценария с комментариями и датами.

Возвращает граф сценария к выбранной редакции. История не переписывается — поверх создаётся новая редакция. Если сценарий в работе, бот начнёт вести себя по-старому сразу.

Проверяет сценарий без Telegram: какой триггер сработал, какие шаги прошли и что бот ответил бы. Диалог нигде не сохраняется, задержки пропускаются, запросы к внешним адресам не выполняются. Внимание: узлы с ИИ обращаются к настоящей модели и расходуют её лимиты.

Удаляет сценарий вместе со всей историей редакций. Восстановить нельзя. Если удалить работающий сценарий, бот останется без полотна.

Переписки ботов дела с отбором по боту, режиму и подстроке. Показывает, где есть непрочитанное и какие диалоги ведёт оператор.

Диалог и его положение в сценарии: на каком шаге стоит разговор, какого ответа ждёт, какой путь уже пройден, что запланировано и какие переменные накоплены.

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

Отправляет сообщение человеку от имени бота. По умолчанию диалог переходит в ручной режим и закрепляется за вами — сценарий перестаёт вести разговор, пока его не вернут (dialogs_update mode=bot). Бот должен быть запущен. Проверяйте поле «ошибка доставки» в ответе: сообщение сохраняется даже тогда, когда Telegram его не принял.

Меняет режим ведения (сценарий или оператор), отвечает ли ИИ, метки, закрепление и блокировку. Перевод в режим bot возвращает разговор сценарию и снимает оператора.

Удаляет диалог вместе со всей перепиской. Восстановить нельзя. Чтобы просто перестать получать сообщения, используйте dialogs_update blocked=true.

Что запланировано в деле: «написать через три дня», «напомнить, если не ответил». Показывает и выполненные, и отменённые — отбирайте по статусу.

Снимает запланированное действие: бот не отправит то, что собирался.

Без параметра base — все базы знаний дела с их настройками. С параметром base — ещё и список материалов с состоянием разбора.

Без параметра base создаёт базу, с параметром — меняет её настройки. Для поиска базе нужно подключение к ИИ-сервису, умеющему считать векторы. Подключение можно сменить только у пустой базы: векторы разных моделей несопоставимы. После правки размера куска старые материалы нужно пересобрать через knowledge_reindex.

Кладёт в базу текст или страницу по ссылке. Разбор идёт в фоне: сразу после добавления материал в состоянии pending, проверьте его позже через knowledge_list. Повторный вызов создаёт дубликат, а не обновляет прежний материал.

Ставит материалы в очередь на повторный разбор. Нужно после смены размера куска или подключения к ИИ-сервису: старые фрагменты нарезаны по-прежнему. Без параметра document пересобирается вся база.

Показывает, какие фрагменты база подставит модели в ответ на такой вопрос. Так проверяют, что материалы разобраны и порог близости выбран верно. Если база выключена или векторы не считаются, ответ будет пустым без ошибки.

С параметром document удаляет один материал, без него — базу знаний целиком вместе со всеми материалами и векторами. Восстановить нельзя.

Какие ИИ-сервисы подключены к делу, с какими моделями и сколько ботов их используют. Ключи не показываются — только последние символы.

Без параметра provider подключает новый сервис, с ним — меняет настройки. Какие ключи нужны: gigachat — authorization_key (обязательно), scope (по умолчанию GIGACHAT_API_PERS); yandexgpt — api_key (обязательно), folder_id (обязательно); openai — api_key (обязательно); openrouter — api_key (обязательно); custom — api_key (по желанию); обязателен base_url. При изменении переданные ключи дописываются поверх прежних, а стереть ключ пустой строкой нельзя — только перезаписать.

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

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