Segredos do workspace
Mantenha tokens e URLs secretas fora das decisões — segredos do workspace referenciados como {{secrets.NAME}}, quem pode gerenciá-los, como são guardados e mascarados, e quando as mudanças valem.
Tokens de API, senhas e URLs secretas — a URL de um webhook do Slack ou do n8n — não pertencem a uma decisão: o schema é versionado, exibido no editor e guardado a cada deploy. Mantenha-os nos segredos do workspace e referencie-os pelo nome.
Adicionar um segredo
Em Configurações → Destinos → Segredos, digite um nome e um valor e clique em Adicionar segredo (ou Substituir para um nome existente).
- Os nomes são UPPER_SNAKE_CASE: uma letra maiúscula, seguida de letras maiúsculas, dígitos e
_, até 64 caracteres —CRM_TOKEN,SLACK_WEBHOOK. - Os valores têm de 1 a 4.096 caracteres e são somente escrita: depois de salvo, o app mostra o nome, os últimos 4 caracteres (para Admins) e quando ele mudou — nunca o valor.
- Um workspace guarda até 50 segredos.
Use-o
Escreva {{secrets.NAME}} onde um destino precisar dele:
| Onde | Exemplo |
|---|---|
| Um valor de header | Authorization: Bearer {{secrets.CRM_TOKEN}} |
| Uma URL inteira | {{secrets.SLACK_WEBHOOK}} como URL de uma requisição de API ou de um webhook |
Um body http | {"api_key": {{secrets.MAILER_KEY}}} |
Um segredo pode ser o início de uma URL — a URL inteira — ou parte de um header ou de um body. Segredos não podem ser usados em respostas fixas, prompts e entradas de LLM, nem em instruções de agentes: esse texto é devolvido a quem chamou ou enviado a um modelo.
Quem pode fazer o quê
| Leitor | Membro | Admin | Proprietário | |
|---|---|---|---|---|
| Ver os nomes dos segredos (para escrever templates) | — | ✓ | ✓ | ✓ |
| Ver os últimos 4 caracteres | — | — | ✓ | ✓ |
| Adicionar, substituir e excluir segredos | — | — | ✓ | ✓ |
| Revelar e trocar o segredo de assinatura | — | — | ✓ | ✓ |
Como eles são protegidos
- Criptografados em repouso com AES-256-GCM. Os valores nunca saem da API, exceto dentro da requisição em que são renderizados.
- Nunca no decision schema, na resposta da API, no log de execução nem no Playground: as prévias mostram
••••no lugar deles, e o log de entregas guarda só uma prévia mascarada de cada requisição — método, URL, headers e o tamanho do body. - A requisição completa, com os segredos, é guardada criptografada enquanto uma entrega ainda pode precisar dela — veja Entrega e novas tentativas.
Quando as mudanças valem
Os segredos são lidos quando a decisão roda: a Dcision renderiza a requisição com os valores atuais e a guarda, criptografada, para as tentativas.
- Um valor novo ou alterado vale para as próximas execuções. As entregas que já estão na fila — e as novas tentativas delas — mantêm a requisição com que foram renderizadas.
- Um destino que referencia um segredo inexistente falha a entrega na hora, com "Set the secret CRM_TOKEN in Settings → Destinations, then resend." — nada é enviado. Como a requisição foi renderizada sem o segredo, adicione-o e rode a decisão de novo: reenviar aquela entrega falha da mesma forma. Um agente no modo
syncdevolve"status": "failed"com a mesma orientação. - Excluir um segredo faz os destinos que o usam falharem até ele ser definido de novo.
O segredo de assinatura
Separado desses segredos, todo workspace tem um segredo de assinatura (whsec_…) que assina todas as suas entregas. Admins e o Proprietário o revelam e trocam em Configurações → Destinos → Segredo de assinatura — veja Verificar a assinatura e Trocar o segredo de assinatura.
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.
Entrega e retries
Como a Dcision entrega webhooks, requisições de API, workflows e repasses a agentes — pelo menos uma vez, seis tentativas em cerca de sete horas, Retry-After, timeouts, status, reenvios e retenção.