APIs e .env

Todas as chaves de acesso que o sistema precisa. Onde obter, como configurar e quando renovar cada uma.

O arquivo .env fica na raiz do workspace e contem todas as chaves de API. Ele e gitignored — nunca vai para o repositorio. Cada novo membro da equipe precisa criar o seu a partir do template.

Criar o arquivo .env

Copie o template e edite com suas chaves reais:

Criar e abrir

$cp .env.example .env && code .env

Template completo

.env

# ===========================
# Nomics Hub — .env
# ===========================

# Google Gemini (transcricao, analise de imagem)
GEMINI_API_KEY=sua_chave_aqui

# Meta Ads (campanhas, criativos, metricas)
META_ADS_ACCESS_TOKEN=seu_token_aqui

# ClickUp (gestao de tarefas)
CLICKUP_API_KEY=sua_chave_aqui
CLICKUP_TEAM_ID=seu_team_id_aqui

# Freepik (imagens, vetores)
FREEPIK_API_KEY=sua_chave_aqui

# n8n (automacoes)
N8N_API_URL=https://auto.nomics.com.br
N8N_API_KEY=sua_chave_aqui

# Microsoft Clarity (heatmaps, sessoes)
CLARITY_API_TOKEN=seu_token_aqui

Nunca compartilhe esse arquivo

O .env contem tokens com acesso a contas de anuncios, automacoes e APIs pagas. Se vazar, qualquer pessoa pode gerenciar campanhas, criar automacoes ou consumir creditos. Veja Seguranca para mais detalhes.

Detalhes por API

GEMINI_API_KEYGoogle Gemini

Onde obter

Acesse o AI Studio, faca login com sua conta Google, clique em "Get API key" e copie.

https://aistudio.google.com/apikey

Permissoes necessarias

Acesso total a API do Gemini. Plano gratuito com rate limit.

Expiracao

Nao expira (enquanto a conta existir)

Testar

$curl -s "https://generativelanguage.googleapis.com/v1/models?key=$GEMINI_API_KEY" | head -5

META_ADS_ACCESS_TOKENMeta Ads

Onde obter

Abra o Graph API Explorer, selecione o app, marque as permissoes acima e clique em "Generate Access Token".

https://developers.facebook.com/tools/explorer/

Permissoes necessarias

ads_read, ads_management, read_insights. Selecione o app da Nomics e gere o token.

Expiracao

Expira a cada 60 dias. Renove antes para nao perder acesso.

Testar

$curl -s "https://graph.facebook.com/v22.0/me?access_token=$META_ADS_ACCESS_TOKEN"

CLICKUP_API_KEY + CLICKUP_TEAM_IDClickUp

Onde obter

Clickup > Settings > Apps > API Token > gere ou copie o token pessoal. O Team ID esta na URL do workspace.

https://app.clickup.com/settings/apps

Permissoes necessarias

Token pessoal com acesso ao workspace inteiro.

Expiracao

Nao expira (token pessoal)

Testar

$curl -s -H "Authorization: $CLICKUP_API_KEY" "https://api.clickup.com/api/v2/team"

FREEPIK_API_KEYFreepik

Onde obter

Freepik > Minha conta > API Keys > Criar nova chave.

https://www.freepik.com/api/keys

Permissoes necessarias

Acesso a API de busca de imagens e vetores.

Expiracao

Nao expira (enquanto a conta existir)

Testar

$curl -s -H "x-freepik-api-key: $FREEPIK_API_KEY" "https://api.freepik.com/v1/resources?term=test&limit=1"

N8N_API_URL + N8N_API_KEYn8n

Onde obter

No painel do n8n, va em Settings > n8n API > Create API Key. A URL e o endereco da sua instancia.

https://auto.nomics.com.br (Settings > n8n API)

Permissoes necessarias

Acesso a API do n8n para gerenciar workflows e execucoes.

Expiracao

Nao expira (gerenciado pelo admin)

Testar

$curl -s -H "X-N8N-API-KEY: $N8N_API_KEY" "$N8N_API_URL/api/v1/workflows?limit=1"

CLARITY_API_TOKENMicrosoft Clarity

Onde obter

Clarity > Projeto > Settings > API > Generate token.

https://clarity.microsoft.com (Dashboard > Settings > API)

Permissoes necessarias

Acesso somente leitura a heatmaps e sessoes. Limite: 10 chamadas/dia.

Expiracao

Nao expira (mas tem limite diario de 10 chamadas)

Testar

$curl -s -H "Authorization: Bearer $CLARITY_API_TOKEN" "https://www.clarity.ms/api/v1/projects"