Триггеры
Как запускаются workflow — вебхук, расписание и триггеры коннекторов.
Триггеры
Триггер — это первый узел workflow, событие, которое запускает каждое выполнение. В каждом workflow ровно один триггер. Выбирайте тип в зависимости от того, как внешний мир сообщает вам о событии.
Webhook-триггер
Триггер Inbound Webhook даёт вам уникальный URL. Любой, кто отправит запрос на этот URL, запустит workflow.
Когда вы добавляете триггер и публикуете workflow, Triggo генерирует URL вида:
https://your-workspace.triggo.app/webhooks/<subscription-id>Эндпоинт принимает POST-запросы. Тело запроса парсится как JSON и доступно следующим узлам как {{trigger.output.body}} вместе с {{trigger.output.timestamp}} (ISO-8601 timestamp приёма).
Одного curl-вызова достаточно для сквозного теста. Пример уведомления о новом лиде:
curl -X POST https://your-workspace.triggo.app/webhooks/<subscription-id> \
-H "Content-Type: application/json" \
-d '{"email":"alice@acme.io","name":"Alice"}'Следующий узел workflow может прочитать {{trigger.output.body.email}} и {{trigger.output.body.name}}. Подключение или учётные данные не требуются — вебхуки не привязаны к коннекторам. Если в триггере настроен webhook secret, Triggo автоматически проверит HMAC-подпись.
Триггер по расписанию
Триггер Schedule запускает workflow по часам. У него два режима:
- Фиксированный интервал — каждые N секунд. Минимум 60 секунд, максимум 86 400 секунд (24 часа), проверяется при активации.
- Cron-выражение — стандартный 5-польный cron (
минута час день-месяца месяц день-недели). Примеры:0 9 * * MON-FRI(будни в 9:00),*/5 * * * *(каждые 5 минут),0 0 * * *(ежедневно в полночь).
Cron-расписания принимают строку с часовым поясом IANA (например, Europe/Moscow, UTC); по умолчанию UTC. Планирование делегировано BullMQ upsertJobScheduler с параметрами pattern + tz, поэтому поддерживается любое выражение, которое принимает BullMQ.
Выход триггера содержит timestamp, scheduleType ("interval" или "cron") и expression — либо буквальную cron-строку, либо "every 300s" для интервалов.
Триггеры коннекторов
Некоторые коннекторы имеют собственные потоки событий — обычно через вебхуки вендора или опрос, — так что отдельный webhook-триггер не нужен, чтобы реагировать на изменения внутри сервиса.
- AmoCRM —
lead_added,lead_edited,lead_deleted,lead_restored,lead_status_changed,lead_responsible_changed,contact_added,contact_edited,contact_deleted,contact_restored,contact_responsible_changed,company_added,company_edited,company_deleted,company_restored,company_responsible_changed,task_added,task_edited,task_deleted,task_responsible_changed,unsorted_added,unsorted_edited,unsorted_deleted,note_lead_added,note_contact_added,note_company_added,catalog_element_added,catalog_element_updated,catalog_element_deleted,message_received,talk_added,talk_edited— срабатывает на соответствующее CRM-событие. - Bitrix24 —
new_deal,deal_updated,new_contact,new_lead,task_added,task_updated: срабатывает на соответствующее CRM-/task-событие. - Gmail —
new_email: срабатывает, когда в подключённом ящике появляется новое письмо. - Google Sheets —
row_changed: срабатывает, когда в отслеживаемой таблице добавляется или редактируется строка. - HubSpot —
new_contact: срабатывает при создании нового контакта. - MAX —
new_message,callback_query: срабатывает на входящие сообщения и callback-ответы inline-кнопок в мессенджере MAX. - Telegram —
new_message,callback_query,chat_join_request,bot_event: срабатывает на входящие обновления Telegram для подключённого бота.
Триггерам коннекторов нужна подписка на соответствующий сервис, чтобы Triggo мог подписаться на события от вашего имени.
Как выбрать триггер
- Внешняя система пингует нас, когда что-то происходит? → webhook.
- Нужно запускать по часам? → schedule.
- У конкретного сервиса есть свой поток событий? → триггер коннектора.
Если сомневаетесь, начните с webhook-триггера — он работает с любым сервисом, способным отправить HTTP-запрос, — а позже переключитесь на триггер коннектора, если интеграция предоставляет более богатые метаданные события.