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.
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.

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
- Descarregue
dfwhatsapp-2.0.0.zipna sua área de cliente DataFirefly. - No back office, abra Módulos > Gestor de módulos e clique em Carregar um módulo.
- Selecione o ficheiro zip e clique em Configurar.
- 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.
- Em Clientes > WhatsApp, clique em Adicionar um agente.
- 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. - 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.
- Opcional: uma saudação (primeira bolha da janela) e uma mensagem pré-preenchida própria do agente.
- Em Visibilidade, limite o agente a determinados idiomas, grupos de clientes ou tipos de página e, em multiloja, a determinadas lojas.

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.

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.

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.

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.

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 telemóvel, a janela abre-se em ecrã inteiro e o botão abre diretamente a aplicação WhatsApp.

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.

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.

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.

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).

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.

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).

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
- Consulte a lista de verificação das definições: módulo ativado, pelo menos um agente ativo com um número internacional válido.
- Verifique as regras de apresentação: dispositivos, páginas, grupos, exclusões e a visibilidade de cada agente (idiomas, grupos, páginas, lojas).
- Se o modo offline for «Ocultar o botão», verifique o horário de funcionamento e os encerramentos.
- 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.