Como adicionar o Gemini ao WordPress – Guia passo a passo

30 de novembro de 2025

Quer adicionar o Google Gemini ao seu site WordPress? O plugin de IA certo faz mais do que apenas conectar uma API – ele treina o chatbot com base no seu conteúdo real, para que as respostas sejam precisas, específicas do seu site e úteis.

Veja como configurar e treinar tudo em menos de 10 minutos. Você está no lugar certo. Neste tutorial passo a passo, vou mostrar exatamente como adicionar o Google Gemini ao WordPress, mesmo que você nunca tenha feito nada parecido antes.

Sem necessidade de programação. Leva cerca de 10 minutos. Vamos lá 🚀

Purio AI Assistant
Purio AI Assistant
Send an Email
Como funciona?
1


O que é um plugin do Gemini AI para WordPress?

É um plugin do WordPress com tecnologia de IA que conecta o Google Gemini ao seu site, permitindo que os visitantes interajam com um assistente de IA diretamente nas suas páginas. Também existem muitas outras ferramentas de IA para WordPress para criação de conteúdo, SEO etc., mas neste artigo vamos focar em um chatbot de IA treinado com o conteúdo do seu site.

Um plugin do Gemini treinado vai além: ele “aprende” o seu conteúdo real – páginas, posts do blog, produtos, FAQs – e usa esse conhecimento para responder a perguntas. Quando alguém pergunta “Vocês enviam para o Canadá?” ou “Qual é a política de devolução?”, a IA busca as respostas no seu site, não inventa.

Isso se chama RAG (Geração Aumentada por Recuperação). O chatbot primeiro pesquisa no seu conteúdo e, em seguida, o envia ao Gemini para gerar uma resposta relevante e precisa. O resultado: respostas específicas para o seu negócio, e não palpites genéricos de IA.

Se lhe interessam os aspetos técnicos, veja o nosso artigo sobre como funcionam os chatbots com tecnologia RAG.

O que observar em um plugin do Gemini para WordPress:

  •  Content training – can it learn from your pages, posts, and products?
  •  WooCommerce support – does it understand product filters, stock, pricing?
  •  Knowledge sources – can you point it to specific pages (shipping policy, terms) for sensitive topics?
  •  Custom instructions – can you set the tone, persona, and guardrails?
  •  Multiple AI models – Gemini is great, but having Gemini as an option is useful

Para uma comparação direta de chatbots que oferecem suporte nativo ao WooCommerce, confira nosso comparativo de chatbots de IA para WooCommerce.

O que você precisa para adicionar o Gemini ao WordPress?

  • Site WordPress 🙂
  • Um plugin de chatbot de IA (vou apresentar as opções abaixo)
  • Chave de API da OpenAI ou do Google (leva 2 minutos para ser criada)
  • Cerca de 10 a 15 minutos

É isso. Vamos lá.

Etapa 1: Escolha um plugin de chatbot de IA para WordPress

Agora você precisa de um plugin do WordPress para conectar tudo. Existem várias opções por aí – AI Engine, Tidio, etc.

Eu uso o plugin de chatbot PurioChat WP, que tem uma versão gratuita para você começar.Ele é realmente nativo do WordPress e funciona com qualquer tema WordPress, além de treinar o chatbot com o conteúdo real do seu site.

Baixar plugin →

Para instalar:

  1. Baixe o plugin no site: Download do PurioChat
  2. Vá para WordPress → Plugins → Adicionar novo → Enviar plugin
  3. Envie o arquivo zip, instale e ative

Isso é tudo para a configuração básica.

Etapa 2: Obtenha uma chave da API do Google Gemini

Primeiro: você precisa de uma chave de API para conectar seu site ao Gemini. Basicamente, é uma senha que permite que seu chatbot converse com a IA.

Você pode escolher o Google ou o Google (Gemini). Ambos funcionam muito bem. Veja como obter cada um:

Se você prefere gerenciar vários provedores de IA em um só lugar, leia o guia de chatbot WordPress compatível com OpenRouter antes de escolher a configuração do seu modelo.

Você só precisa de uma única chave de API do Google. Veja como obtê-la:

Obtenha sua chave de API do Google Gemini

O Gemini tem um plano gratuito, o que é ótimo para testar:

  1. Acesse aistudio.google.com/api-keys
  2. Clique em “Criar chave de API“
  3. Escolha um projeto do Google Cloud (ou crie um)
  4. Copie sua chave

Pronto. Literalmente 30 segundos.

Limites do plano grátis: 10 requisições por minuto, 250 requisições por dia para o Gemini 2.5 Flash. Bom o bastante para testes e sites com pouco tráfego.

Para uso em produção, você vai querer ativar o faturamento. O Gemini 2.5 Flash custa cerca de US$ 0,30 por milhão de tokens de entrada – bem barato – semelhante ao Gemini: ~US$ 5 por 5.000 mensagens. Só tenha em mente que o Gemini cobra após o ciclo (não é pré-pago como a OpenAI), então fique de olho no seu uso.

Etapa 3: Conecte sua chave de API no WordPress

Agora vamos conectar tudo:

  1. Na barra lateral do WordPress, encontre PurioChat
  2. Vá para a aba Configurações
  3. Cole sua chave de API da OpenAI ou da Gemini
  4. Escolha seu modelo de IA (eu gosto do GPT-5.1 e do Gemini Flash 2.5)
  5. Salvar

Etapa 4: Treinar o Chatbot

Esta é a parte mais importante – o chatbot precisa aprender o que há no seu site.

  1. Vá para a aba Treinamento de dados
  2. Clique em “🚀 Iniciar treinamento”
  3. Aguarde a conclusão do processo

O plug-in examina seu conteúdo e cria embeddings (basicamente um índice pesquisável) que a IA usa para encontrar itens relevantes ao responder a perguntas.

Use seu prompt do sistema como uma cola. Na versão gratuita, você tem 1000 caracteres – o suficiente para incluir suas informações de contato, política de envio, política de devolução, horário de atendimento e respostas para perguntas comuns. A IA usa isso para responder sem nem precisar pesquisar no seu banco de dados.

A versão gratuita permite treinar com todos os posts do blog. Você pode adicionar alguns posts e usá-los como fonte sobre o seu site e também transformá-los em artigos otimizados para SEO. Todo mundo ganha! A versão Pro libera páginas, produtos, Tipos de Post Personalizados e PDFs enviados.

Exemplo:

Somos uma torrefação de café sediada em Portland. Enviamos grãos frescos semanalmente.

TRANSPORTE: Gratuito acima de $35, caso contrário, $5,99. Envio em até 2 dias.
DEVOLUÇÕES: reembolso total em até 14 dias se não for aberto.
CONTATO: [email protected], de segunda a sexta, das 9h às 17h PST

Popular: Yirgacheffe da Etiópia ($18), House Blend ($14)
Assinaturas: 10% de desconto, cancelamento a qualquer momento na página da conta.

A IA vai usar essas informações para responder a perguntas mesmo sem consultar seu banco de dados. Se alguém perguntar “vocês oferecem assinaturas?”, ela já vai saber.

Etapa 5: Personalize as respostas da IA para o seu site WordPress

Mantenha as respostas curtas

Adicione isso ao prompt do sistema:

Mantenha as respostas breves, com menos de 100 palavras. Faça um link para as páginas relevantes para obter detalhes.

Respostas mais curtas = respostas mais rápidas.

O chatbot funciona bem, mas você pode torná-lo muito melhor informando-o sobre o seu site. Encontre as instruções personalizadas ou o campo de prompt do sistema e adicione algum contexto:

IMPORTANT:
- This is [describe your site - what you sell/do]
- If users ask about [common question], tell them [answer]
- If users ask about [another common thing], explain [how it works]

CONTACT INFO:
- Email: [email protected] 
- Phone: your number
- Hours: when you're available

Por exemplo, uma loja on-line pode usar:

IMPORTANTE:
- Esta é uma loja de móveis on-line com remessa mundial.
- Se os usuários perguntarem sobre os pedidos, eles poderão rastreá-los em "My Account" ou enviar um e-mail para o suporte.
- Se os usuários perguntarem sobre devoluções, aceitamos devoluções no prazo de 30 dias.

CONTATO: [email protected], de segunda a sexta, das 9h às 17h

Correção rápida para resultados vazios

Se o chatbot não retornar nada quando alguém pedir por “bons fones de ouvido” ou “restaurante legal” – pode ser que ele esteja filtrando automaticamente por avaliações altas. Adicione esta linha:

Não aplique um filtro de classificação a menos que o usuário o solicite especificamente.

Adicionar fonte de conhecimento (Pro)

Este é um recurso extra que orienta a IA a usar uma página ou documento específico ao responder perguntas sobre um tema em particular. Útil para tópicos sensíveis em que a precisão é essencial (e.g.
páginas legais, políticas de envio, termos de serviço).

Sc

PurioChat → Chat com IA → Ferramentas de IA → Prompt do Sistema → Adicionar Fonte de Conhecimento

Clique no botão Adicionar fonte de conhecimento abaixo da área de texto do Prompt do sistema, preencha o
tópico e selecione uma página/documento, e a instrução é adicionada automaticamente ao seu
prompt do sistema.

  • Pesquisas em páginas, posts de blog, documentos PDF e páginas externas
  • Máx. 2 posts podem ser referenciados por consulta de busca da IA
  • O conteúdo é obtido diretamente (até 8000 caracteres por post) e combinado com
    resultados normais de busca por IA
  • A instrução é traduzível – funciona em qualquer idioma Exemplos de instruções (geradas automaticamente): Quando o usuário perguntar sobre envio, entrega, devoluções – pesquise no post ID 99 (“Política de Envio
    ”). Quando o usuário perguntar sobre reembolsos, cancelamentos – pesquise no post ID 105 (“Termos &
    Condições”).

Como funciona: Quando um visitante pergunta sobre um tópico correspondente, a IA busca diretamente o conteúdo da página referenciada e também faz uma busca comum em todo o conteúdo treinado – oferecendo a resposta mais precisa possível a partir da fonte exata que você especificou.

Etapa 6: Personalize o widget do chatbot no WordPress

A configuração básica está pronta, mas há várias opções para deixar o chatbot mais adequado ao seu site. Vá até a aba AI Chat nas configurações.

Precisa de mais do que chat em texto? O guia separado sobre chatbots para WordPress com entrada de imagem e voz explica quando vale a pena adicionar visão e conversão de fala em texto.

Configurações básicas

  • Nome do chatbot – o que aparece no cabeçalho do chat (padrão: “Assistente”)</numerusform code only with translated HTML.
  • Mensagem de boas-vindas – a primeira mensagem que os visitantes veem ao abrir o chat. Algo como “Olá! Posso ajudar você a encontrar produtos ou responder a perguntas. O que você está procurando?”
  • Modelo de IA – escolha o modelo de sua preferência, como GPT 5.1 ou Gemini 3 Pro / 2.5 Flash
  • Resultados máximos – quantos itens exibir nos resultados de pesquisa (5–50)

Aparência do widget

Você pode personalizar a aparência do balão de bate-papo flutuante:

  • Ícone personalizado do botão – faça upload do seu próprio ícone SVG
  • Mensagem de boas-vindas – o pequeno texto que aparece acima do botão do chat (“Olá! Como posso ajudar?”)
  • Largura/altura do pop-up – redimensione a janela do chat (padrão 390x600px)
  • Cor do botão & cor primária – combine com as cores da sua marca
  • Esquema de cores escuro, claro ou automático
  • Estilo de Cabeçalho Inicial – Escolha entre um cabeçalho simples (padrão) (seção superior da janela de chat) ou um cabeçalho com imagem de fundo para a visualização inicial do cabeçalho (antes da primeira mensagem). Isso funciona apenas com o widget flutuante, não com shortcodes. Permite personalizar visualmente a janela de chat para combinar com a sua marca.

Opções de privacidade e acesso

  • Exigir login para usar o chat – apenas usuários conectados podem conversar (útil para sites de membros)
  • Ativar o rastreamento do histórico de conversas – salva as conversas para análises (excluídas automaticamente após 30 dias)
  • Mostrar aviso de Termos de Uso – adiciona um aviso de termos para conformidade
  • Ocultar o chat em páginas selecionadas – desative o widget em páginas específicas, como Carrinho, Finalização de compra e Minha conta

Usando o código curto

Não quer o widget flutuante? Use o shortcode:

[ ai_chat ]

Você pode personalizá-lo com parâmetros:

[ ai_chat height="600px" style="2" ]

Isso permite que você incorpore o chat em qualquer lugar – em uma página, na barra lateral ou em seções específicas do seu site.

É isso – você terminou! 🎉

Sério, esse é todo o processo. Seu site agora tem um chatbot de IA que:

  • Compreende perguntas em linguagem natural
  • Busca respostas em seu conteúdo real
  • Funciona 24 horas por dia, 7 dias por semana, sem que você precise fazer nada

Se você estiver configurando isso para sites de clientes, o artigo chatbots WordPress para agências detalha licenciamento e revenda.

Se você estiver configurando isso para sites de clientes, o artigo chatbots para agências no WordPress explica detalhadamente a parte de licenciamento e revenda.

Perguntas sobre configuração do Gemini no WordPress

Qual é o custo de operação?

Os custos da API são normalmente de $5-15/mês para sites de pequeno a médio porte. Muito menos do que a maioria dos serviços de chatbot por assinatura.

Isso deixará meu site mais lento?

Não. O chatbot é carregado de forma assíncrona, o processamento de IA ocorre nos servidores OpenAI/Google. A pesquisa do conteúdo do site ocorre em seu servidor por meio do cálculo de similaridade de cosseno das incorporações (alerta de nerd)

Preciso criar fluxos de conversa ou árvores de decisão?

Não. Você só escreve instruções em linguagem simples — como se estivesse orientando um novo funcionário. “Mantenha um tom amigável, sugira o WhatsApp se a pessoa não encontrar o que precisa, evite jargão técnico.” O IA entende o resto.

É multilíngue?

Funciona em qualquer idioma. Você pode até mesmo instruí-lo a traduzir as consultas antes de pesquisar se o seu conteúdo estiver em um idioma específico.

Alguém pode enviar spam para o chatbot?

Não. Há duas camadas de limitação de taxa — no lado do cliente (cache do navegador) e no lado do servidor. Portanto, mesmo que alguém tente abusar, vai bater nos limites logo no início.

Quando Você Precisa de um Plugin Completo de Chatbot de IA para WordPress?

Se você precisar de mais, a versão Pro (US$ 59, pagamento único) adiciona:

Se você está substituindo um widget hospedado em vez de começar do zero, compare a configuração nativa do WordPress com estas alternativas SaaS: Chatbase, ChatBot.com, Jotform e Lyro AI/Tidio.

  • Histórico de conversas do chat – veja o que os visitantes estão perguntando
  • Pesquisa em posts e páginas – a IA pesquisa em todo o seu conteúdo
  • Filtros do WooCommerce – filtrar por preço, estoque, avaliações, itens em promoção
  • Cartões de produtos no chat – mostre cartões de produtos reais, não apenas texto
  • Tipos de post personalizados – treine com qualquer tipo de conteúdo
  • Treinamento em PDF – envie manuais, FAQs, documentos
  • Remover branding – sem rótulo “powered by”

Se você quiser conferir alternativas ao PurioChat, pode ler nosso artigo de comparação entre diferentes chatbots para WordPress → Se você quer uma análise mais focada exatamente neste caso de uso, confira nosso guia do melhor plugin de IA Gemini. Se você ainda está comparando abordagens de chatbot antes de instalar qualquer coisa, este guia mais completo de configuração de chatbot no WordPress explica os principais casos de uso, benefícios e concessões.

Links:

Purethemes