Synchra.24
menu_bookDocumentación
Практические материалы по запуску и развитию

Здесь собраны инструкции по запуску, разработке внутренних сценариев и встраиванию собственных инструментов в рабочий контур компании.

folderServicios integrados

Editor de servicios y AI

Creación de un Servicio integrado, Editor de código, vista previa, asistente de IA y publicación de borrador.

La traducción no está disponible. Se muestra el original.

В Администратор → Сервисы можно подключить готовое приложение по ссылке или создать встроенный сервис. Встроенный сервис работает внутри Synchra24 и не требует отдельного сервера приложения.

В облачной Synchra24 основные сервисы работают в нескольких экземплярах. При недоступности одного сервера запросы могут обслуживаться оставшимися экземплярами; сохранённые данные при этом общие. Текущий запрос или открытое соединение могут прерваться: обновите экран и проверьте результат перед повторной отправкой действия. Для работы всё равно нужен доступ к интернету; резервирование серверов не исключает общих сбоев связи и внешних сервисов. Доступ к сервису по-прежнему определяется подпиской и правами сотрудника.

Два способа подключения

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

HTML, CSS и JavaScript — создание приложения в редакторе Synchra24. Можно загрузить готовые файлы, импортировать ZIP-шаблон или попросить AI-помощника подготовить код. В компании может быть до 100 активных встроенных сервисов.

Для управления сервисами нужны возможность Приложения в подписке и право редактирования сервисов. Для AI-помощника также нужен AI-ассистент. Администратор выбирает, каким сотрудникам доступен сервис.

После сохранения или публикации появится уведомление с результатом. Если возникла ошибка, внесённые изменения можно проверить и сохранить повторно.

Редактор

Создайте встроенный сервис и укажите название и иконку. Под названием можно добавить необязательное описание до 300 символов. В веб-версии оно появится под заголовком открытого сервиса. Если описание не заполнено, дополнительная строка не показывается.

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

При создании и в настройках сервиса задайте платформы показа: Разрешить в веб-версии и Разрешить в мобильной версии работают независимо. Для виджета они находятся в плашке Настройки виджета, для обычного сервиса — Доступность сервиса. По умолчанию мобильный показ включён, веб-показ выключен; у существующих сервисов прежний веб-показ сохраняется. Выключение платформы скрывает сервис на ней, сохраняя код, данные и возможность редактирования администратором. Эти настройки не заменяют требования подписки и доступа сотрудника.

В редакторе доступны вкладки:

  • HTML — содержимое страницы;
  • CSS — оформление страницы;
  • JavaScript — поведение страницы и работа с данными;
  • Переменные — общие данные для кода конкретного сервиса в компании;
  • События — определения событий, вызываемых из кода для запуска автоматизаций.

Редакторы поддерживают подсветку кода, отступы и сворачивание блоков. Встроенные библиотеки и работа с данными описаны отдельно в статье «Код, библиотеки и SDK».

Кнопка Загрузить код из файлов позволяет выбрать HTML, CSS и JavaScript. Можно загрузить несколько файлов, но только один файл каждого типа. Они заменят содержимое соответствующих вкладок. При ошибке загрузки прежний код сохранится. Общий объём исходников — до 5 МиБ.

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

Кнопка Экспортировать код в ZIP скачивает код из редактора, включая несохранённые правки. Архив можно использовать как шаблон для нового сервиса. Доступ сотрудников нужно настроить заново. Экспорт не сохраняет и не публикует сервис.

Кнопка Форматировать в панели каждого редактора расставляет отступы и выравнивает HTML, CSS или JavaScript. При ошибке синтаксиса исходный текст сохраняется, а редактор показывает причину. Форматирование не сохраняет и не публикует сервис автоматически.

Примеры работы с данными, темой и библиотеками приведены в статье «Код, библиотеки и SDK».

Предпросмотр

Предпросмотр показывает, как сервис выглядит на экране телефона. Рядом находится панель сообщений и ошибок, которая помогает проверить его работу. На узком экране она располагается ниже предпросмотра.

Предпросмотр использует тестовые артефакты. Рабочие данные компании при такой проверке не меняются. Пример тестовых данных:

{"warehouse.stock":{"items":[{"sku":"A01","quantity":12}]}}

Кнопка Обновить предпросмотр перезапускает проверку с текущим кодом и тестовыми данными. То же действие выполняет Ctrl+S (Cmd+S на Mac), когда курсор находится в редакторе. Это обновляет предпросмотр, но не сохраняет черновик и не публикует сервис.

AI-помощник

Кнопка со звёздочками открывает AI-помощника. Опишите, что должен делать сервис, например: «Покажи остатки товаров, добавь поиск и выдели товары, которых мало». Помощник подготовит предложение на основе текущего кода.

AI возвращает предложение и краткое описание. Посмотрите предложенный код и нажмите Применить к черновику. Затем проверьте предпросмотр, сохраните и опубликуйте. Генерация сама не меняет рабочую версию и не предоставляет дополнительных прав пользователю.

Предложенный код показан в отдельных вкладках HTML, CSS и JavaScript с подсветкой и автоматическим форматированием. Его можно поправить в редакторе и отформатировать кнопкой. Повторный запрос дорабатывает предложенный вариант. Кнопка Применить к черновику переносит код в основной редактор; до применения текущие исходники не меняются.

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

Работа с событиями

Перед запросом к AI сохраните сервис и создайте нужное событие на вкладке События. Помощник видит события открытого сервиса и может добавить их вызов в код.

Например: «После подготовки отчёта добавь кнопку, которая отправляет событие report_ready. Покажи результат отправки и сообщение при ошибке».

Если нужное событие отсутствует или выключено, сначала создайте или включите его. Затем отправьте новый запрос помощнику.

Возврат в редактор после перезагрузки

После перезагрузки страницы откроются тот же сервис и та же вкладка. Работают кнопки браузера «Назад» и «Вперёд». Ссылку можно отправить коллеге с доступом к сервису.

Перед перезагрузкой сохраните черновик: несохранённые изменения по ссылке не передаются.

Черновик и публикация

Кнопки Открыть, Сохранить черновик и Опубликовать находятся под редактором. Публикация доступна только для сохранённого текущего кода; после правок сначала сохраните черновик.

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

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

Хранятся текущий черновик и последняя опубликованная версия. Название, описание и доступ меняются в настройках сервиса.

Другие документы о встроенных сервисах

Темы, перенесённые из этой статьи

Код, библиотеки и SDK.

Виджеты дашборда и карточек.

Переменные сервиса.

События сервиса.

Запуск в веб-версии.

Импорт и экспорт ZIP-шаблонов.

Магазин расширений.