Documentação · 💬 Widget

WordPress

Instale o plugin Pommy AI pelo diretório de plugins do WordPress.

Sites WordPress têm o próprio plugin Pommy AI. Ele faz tudo o que o código de instalação faz, e um pouco mais: sobrevive a trocas de tema, impede que plugins de cache e otimização quebrem o widget e reconhece o WooCommerce — assim o balão de chat sai do caminho na página de finalização da compra.

Ele está no diretório oficial de plugins do WordPress — wordpress.org/plugins/pommy-ai — então você instala como qualquer outro plugin: busque no seu próprio painel administrativo e clique em instalar. O WordPress oferece as novas versões sozinho.

O que você precisa#

  • Um site WordPress hospedado por você — o tipo que sua empresa de hospedagem instala para você. (No wordpress.com, instalar plugins exige um plano pago.)
  • WordPress 5.9 ou mais recente e PHP 7.2 ou mais recente — qualquer coisa dos últimos anos serve.
  • Permissão para instalar plugins. Se o menu Plugins não tiver Add New (Adicionar novo), sua hospedagem desativou a instalação de plugins; veja a observação no fim desta página.

Instalação#

  1. Copie seus dois valores

    No Pommy, abra Integrations e clique no card WordPress. O painel de configuração mostra os dois valores que você vai colar daqui a pouco: seu Project ID e seu API address. Deixe a aba aberta.

  2. Instale o plugin

    No painel administrativo do WordPress, vá em Plugins → Add New, busque Pommy AI e clique em Install Now no resultado. Nada para baixar e nada para enviar.

  3. Ative

    Quando a instalação terminar, clique em Activate. Uma entrada Pommy AI aparece em Settings.

  4. Conecte ao seu projeto

    Abra Settings → Pommy AI, cole o Project ID e o API address do passo 1 e clique em Save.

  5. Teste a conexão

    Clique em Test connection. A resposta deve trazer o nome do seu projeto. Se ele não encontrar o projeto, o Project ID foi colado errado — copie de novo em Integrations.

  6. Veja o seu site

    Abra seu site em uma nova aba. O balão de chat está no canto inferior direito. Pronto — nada para adicionar ao tema.

Se você tem uma loja WooCommerce#

O plugin reconhece o WooCommerce sozinho; não há nada extra para instalar. Por padrão, ele esconde o balão de chat na página de finalização da compra — um cliente digitando os dados do cartão não deveria ter uma janela de chat por cima do formulário. Em todas as outras páginas, inclusive o carrinho, o balão continua.

Mantendo atualizado#

Não há nada a fazer. O WordPress verifica o diretório para você e mostra a atualização na tela Plugins como qualquer outra; clique em Update now ou ative as atualizações automáticas para ele. Seu Project ID e seu API address sobrevivem a todas as atualizações.

Dica: A busca não encontra nada, ou não existe Add New? Alguns pacotes de hospedagem desativam a instalação de plugins. Para esse caso, Integrations → WordPress guarda um .zip do mesmo plugin — baixe ali e use Plugins → Add New → Upload Plugin (não descompacte antes). Se o envio também estiver bloqueado, peça à hospedagem para liberar, ou dispense o plugin e cole o código de instalação de Integrations → Custom no seu tema (veja Instalando o widget). Esse último caminho perde a regra da finalização da compra, então, em uma loja WooCommerce, vale a ligação para a hospedagem.

Atenção: Se o balão não aparecer, o culpado costuma ser um plugin de cache ou otimização. O plugin do Pommy já pede a eles que não mexam no seu código; se algum ainda assim o engolir, limpe o cache do site uma vez e recarregue.