# Conectar o Google Gemini

> Crie uma chave de API no Google AI Studio e cole em Configurações › Integrações › Google Gemini. O uso é cobrado pelo Google, à parte do plano.

Endereço: https://help.nextags.com.br/tutoriais/ia/conectar-gemini/
Tipo: Tutorial · Básico

Atualizado em: 25/10/2026

> **Resposta rápida**
>
> Crie uma chave em [aistudio.google.com/apikey](https://aistudio.google.com/apikey). Na NexTags, abra **Configurações** › **Integrações** › **Google Gemini**, clique em **Conectar**, cole a chave em **Chave de API** e clique em **Continuar**.

**Antes de começar**

- Uma conta Google com acesso ao Google AI Studio. O uso da IA é cobrado pelo Google, à parte do plano da NexTags. Veja [Quanto custa usar a IA](https://help.nextags.com.br/tutoriais/ia/custos-da-ia/).
- Acesso às **Configurações** da NexTags no seu usuário.

## Passo a passo

### Passo 1: Crie a chave de API no Google AI Studio

Entre em [aistudio.google.com/apikey](https://aistudio.google.com/apikey) com a sua conta Google e clique em **Create API key**. Na primeira vez, o Google cria um projeto para você. Copie a chave.

Trate a chave como uma senha: não mande por chat ou e-mail. Se ela vazar, crie outra e desative a antiga no AI Studio.

Tutorial oficial: [documentação do Gemini](https://ai.google.dev/gemini-api/docs/api-key).

### Passo 2: Abra o Google Gemini em Configurações › Integrações

No pé do menu, clique em **Configurações** e abra a aba **Integrações**. Clique no cartão **Google Gemini** (1) e em **Conectar** (2).

![Cartão Google Gemini aberto em Configurações › Integrações, Não conectado, com o botão Conectar.](https://help.nextags.com.br/_img/ia-agentes/gemini-conectar.webp)
*1. O cartão Google Gemini, ainda Não conectado. 2. Conectar.*

1. **Google Gemini**: o cartão abre com um clique. **Não conectado** mostra que a conta ainda não tem o Gemini.
2. **Conectar**: abre a janela da chave.

### Passo 3: Cole a chave e continue

Na janela **Google Gemini**, cole a chave em **Chave de API** (1). Quando o Google aceita a chave, o **Continuar** (2) é liberado. Clique nele.

![Janela Google Gemini com o campo Chave de API preenchido com uma chave de exemplo e os botões Cancelar e Continuar.](https://help.nextags.com.br/_img/ia-agentes/gemini-chave.webp)
*1. A chave colada. 2. Continuar.*

1. **Chave de API**: a chave do AI Studio. A do print é só um exemplo.
2. **Continuar**: conecta o Gemini à conta.

### Passo 4: Confira a conexão

O cartão passa a mostrar **Conectado**, com os ajustes da IA logo abaixo:

![Cartão Google Gemini conectado, com Desconectar e os interruptores Resposta Automática por IA e Transcrever mensagens de voz.](https://help.nextags.com.br/_img/ia-agentes/gemini-conectado.webp)
*O cartão Google Gemini conectado.*

1. **Conectado**: o Gemini está ligado à conta. Ao lado do nome, **Desconectar** tira o Gemini da conta.
2. **Resposta Automática por IA**: o agente padrão responde às mensagens antes do fluxo de fallback. Já vem ligada. Veja [Agente padrão e resposta automática por IA](https://help.nextags.com.br/tutoriais/ia/agente-padrao/).
3. **Transcrever mensagens de voz**: a IA transforma os áudios dos contatos em texto antes das automações. Com ela e a Resposta Automática por IA ligadas, aparece também **Resposta automática de voz**, que responde em áudio a quem mandou áudio.

### Passo 5: Salve se mudou algum ajuste

Ao ligar ou desligar um interruptor, aparece no alto da tela a barra com **Salvar** (1). Clique nele para guardar.

![A barra no alto da tela, com os botões Cancelar e Salvar.](https://help.nextags.com.br/_img/ia-agentes/salvar.webp)
*1. Salvar.*

1. **Salvar**: guarda a mudança. **Cancelar** desfaz.

> **Faixa gratuita do Gemini:**
> O Google oferece uso gratuito de alguns modelos, com limites. Na faixa gratuita, o Google pode usar o conteúdo para melhorar os produtos dele; na paga, não. Para conversas com dados de clientes, confira as condições na [página de preços do Gemini](https://ai.google.dev/gemini-api/docs/pricing).

## Pronto: como conferir

- Em **Configurações** › **Integrações**, o cartão **Google Gemini** mostra **Conectado**.
- No editor do agente, os modelos do Google aparecem em **Modelo (Gemini)**. Veja [Criar um agente de IA](https://help.nextags.com.br/tutoriais/ia/criar-agente/).

## Se não funcionou

### O Continuar não libera

A NexTags ainda não recebeu a resposta do Google ou a chave não foi aceita. Confira se você colou a chave inteira, sem espaço no começo ou no fim.

### Apareceu "Não foi possível concluir esta operação."

O Google recusou a chave. Crie outra no [AI Studio](https://aistudio.google.com/apikey) e cole de novo.

### O botão Create API key não aparece no AI Studio

O seu usuário pode não ter permissão no projeto do Google Cloud. Peça a quem administra o projeto para liberar o acesso ou criar a chave.

### A IA parou de responder de repente

Confira no AI Studio se a chave continua ativa e se o projeto não passou dos limites da faixa gratuita. Veja também [O agente de IA não está respondendo](https://help.nextags.com.br/perguntas/ia/ia-nao-responde/).

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
Vou conectar o Google Gemini na NexTags. Leia este tutorial: https://help.nextags.com.br/tutoriais/ia/conectar-gemini.md

Me explique, em passos curtos, como criar a chave no Google AI Studio, a diferença entre a faixa gratuita e a paga do Gemini para um atendimento com dados de clientes e como acompanhar o uso. Não me peça para colar a chave aqui.
```
