ДокументацияНастройка проекта

Плагины

для администратора школы

Плагин — дополнение кабинета, которое вы делаете под себя: кнопка «Выгрузить в 1С» в карточке клиента, своё поле «ИНН», отчёт в меню, панель с данными из своей системы, кнопка в шапке рассылок. Код плагина пишет ИИ по готовой инструкции, а вы загружаете архив в «Настройки → Плагины» и решаете, что ему можно.

Плагины есть на тарифах «Рост» и «Всё включено», в «Собери сам» — модулем «Плагины», если сумма тарифа не меньше «Роста». Сколько плагинов работает одновременно, тоже задаёт тариф: в «Росте» и «Собери сам» — до 3 включённых, во «Всё включено» — до 10, пакет «+5 плагинов» добавляет ещё пять. Загрузить можно и больше — лимит считает только включённые. В демо плагины не включаются. Устанавливает, настраивает и выключает плагины только администратор; остальные сотрудники видят их кнопки и экраны.

Что умеет плагин

  • добавить свой экран в меню — группа «Плагины»;
  • добавить свою вкладку в раздел рядом со встроенными: отчёт в «Аналитике», вкладку в «Продажах», «Рассылках», «Курсах» или «Кураторах»;
  • встроить панель и кнопки в карточку клиента в «Диалогах» и в блок «Сделка»;
  • поставить кнопку в шапку переписки, в шапку любого раздела меню и в строку списка рассылок или сотрудников;
  • добавить своё поле клиента или сделки — оно видно в карточке и доступно в воронках как переменная;
  • скрыть или переименовать встроенный элемент — поле карточки, этап продаж, пункт меню;
  • завести свой раздел в «Настройках»;
  • сам отвечать на события — оплата прошла, тег поставлен, клиент дошёл до этапа — и запускаться по расписанию;
  • открыть нужное место кабинета: карточку клиента, рассылку, воронку, раздел меню или свой экран — например, по нажатию на строку своей таблицы;
  • отдать файл — таблицу CSV или Excel, отчёт в PDF, выгрузку в JSON или текстом;
  • работать с задачами и людьми: смотреть сотрудников, назначать клиенту менеджера, ставить и закрывать задачи;
  • собрать черновик рассылки по своему списку клиентов и показать итоги рассылок и воронок за период.

Запустить рассылку плагин не может. Черновик появляется в «Рассылках», проверяет и отправляет его сотрудник кнопкой «Запустить рассылку» — как любой другой черновик.

Как сделать плагин с ИИ

  1. Нажмите «Скопировать промт для ИИ» — здесь или в «Настройки → Плагины».
  2. Вставьте промт в чат с ChatGPT или Claude и опишите обычными словами, что нужно: где кнопка, что она делает, какие данные показать. ИИ соберёт архив .zip с плагином.
  3. В «Настройки → Плагины» нажмите «Загрузить плагин (.zip)». TERVIO проверит архив; если что-то не так — покажет ошибки: скопируйте их и отправьте тому же ИИ.
  4. Проверьте экран установки: права, домены и места встраивания. Заполните настройки и нажмите «Установить плагин».
  5. Нужно поправить — опишите правку ИИ и загрузите новую версию тем же способом.

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

Безопасность

  • Код плагина работает в отдельной закрытой рамке, а не на странице кабинета. Он не видит вход сотрудника, пароли и токены, не может открыть другие разделы и не обращается к серверу в обход TERVIO.
  • Кнопки, пункты меню и поля рисует сам кабинет — только текстом. Плагин не может подменить страницу кабинета или вставить на неё свою разметку.
  • Экран плагина — одна страница. Если плагин пытается открыть внутри себя другую страницу или чужой сайт, кабинет закрывает экран и предлагает загрузить его снова: чужой сайт под рамкой кабинета мог бы выдать себя за TERVIO.
  • Всё, что нужно плагину, он просит у TERVIO, и TERVIO проверяет права на каждый запрос.
  • Секретные настройки (ключи, пароли от своей системы) после сохранения не показываются никому — ни вам, ни коду плагина в кабинете: сервер подставляет их в запрос сам и только в серверной части плагина. Сотрудник с экрана плагина ключом администратора не воспользуется.
  • Ответы на события (оплата прошла, новый клиент) зовёт только TERVIO: кнопкой их не запустить, поэтому выдуманное событие во внешнюю систему не уйдёт. Ушёл администратор, который ставил плагин, — фоновая работа плагина останавливается, пока его не переустановит другой администратор.
  • Открыть плагин может только экран самого кабинета: карточку, рассылку, воронку, раздел или свой экран. Адрес собирает TERVIO по номеру карточки или названию раздела — увести сотрудника на чужой сайт этим способом нельзя.
  • Файл сохраняет сам кабинет и только таблицей, PDF, JSON или текстом. Веб-страницы, картинки SVG, программы и скрипты плагин отдать не может.
  • Всё, что сделал плагин, записывается в «Журнал действий» с автором «плагин» и в журнал вызовов плагина.

Права

Права плагина — те же уровни по разделам, что у ключа агента:

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

Кнопка или экран плагина работают с теми правами, что есть и у плагина, и у сотрудника, который нажал: оператор без доступа к рассылкам не запустит рассылку и через плагин. Серверные функции и ответы на события работают с правами плагина. Событие плагин получает, только если может смотреть его данные: ответ клиента в воронке — с «Перепиской», оплату и новых клиентов — с «Клиентами и сделками». Новая версия, которая просит больше прав, новые адреса или новые события, не включится без вашего подтверждения — на экране подтверждения ровно та версия, что включится.

Домены: данные наружу

Плагин отправляет данные во внешнюю систему только через сервер TERVIO и только на адреса, перечисленные в его описании. При установке TERVIO показывает их с предупреждением: «Плагин сможет отправлять данные ваших клиентов на эти адреса — проверьте, что доверяете им». Новый адрес в новой версии — снова ваше подтверждение. Только https, только стандартный порт; звёздочка на общих хостингах (github.io, vercel.app и подобных, где сайт заводит кто угодно) запрещена — нужен точный адрес.

Плагин может открыть ссылку в новой вкладке, а в ссылку — положить данные. Браузер этого не запрещает, поэтому ставьте плагины, которые сделали вы сами или те, кому вы доверяете.

Где встраивается

  • Меню — свой раздел со своим адресом — его можно отправить коллеге. Встаёт в группу «Плагины» или в любую группу меню рядом с нужным разделом: например, в «Маркетинг» сразу под «Рассылками». Над экраном всегда подписано «плагин «…»», а называться как встроенный пункт меню или как «Настройки», «Сотрудники», «Журнал действий» плагин не может;
  • Вкладка в разделе — своя вкладка рядом со встроенными — в «Аналитике» (в списке отчётов, группа «Плагины»), «Продажах», «Рассылках», «Курсах» и «Кураторах». У вкладки свой адрес, его можно отправить коллеге. У подписи вкладки — значок плагина, над экраном — «плагин «…»»; называться как встроенная вкладка раздела или «Настройки» вкладка плагина не может;
  • Карточка клиента — панель, кнопки и свои поля — в «Диалогах», в карточке справа;
  • Карточка сделки — панель, кнопки и свои поля — в блоке «Сделка» той же карточки (его открывают и из «Продаж»);
  • Шапка переписки — кнопка «Действия плагинов» рядом с поиском по переписке;
  • Шапка раздела — кнопки в шапке «Диалогов», «Продаж», «Сценариев», «Рассылок», «Курсов», «Кураторов», «Онлайн-трансляций», «Сайтов», «Аналитики», «Ботов», «Аккаунтов», «Сотрудников»;
  • Строка списка — действие над рассылкой или сотрудником;
  • Настройки — свой раздел под «Плагинами».

Свои поля хранятся в переменных карточки с именем plugin.ключ-плагина.поле — их видно в «Переменных» и можно подставлять в сообщения воронок. Скрыть плагин может поля карточек, этапы продаж и пункты меню — только с вида: права сотрудников от этого не меняются. «Настройки», «Плагины», «Сотрудников», «Журнал действий» и «Агентов ИИ» плагин не прячет и не переименовывает: там вы видите, кто что сделал и кому что разрешено, и выключаете сам плагин.

Переходы и файлы

Плагин может открыть место кабинета: карточку клиента, рассылку в списке «Рассылок», воронку на холсте, раздел меню или свой экран. Например, в отчёте плагина нажали на клиента — открылась его переписка, а кнопка «Назад» в чате вернула к отчёту.

Файл плагин собирает у себя, а сохраняет кабинет — как обычную загрузку браузера, в папку загрузок. Можно таблицы CSV и Excel, PDF, JSON и текст, до 5 МБ, не больше 5 файлов в минуту. Таблицу CSV TERVIO сохраняет так, чтобы Excel сразу показал русские буквы. После сохранения появляется уведомление «Файл «…» сохранён» с именем плагина.

Данные проекта

Плагин видит и меняет только то, на что вы дали права при установке. Кроме клиентов, сделок, переписки и воронок ему доступны:

  • сотрудники проекта — чтобы выбрать, кому назначить клиента или задачу;
  • менеджер клиента — плагин может назначить его, как это делают в карточке;
  • задачи — список, новая задача, отметка «выполнено»;
  • черновик рассылки по списку клиентов — запускает его только сотрудник;
  • итоги рассылок и воронок за период — для своих отчётов и таблиц.

Версии

Каждая загрузка — новая версия; прежние остаются. В карточке плагина, во вкладке «Версии», любую можно вернуть кнопкой «Вернуть эту версию». Во вкладке «Журнал» — каждый вызов: кто нажал, что плагин сделал и чем кончилось.

Как отключить

  • Плагин не отвечает — вместо его панели появится «Плагин не ответил»; остальной TERVIO работает. Администратору там же видна кнопка «Отключить плагин», остальным — подсказка позвать администратора.
  • В «Настройки → Плагины» откройте плагин и нажмите «Выключить плагин»: его кнопки, поля и панели пропадут у всех сотрудников сразу. Включается обратно той же кнопкой.
  • «Удалить плагин» убирает его вместе с версиями и настройками. Данные, которые он записал в карточки клиентов, остаются.
  • Нашли в плагине проблему — TERVIO может выключить его во всех проектах сразу, в том числе копию под другим именем. Данные и настройки при этом сохраняются.

Ограничения

  • архив — до 2 МБ и 200 файлов, без внешних скриптов и шрифтов;
  • не больше 60 запросов в минуту на плагин у одного сотрудника;
  • файл от плагина — до 5 МБ и не больше 5 файлов в минуту;
  • серверная функция — до 2 секунд счёта и 30 секунд вместе с ответами внешних сервисов; кнопки — до 300 запусков в час, ответы на события и расписание — свои 300 в час (лишние события ждут, а не теряются);
  • тег плагин ставит только существующий — новые теги заводят в «Справочниках»;
  • хранилище плагина общее для сотрудников проекта: что в нём лежит, видит любой, у кого открыт экран плагина;
  • своё хранилище плагина — до 5 000 записей по 10 КБ.