Introdução

Especialista em WP Chat é um plugin avançado para WordPress que fornece um widget de chat inteligente alimentado por IA. Ele utiliza a API do Google Gemini para gerar respostas naturais e contextualmente relevantes, enquanto gerencia automaticamente o fluxo da conversa e a captura de leads potenciais.

O plugin é projetado para melhorar a experiência do usuário em seu site, fornecendo assistência imediata e capturando informações de contato valiosas de forma orgânica durante as conversas.

Principais características:

• Widget de chat com IA powered by Google Gemini
• Gerenciamento automático de estados de conversa
• Captura inteligente de leads
• Suporte multi-idioma completo
• Sistema de proteção anti-spam e banimentos
• Painel de administração completo
• Hooks extensíveis para desenvolvedores

Instalação e Configuração

Instalação do Plugin

1. Baixe o arquivo .zip do plugin Especialista em WP Chat.

2. No seu painel de administração do WordPress, vá para Plugins > Adicionar novo.

3. Clique no botão Carregar plugin na parte superior da página.

4. Selecione o arquivo .zip que você baixou e clique em Instalar agora.

5. Uma vez instalado, clique em Ativar plugin.

Configuração Inicial

Após ativar o plugin, um novo menu “Especialista em WP Chat” aparecerá no seu painel de administração.

1. Vá para Especialista em WP Chat > Configurações.

2. Preencha os campos básicos:

• Nome da Empresa: O nome da sua empresa ou site
• Nome do Agente: Como o bot será identificado (ex. “Assistente Virtual”)
• Informações Base: Informações sobre seu negócio, serviços e produtos que a IA usará para responder

Configuração da API do Google Gemini

Para que o chat funcione com IA, você precisa configurar sua chave de API do Google Gemini:

1. Obtenha sua chave de API em Google AI Studio.

2. Em Configurações, cole sua chave no campo “Chave da API do Google Gemini”.

3. Selecione o modelo do Gemini (por padrão: gemini-2.0-pro-exp-02-05).

4. Salve as alterações. O widget de chat aparecerá automaticamente em seu site.

Widget de Chat

Funcionamento do Chat

O widget de chat aparece como um botão flutuante no canto inferior direito do seu site. Os visitantes podem clicar para iniciar uma conversa.

Características do widget:

• Design responsivo que funciona em dispositivos móveis e desktop
• Indicadores de digitação em tempo real
• Persistência de conversas entre páginas
• Suporte para RTL (idiomas da direita para a esquerda)
• Modo de depuração opcional para desenvolvimento

Estados de Conversa

O plugin gerencia automaticamente diferentes estados durante a conversa:

• Início: Saudação inicial e consultas gerais
• Informação: Fornecendo informações sobre produtos/serviços
• Captura de Lead: Coletando dados de contato do usuário
• Despedida: Finalizando a conversa

A IA decide automaticamente quando fazer a transição entre os estados com base no contexto da conversa.

Captura de Leads

Quando a IA detecta interesse comercial, ela ativará automaticamente o modo de captura de leads:

1. Solicitará de forma natural o nome e e-mail do usuário.

2. Opcionalmente, pode pedir o número de telefone.

3. Os dados são salvos automaticamente no banco de dados.

4. Notificações configuráveis são enviadas aos administradores.

Os usuários podem “escapar” do modo de captura de leads se ainda tiverem dúvidas, retornando ao fluxo informativo.

Painel de Administração

Dashboard de Leads

Gerencie todos os leads capturados em Especialista em WP Chat > Leads:

• Lista de leads: Visualize todos os contatos capturados
• Status: Novo, Contatado, Fechado
• Ações em massa: Mude o status de múltiplos leads
• Histórico de conversa: Veja a conversa completa que levou ao lead
• Exportação: Possibilidade de exportar dados para CRMs externos

Cada lead inclui informações detalhadas como nome, e-mail, telefone (opcional) e o log completo da conversa.

Gestão de Banimentos

O plugin inclui proteção automática contra spam e comportamento abusivo:

1. Vá para Especialista em WP Chat > Banimentos para gerenciar IPs banidos.

2. Os banimentos são aplicados automaticamente quando conteúdo inapropriado é detectado.

3. Você pode desbanir IPs manualmente ou limpar o armazenamento local.

4. Os banimentos são temporários e são levantados automaticamente após o período estabelecido.

Configurações Avançadas

Opções adicionais disponíveis no painel de configuração:

• Modo de Depuração: Mostra informações técnicas para desenvolvimento
• Idioma da IA: Código do idioma para as respostas da IA
• Modelo do Gemini: Seleção do modelo de IA a ser utilizado
• Configuração de Sessões: Tempo de vida das sessões de chat

Suporte Multi-idioma

Idiomas Disponíveis

O plugin inclui suporte completo para múltiplos idiomas:

• Espanhol (es_ES): Idioma padrão
• Inglês (en_US): Suporte completo
• Outros idiomas: Facilmente extensível

Configuração de Idioma

1. Em Configurações, selecione o idioma padrão da interface.

2. Configure o “Idioma Padrão da IA” para as respostas da inteligência artificial.

3. A IA pode detectar automaticamente o idioma do usuário e adaptar suas respostas.

4. Os textos da interface se adaptam automaticamente ao idioma selecionado.

Personalização e Hooks

Hooks para Desenvolvedores

O plugin fornece múltiplos hooks para estender sua funcionalidade:

Hooks de ação:

• especialista_wp_chat_lead_captured – Executado quando um lead é capturado
• especialista_wp_chat_conversation_started – Ao iniciar uma conversa
• especialista_wp_chat_message_processed – Após processar uma mensagem

Integrações com CRM

Exemplo de integração com um CRM externo:

add_action('especialista_wp_chat_lead_captured', 'enviar_lead_a_crm', 10, 3);function enviar_lead_a_crm($lead_id, $lead_data, $conversation_history) {    // Seu código de integração com CRM aqui    // $lead_data contém: nome, e-mail, telefone, etc.    // $conversation_history contém o histórico completo}      

Solução de Problemas

O chat não aparece no site:

• Verifique se a chave da API do Gemini está configurada corretamente
• Certifique-se de que o plugin está ativado
• Verifique o console do navegador para erros de JavaScript

A IA não responde ou apresenta erros:

• Verifique sua chave da API no Google AI Studio
• Verifique se o modelo do Gemini selecionado está disponível
• Ative o modo de depuração para ver erros detalhados

Os leads não são salvos:

• Verifique se a tabela do banco de dados foi criada corretamente
• Verifique as permissões do banco de dados
• Verifique os logs do PHP para erros

Problemas de desempenho:

• O plugin usa transients para otimizar o desempenho
• Os banimentos e sessões são limpos automaticamente
• Considere usar cache de objeto para sites de alto tráfego

Para suporte adicional: Entre em contato com EspecialistaEmWP.com