Workflows — intégrations & interpolation

Au-delà des actions de plan, les workflows peuvent appeler des systèmes externes et envoyer des e-mails — et n’importe quel champ peut référencer des valeurs antérieures via l’interpolation.

CALL_WEBHOOK

{
  "actionType": "CALL_WEBHOOK",
  "url": "https://example.com/hook",
  "method": "POST",
  "headers": [ { "key": "X-Source", "value": "solya" } ],
  "queryParams": [ { "key": "ref", "value": "{{workflow.id}}" } ],
  "bodyType": "json",
  "bodyTemplate": "{ \"plan\": \"{{steps.create.output.planId}}\" }",
  "auth": { "type": "bearer", "credentialId": "<uuid>" },
  "timeoutMs": 10000,
  "retries": { "count": 2, "backoffMs": 1000 },
  "successStatusCodes": [200, 201, [200, 299]],
  "saveResponseAs": "hookResult"
}

Champ	Signification
`method`	`GET` · `POST` · `PUT` · `PATCH` · `DELETE`.
`url`, `headers`, `queryParams`, `bodyTemplate`	Tous supportent l’interpolation.
`bodyType`	`none` · `json` · `form` · `raw` (`bodyContentType` pour `raw`).
`auth`	`{ type: "none" }`, ou `bearer` / `basic` / `apiKey` référençant un `credentialId` (`apiKey` prend aussi un `headerName`).
`timeoutMs` / `retries`	Politique d’exécution (`retries`: `{ count, backoffMs }`).
`successStatusCodes`	Codes (ou plages `[from, to]`) traités comme succès.
`saveResponseAs`	Nomme la sortie de réponse pour qu’elle soit accessible en aval.

SEND_EMAIL

{
  "actionType": "SEND_EMAIL",
  "to": ["buyer@example.com"],
  "cc": [], "bcc": [], "replyTo": "ops@solya.app",
  "fromAddress": "no-reply@solya.app",
  "fromName": "Solya",
  "subject": "Restock plan {{steps.create.output.planName}} ready",
  "bodyFormat": "markdown",
  "bodyTemplate": "Added **{{steps.add.output.addedCount}}** items.",
  "tags": ["restock"],
  "trackOpens": true,
  "trackClicks": false
}

Envoyé via Mailgun à partir d’un domaine expéditeur vérifié. bodyFormat est text, html, ou markdown. Sortie : messageId.

Identifiants

Les secrets webhook ne vivent jamais dans la définition de flux — ils sont stockés séparément et référencés par credentialId.

Types : BEARER_TOKEN, BASIC_AUTH, API_KEY.
Stockés chiffrés au repos (AES-256-GCM) ; le flux ne tient que l’id de l’identifiant.
L’app expose une vue sécurisée (id, name, type — jamais le secret) ; le secret est résolu côté serveur uniquement quand la plateforme données exécute l’appel.

Décalages de date

Les dates du plan (deadline, startDate, endDate) utilisent un DateOffset :

Genre	Format	Signification
`absolute`	`{ "kind": "absolute", "iso": "2026-09-01T00:00:00Z" }`	Une date-heure ISO fixe.
`relative`	`{ "kind": "relative", "offsetDays": 30 }`	N jours à partir de `{{now}}`.
`interpolated`	`{ "kind": "interpolated", "template": "{{steps.x.output.date}}" }`	Résolu à partir d’un modèle.

Interpolation

N’importe quel champ interpolé utilise {{ … }} avec la notation par points. La résolution se fait à l’exécution sur la plateforme données (le générateur offre l’autocomplétion). Variables statiques

Variable	Valeur
`{{trigger.entityType}}` / `{{trigger.entityId}}`	Le type d’entité déclencheur / premier id correspondant.
`{{org.id}}` / `{{org.name}}`	L’organisation.
`{{workflow.id}}` / `{{workflow.name}}`	Le workflow.
`{{now}}`	Horodatage ISO au démarrage de l’exécution.

Sorties d’étape — {{steps.<nodeId>.output.<field>}}, par ex. :

create-plan: planId, planType, planName, isNew
add-items: addedCount, skippedCount
webhook: votre champ saveResponseAs
email: messageId

Les noms de sortie s’alignent avec les enregistrements d’étape — voir Exécutions & exemples.

Intégration API

Recettes API

Plateforme & modèle de données

Couche décision (référence)

Exploitation & infrastructure

Specs d'ingestion (référence)

Workflows (référence)

Règles de tagging (référence)

Alertes (référence)

Workflows — intégrations & interpolation

CALL_WEBHOOK

SEND_EMAIL

Identifiants

Décalages de date

Interpolation

​CALL_WEBHOOK

​SEND_EMAIL

​Identifiants

​Décalages de date

​Interpolation

CALL_WEBHOOK

SEND_EMAIL

Identifiants

Décalages de date

Interpolation