Что такое скрипты Coverse

Скрипт — это программа на JavaScript, которая хранится в таблице Coverse и выполняется на сервере Coverse. Скрипт берёт на себя повторяющуюся работу: собирает отчёты, переносит и проверяет данные, раскрашивает строки, рассылает уведомления, принимает заявки из других сервисов.

Что умеет скрипт

• Работать с данными таблицы: читать и записывать значения и формулы, добавлять, удалять и переносить строки и столбцы, создавать, копировать и скрывать листы. См. Чтение и запись данных.
• Оформлять и упорядочивать: цвет, шрифт, числовые форматы, границы, объединение ячеек, подсветка по условию, фильтры, сортировка, выпадающие списки, флажки, сводные таблицы, диаграммы, защита. См. Оформление и структура листа.
• Запускаться сам: по расписанию, при изменении таблицы, при отправке формы, при открытии таблицы и по запросу из внешнего сервиса. См. Триггеры и Вебхуки.
• Запускаться по кнопке: из меню «Макросы», кнопкой-картинкой на листе или сочетанием клавиш. См. Макросы, кнопки и сочетания клавиш.
• Связываться с внешним миром: HTTP-запросы к сервисам, сообщения в Telegram, письма на почту, запросы к ИИ. См. Внешние сервисы, Telegram и почта и ИИ в скриптах.
• Хранить состояние и ключи: «Память» для значений между запусками и «Секреты» для токенов и паролей. См. Память скрипта и Секреты.
• Работать с другими таблицами и использовать общий код из библиотек рабочего пространства. См. Другие таблицы и Библиотеки.

Где найти скрипты

• В таблице: откройте настройки таблицы (⋯ справа сверху) и выберите «Скрипты» в блоке «Автоматизация и API». Пока в таблице нет макросов, панель скриптов открывается и из меню «Макросы» (значок ▶ на панели инструментов) кнопкой «Открыть скрипты».
• В рабочем пространстве: раздел «Автоматизация» в левом меню. Там собраны все скрипты пространства, общий журнал запусков и библиотеки.

Тариф

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

На тарифе «Бизнес» скриптам владельца даётся 300 минут работы в сутки на все таблицы. Сколько уже израсходовано, видно в панели скриптов: «Сегодня: N мин из 5 ч». Все ограничения собраны в статье Лимиты.

Как устроен запуск

1. Вы нажимаете «Запустить», срабатывает триггер или приходит вебхук.
2. Запуск встаёт в очередь и выполняется в изолированной среде на сервере. Скрипт не видит других клиентов, файловой системы и внутренних сетей.
3. Скрипт работает с таблицей через команды Coverse.table, Http, Mail и другие. Один запуск длится не больше 30 секунд.
4. Результат, вывод console.log и ошибки попадают в журнал скрипта.

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

Кто что может

Действие	Владелец скрипта	Редактор таблицы	Читатель
Видеть список скриптов и код	да	да	нет
Создавать и менять скрипты	да	да	нет
Запускать скрипты и макросы	да	да	нет
Настраивать триггеры	да	да	нет
Добавлять другие таблицы на вкладке «Таблицы»	да	нет	нет
Подтверждать код после чужих правок	да	нет	нет

Скрипты, API и AI-агенты

	Скрипты	API	AI-агенты (MCP)
Где выполняется	на сервере Coverse	в вашей системе	в ИИ-ассистенте (Claude, ChatGPT и др.)
Нужен свой сервер	нет	да	нет
Кто пишет логику	вы или ИИ в редакторе	ваш разработчик	ИИ-агент по вашей просьбе
Запуск по расписанию и событиям	встроен	делаете сами, вебхуки есть	нет
Подходит для	автоматизации внутри таблиц	интеграции с 1С, CRM, сайтом	разовых задач голосом или текстом

Скрипты и API можно сочетать: например, внешняя система пишет заказы через API, а скрипт при изменении листа раскрашивает строки и уведомляет менеджера в Telegram.

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

Что такое скрипты в Coverse?

Скрипт — программа на JavaScript, которая хранится в таблице Coverse и выполняется на сервере: по кнопке, по расписанию, при изменении ячеек, после ответа формы или по вебхуку. Он читает и меняет данные, оформляет листы, отправляет сообщения в Telegram и письма, обращается к внешним сервисам и к ИИ.

На каком тарифе доступны скрипты?

Скрипты работают, если у владельца рабочего пространства тариф «Бизнес» или выше. Скриптам владельца таблицы даётся 300 минут работы в сутки на все таблицы.

Нужно ли уметь программировать?

Нет. Опишите задачу словами, и ИИ в редакторе напишет скрипт с названиями листов и столбцов вашей таблицы. См. Скрипт с помощью ИИ.

Что дальше

• Первый скрипт: пошаговый пример.
• Скрипт с помощью ИИ: описать задачу словами.
• Готовые сценарии: примеры кода для типовых задач.