ДокументацияНастройка проекта
Плагины
Плагин — дополнение кабинета, которое вы делаете под себя: кнопка «Выгрузить в 1С» в карточке клиента, своё поле «ИНН», отчёт в меню, панель с данными из своей системы, кнопка в шапке рассылок. Код плагина пишет ИИ по готовой инструкции, а вы загружаете архив в «Настройки → Плагины» и решаете, что ему можно.
Плагины есть на тарифах «Рост» и «Всё включено», в «Собери сам» — модулем «Плагины», если сумма тарифа не меньше «Роста». Сколько плагинов работает одновременно, тоже задаёт тариф: в «Росте» и «Собери сам» — до 3 включённых, во «Всё включено» — до 10, пакет «+5 плагинов» добавляет ещё пять. Загрузить можно и больше — лимит считает только включённые. В демо плагины не включаются. Устанавливает, настраивает и выключает плагины только администратор; остальные сотрудники видят их кнопки и экраны.
Что умеет плагин
- добавить свой экран в меню — группа «Плагины»;
- добавить свою вкладку в раздел рядом со встроенными: отчёт в «Аналитике», вкладку в «Продажах», «Рассылках», «Курсах» или «Кураторах»;
- встроить панель и кнопки в карточку клиента в «Диалогах» и в блок «Сделка»;
- поставить кнопку в шапку переписки, в шапку любого раздела меню и в строку списка рассылок или сотрудников;
- добавить своё поле клиента или сделки — оно видно в карточке и доступно в воронках как переменная;
- скрыть или переименовать встроенный элемент — поле карточки, этап продаж, пункт меню;
- завести свой раздел в «Настройках»;
- сам отвечать на события — оплата прошла, тег поставлен, клиент дошёл до этапа — и запускаться по расписанию;
- открыть нужное место кабинета: карточку клиента, рассылку, воронку, раздел меню или свой экран — например, по нажатию на строку своей таблицы;
- отдать файл — таблицу CSV или Excel, отчёт в PDF, выгрузку в JSON или текстом;
- работать с задачами и людьми: смотреть сотрудников, назначать клиенту менеджера, ставить и закрывать задачи;
- собрать черновик рассылки по своему списку клиентов и показать итоги рассылок и воронок за период.
Запустить рассылку плагин не может. Черновик появляется в «Рассылках», проверяет и отправляет его сотрудник кнопкой «Запустить рассылку» — как любой другой черновик.
Как сделать плагин с ИИ
- Нажмите «Скопировать промт для ИИ» — здесь или в «Настройки → Плагины».
- Вставьте промт в чат с ChatGPT или Claude и опишите обычными словами, что нужно: где кнопка, что она делает, какие данные показать. ИИ соберёт архив .zip с плагином.
- В «Настройки → Плагины» нажмите «Загрузить плагин (.zip)». TERVIO проверит архив; если что-то не так — покажет ошибки: скопируйте их и отправьте тому же ИИ.
- Проверьте экран установки: права, домены и места встраивания. Заполните настройки и нажмите «Установить плагин».
- Нужно поправить — опишите правку ИИ и загрузите новую версию тем же способом.
Агент ИИ, подключённый по 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 КБ.