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" }
}
ПолеТипПо умолчаниюОписание
platformstringcustomn8n, make, zapier, pipedream или custom. Подписывает назначение и подсказывает формат URL в редакторе; запрос для всех одинаковый.
urlstring—URL запуска workflow: https://… или {{secrets.NAME}}, содержащий весь URL. До 2 048 символов, с переменными.
namestring—Необязательно, до 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, как выше.

Запрос

Тело POST
{
  "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.

На этой странице