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

# OpenAI

> Configure a OpenAI para escrever posts do blog e gerar emails no Notifuse.

![OpenAI](https://www.notifuse.com/docs/assets/integrations/openai.png)

A integração OpenAI faz o [assistente de IA](https://www.notifuse.com/pt/docs/features/ai-assistant.md) do Notifuse rodar com os modelos GPT, 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 **OpenAI** em **Assistente de IA**.

### Campos do formulário

| Campo                     | Descrição                                                                                                     | Exemplo                        |
| ------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| **Chave API**             | A sua chave API da OpenAI                                                                                     | `sk-proj-...`                  |
| **Modelo**                | O ID do modelo a usar. É texto livre, então qualquer modelo atual ou futuro funciona                          | `gpt-4.1`                      |
| **URL base**              | Opcional. O endpoint da API, para provedores compatíveis com a OpenAI. Deixe vazio para usar a própria OpenAI | `https://openrouter.ai/api/v1` |
| **Esforço de raciocínio** | Opcional. Quanto os modelos de raciocínio pensam: Nenhum, Mínimo, Baixo, Médio, Alto ou Muito alto            | `Default`                      |

### Como escolher um modelo

O campo Modelo é texto livre, então você pode usar um modelo lançado depois da sua versão do Notifuse. Digite o ID exatamente como o seu provedor o escreve.

| Modelo      | Indicado para                                          |
| ----------- | ------------------------------------------------------ |
| **GPT-4.1** | O padrão. Confiável para templates MJML e posts longos |
| **GPT-5.4** | Raciocínio complexo e as gerações mais exigentes       |
| **o4-mini** | Raciocínio mais barato para tarefas curtas e simples   |

Veja os preços atuais na [página de preços da OpenAI](https://platform.openai.com/docs/pricing).

> [!NOTE]
>
> Deixe **Esforço de raciocínio** em Padrão para modelos sem raciocínio, como o GPT-4.1. Os provedores que não aceitam essa opção a ignoram. Se as respostas vierem cortadas, reduzir o esforço deixa uma parte maior do limite de saída para a resposta visível.

> [!NOTE]
>
> O painel do assistente mostra o custo acumulado das conversas com Anthropic e Gemini, mas não com OpenAI. Como qualquer ID de modelo é aceito, incluindo todos os modelos do OpenRouter e qualquer runtime self-hosted, o Notifuse não tem uma tabela de preços para calcular esse custo. Acompanhe os gastos no painel do seu provedor.

## Recursos habilitados

Com a integração OpenAI 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       |

## Como usar o OpenRouter

O [OpenRouter](https://openrouter.ai) é um gateway de API que dá acesso a centenas de modelos de IA (Google Gemini, Meta Llama, Mistral, DeepSeek e outros) por um único endpoint compatível com a OpenAI.

A integração OpenAI do Notifuse usa o SDK padrão da OpenAI, então você pode apontá-la para o OpenRouter pelo campo **URL base**:

### Campos do formulário para o OpenRouter

| Campo         | Descrição                                | Valor                          |
| ------------- | ---------------------------------------- | ------------------------------ |
| **Chave API** | A sua chave API do OpenRouter            | `sk-or-v1-...`                 |
| **Modelo**    | Qualquer modelo disponível no OpenRouter | `google/gemini-3-pro-preview`  |
| **URL base**  | A URL base da API do OpenRouter          | `https://openrouter.ai/api/v1` |

Assim, os recursos de IA do Notifuse podem usar qualquer modelo do OpenRouter, incluindo o Qwen. O mesmo campo funciona com qualquer outro endpoint compatível com a OpenAI: o Azure OpenAI ou um runtime self-hosted como Ollama, vLLM ou LiteLLM.

> [!TIP]
>
> Compare os modelos disponíveis em [openrouter.ai/models](https://openrouter.ai/models).

> [!WARNING]
>
> O agente de IA gera templates de email estruturados em MJML e posts completos em HTML. Só modelos bons em código (por exemplo, GPT-4.1, Claude Sonnet, Gemini Pro) produzem um resultado correto. Modelos menores podem gerar templates quebrados ou conteúdo malformado.

## Pré-requisitos

Você precisa de:

1. Uma conta em [platform.openai.com](https://platform.openai.com)
2. Uma chave API gerada no painel da OpenAI
3. Créditos de API suficientes na conta

## Observações de uso

> [!NOTE]
>
> As chamadas de API aos modelos GPT contam no uso da sua conta OpenAI. Você pode acompanhar os gastos no painel da OpenAI.

> [!TIP]
>
> O **GPT-4.1** atende à maioria dos usos. Passe para um modelo de raciocínio em trabalhos criativos complexos, ou para uma variante mini ou nano em tarefas simples e de grande volume.
