← Central de Ajuda
🔵

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).

Gratuito ou pago? No nível gratuito, o Google pode usar as perguntas e respostas para melhorar os produtos dele, e os limites de uso são baixos. Para atender clientes, use o nível pago (Tela 4): os dados deixam de ser usados para treinar e os limites sobem. O crédito de boas-vindas de US$ 300 do Google Cloud não vale para o Gemini.

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.

Conta do Google Workspace (e-mail da empresa)? O acesso vem liberado, mas o administrador pode ter desligado. Se aparecer "você não tem acesso ao Google AI Studio", peça ao administrador do Workspace para ligar o AI Studio.

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.

Mensagem "You do not have permission to create a key in this project"? Você não tem permissão no projeto. Peça ao administrador do projeto (papel Editor) ou crie um projeto novo.

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.

Quando o saldo pré-pago chega a zero, todas as chaves daquela conta de faturamento param na hora (erro 402) — o atendimento com IA passa para a equipe até você recarregar. Por isso vale ligar a recarga automática.

Ú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

Este artigo ajudou? Se precisar de mais detalhe, escreva para [email protected].