Como adicionar chaves de API e segredos no ChanTan Studio

Guarde a chave de um serviço como Stripe ou Resend para seu app usar com segurança: colada uma vez, criptografada, nunca exibida no chat nem no seu código.

Alguns recursos precisam de uma chave de um serviço de fora — um meio de pagamento, um serviço de envio de e-mail, um serviço de mapas. Uma chave é como uma senha que deixa seu app conversar com aquela empresa. Para uma confeitaria que começa a vender brigadeiros pelo site, por exemplo, é a chave do Stripe que permite receber os pedidos.

ChanTan guarda essas chaves em “Segredos” — “Adicione informações sensíveis, como chaves de API, de que seu app precisa para funcionar com segurança.”

O caminho mais fácil é não fazer nada. Quando um recurso precisa da sua chave, a IA mostra um card mascarado de “cole sua chave” logo abaixo da mensagem dela no chat. A chave vai direto para o armazenamento criptografado, é usada só no servidor e nunca aparece no chat nem no seu código.

Esta página é para quando você quiser adicionar ou trocar uma chave por conta própria.

1. Abra “Gerenciar ▾” → “Banco de dados”

No topo do seu projeto, aperte “Gerenciar ▾” e depois “Banco de dados”.

2. Vá em “Avançado” → “Segredos”

Em “A sala de máquinas do seu app”, encontre a fileira mais discreta “Avançado” e abra “Segredos”.

3. Aperte “Novo segredo”

Aparece um formulário pedindo um nome e um valor.

4. Digite o nome, cole o valor

O “Nome” é um rótulo (por exemplo, o nome que o serviço mandou você usar). O “Valor” é a chave em si — cole exatamente como está, sem espaços a mais.

⚠️ Nomes que começam com CHANTAN_ são recusados. Eles são reservados: “ChanTan gerencia alguns segredos para você nos bastidores, para que seu app possa usar IA. Eles ficam protegidos e escondidos aqui.” Você não pode mudar nem excluir esses, e não precisa.

5. Aperte “Criar segredos”

✅ Pronto. Sua chave agora aparece na lista mostrando só o nome e a data — nunca o valor em si. Isso é de propósito: depois de salvar, o valor nunca mais é exibido, nem para você.

Trocar uma chave que mudou

Peça no chat — algo como “minha chave do Stripe mudou” — e um card “Substituir chave” aparece para você colar a nova.

Excluir uma chave

Para excluir, você precisa digitar antes a palavra excluir, porque remover uma chave pode fazer parte do seu app parar de funcionar.

⚠️ Anote suas chaves em um lugar seguro, só seu. ChanTan nunca mostra de novo um valor salvo, então se você excluir uma chave e não tiver cópia em outro lugar, vai precisar pedir uma chave nova ao serviço.

Relacionado: código de servidor que usa suas chaves

Webhooks e integrações do lado do servidor (retornos de pagamento, por exemplo) rodam como “Edge Functions” — “Pequenos trechos de código no servidor que fazem funcionar coisas como webhooks de pagamento e integrações. Peça à IA no chat para adicionar uma.”

Essa tela é uma lista somente leitura — não existe botão de “criar”, de propósito. Para adicionar uma, descreva o que você precisa no chat.

Limites honestos

• Suas chaves nunca vão para o GitHub. Se você usar “Enviar para o GitHub”, recebe o aviso: “Suas chaves do banco de dados foram substituídas por marcadores — elas nunca são enviadas ao GitHub.”
• As chaves são usadas só no servidor — elas não chegam ao navegador de quem visita seu app.
• Os recursos de IA dentro do seu app não precisam de chave nenhuma. Chatbots, geração de imagens e leitura de imagens funcionam de cara, cobrados da sua carteira de créditos.
• ChanTan não consegue buscar uma chave para você. Se você a perdeu, pegue uma nova no serviço que a emitiu e cole a nova.

Se algo der errado