📚 Manual Administrativo

ConectaKS-Chat v2.0 - Guia Completo de Instalação e Configuração

Versão 2.0

Instalação do Plugin

1

Pré-requisitos

Antes de instalar o plugin, certifique-se de que seu site atende aos seguintes requisitos:

  • WordPress: Versão 5.0 ou superior
  • PHP: Versão 7.4 ou superior
  • Permissões: Acesso de administrador ao WordPress
  • Espaço: Aproximadamente 50KB de espaço em disco
💡 Dica: Você pode verificar a versão do WordPress em Painel Admin → Atualizações e a versão do PHP em Ferramentas → Informações do Site.
2

Download do Plugin

Baixe o arquivo do plugin:

  • Clique no botão "Baixar Plugin" na landing page
  • Ou baixe diretamente o arquivo ConectaKS-Chat-v2.0.zip
  • Salve o arquivo em uma pasta de fácil acesso no seu computador
✅ Arquivo baixado com sucesso!
O arquivo ZIP contém todos os arquivos necessários para o funcionamento do plugin.
3

Acesso ao WordPress

Entre no painel administrativo do seu site WordPress:

  • Abra seu navegador e acesse: seudominio.com/wp-admin
  • Faça login com suas credenciais de administrador
  • Certifique-se de ter permissões para instalar plugins
⚠️ Importante: Você precisa ter permissões de administrador para instalar plugins. Se você não tem essas permissões, entre em contato com o administrador do site.
4

Instalação via Upload

Siga estes passos para instalar o plugin:

  • No menu lateral, clique em "Plugins"
  • Clique em "Adicionar Novo"
  • Clique em "Enviar Plugin"
  • Clique em "Escolher Arquivo" e selecione o arquivo ZIP baixado
  • Clique em "Instalar Agora"
Caminho: Plugins → Adicionar Novo → Enviar Plugin → Escolher Arquivo → Instalar Agora
5

Ativação do Plugin

Após a instalação bem-sucedida:

  • Clique em "Ativar Plugin"
  • Ou vá em "Plugins" → "Plugins Instalados"
  • Encontre "ConectaKS - Gpt" na lista e clique em "Ativar"
🎉 Plugin ativado com sucesso!
O botão de chat já deve estar aparecendo no seu site.
6

Verificação da Instalação

Verifique se a instalação foi bem-sucedida:

  • Acesse o frontend do seu site
  • Verifique se o botão de chat está visível no canto inferior direito
  • Teste o clique no botão para abrir o chat
  • Verifique se o posicionamento está correto em desktop e mobile
🔍 Verificação: Se o botão não aparecer, verifique se o plugin está ativado e se as configurações de exibição estão corretas.

Acesso ao Painel de Configuração

1

Localizar o Menu de Configuração

Para acessar as configurações do plugin:

  • No painel administrativo do WordPress, vá para "Configurações"
  • Clique em "ConectaKS - Gpt"
  • Você será direcionado para o painel de configuração do plugin
Caminho: Configurações → ConectaKS - Gpt
2

Configuração da URL do Assistente

Configure a URL do seu assistente de IA:

  • No campo "URL do Assistente", cole a URL completa do seu chatGPT
  • Exemplo: https://chat.openai.com/g/g-xxxxxxxxx
  • Certifique-se de que a URL está correta e acessível
⚠️ Importante: A URL deve ser acessível publicamente. URLs privadas ou com autenticação podem não funcionar corretamente.
3

Configuração de Exibição

Escolha onde o botão deve aparecer:

  • "Todas as páginas": O botão aparecerá em todas as páginas do site
  • "Páginas específicas": Selecione apenas as páginas onde o botão deve aparecer
💡 Dica: Use a opção "Páginas específicas" para controlar melhor onde o botão aparece, como apenas na página inicial ou em páginas de contato.
4

Seleção de Páginas Específicas

Se escolheu "Páginas específicas":

  • Use a caixa de busca para encontrar páginas rapidamente
  • Marque as páginas onde o botão deve aparecer
  • Use os botões "Selecionar Todas" ou "Deselecionar Todas" para facilitar
  • As páginas e posts são listados separadamente
5

Salvamento das Configurações

Após configurar todas as opções:

  • Clique no botão "💾 Salvar Configurações"
  • Aguarde a confirmação de que as configurações foram salvas
  • Teste as configurações acessando o frontend do site
✅ Configurações salvas!
Suas configurações foram salvas com sucesso e já estão ativas no site.

Personalização Visual

1

Ícone do Botão

Personalize o ícone do botão de chat:

  • Emoji padrão: Deixe o campo vazio para usar o emoji 🤖
  • Imagem personalizada: Cole a URL de uma imagem ou use o botão "📁 Escolher Imagem"
  • Upload de imagem: Use o botão para fazer upload de uma imagem da biblioteca do WordPress
  • Remover imagem: Use o botão "🗑️ Remover" para voltar ao emoji padrão
💡 Dica: Para melhores resultados, use imagens quadradas (1:1) com pelo menos 100x100 pixels.
2

Cores do Botão

Configure as cores do botão:

  • Cor do botão: Escolha a cor de fundo principal do botão
  • Cor do hover: Escolha a cor quando o mouse passar por cima
  • Use os seletores de cor para escolher as cores desejadas

🎨 Cores Recomendadas

Use cores que contrastem bem com o fundo do seu site para melhor visibilidade.

🔄 Efeito Hover

O efeito hover melhora a interatividade e chama atenção do usuário.

3

Mensagem de Hover

Configure a mensagem que aparece ao passar o mouse:

  • Texto da mensagem: Digite a mensagem que aparecerá
  • Cor do texto: Escolha a cor do texto da mensagem
  • Cor de fundo: Escolha a cor de fundo da mensagem
💡 Exemplos de mensagens: "Vamos conversar!", "Precisa de ajuda?", "Fale conosco!", "Chat com IA"
4

Preview das Configurações

Visualize suas configurações:

  • As configurações são aplicadas em tempo real
  • Teste diferentes combinações de cores e textos
  • Verifique se a legibilidade está adequada
  • Teste em diferentes dispositivos se possível

Configuração de Posicionamento

1

Posicionamento Desktop

Configure a posição do botão em dispositivos desktop:

  • Distância do fundo: Distância em pixels do fundo da tela (ex: 30px)
  • Distância da direita: Distância em pixels da direita da tela (ex: 20px)
Exemplo de valores: • Distância do fundo: 30px • Distância da direita: 20px
2

Posicionamento Mobile

Configure a posição do botão em dispositivos móveis:

  • Distância do fundo: Distância em pixels do fundo da tela no mobile (ex: 20px)
  • Distância da direita: Distância em pixels da direita da tela no mobile (ex: 10px)
📱 Dica Mobile: Use valores menores no mobile para evitar que o botão interfira com elementos da interface.
3

Valores Recomendados

Valores sugeridos para diferentes tipos de site:

🖥️ Desktop

Fundo: 30px
Direita: 20px

📱 Mobile

Fundo: 20px
Direita: 10px

🎯 E-commerce

Fundo: 40px
Direita: 15px

📝 Blog

Fundo: 25px
Direita: 25px

4

Teste de Posicionamento

Teste o posicionamento em diferentes dispositivos:

  • Acesse o site em diferentes resoluções de tela
  • Teste em dispositivos móveis reais
  • Verifique se o botão não interfere com outros elementos
  • Ajuste os valores conforme necessário

Solução de Problemas Comuns

❌ Botão não aparece no site

  • Verifique se o plugin está ativado em Plugins → Plugins Instalados
  • Confirme se as configurações de exibição estão corretas
  • Verifique se a página atual está na lista de páginas selecionadas
  • Teste com um tema padrão do WordPress temporariamente
Solução: Ative o plugin e configure "Todas as páginas" para teste inicial.

❌ Botão não abre o chat

  • Verifique se a URL do assistente está correta
  • Teste a URL diretamente no navegador
  • Verifique se a URL é acessível publicamente
  • Confirme se não há erros de JavaScript no console
Solução: Use uma URL válida e acessível, como: https://chat.openai.com/g/g-xxxxxxxxx

❌ Erro ao instalar o plugin

  • Verifique se o arquivo ZIP não está corrompido
  • Confirme se tem permissões de administrador
  • Verifique se há espaço suficiente no servidor
  • Tente fazer upload novamente
Solução: Baixe o arquivo novamente e tente a instalação em um navegador diferente.

❌ Conflito com tema ou outros plugins

  • Desative outros plugins temporariamente para testar
  • Teste com um tema padrão do WordPress
  • Verifique se há erros no console do navegador
  • Ative os plugins um por um para identificar o conflito
Solução: Identifique o plugin ou tema conflitante e entre em contato com o suporte.

❌ Botão aparece em posição incorreta

  • Verifique as configurações de posicionamento
  • Confirme se os valores estão em pixels (px)
  • Teste em diferentes resoluções de tela
  • Verifique se não há CSS conflitante
Solução: Ajuste os valores de posicionamento e teste em diferentes dispositivos.

❌ Imagem personalizada não aparece

  • Verifique se a URL da imagem está correta
  • Confirme se a imagem é acessível publicamente
  • Teste com uma imagem de outra fonte
  • Verifique se a imagem está no formato correto (JPG, PNG, GIF)
Solução: Use o botão "Escolher Imagem" para fazer upload através da biblioteca do WordPress.

Perguntas Frequentes

❓ O plugin é gratuito?

Sim, o ConectaKS-Chat é totalmente gratuito e de código aberto. Você pode usar, modificar e distribuir conforme necessário.

❓ Preciso de conhecimentos técnicos para usar?

Não! O plugin foi desenvolvido para ser fácil de usar. Basta instalar, ativar e configurar através do painel administrativo do WordPress.

❓ O plugin funciona com qualquer tema do WordPress?

Sim, o plugin é compatível com a maioria dos temas do WordPress. Se houver conflitos, teste com um tema padrão temporariamente.

❓ Posso personalizar a aparência do botão?

Sim! Você pode personalizar cores, ícone, posição, mensagem de hover e muito mais através do painel de configuração.

❓ O plugin afeta a velocidade do site?

O plugin é muito leve (apenas ~50KB) e não afeta significativamente a velocidade do site. Ele carrega apenas o CSS e JavaScript necessários.

❓ Posso usar o plugin em múltiplos sites?

Sim, você pode instalar o plugin em quantos sites desejar. Não há limitações de uso.

❓ O plugin é compatível com cache?

Sim, o plugin funciona com a maioria dos plugins de cache. Se houver problemas, adicione o plugin à lista de exclusão do cache.

❓ Posso desinstalar o plugin facilmente?

Sim, você pode desinstalar o plugin normalmente através do painel de plugins do WordPress. Todas as configurações serão removidas.

❓ O plugin funciona em sites multilíngues?

Sim, o plugin funciona em sites multilíngues. Você pode configurar diferentes mensagens para diferentes idiomas se necessário.

❓ Preciso de uma conta no ChatGPT para usar?

Sim, você precisa de uma conta no ChatGPT e criar um assistente personalizado para obter a URL necessária para o plugin.

Voltar Para Home