PS PrestaShop Iniciante

DataFirefly WhatsApp: documentação

Instalar, configurar e utilizar o DataFirefly WhatsApp 2.0.0 no PrestaShop 1.7.8 a 9: agentes, horário de funcionamento, mensagens pré-preenchidas, pedidos de contacto, estatísticas e privacidade.

Atualizado Versão do módulo 2.0.0

O DataFirefly WhatsApp adiciona um botão e uma janela de chat WhatsApp à sua loja PrestaShop. O visitante escolhe a quem escrever, lê uma mensagem já preenchida para a página em que se encontra (produto, carrinho, encomenda…) e abre o WhatsApp no telemóvel ou no computador. Responde a partir da sua aplicação WhatsApp ou WhatsApp Business habitual.

O que o módulo não faz: não envia nenhuma mensagem em seu nome e não utiliza a WhatsApp Business API. Cria ligações de chat https://wa.me/… que o próprio visitante abre.

Como funciona

  • O botão flutuante é mostrado na parte inferior do ecrã, com um texto e uma bolha de boas-vindas opcionais.
  • A janela de chat apresenta a sua equipa: fotografia ou iniciais, função, departamento, disponibilidade («Online», «Amanhã a partir das 08:30»).
  • O visitante escolhe um agente, edita a mensagem pré-preenchida se quiser e abre o WhatsApp.
  • No computador, também pode digitalizar um código QR para continuar no telemóvel.
  • Quando ninguém está online, pode manter o botão, ocultá-lo ou propor um formulário de pedido de contacto.
Janela de conversa: equipa com fotos, departamentos, disponibilidade e filtro por departamento
Janela de conversa: equipa com fotos, departamentos, disponibilidade e filtro por departamento

Instalação e atualização

Requisitos

  • PrestaShop 1.7.8 a 9.x (temas Classic e Hummingbird testados)
  • PHP 7.4 a 8.5
  • Pelo menos um número WhatsApp ou WhatsApp Business, em formato internacional

Instalação

  1. Descarregue dfwhatsapp-2.0.0.zip na sua área de cliente DataFirefly.
  2. No back office, abra Módulos > Gestor de módulos e clique em Carregar um módulo.
  3. Selecione o ficheiro zip e clique em Configurar.
  4. Abra Clientes > WhatsApp e adicione o seu primeiro agente.

O módulo cria o menu Clientes > WhatsApp, com quatro separadores: Agentes e horários, Pedidos de contacto, Estatísticas e Definições. Uma lista de verificação no topo das definições mostra o que falta fazer.

Atualização a partir da 1.0.0

Carregue o novo zip por cima do antigo: o PrestaShop executa o script de atualização. Os seus agentes, horários de funcionamento, encerramentos, estatísticas, pedidos de contacto e definições são mantidos.

  • O departamento de cada agente é copiado para todos os idiomas da loja.
  • Os números são convertidos para o formato internacional sempre que possível; um número sem indicativo do país é assinalado na lista de agentes e deixa de ser mostrado na loja até ser corrigido.
  • Os modos «round-robin» e «aleatório» passam a «Repartir entre os agentes» e o modo «manual» passa a «O cliente escolhe».
  • As posições no topo do ecrã passam para a parte inferior (do mesmo lado).
  • Os avatares SVG deixam de ser mostrados (são substituídos pelas iniciais): substitua-os por uma fotografia JPG, PNG ou WebP.

Adicione os seus agentes

Um agente é um número WhatsApp mostrado aos seus clientes: uma pessoa, um departamento ou toda a equipa.

  1. Em Clientes > WhatsApp, clique em Adicionar um agente.
  2. Introduza o nome mostrado e o número WhatsApp com o indicativo do país, por exemplo +33 6 00 00 00 00. O módulo verifica o formato e disponibiliza um botão Testar a ligação.
  3. Introduza a função e o departamento em cada idioma, adicione uma fotografia (JPG, PNG ou WebP, 2 MB no máximo) ou mantenha as iniciais.
  4. Opcional: uma saudação (primeira bolha da janela) e uma mensagem pré-preenchida própria do agente.
  5. Em Visibilidade, limite o agente a determinados idiomas, grupos de clientes ou tipos de página e, em multiloja, a determinadas lojas.
Back office: lista de agentes com foto, departamento, número internacional verificado e disponibilidade em tempo real
Back office: lista de agentes com foto, departamento, número internacional verificado e disponibilidade em tempo real

Dica: a lista de agentes mostra a respetiva disponibilidade em tempo real e assinala qualquer número sem indicativo do país. Arraste as linhas para alterar a ordem de prioridade.

Horário de funcionamento, fusos horários e encerramentos

  • Vários intervalos por dia, com preenchimento rápido (Seg-Sex 9:00-12:30 / 14:00-18:00, Seg-Sáb 10:00-19:00) e cópia da segunda-feira para os outros dias.
  • Intervalos noturnos: um intervalo 22:00 – 02:00 continua no dia seguinte.
  • Um fuso horário por agente, útil para uma equipa repartida por vários países.
  • Encerramentos por agente (férias) e para toda a equipa (feriados), em Definições > Horários e offline.
  • Um agente sem horário é sempre mostrado como online.
Horário de um agente: vários períodos por dia, preenchimento rápido, fuso horário e encerramentos
Horário de um agente: vários períodos por dia, preenchimento rápido, fuso horário e encerramentos

Os visitantes veem quando cada agente ausente regressa, por exemplo «Segunda-feira a partir das 09:00».

O que os visitantes veem

Botão e bolha de boas-vindas

O botão tem uma posição fixa e não desloca a página. A bolha de boas-vindas é opcional (atraso ajustável, uma vez por visita); a animação do botão é reproduzida no máximo três vezes e nunca quando o visitante pediu ao seu sistema para reduzir o movimento.

Botão flutuante do WhatsApp com o seu texto e a bolha de boas-vindas do agente na página inicial
Botão flutuante do WhatsApp com o seu texto e a bolha de boas-vindas do agente na página inicial

Mensagem pré-preenchida e botões nas páginas

Numa página de produto, o botão «Uma pergunta sobre este produto?» é mostrado por baixo do botão de adicionar ao carrinho. A mensagem contém o nome e a ligação do produto, atualizados quando o visitante muda de combinação. O visitante pode editar o texto antes de abrir o WhatsApp.

Página de produto: mensagem pré-preenchida com o nome e a ligação do produto, editável antes de abrir o WhatsApp
Página de produto: mensagem pré-preenchida com o nome e a ligação do produto, editável antes de abrir o WhatsApp

No carrinho, a mensagem lista os artigos, as respetivas combinações e o total; na confirmação da encomenda, contém a referência da encomenda.

Carrinho: botão «Uma pergunta sobre o carrinho?» e mensagem com os artigos e o total
Carrinho: botão «Uma pergunta sobre o carrinho?» e mensagem com os artigos e o total

No computador e no telemóvel

No computador, abre-se o WhatsApp Desktop ou o WhatsApp Web. O visitante também pode mostrar um código QR da conversa e continuá-la no telemóvel. O código QR é gerado no navegador: a ligação não é enviada para nenhum serviço externo.

No computador: código QR da conversa gerado no navegador para continuar no telemóvel
No computador: código QR da conversa gerado no navegador para continuar no telemóvel

No telemóvel, a janela abre-se em ecrã inteiro e o botão abre diretamente a aplicação WhatsApp.

No telemóvel: janela em ecrã inteiro com a saudação do agente e a mensagem pré-preenchida do produto
No telemóvel: janela em ecrã inteiro com a saudação do agente e a mensagem pré-preenchida do produto

Definições

Apresentação

  • Botão ativado/desativado, dispositivos (computadores, telemóveis ou ambos), tipos de página e grupos de clientes.
  • Botões nas páginas: produto, carrinho, confirmação da encomenda.
  • Escolha do agente quando vários estão disponíveis: o cliente escolhe, repartir entre os agentes (cada visitante mantém o seu) ou por prioridade.
  • Exclusões: controladores, categorias (e respetivos produtos), produtos.

Aspeto

Cor (com um tom mais escuro calculado automaticamente quando um texto branco não seria legível), posição em baixo à direita ou à esquerda, tamanho, margens em computador e telemóvel, animação, texto ao lado do botão, título e subtítulo da janela, bolha de boas-vindas, código QR em computadores. A pré-visualização à direita é atualizada enquanto escreve, no idioma selecionado.

Definições de aspeto com pré-visualização em tempo real: cor, posição, tamanho, margens e animação
Definições de aspeto com pré-visualização em tempo real: cor, posição, tamanho, margens e animação

Mensagens e variáveis

Uma mensagem por tipo de página, em cada idioma. Clique numa variável para a inserir:

{shop_name}, {customer_firstname}, {customer_name}, {page_url}, {page_title}, {product_name}, {product_ref}, {product_price}, {product_url}, {category_name}, {cart_total}, {cart_products}, {cart_id}, {order_ref}, {order_total}. As variáveis vazias são removidas da mensagem.

Mensagens pré-preenchidas por página, em 8 idiomas, com variáveis de produto, carrinho e encomenda
Mensagens pré-preenchidas por página, em 8 idiomas, com variáveis de produto, carrinho e encomenda

Offline

  • Manter o botão: os visitantes veem quando a equipa regressa e podem continuar a escrever.
  • Formulário de pedido de contacto: nome, telefone, mensagem e caixa de consentimento; os pedidos chegam a Pedidos de contacto, com um e-mail opcional.
  • Ocultar o botão: só aparece durante o horário de funcionamento.
Equipa indisponível: formulário de pedido de contacto com nome, telefone, mensagem e consentimento
Equipa indisponível: formulário de pedido de contacto com nome, telefone, mensagem e consentimento

Pedidos de contacto

Cada pedido mostra o nome, o telefone (com uma ligação para responder no WhatsApp e uma ligação de chamada), a mensagem, a página a partir da qual foi enviado, o idioma e, se o visitante tinha sessão iniciada, a respetiva conta de cliente. Marque-o como «Tratado» e adicione uma nota interna. O formulário está protegido contra bots (campo invisível, no máximo três pedidos por hora).

Pedidos de contacto: estado, telefone com ligação de resposta no WhatsApp, mensagem e idioma do visitante
Pedidos de contacto: estado, telefone com ligação de resposta no WhatsApp, mensagem e idioma do visitante

Estatísticas

O separador Estatísticas mostra, para o período escolhido (7, 30, 90 dias ou datas personalizadas):

  • aberturas da janela de chat, conversas iniciadas e a respetiva proporção;
  • códigos QR mostrados e pedidos de contacto;
  • a repartição por dia, página, botão, agente, produto, dispositivo e hora;
  • uma exportação CSV dos dados diários.
Estatísticas anónimas: aberturas, conversas iniciadas, por dia, página, botão, agente, produto e dispositivo
Estatísticas anónimas: aberturas, conversas iniciadas, por dia, página, botão, agente, produto e dispositivo

A saber: uma «conversa iniciada» significa que o WhatsApp foi aberto. O módulo não consegue saber se a mensagem foi efetivamente enviada.

Privacidade

  • Nenhum script do WhatsApp ou da Meta é carregado na loja: o WhatsApp só se abre quando o visitante clica.
  • Uma caixa de consentimento opcional antes de abrir o WhatsApp e no formulário de pedido de contacto, com uma ligação para a sua página de política de privacidade.
  • As estatísticas não guardam nenhum endereço IP nem identificador de cliente: os visitantes são contados com um pseudónimo que muda todos os dias. Período de conservação ajustável (180 dias por predefinição).
  • Os pedidos de contacto de um cliente são exportados e eliminados com os respetivos dados (módulo oficial RGPD do PrestaShop e eliminação do cliente).
Privacidade: caixa de consentimento antes do WhatsApp, ligação para a política, estatísticas sem endereço IP e prazo de conservação
Privacidade: caixa de consentimento antes do WhatsApp, ligação para a política, estatísticas sem endereço IP e prazo de conservação

Importante: o texto da caixa de consentimento e a sua política de privacidade continuam a ser da sua responsabilidade. Peça ao seu consultor que os verifique.

Acessibilidade e desempenho

  • Navegação por teclado, fecho com a tecla Escape, foco movido para a janela e depois devolvido ao botão, etiquetas traduzidas para leitores de ecrã.
  • Uma folha de estilos e um script leves, sem tipo de letra nem biblioteca externos; o gerador de códigos QR só é carregado ao clicar.
  • O botão tem uma posição fixa: não provoca deslocamentos do layout.

Compatibilidade

  • PrestaShop 1.7.8, 8.0 a 8.2, 9.0 e 9.1 (testado em 1.7.8.11, 8.2.1 e 9.1.5)
  • PHP 7.4 a 8.5
  • Temas Classic e Hummingbird (hooks padrão do PrestaShop)
  • Multiloja (agentes atribuídos a lojas, definições por loja) e multilingue
  • 8 idiomas incluídos: francês, inglês, espanhol, alemão, italiano, neerlandês, polaco e português

Resolução de problemas

O botão não aparece

  1. Consulte a lista de verificação das definições: módulo ativado, pelo menos um agente ativo com um número internacional válido.
  2. Verifique as regras de apresentação: dispositivos, páginas, grupos, exclusões e a visibilidade de cada agente (idiomas, grupos, páginas, lojas).
  3. Se o modo offline for «Ocultar o botão», verifique o horário de funcionamento e os encerramentos.
  4. Limpe a cache do PrestaShop (Parâmetros Avançados > Desempenho).

Um agente não aparece

O número dele provavelmente não tem indicativo do país (etiqueta vermelha na lista) ou a sua visibilidade exclui o idioma, o grupo ou a página atual.

As estatísticas continuam vazias

Verifique se a opção «Contar aberturas e conversas» está ativada em Definições > Privacidade e estatísticas. Os bots e as visitas de teste automatizadas não são contados.

Histórico de alterações

2.0.0 — 7 de novembro de 2026

  • Compatibilidade com PrestaShop 1.7.8 a 9.x.
  • Corrigido: bloqueio dos ficheiros CSS, JS e imagens do módulo, página Estatísticas, formulário de pedido de contacto.
  • Nova janela de chat: equipa, departamentos, disponibilidade, mensagem editável, código QR gerado no navegador.
  • Vários intervalos por dia, intervalos noturnos, fuso horário por agente, encerramentos da equipa.
  • Apresentação por página, grupo, idioma, dispositivo e loja.
  • Botões de produto, carrinho e encomenda; 15 variáveis.
  • Pedidos de contacto no back office, notificação opcional por e-mail.
  • Estatísticas anónimas, exportação CSV, período de conservação, exportação e eliminação RGPD.
  • Novo back office com pré-visualização em tempo real; 8 idiomas.

1.0.0 — 13 de maio de 2026

  • Versão inicial.
Esta página foi útil?

Ainda com dúvidas? Contacte o suporte