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\"}"
  }
}
CampoTipoPadrãoDescrição
methodstringPOSTGET, POST, PUT, PATCH ou DELETE.
urlstring—https://… ou {{secrets.NAME}} contendo a URL inteira; até 2.048 caracteres, variáveis codificadas para URL.
headersarray[]Até 20 pares { "name", "value" }; valores de até 2.048 caracteres, com variáveis e secrets.
bodystringos params como JSONSó 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, PUT ou PATCH: os params são enviados como um objeto JSON.
  • Content-Type: application/json é definido, a menos que você adicione o seu próprio header Content-Type.
  • GET e DELETE nã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:

HeaderValor
Os seus headersOs valores renderizados como texto — quebras de linha viram espaços.
Content-Typeapplication/json quando há body, a menos que você o defina.
User-AgentDcision-Destinations/1.0 (+https://docs.dcision.io/destinations), a menos que você o defina.
Idempotency-KeyO 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-SignatureComo 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.

Nesta página