Requisições HTTP
Chame qualquer API depois de uma decisão — método, URL, headers e um body JSON montado com variáveis e secrets do workspace — entregue com retries, um Idempotency-Key e uma assinatura.
Um destino de requisição de API (tipo http) chama qualquer API HTTP com uma requisição que você desenha — criar um lead no seu CRM, abrir um ticket, postar no Slack — em segundo plano, com retries. Os tokens ficam nos secrets do workspace, nunca na decisão.
Configure
{
"key": "create_lead",
"type": "http",
"when": { "conditions": [{ "field": "route", "on": "output", "operator": "eq", "value": "sales" }] },
"params": {
"email": { "from": "state.email", "required": true },
"score": { "from": "composites.lead_score" }
},
"http": {
"method": "POST",
"url": "https://api.crm.example.com/v2/leads?source={{decision.slug}}",
"headers": [{ "name": "Authorization", "value": "Bearer {{secrets.CRM_TOKEN}}" }],
"body": "{\"email\": {{params.email}}, \"score\": {{params.score}}, \"note\": \"Routed to {{result.route}} by Dcision\"}"
}
}| Campo | Tipo | Padrão | Descrição |
|---|---|---|---|
method | string | POST | GET, POST, PUT, PATCH ou DELETE. |
url | string | — | https://… ou {{secrets.NAME}} contendo a URL inteira; até 2.048 caracteres, variáveis codificadas para URL. |
headers | array | [] | Até 20 pares { "name", "value" }; valores de até 2.048 caracteres, com variáveis e secrets. |
body | string | os params como JSON | Só POST, PUT e PATCH: um template JSON de até 10.000 caracteres. |
O body
O body é um template JSON: fora de aspas, uma variável vira um valor JSON; dentro de aspas, vira texto — veja Bodies JSON. Com o destino acima, o CRM recebe:
{ "email": "ana@acme.com", "score": 0.8414, "note": "Routed to sales by Dcision" }- Sem template de body em
POST,PUTouPATCH: os params são enviados como um objeto JSON. Content-Type: application/jsoné definido, a menos que você adicione o seu próprio headerContent-Type.GETeDELETEnão têm body — um body neles é um erro de schema. Os params deles são adicionados à query string (?email=ana%40acme.com&score=0.8414), a menos que a URL já use{{params.…}}.
Headers
Os seus headers são enviados junto com os da Dcision:
| Header | Valor |
|---|---|
| Os seus headers | Os valores renderizados como texto — quebras de linha viram espaços. |
Content-Type | application/json quando há body, a menos que você o defina. |
User-Agent | Dcision-Destinations/1.0 (+https://docs.dcision.io/destinations), a menos que você o defina. |
Idempotency-Key | O ID da entrega, dlv_…, a menos que você o defina — o mesmo em toda tentativa, para que APIs que aceitam chaves de idempotência nunca apliquem um retry duas vezes. |
Dcision-Delivery, Dcision-Attempt, Dcision-Event, Dcision-Signature | Como nos webhooks. |
Alguns nomes são definidos pela Dcision ou pela camada HTTP e não podem ser usados: Host, Content-Length, Connection, Transfer-Encoding, Upgrade, Keep-Alive, TE, Trailer, Expect, e qualquer nome que comece com Proxy- ou Dcision-.
Autenticação
Coloque as credenciais num header com um secret — Authorization: Bearer {{secrets.CRM_TOKEN}} — ou na URL como secret quando a API espera uma URL secreta ({{secrets.SLACK_WEBHOOK}}). Credenciais na própria URL (https://user:password@…) são recusadas.
A assinatura
Requisições de API são assinadas como os webhooks, sobre o body exato enviado — um body vazio para GET e DELETE. Se a API que recebe for sua, verifique o Dcision-Signature com verifySignature (TypeScript) ou verify_signature (Python): o body é o seu template, não um evento de webhook. Veja Verificar a assinatura.
Exemplo: uma mensagem no Slack
Os incoming webhooks do Slack esperam o próprio JSON deles, então use uma requisição de API com a URL do webhook guardada como secret:
{
"key": "escalation_alert",
"type": "http",
"when": { "actions": ["escalate"] },
"params": { "message": { "from": "state.message" } },
"http": {
"method": "POST",
"url": "{{secrets.SLACK_WEBHOOK}}",
"body": "{\"text\": \"{{decision.slug}} asks for a person ({{action}}): {{params.message}}\"}"
}
}A mensagem é escrita dentro de aspas, então o param é inserido como texto escapado — aspas e quebras de linha na mensagem do lead não conseguem quebrar o JSON.
Webhooks
Receba o evento assinado decision.completed na sua URL — o envelope, os headers, como verificar Dcision-Signature com e sem os SDKs, raw bodies em Express e Next.js, troca de segredo e deduplicação.
Funções
Deixe o seu próprio código agir sobre um resultado — a resposta indica a função e seus params, e os SDKs TypeScript e Python chamam o handler que você registrou, em ordem e uma vez por chamada.