Como criar a chave do Gemini e ligar o faturamento

O que o Fiber Desk vai pedir

Estes são os campos de Configurações → IA. O guia abaixo busca a chave.

Antes de começar

Duas coisas, e as duas levam menos de um minuto para conferir.

1. Uma conta Google Qualquer conta serve, inclusive um Gmail comum. Use uma conta da empresa, não a pessoal de um funcionário: a chave fica amarrada a ela, e quem sai da empresa leva o acesso junto.
2. Um cartão, se for ligar o faturamento Só para a segunda parte do guia. Para criar a chave e testar, nada é cobrado e nada é pedido.

1. Criar a chave

É a parte rápida. No fim dela você já consegue ligar a IA no Fiber Desk e testar.

1. Entre em aistudio.google.com/apikey Faça login com a conta Google da empresa. Esse é o Google AI Studio, o painel do Google para a API do Gemini. Logado com mais de uma conta Google no navegador? Confira no canto superior direito qual está ativa antes de criar a chave. Criar na conta errada é o engano mais comum aqui, e ele só aparece semanas depois, na hora da cobrança.
2. Clique em "Criar chave de API" O Google pede um projeto para guardar a chave. Se for a primeira vez, ele cria um sozinho; se já houver algum, escolha um ou crie um novo com o nome do provedor. Anote qual projeto você escolheu. O faturamento da segunda parte é ligado no projeto, não na chave, e com vários projetos na conta é fácil ligar no que não é o seu.
3. Copie a chave inteira Ela começa com AIza e tem cerca de 40 caracteres. Copie pelo botão da própria tela, sem selecionar com o mouse. A chave aparece inteira só nesse momento. Se fechar a tela sem copiar, não tem como revelar de novo: crie outra, que é de graça.
4. Cole no Fiber Desk No painel, abra Configurações → IA, escolha o provedor Gemini e cole a chave. A plataforma testa a chave na hora e só oferece os modelos que responderam de verdade. Guarde a chave num gerenciador de senhas, nunca num grupo de WhatsApp. Quem tem a chave gasta na conta do provedor.

2. Ligar o faturamento

Esta é a parte que evita o bot ficar mudo no dia de movimento. Sem ela a chave fica no plano gratuito, que tem limite por minuto e por dia.

1. Volte em aistudio.google.com/apikey Na mesma tela das chaves, procure a coluna Billing Tier (nível de faturamento) na linha do seu projeto. Projeto no gratuito aparece como Free.
2. Clique em "Set up billing" na linha do projeto O botão fica na própria coluna de faturamento. Ele também pode aparecer como Configurar faturamento, dependendo do idioma da conta. Não achou o botão? O mesmo caminho existe pelo menu lateral, no rodapé: Settings → Plan information. É a mesma tela por outra porta.
3. Escolha o país, aceite os termos e informe o pagamento Você pode usar uma conta de faturamento do Google que a empresa já tenha, ou criar uma na hora. É o mesmo cadastro de faturamento do Google Cloud. O país define a moeda e os impostos da conta, e não dá para trocar depois. Para empresa brasileira, escolha Brasil e informe o CNPJ.
4. Conclua o depósito mínimo, se for pedido Dependendo do país e do plano, o Google pede um valor inicial em crédito (hoje a partir de US$ 5) ou oferece a escolha entre pré-pago e pós-pago. No pré-pago, a API para de responder quando o saldo acaba, então deixe o alerta de saldo baixo ligado.
5. Confirme que saiu do gratuito Volte à tela de chaves e olhe a coluna Billing Tier do seu projeto. Ela precisa ter deixado de dizer Free. Enquanto disser, o limite antigo continua valendo. O Google às vezes demora alguns minutos para atualizar essa coluna. Se o cadastro foi aceito e ela não mudou, espere e recarregue a página antes de refazer o cadastro.

3. Controlar o gasto

Opcional, e recomendado. Leva dois minutos e evita susto na fatura.

1. Crie um alerta de orçamento No Google Cloud, em Faturamento → Orçamentos e alertas, crie um orçamento mensal para o projeto da chave. O Google manda e-mail ao chegar em 50%, 90% e 100% do valor. O alerta avisa, não corta. Ele serve para você descobrir um consumo fora do normal no mesmo dia, em vez de no fim do mês.
2. Acompanhe pelo próprio Fiber Desk O painel mostra o que a IA respondeu e o que foi para atendimento humano. Consumo alto sem aumento de atendimento costuma ser fluxo chamando a IA onde um menu resolveria.

Não funcionou?

Os casos que respondem por quase todos os chamados desta integração.