Запуск па падзеях Synchra24
Сістэмныя і прыстасаваныя падзеі сэрвісаў: payload, Умовы, абмежаванні, дастаўка і прыклады аўтаматызацый.
Пераклад пакуль недаступны. Паказаны арыгінал.
Событийная автоматизация запускается после изменения в Synchra24 или вызова зарегистрированного события из вашего сервиса. Она подходит для процессов вида «если произошло событие и выполнено условие — отправить данные или вызвать внешний сервис».
Например:
- сотрудник опоздал более чем на 15 минут — отправить запись во внешнюю систему и уведомить управляющего через её API;
- создан инцидент высокой важности — передать его в сервис поддержки;
- завершён чек-лист с нарушениями — создать запись в системе контроля качества;
- задача завершена — отправить результат в учётную систему.
Как работает событийный запуск
После действия в Synchra24 включённая автоматизация получает событие с его названием, временем и данными. Затем проверяются условия, выполняется обработчик и результат отправляется в настроенные назначения. Ход работы и результат доступны в истории запусков.
Событийная автоматизация не опрашивает сервисы по расписанию и не требует поля source: данные уже находятся в конверте события.
Что нужно для настройки
- у компании должна быть активна возможность API-интеграция;
- пользователю нужен доступ к разделу Автоматизации;
- конфигурация должна использовать
version: 2; - автоматизация должна быть включена;
- для внешнего API заранее подготовьте URL, способ авторизации и секреты.
В редакторе выберите тип триггера event и укажите одно точное имя события. Регистр и символы имеют значение: task.completed и Task.Completed считаются разными строками.
Пользовательские события сервисов
Событие принадлежит одному сервису и одной компании. Сначала сохраните сервис
в администраторе, откройте вкладку События со значком молнии и создайте событие.
Например, локальное имя report_ready у сервиса с ID 42 получает полный код
custom.service_42.report_ready. Такой же локальный ключ в другом сервисе
не пересекается с этим событием. Компания определяется авторизацией на сервере.
В шапке редактора автоматизации нажмите компактную квадратную кнопку с молнией
Событие сервиса рядом с удалением. Откроется отдельная модалка с поиском
по событиям и сервисам, пагинацией и состояниями загрузки и пустого списка.
Отметьте включённое событие из каталога сервисов компании и нажмите Выбрать событие.
Кнопка Отмена закрывает окно без изменения конфигурации.
В trigger.event используется полный код, а в коде сервиса — локальное имя.
Автоматизация должна быть включена; создание определения события само её не запускает.
Для управления сервисом нужна лицензия Приложения и право редактирования сервисов;
для автоматизации — API-интеграция и право редактирования интеграций.
Пример конфигурации, сохраняющей результат в артефакт:
version: 2
trigger:
type: event
event: custom.service_42.report_ready
transform:
type: javascript
timeout_seconds: 2
destination:
type: artifact
name: reports.latest
Во вкладке обработчика:
function transform(input, context) {
return {
report_id: input.payload.report_id,
event_id: input.event_id,
prepared_by: input.actor_user_id
};
}
Из опубликованного сервиса событие отправляется через
synchra.emitEvent("report_ready", {report_id: "123"}, {requestKey}) после успешной
проверки isSynchraIntegrated(). Данные payload — JSON-объект до 32 КБ.
Метод использует ранее созданное определение; методов регистрации событий из кода нет.
Сервер сам заполняет компанию, автора и служебные поля конверта.
Полный пример с повторной отправкой:
События сервиса.
Встроенный предпросмотр возвращает {preview: true, accepted: false} и не запускает
автоматизации. Реальная отправка возвращает event_id после сохранения события
на обработку. Это подтверждение приёма, а не успешного выполнения
сценария: результат смотрите в истории автоматизации.
Ключ requestKey сохраняйте вместе с неизменным payload на одну операцию.
Повтор с тем же ключом и данными возвращает прежний event_id; защита действует
не менее 24 часов. Другая нагрузка под тем же ключом отклоняется с 409.
После потери ответа повторяйте прежнюю операцию, а не создавайте новый ключ.
Ограничения пользовательских событий
Лимиты применяются на сервере ко всей компании, независимо от числа устройств. Обычная частота: 30 вызовов в минуту на пользователя и событие, 60 на пользователя в компании, 300 на сервис и 1000 на компанию. Допускаются короткие серии; подробнее об ограничениях — в руководстве сервиса. В сервисе можно зарегистрировать до 100 событий.
Для одного пользовательского события можно включить до 20 автоматизаций. При большой нагрузке запуск может ожидать обработки. Ответ 429 означает, что нужно подождать перед повтором; 503 — что отправка временно недоступна. Покажите ошибку пользователю и повторяйте ту же операцию с прежним ключом, не создавая бесконечных повторов.
Метод emitEvent пока доступен во встроенном веб-движке сервисов;
мобильный мост его не поддерживает. Наличие метода в веб-движке не означает
его наличие в любой установленной версии npm-пакета @synchra24/app.
Каталог событий
Ниже перечислены системные события, которые можно указывать в trigger.event. Дополнительно доступны зарегистрированные события сервисов вашей компании с префиксом custom.service_. Поле Payload показывает основные данные для условий и обработчика. Кроме них, в payload.title может передаваться название сущности.
Задачи, инциденты и чек-листы
| Событие | Когда возникает | Основные поля payload |
|---|---|---|
task.created |
Создана задача. | id, number, title, assigned_to, priority_id, deadline |
task.status_changed |
Статус задачи действительно изменился. | id, number, status, status_title, assigned_to, created_by |
task.completed |
Новый статус задачи — completed. Событие приходит вместе с task.status_changed, но имеет другой event_id. |
те же поля, что у task.status_changed |
task.canceled |
Новый статус задачи — canceled. |
те же поля, что у task.status_changed |
incident.created |
Создан инцидент. | id, number, title, assigned_to, priority_id |
incident.status_changed |
Статус инцидента действительно изменился. | id, number, status, status_title, assigned_to, created_by |
incident.in_progress |
Инцидент переведён в статус in_progress. |
те же поля, что у incident.status_changed |
incident.completed |
Инцидент завершён, закрыт или отмечен невыполненным. | те же поля, что у incident.status_changed |
checklist.submitted |
Результат чек-листа отправлен. | id, status, session_id, violations_count, has_failures |
checklist.failed |
Отправленный чек-лист содержит хотя бы одно нарушение. | те же поля, что у checklist.submitted |
Учёт времени
| Событие | Когда возникает | Основные поля payload |
|---|---|---|
shift.started |
Смена сотрудника запущена им самим, через панель или руководителем. При запуске руководителем его ID передаётся в launching_user_id. |
timer_id, user_id, started_at, launching_user_id, panel_id, manual; при наличии графика — planned_start, planned_end, late_minutes |
shift.ended |
Активная смена остановлена сотрудником, панелью или руководителем. При остановке руководителем его ID передаётся в stopped_by_user_id. |
timer_id, user_id, started_at, ended_at, duration_seconds, stopped_by_user_id, manual |
employee.late |
Смена началась позже планового времени. | поля shift.started, включая late_minutes |
Заявки, формы, документы и отчёты
| Событие | Когда возникает | Основные поля payload |
|---|---|---|
request.created |
Сотрудник создал заявку. | title |
request.approved |
Заявка окончательно согласована. Промежуточное согласование одного участника событие не создаёт. | title |
request.rejected |
Заявка окончательно отклонена. | title |
assessment_360.submitted |
Участник отправил оценку 360°. | title |
form.blank_completed |
Сотрудник заполнил назначенный бланк. | dispatch_id, form_type, title |
form.poll_completed |
Сотрудник прошёл назначенный опрос. | dispatch_id, form_type, title |
document.signed |
Сотрудник подписал документ. | title |
report.created |
Создан отчёт. | date, session_id, title |
Отпуска, идеи и касса
| Событие | Когда возникает | Основные поля payload |
|---|---|---|
vacation.requested |
Сотрудник отправил план отпуска. | subject_user_id, year, days, approver_ids, comment, title |
vacation.approved |
План отпуска согласован. | subject_user_id, year, comment, title |
vacation.canceled |
Дни плана отпуска отменены или отклонены. | subject_user_id, year, days, comment, title |
vacation.updated |
Сотрудник перенёс дни существующего плана отпуска; согласование сбрасывается. | subject_user_id, year, removed_days, added_days, title |
client_hub.employee_idea_created |
Сотрудник отправил идею в клиентском хабе. | status, title |
cash.transaction_created |
Создана операция прихода, расхода, выдачи или возврата. | cashbox_id, type, amount, description, user_id, category_id, title |
cash.transaction_canceled |
Кассовая операция отменена. | cashbox_id, type, amount, description, user_id, category_id, canceled_by, canceled_at, title |
Календарь и новости
| Событие | Когда возникает | Основные поля payload |
|---|---|---|
calendar.event_created |
Создано мероприятие календаря. | starts_at, ends_at, location, user_ids, title |
calendar.event_updated |
Мероприятие календаря изменено. | те же поля, что у calendar.event_created |
calendar.event_deleted |
Мероприятие календаря удалено. | title |
news.created |
Создана новость. | show_from, show_to, title |
news.updated |
Новость изменена. | show_from, show_to, title |
news.deleted |
Новость удалена. | title |
Выездные работы
| Событие | Когда возникает | Основные поля payload |
|---|---|---|
field_visit.created |
Создан черновик выезда. | общие поля выезда |
field_visit.updated |
Изменены параметры выезда. | общие поля выезда |
field_visit.published |
Выезд опубликован и назначен сотрудникам. | общие поля выезда |
field_visit.departed |
Исполнитель начал движение на объект. | общие поля и поля операции |
field_visit.arrived |
Исполнитель отметил прибытие. | общие поля и поля операции |
field_visit.completed |
Выезд завершён. | общие поля и поля операции |
field_visit.canceled |
Выезд отменён. | общие поля и поля операции |
Общие поля выезда: number, status, priority, date, window_start, window_end, timezone, responsible_id, member_ids, title. Для действий также передаются operation_id, offline, geo_state, reason и result. Повторная доставка одной офлайн-операции не создаёт новое событие.
Сотрудники, отделы и роли
| Событие | Когда возникает | Основные поля payload |
|---|---|---|
employee.added |
Пользователь добавлен в компанию. | user_id, position_id, title |
employee.dismissed |
Сотрудник уволен. | profile_id, employment_status, title |
employee.restored |
Уволенный сотрудник восстановлен. | profile_id, employment_status, title |
employee.blocked |
Профиль сотрудника заблокирован. | profile_id, blocked, title |
employee.unblocked |
Блокировка профиля снята. | profile_id, blocked, title |
department.created |
Администратор создал отдел. | department_id, name, description, title |
department.updated |
Изменены название или описание отдела. | department_id, name, description, title |
department.deleted |
Пустой отдел удалён. | department_id, title |
role.created |
Администратор создал роль вручную или через AI-генератор структуры ролей. Для сгенерированной роли создаётся отдельное событие. | role_id, name, description, parent_id, permissions, generated, title |
role.updated |
Изменены роль, её родитель или права. | role_id, name, description, parent_id, permissions, title |
role.deleted |
Роль без дочерних ролей удалена. | role_id, title |
position.created |
Создана или скопирована ставка. | position_id, division_id, name, work_mode, work_start, work_end, title; для копии — copied_from_position_id |
position.updated |
Изменены ставка или её рабочий график. | position_id, name, work_mode, work_start, work_end, title |
position.archived |
Ставка отправлена в архив или восстановлена. | position_id, archived, title |
Квалификационные допуски
| Событие | Когда возникает | Основные поля payload |
|---|---|---|
qualification.created |
Создан вид квалификационного допуска. | qualification_id, kind, name, description, validity_days, document_required, max_level, active, title |
qualification.updated |
Изменены параметры вида допуска. | те же поля, что у qualification.created |
qualification.archived |
Вид допуска отправлен в архив. | qualification_id, active, title |
employee_qualification.assigned |
Сотруднику назначен допуск. | employee_qualification_id, user_id, qualification_id, qualification_name, kind, level, status, issued_at, expires_at, verified_by, title |
employee_qualification.updated |
Изменён допуск сотрудника. | те же поля, что у employee_qualification.assigned |
employee_qualification.revoked |
Допуск сотрудника отозван. | те же поля; status равно revoked |
Файлы подтверждений и фотографии в события допусков не включаются.
Наряды
| Событие | Когда возникает | Основные поля payload |
|---|---|---|
duty.created |
Создан или скопирован черновик наряда. | duty_id, status, date, starts_at, ends_at, timezone, zone_id, zone_name, role_ids, user_ids, required_count, assigned_count, version, title; для копии — copied_from_duty_id |
duty.updated |
Изменены параметры или назначения наряда. | основные поля наряда |
duty.published |
Наряд опубликован сотрудникам. | основные поля наряда; status равно published |
duty.canceled |
Наряд отменён. | основные поля наряда, reason; status равно canceled |
Внештатные сотрудники и ручные дни графика
| Событие | Когда возникает | Основные поля payload |
|---|---|---|
external_worker.added |
Добавлен внештатный сотрудник с первыми назначениями. | external_worker_id, assignment_ids, planned_starts, planned_ends, title |
external_worker.assignment_created |
Существующему внештатному сотруднику добавлены назначения. | те же поля, что у external_worker.added |
external_worker.deleted |
Внештатный сотрудник удалён до начала работы. | external_worker_id, title |
external_worker.session_started |
Внештатный сотрудник начал назначенную смену через Motion-панель. | session_id, external_worker_id, assignment_id, panel_id, started_at, title |
external_worker.session_ended |
Смена внештатного сотрудника завершена им самим или принудительно руководителем. | поля начала сессии, ended_at, duration_seconds, stopped_by_user_id, forced, title |
schedule.workday_added |
В график одного или нескольких сотрудников вручную добавлен рабочий день. | date, user_ids, starts_at, ends_at, timezone, reason, title |
schedule.day_off_added |
В график вручную добавлен нерабочий день. | date, user_ids, reason, title |
schedule.workday_updated |
Изменён вручную назначенный рабочий день. | assignment_id, date, user_ids, starts_at, ends_at, timezone, reason, title |
schedule.day_off_updated |
Изменён вручную назначенный нерабочий день. | assignment_id, date, user_ids, reason, title |
schedule.day_removed |
Ручное назначение дня удалено из графика. | assignment_id, title |
Биржа смен и замены
| Событие | Когда возникает | Основные поля payload |
|---|---|---|
shift_exchange.created |
Сотрудник или руководитель опубликовал смену для замены либо открытую смену. | request_id, kind, requester_id, date, starts_at, ends_at, timezone, status, qualification_ids, title |
shift_exchange.responded |
Сотрудник откликнулся на опубликованную смену. | поля заявки, response_id, response_user_id, title |
shift_exchange.response_withdrawn |
Сотрудник отозвал свой отклик на опубликованную смену. | request_id, response_user_id, status, title |
shift_exchange.approved |
Руководитель согласовал отклик и изменение графика выполнено. | поля заявки, response_id, replacement_user_id, assignment_id, title |
shift_exchange.canceled |
Заявка на обмен или открытую смену отменена. | поля заявки, title |
shift_replacement.created |
Создана прямая замена сотрудников между сменами. | replacement_id, first_date, first_user_ids, second_date, second_user_ids, reciprocal, reason, status, title |
shift_replacement.updated |
Параметры прямой замены изменены. | те же поля, что у shift_replacement.created |
shift_replacement.canceled |
Прямая замена отменена. | те же поля, что у shift_replacement.created |
Email, PIN-коды и ставки внештатных сотрудников в события не включаются.
Визиты посетителей
Визиты — отдельный сервис во вкладке «Приложения» мобильного приложения. Доступ выдаётся отдельными правами на просмотр, управление визитами и согласование допуска; права руководителя и доступ к «Управлению» не требуются. Они не относятся к рабочим сменам и расчёту оплаты. События возникают после подтверждённого изменения на сервере и сохраняются вместе с историей визита. Недоступность брокера не теряет событие: публикация повторяется через outbox.
| Событие | Когда возникает |
|---|---|
visit.created |
Создан визит, в том числе через API интеграции. |
visit.updated |
Изменены плановые даты, объект, цель, автомобиль, ответственный или необходимость допуска. |
visit.arrived |
Сотрудник подтвердил прибытие или посетитель самостоятельно отметился по персональной ссылке. |
visit.entered |
Подтверждён фактический вход на территорию. |
visit.completed |
Посещение завершено; выданный пропуск отозван. |
visit.cancelled |
Визит отменён до входа; пропуск отозван. |
visit.no_show |
После планового окончания сотрудник отметил неявку. |
visit.admission_allowed |
Уполномоченный сотрудник разрешил вход. Это ещё не факт входа. |
visit.admission_denied |
Уполномоченный сотрудник отклонил допуск. |
visit.pass_issued |
Выдан новый персональный QR-пропуск; предыдущий отозван. |
Для всех этих событий source_service — time_manager, entity_type — visit, entity_id — номер визита. В payload передаётся снимок визита: id, provider_id, guest (идентификатор, ФИО, организация и контакты), location, purpose, vehicle, vehicle_plate, comment, responsible_id, responsible_name, require_admission, status, admission, planned_start, planned_end, arrived_at, entered_at, completed_at, created_by, created_at, updated_at, version, external_system, external_id. Дополнительно доступны previous_status, action_comment, method (manual / qr / visitor) и changes. При наличии передаются guest.photo, self_arrival_enabled и arrival_details (geo_status, а при успешном определении — latitude, longitude, accuracy).
Секрет QR-пропуска и его хеш в события и историю не включаются. Сканирование само по себе не меняет состояние: сотрудник проверяет карточку и подтверждает действие. При необходимости допуска вход разрешён только после согласования. Для повторного визита используется тот же посетитель и новая запись посещения.
Автоматизации могут не только отправлять эти данные во внешнюю систему, но и создавать/изменять визиты через provider-scoped API /api/v1/tm/visits, подтверждать статусы через /{id}/status и допуск через /{id}/admission. При изменении нужна текущая version; конфликт даёт 409. Пара external_system + external_id позволяет связать визит с внешней записью и избежать повторного создания при повторной доставке запроса. Для точного поиска доступны одноимённые фильтры. При включённой самостоятельной отметке посетитель может отметить прибытие по личной ссылке: событие visit.arrived получает method=visitor, actor_user_id=0 и arrival_details с результатом определения геолокации. Принимающему сотруднику отправляется пуш; повторное нажатие не дублирует событие. Допуск на территорию остаётся отдельным действием сотрудника. Все методы ограничены компанией, правами пользователя и отдельной лицензией visits («Визиты»), которая входит в Trial (пробный), Pro и Ultimate; конкретная внешняя система в логику визитов не зашита.
Пример: передать прибытие во внешнюю систему
В конфигурации выберите одно событие и при необходимости ограничьте его конкретным объектом:
version: 2
trigger:
type: event
event: visit.arrived
conditions:
all:
- path: payload.location
operator: eq
value: Склад №2
Это фрагмент настроек запуска: добавьте JavaScript-обработчик и HTTP-назначение в редакторе. В обработчике можно подготовить данные:
function transform(input, context) {
const visit = input.payload;
return {
event_id: input.event_id,
visit_id: visit.id,
external_system: visit.external_system,
external_id: visit.external_id,
status: visit.status,
admission: visit.admission,
arrived_at: visit.arrived_at,
method: visit.method,
arrival_details: visit.arrival_details || null
};
}
Настройте адрес и авторизацию HTTP-назначения через секреты. Внешняя система должна учитывать event_id для защиты от повторной доставки. Контакты посетителя передавайте только если они нужны получателю; токен пропуска в событии отсутствует.
Для visit.updated в changes.before и changes.after доступны снимки до и после изменения. При самостоятельной отметке actor_user_id — строка "0", а payload.method — visitor; координаты могут отсутствовать. Пустая геолокация не означает отказ в допуске.
Повторное подтверждение уже достигнутого статуса не создаёт нового события. При использовании входящего API передавайте текущую version; при ответе 409 перечитайте карточку, проверьте состояние и только затем повторите допустимое действие.
Подробнее о пользовательском сценарии: Визиты. Методы интеграции: Open API.
Журналы и база знаний
| Событие | Когда возникает | Основные поля payload |
|---|---|---|
journal.completed |
Сотрудник выполнил мероприятие журнала. | journal_id, journal_title, event_title, completed_by, assignment_at, completion_source, reason, title |
journal.force_completed |
Руководитель принудительно завершил мероприятие. | те же поля; completion_source равно manager_override |
wiki.article_created |
Создана статья базы знаний. | section_id, title |
wiki.article_updated |
Статья базы знаний изменена. | title |
Базовый пример: опоздание более чем на 15 минут
version: 2
trigger:
type: event
event: employee.late
conditions:
all:
- path: payload.late_minutes
operator: gte
value: 15
transform:
type: javascript
timeout_seconds: 2
destination:
type: http
method: POST
url: https://example.com/api/lateness
headers:
Authorization: "Bearer ${secrets.DESTINATION_TOKEN}"
request:
format: json
retry:
attempts: 3
delay_seconds: 5
У событийной автоматизации нет source: источником служит само событие. В режиме steps также нельзя добавлять шаги kind: source, но можно добавить несколько назначений.
Другие примеры условий
Завершён срочный выезд
trigger:
type: event
event: field_visit.completed
conditions:
all:
- path: payload.priority
operator: eq
value: urgent
Кассовая операция больше 100 000
trigger:
type: event
event: cash.transaction_created
conditions:
all:
- path: payload.amount
operator: gte
value: 100000
Любое кадровое выбытие
Одна автоматизация слушает только одно имя события. Для увольнения используйте employee.dismissed. Если нужно одинаково обрабатывать увольнение и блокировку, создайте две автоматизации или направьте оба сценария в один внешний endpoint.
Условия
В conditions.all перечисляются условия, которые должны выполниться одновременно. В conditions.any достаточно выполнения одного условия. Обе группы можно использовать вместе.
| Оператор | Назначение |
|---|---|
eq, ne |
Равно или не равно. |
gt, gte, lt, lte |
Сравнение чисел. |
in |
Значение входит в указанный массив. |
contains |
Строка содержит фрагмент или массив содержит значение. |
exists |
Поле существует; для проверки отсутствия укажите value: false. |
Путь может обращаться к event_type, actor_user_id, entity_type, entity_id, source_service или полям payload, например payload.priority_id.
Данные обработчика
Функция transform(input, context) получает конверт события целиком:
| Поле | Тип | Описание |
|---|---|---|
event_id |
UUID | Уникальный идентификатор события и ключ защиты от дублей. |
schema_version |
число | Версия конверта. Сейчас используется 1. |
event_type |
строка | Имя события из каталога выше. |
provider_id |
строка | Идентификатор компании. |
actor_user_id |
строка | Пользователь, выполнивший действие. Для системного процесса может быть пустым. |
source_service |
строка | Сервис Synchra24, создавший событие. |
entity_type |
строка | Тип сущности: например task, timer или field_visit. |
entity_id |
строка | Идентификатор сущности. |
occurred_at |
дата и время | Момент события в UTC в формате ISO 8601. |
correlation_id |
строка | Идентификатор связанной цепочки операций. |
causation_id |
строка | Идентификатор события-причины, если оно есть. |
depth |
число | Глубина цепочки автоматизаций, от 0 до 4. |
payload |
объект | Данные конкретного события. |
{
"event_id": "2dc81c0d-7bf5-4cd6-8837-57ce93730c50",
"schema_version": 1,
"event_type": "employee.late",
"provider_id": "company-id",
"actor_user_id": "42",
"source_service": "time_manager",
"entity_type": "timer",
"entity_id": "123",
"occurred_at": "2026-10-04T08:15:00Z",
"correlation_id": "2dc81c0d-7bf5-4cd6-8837-57ce93730c50",
"depth": 0,
"payload": {
"user_id": "42",
"late_minutes": 15
}
}
event_id уникален и используется для защиты от повторной обработки. correlation_id связывает действия одной цепочки. Глубина цепочки ограничена пятью уровнями, чтобы автоматизации не могли создать бесконечный цикл.
В JavaScript поля читаются напрямую:
function transform(input, context) {
return {
eventId: input.event_id,
companyId: input.provider_id,
employeeId: input.actor_user_id,
minutesLate: input.payload.late_minutes,
receivedAt: context.started_at
};
}
Если поле не относится к конкретному событию, оно может отсутствовать или иметь значение null. Проверяйте необязательные поля перед использованием.
Доставка и защита от дублей
Доставка выполняется асинхронно. Пользовательский запрос не ждёт выполнения внешнего HTTP-вызова: созданная задача, остановленная смена или другое действие сохраняются независимо от результата автоматизации.
При сбое событие может быть доставлено повторно. Чтобы внешняя система не выполнила одно действие дважды, используйте event_id как уникальный ключ операции. Synchra24 также защищает запуск одной автоматизации от повторной обработки того же события.
События разных действий могут прийти почти одновременно. Если порядок критичен, сравнивайте occurred_at и состояние сущности во внешней системе.
Совместимость
- имя существующего события и смысл текущих полей не меняются без необходимости;
- новые необязательные поля могут появляться в
payload; - обработчик не должен завершаться ошибкой из-за неизвестного поля;
- при создании новой несовместимой структуры будет увеличена
schema_version; - даты передаются в UTC, если в описании поля не указано иное;
- денежные значения передаются числом в валюте, используемой кассой компании.
Проверка и запуск
Выполните проверочный запуск перед включением автоматизации: он помогает проверить условия и обработчик без отправки результата в рабочие назначения. Для проверки конкретного события подготовьте пример его данных. Подробнее о вводе тестовых данных — в руководстве по проверке.
Один событийный запуск ограничен 60 секундами. Рабочая событийная автоматизация не имеет обычного ручного запуска: её запускает выбранное событие.
После реального события откройте историю автоматизации и проверьте:
- появился ли запуск с триггером
event; - совпал ли
event_type; - прошли ли условия;
- что записано во входных и выходных данных;
- какие сообщения вывел обработчик;
- какой ответ вернул внешний endpoint.
Если запуска нет, проверьте точное имя события, компанию, включённое состояние автоматизации и момент фактического бизнес-действия. Если в результате указано condition_not_matched, событие получено, но не прошло conditions.
Подробнее об отладке: Проверка и устранение ошибок. Правила хранения токенов: Секреты и безопасность.
Событие из виджета карточки
Сервис-виджет может прочитать текущую запись через await synchra.getWidgetContext() и передать её ID в данные своего события synchra.emitEvent(). Контекст имеет одинаковую оболочку в WebView и Shadow DOM; описание и поля записи находятся в data. Не отправляйте событие при каждом обновлении контекста или рендере: используйте явное действие пользователя и устойчивый requestKey для одной операции. Кастомные события мобильного моста по-прежнему доступны только в поддержанных им методах; emitEvent сейчас поддерживается веб-мостом. Подробнее: Контекст виджета.
Артефакты в событийной автоматизации
Блок artifacts: {settings: service.settings} подключает значения текущей компании без HTTP-источника. Условия могут читать artifacts.settings.enabled и сравнивать поля события с ${artifacts.settings.minimum}; transform читает context.artifacts.settings. Назначения используют тот же набор значений на начало запуска. Запись из сервиса через setArtifact сама событие не создаёт: после успешного сохранения при необходимости вызовите зарегистрированное emitEvent. Правила чтения и записи.