Conectar o Gemini (Google): manual tela a tela
Tempo: 5 a 10 minutos com a sua conta Google. Custo: existe um nível gratuito (com limites baixos) e o nível pago com créditos pré-pagos (mínimo US$ 5, valem por 12 meses, não reembolsáveis).
Tela 1 — Abrir o Google AI Studio
1. Acesse aistudio.google.com/api-keys e entre com a sua conta Google.
2. Aceite os termos no primeiro acesso.
Tela 2 — Projeto
Toda chave pertence a um projeto do Google Cloud — é ele que concentra a cobrança e os limites.
- Primeiro acesso: o AI Studio já cria um projeto padrão e uma chave para você.
- Já usa o Google Cloud? Os seus projetos não aparecem sozinhos. Vá em Dashboard → Projects → Import projects, procure o projeto e clique em Import.
- Recomendado: use um projeto só para a IA do atendimento (ex.: "atendimento-ia"). Assim o gasto e os limites ficam separados de outros sistemas da empresa.
Tela 3 — Criar a chave ("Criar uma nova chave")
1. Na página API Keys (Chaves de API), clique em Create API key (Criar chave de API).
2. Abre a janela "Criar uma nova chave":
- Dar um nome à chave: troque "Gemini API Key" por Blocks2Work (assim você sabe para que serve).
- Escolha um projeto importado: escolha o projeto da Tela 2. Se a lista estiver vazia ou faltar o projeto, importe-o primeiro (Tela 2).
3. Clique em Criar chave.
4. Na lista, clique na chave criada e no ícone de copiar.
Tela 4 — Ativar o nível pago (recomendado)
1. Na lista de chaves (ou em Projects), olhe a coluna Billing Tier / Plano do projeto. Se estiver Free, clique em Set up billing (Configurar faturamento).
2. Primeira vez no Google Cloud? Escolha o país, aceite os termos e informe contato e cartão. Já tem conta de faturamento? Escolha uma existente ou Add new billing account.
3. Faça a compra pré-paga (mínimo US$ 5). Algumas contas podem escolher entre Prepay (pré-pago) e Postpay (fatura no fim do mês).
4. Em aistudio.google.com/billing, ligue a recarga automática (Setup auto-reload) e defina um limite mensal de recargas.
5. Opcional: em aistudio.google.com/spend → Monthly spend cap → Edit spend cap, defina um teto de gasto do projeto.
Última tela: colar a chave na Blocks2Work
1. Na Blocks2Work, abra Configurações → Integrações e role até Inteligência artificial (ou use o botão Conectar minha conta de IA).
2. Escolha o provedor e cole a chave no campo Chave de API.
3. Deixe o modelo "rápido e barato" (é o ideal para atendimento) e ajuste o limite de respostas por dia — ele protege o seu gasto.
4. Clique em Testar e conectar. Testamos a chave na hora: se aparecer conectado em verde, está pronto.
A chave fica guardada criptografada e não aparece de novo. Só o dono ou um administrador da conta pode conectar.
Privacidade
As mensagens que o Atendente com IA responde são enviadas ao provedor escolhido para gerar a resposta, sob os termos da sua conta nesse provedor. Não coloque nas "Informações da empresa" nada que não possa ser dito a um cliente.
Deu erro?
- 402 / sem créditos ("No credits"): o saldo pré-pago acabou — compre créditos ou ligue a recarga automática (Tela 4).
- 429 / quota: limite do nível gratuito atingido — ative o nível pago (Tela 4) ou aguarde.
- 403 / permissão / chave bloqueada: a chave está restrita a outra API ou foi bloqueada. Crie uma chave nova no AI Studio.
- "Set up Prepay" na coluna de faturamento: a conta de faturamento existe, mas precisa da compra pré-paga para funcionar.
- Conta Google Cloud com pagamento atrasado em outros serviços também suspende o Gemini, mesmo com crédito.
Ainda precisa de ajuda?
Escreva para [email protected] com um print da tela (se houver erro). Respondemos em até 1 dia útil.
Última atualização: 2026-10-31