> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Gemini

> Configure o Google Gemini para escrever posts do blog e gerar emails no Notifuse.

![Google Gemini](https://www.notifuse.com/docs/assets/integrations/gemini.svg)

A integração Google Gemini faz o [assistente de IA](https://www.notifuse.com/pt/docs/features/ai-assistant.md) do Notifuse rodar com os modelos Gemini do Google, para escrever posts do blog, montar emails e analisar o tráfego na Web Analytics.

## Configuração

Vá em **Configurações** → **Integrações**, clique em **Adicionar integração** e escolha **Google Gemini** em **Assistente de IA**.

### Campos do formulário

| Campo         | Descrição                                                         | Exemplo                  |
| ------------- | ----------------------------------------------------------------- | ------------------------ |
| **Chave API** | A sua chave API do Gemini (Gemini Developer API)                  | `AIza...`                |
| **Modelo**    | Escolha um modelo sugerido ou digite qualquer ID de modelo Gemini | `gemini-3.1-pro-preview` |

O campo **Modelo** é texto livre com sugestões, então você pode informar qualquer ID de modelo Gemini atual sem esperar uma atualização do Notifuse.

### Modelo recomendado

| Modelo             | Descrição                                                                 | Preço em $ (por MTok)        |
| ------------------ | ------------------------------------------------------------------------- | ---------------------------- |
| **Gemini 3.1 Pro** | O modelo mais capaz, recomendado para a saída estruturada do agente de IA | $2 de entrada / $12 de saída |

> [!WARNING]
>
> O agente de IA gera templates de email estruturados em MJML e posts completos em HTML. Só modelos capazes, como o **Gemini Pro**, produzem um resultado correto. Os modelos mais leves **Flash** / **Flash-Lite** muitas vezes geram templates quebrados ou conteúdo malformado, por isso não os recomendamos para o agente.

## Recursos habilitados

Com a integração Google Gemini configurada, o assistente de IA pode fazer o seguinte.

### Agente de IA do blog

No blog, o agente de IA pode:

| Recurso                    | Descrição                                                                |
| -------------------------- | ------------------------------------------------------------------------ |
| **Escrever posts do blog** | Escrever artigos completos a partir de um tema ou de uma descrição curta |
| **Otimização para SEO**    | Gerar meta títulos, descrições e palavras-chave                          |
| **Edição de conteúdo**     | Melhorar, ampliar ou resumir um conteúdo existente                       |

### IA do editor de emails

No editor de emails, o agente de IA pode:

| Recurso                   | Descrição                                                   |
| ------------------------- | ----------------------------------------------------------- |
| **Geração de emails**     | Criar o conteúdo do email a partir de prompts ou descrições |
| **Linhas de assunto**     | Sugerir linhas de assunto                                   |
| **Variações de conteúdo** | Criar várias versões para testes A/B                        |

### Assistente da Web Analytics

Responda a perguntas sobre o tráfego do seu site com o [assistente da Web Analytics](https://www.notifuse.com/pt/docs/web-analytics/ai-assistant.md):

| Recurso                       | Descrição                                                            |
| ----------------------------- | -------------------------------------------------------------------- |
| **Perguntar sobre o tráfego** | Consultar sessões, páginas, origens e metas em linguagem comum       |
| **Resumos do período**        | Uma análise escrita do que mudou em relação ao período de comparação |
| **Controlar o dashboard**     | Mudar o período, aplicar filtros ou abrir um relatório do Explorar   |

## Com o Firecrawl

Adicionar a [integração Firecrawl](https://www.notifuse.com/pt/docs/integrations/firecrawl.md) dá ao agente de IA acesso à web:

| Recurso                     | Descrição                                                 |
| --------------------------- | --------------------------------------------------------- |
| **Pesquisa na web**         | Buscar na web informações e tendências atuais             |
| **Extração de URLs**        | Extrair o conteúdo de páginas específicas como referência |
| **Análise da concorrência** | Pesquisar o conteúdo e as estratégias dos concorrentes    |
| **Checagem de fatos**       | Conferir afirmações em fontes atuais da web               |

Com o Firecrawl configurado, o agente de IA passa a ter estas ferramentas:

| Ferramenta   | Descrição                                       |
| ------------ | ----------------------------------------------- |
| `scrape_url` | Extrai uma URL e devolve o conteúdo em markdown |
| `search_web` | Busca na web e devolve as URLs relevantes       |

## Pré-requisitos

Você precisa de:

1. Uma conta em [aistudio.google.com](https://aistudio.google.com)
2. Uma chave API gerada no [Google AI Studio](https://aistudio.google.com/apikey)
3. Cota suficiente, ou faturamento ativado, no seu projeto para o modelo escolhido

## Observações de uso

> [!NOTE]
>
> As chamadas de API ao Gemini contam no seu uso do Google AI. Você pode acompanhar os gastos no [Google AI Studio](https://aistudio.google.com).

> [!NOTE]
>
> O painel do assistente mostra o custo acumulado para os modelos Gemini com preço conhecido pelo Notifuse. Um ID de modelo que ele não reconhece continua funcionando, mas o custo da conversa aparece como `$0.0000`: veja no Google AI Studio quanto você gastou de fato.

> [!TIP]
>
> Modelos em preview, como o `gemini-3.1-pro-preview`, mudam com o tempo. Se um ID de modelo for recusado, veja a lista atual na [documentação de modelos da Gemini API](https://ai.google.dev/gemini-api/docs/models) e informe-o no campo **Modelo**.
