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:

OndeExemplo
Um valor de headerAuthorization: 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ê

LeitorMembroAdminProprietá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 sync devolve "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.

Nesta página