Workflow
Запускайте n8n, Make, Zapier, Pipedream или любой URL workflow с переменными маршрута в виде плоских полей JSON и решением в поле dcision — с подписью и повторами в фоне.
Назначение workflow запускает автоматизацию, которую вы собрали в no-code- или low-code-инструменте. Dcision отправляет POST с переменными маршрута на URL запуска workflow — в виде плоских полей JSON, которые эти инструменты сопоставляют в один клик, — и доставляет его в фоне, с повторами.
Настройка
{
"key": "sales_crm",
"type": "workflow",
"when": { "conditions": [{ "field": "route", "on": "output", "operator": "eq", "value": "sales" }] },
"params": {
"message": { "from": "state.message", "required": true },
"company_size": { "from": "state.company_size" },
"lead_score": { "from": "composites.lead_score" },
"team": { "value": "inbound" }
},
"workflow": { "platform": "n8n", "url": "{{secrets.N8N_LEADS_WEBHOOK}}", "name": "New sales lead" }
}| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
platform | string | custom | n8n, make, zapier, pipedream или custom. Подписывает назначение и подсказывает формат URL в редакторе; запрос для всех одинаковый. |
url | string | — | URL запуска workflow: https://… или {{secrets.NAME}}, содержащий весь URL. До 2 048 символов, с переменными. |
name | string | — | Необязательно, до 120 символов. Отправляется как dcision.workflow. |
В редакторе параметры workflow называются Переменные workflow.
| Платформа | Какой триггер создать |
|---|---|
| n8n | Узел Webhook с методом POST; используйте его production URL. |
| Make | Модуль Custom webhook. |
| Zapier | Триггер Webhooks by Zapier → Catch Hook. |
| Pipedream | Триггер HTTP / Webhook. |
| Своя | Любой endpoint https, принимающий JSON POST. |
URL запуска на практике являются секретами — любой, у кого он есть, может запустить ваш workflow. Храните его как секрет рабочего пространства и используйте {{secrets.NAME}} в качестве URL, как выше.
Запрос
{
"message": "We need pricing for 500 users and want to start next month.",
"company_size": 500,
"lead_score": 0.8414,
"team": "inbound",
"dcision": {
"decision": "lead-qualification",
"decision_id": "dec_3fKq9ZtW1mXcV7bN2pLa",
"version": 4,
"execution_id": "exec_8HsT2kQw9ZyR4vMn1cXe",
"result": { "purchase_intent": 0.9412, "priority": "high", "route": "sales" },
"confidence": { "purchase_intent": 0.8824, "priority": 0.69, "route": 0.85 },
"action": "continue",
"action_reason": { "type": "default" },
"destination": "sales_crm",
"workflow": "New sales lead",
"delivery_id": "dlv_8kJx2mQp4LzN7vR1tY6w",
"livemode": true
}
}- Каждый параметр — это поле верхнего уровня; само решение находится в
dcision. Параметр с именемdcisionбыл бы заменён этим объектом — выберите другое имя. dcision.workflow— этоnameназначения (null, если его нет),dcision.versionравенnullв Playground, аdcision.livemodeравенfalseдля тестовых ключей и Playground.- Состояние как таковое никогда не отправляется — только сопоставленные вами параметры.
Запрос содержит Content-Type: application/json, заголовки Dcision с Dcision-Signature и Idempotency-Key, равный ID доставки. Большинство no-code-триггеров не умеют проверять подпись HMAC — вместо этого держите URL в секрете. Если ваш workflow умеет выполнять код, проверяйте подпись как у вебхука.
Доставка
Workflow доставляются как минимум один раз, с шестью попытками примерно за семь часов: отвечайте 2xx быстро и выполняйте workflow асинхронно. Запуск, начатый дважды для одной и той же доставки, содержит один и тот же dcision.delivery_id — дедуплицируйте по нему, когда дубликат может навредить, например перед созданием записи в CRM.
Агенты
Передайте результат endpoint'у вашего собственного агента с инструкциями и инструментами маршрута — дождитесь его ответа в ответе API или передайте работу в фоне с повторными попытками.
Вебхуки
Получайте подписанное событие decision.completed на свой URL — конверт, его заголовки, проверка Dcision-Signature с SDK и без них, сырые тела в Express и Next.js, ротация и дедупликация.