Variáveis e segredos

Variáveis e segredos levam configurações e chaves de API ao código do site sem escrevê-las nos arquivos.

Antes de começar

• O site precisa ser uma Landing Page ou uma Aplicação Web. A Página Estática não tem variáveis nem segredos.

Diferença entre variável e segredo

	Variável	Segredo
Exemplo	EMAIL_FROM, SITE_NAME	OPENROUTER_API_KEY, RESEND_API_KEY
Quem vê o valor	A IA e você, no painel	Ninguém depois de salvo
Como definir	Pela IA ou no painel	Pelo link seguro ou no painel, com a opção Segredo

Um segredo não pode ser lido de volta, nem pela IA. Para trocá-lo, salve um valor novo por cima.

Regras de nome e tamanho

• Letras maiúsculas, números e _, começando com letra: API_URL, STRIPE_SECRET_KEY.
• Alguns nomes de sistema são recusados, como PATH e HOME.
• O valor tem no máximo 5 KB.

Escopos: build, execução ou os dois

Escopo no painel	Quando o valor existe
Build	Só durante a publicação, quando o site é montado.
Execução	Só com o site no ar, no código do servidor.
Build e execução	Nos dois. Padrão das variáveis.

Segredos usam Execução por padrão. Na Landing Page, só páginas renderizadas sob demanda leem valores de execução.

Cuidado

Um segredo no escopo Build pode acabar copiado para os arquivos publicados. Só use Build num segredo quando a IA explicar por quê; a publicação é recusada se o valor aparecer nos arquivos gerados.

Definir uma variável

Pela IA

Defina a variável EMAIL_FROM do meu site como contato@minhaloja.com.br e publique.

Pelo painel

1. Abra o site e vá em Configurações → Variáveis e secrets.
2. Preencha Nome e Valor e, se quiser, clique em Alterar para mudar o escopo.
3. Clique em Salvar 1 valor e peça à IA para publicar de novo.

Informar um segredo pelo link seguro

A IA nunca pede um segredo na conversa: ela envia um link seguro onde você digita o valor.

1. Peça à IA para configurar a chave, por exemplo “configure a minha chave da OpenRouter”.
2. Abra o link. A página “Informe os valores do seu site” mostra os campos pedidos; você pode colar um .env inteiro.
3. Salve, avise a IA e peça para publicar de novo.

Cada link vale por 15 minutos. Se expirar, peça um novo. Você também pode digitar segredos em Configurações → Variáveis e secrets, marcando Segredo.

As mudanças valem na próxima publicação

Salvar uma variável ou um segredo não muda o site no ar; o valor entra na próxima publicação. Alguns templates exigem valores antes de publicar, como o Chatbot Customizado (veja Usar um template).

Variáveis em vars no wrangler.jsonc também valem; se o nome existir nas variáveis do site, o valor do site vence.

Nunca coloque chaves nos arquivos do site

A publicação é bloqueada se houver chave ou senha nos arquivos do site. A mensagem mostra o arquivo e a linha, e a versão anterior continua no ar. Peça à IA para mover o valor para um segredo e publicar de novo.

Perigo

Nunca cole chaves de API, senhas ou tokens na conversa nem peça para a IA escrevê-los em arquivos. Use o link seguro ou o painel.

Ver a configuração atual

Pergunte à IA quais variáveis e segredos o site tem: ela mostra nomes e valores das variáveis e só os nomes dos segredos. No painel, veja Variáveis e secrets.

Próximos passos

Banco de dados e KVGuarde dados do site entre visitas.

A publicação falhouEntenda erros de build, de segredos e de configuração.