Guia para integrar com Prestashop

Se o seu eCommerce foi desenvolvido em PrestaShop, você pode sincronizá-lo com sua conta do Connectif em apenas alguns minutos e começar a coletar dados de interação dos seus contatos no site.

Neste artigo, você aprenderá como integrar sua conta do Connectif com seu PrestaShop.

 
Tempo de implementação: 10 min.
Dificuldade: Baixa.
Quando utilizá-lo?: Ao criar sua conta no Connectif.

 

PASSO 1. Download do módulo

1. Faça login na sua conta do Connectif.

2. Acesse Configurações da Loja no menu lateral esquerdo.

3. Na seção Plataformas e-commerce, encontre PrestaShop e clique em  Editar.

Guia para integrar com PrestaShop 2025 - 15-min.png

4. Na seção Configuração, clique em  Baixar zip para baixar o arquivo “connectif.zip” no seu computador.

Integração com PrestaShop - 2-min.png

 

Não feche esta janela! Você precisará dela mais tarde para extrair os dados identificadores da sua conta.

 

PASSO 2. Instalação do módulo no seu PrestaShop

5. Faça login no backoffice do seu PrestaShop.

6. Acesse “Módulos > Módulos e Serviços”.

7. No canto superior direito, clique em  Carregar um módulo.

Guia para integrar com PrestaShop 2025 - 2-min.png

8. Na janela pop-up, clique em Selecionar arquivo ou arraste-o para dentro do retângulo pontilhado. O assistente iniciará a instalação automaticamente.

Integração_Prestashop_-_4__sem_figma_.png

9. Quando o módulo for instalado, clique em Configurar.

Integração_Prestashop_-_5__sem_figma_.png

 

Também é possível acessar a configuração posteriormente em “Módulos > Módulos e Serviços > Connectif” clicando em Configurar.

 

PASSO 3. Configuração do módulo no PrestaShop

3.1. Vinculação da conta do PrestaShop com o módulo Connectif

(Nesta seção, explicamos como vincular sua conta do PrestaShop ao módulo Connectif, um passo necessário para concluir a integração).

10. Na seção Configuração Básica, clique em Gerenciar lojas vinculadas.

Guia para integrar com Prestashop 2025 - 13-min.png

11. Na janela pop-up, faça login na sua conta do PrestaShop.

12. Aceite as permissões para vincular sua conta do PrestaShop ao Connectif.

13. Depois que as contas forem vinculadas, uma mensagem de confirmação aparecerá na tela de configuração do módulo.

Guia para integrar com Prestashop 2025 - 14-min.png

 

3.2. Configuração básica

(Nesta seção, você informará os dados identificadores da sua conta para sincronizá-la e começar a coletar dados de interação dos contatos no site em tempo real).

14. Volte para sua Loja Connectif (seção “Integrações > PrestaShop”) e copie os dados identificadores da sua conta (Identificador do cliente e Chave secreta).

Integração com PrestaShop - 3-min.png

15. Volte para a aba do PrestaShop que você deixou aberta (configuração do módulo) e cole os dados copiados nos campos “Client ID” e “Secret KEY”, respectivamente.

16. Verifique se no campo “Enabled” está selecionado YES.

17. (Opcional). Se você tiver um código de indicação, deverá informá-lo nesta tela, na área Código de Indicação.

18. Clique em   Salvar.

Guia para integrar com Prestashop 2025 - 3-min.png

 

3.3. Banners

 Os banners são uma funcionalidade obsoleta no Connectif. Você pode consultar mais informações a respeito  aqui.

19. Não é necessário realizar nenhuma ação nesta seção.

Guia para integrar com Prestashop 2025 - 4-min.png

 

3.4. URLs públicas

(Nesta seção, os URLs de inscrição/cancelamento de assinatura da newsletter, assim como o Service Worker das notificações push, são preenchidos automaticamente).

 20. Não é necessário realizar nenhuma ação nesta seção.
 
Você pode consultar esses URLs na sua conta do Connectif:

— Inscrição/cancelamento da newsletter, nas configurações da integração:

Integração com PrestaShop - 4-min.png

Service Worker de notificações push, nos Ajustes da Loja, “Canais > Notificações Push”.

Integração com PrestaShop - 5-min.png

 

3.5 Campos do formulário de registro

(Nesta seção, são indicadas as propriedades do contato coletadas no PrestaShop que serão sincronizadas com o Connectif).

21. Na seção Campos do contato, estão selecionados por padrão firstname (nome), “lastname” (sobrenome) e birthday (data de nascimento). Se desejar que o Connectif sincronize qualquer uma das demais opções desta seção ou de Campos de endereço, marque “Sim” nos campos desejados.

 

Para registrar os dados selecionados no perfil de cada contato, será necessário criar um campo personalizado com cada um deles, garantindo que o ID seja o mesmo indicado na lista (por exemplo, id_gender). Esse processo deve ser feito para todos os campos opcionais ativados, exceto o campo “Newsletter”, que captura automaticamente as inscrições. Para mais informações, consulte aqui.
Guia para integrar com Prestashop 2025 - 5-min.png

 

3.6. Configurações avançadas

(Nesta seção, são configuradas opções avançadas da integração).

22. Para uma integração básica, não é necessário realizar nenhuma ação nesta etapa. Se desejar uma configuração mais avançada, ative/desative as opções que deseja sincronizar com o Connectif:

Configurações gerais

  • Ativar multilinguagem: coletar dados de interação dos contatos diferenciando por idiomas.
  • Incluir categoria raiz na categoria da página: indicar que a categoria “Root” apareça nas categorias de produto.
  • Verificar se o hook top não é renderizado mais de uma vez: ativar/desativar o cálculo da porcentagem de desconto baseado nos preços.
  • Habilitar logs de depuração: ativar/desativar os logs.
  • Sincronizar as informações do contato no Connectif ao atualizar o cliente a partir do backoffice do PrestaShop: sincronizar no contato do Connectif, além dos campos básicos e nativos do módulo, os campos ativados na aba Campos do formulário de registro, na seção Campos do contato. Se a opção multilinguagem estiver ativada, a sincronização será realizada em cada loja do Connectif onde o e-mail do contato existir.

 

Essas alterações não são enviadas ao Connectif se for realizada uma importação de clientes no PrestaShop ou se um cliente for excluído do PrestaShop.

Guia para integrar com Prestashop 2025 - 6-min.png

Eventos

  • Eventos de compra: registrar todas as compras.

  • Eventos de registro: registrar as atividades de registro.

  • Eventos de login: registrar os logins do contato.

  • Eventos de inscrição na newsletter: registrar as inscrições na newsletter.

  • Status do carrinho: registrar os eventos do status do carrinho.

  • Eventos de pesquisa: registrar os eventos de pesquisa no eCommerce.

Guia para integrar com Prestashop 2025 - 7-min.png

Configurações de produto

  • Usar descrição longa: coletar a descrição longa dos produtos.
  • Usar combinações de produto no carrinho e compras: determinar se, ao receber o Connectif as informações dos produtos no carrinho, ele coletará o produto padrão ou a combinação específica (tamanho, cor, etc.).
  • Usar SKU como identificador do produto: utilizar o SKU dos seus produtos no PrestaShop como ID dos produtos no Connectif.
  • Calcular a porcentagem de desconto com base nos preços: ativar/desativar o cálculo automático desses valores.
  • Incluir imposto no desconto: incluir o IVA nos produtos com desconto.
  • Arredondar preços: arredondar os preços dos produtos no Connectif.
  • Disponibilidade máxima em dias: defina o período, em dias, antes da data de reposição, no qual um produto estará disponível para compra antecipada.
  

Se os dias restantes até a data de reposição de um produto forem superiores à disponibilidade máxima em dias, o item será considerado fora de estoque, e o Connectif não o recomendará nas estratégias ativas.

  • Selecionar tamanho da imagem do produto: indicar o tipo de imagem dos produtos que será sincronizada (recomenda-se selecionar a mesma usada na página do produto no PrestaShop).

Guia para integrar com Prestashop 2025 - 8-min.png

 

PASSO 4. Configuração em lojas com vários idiomas

 

Este passo só será necessário se o seu PrestaShop utilizar vários idiomas e/ou moedas.

 

Os eCommerces com multi-idioma exigem a criação de uma conta individual para cada idioma e moeda. Para mais informações, entre em contato com accountmanager@connectif.es.

Para registrar os dados diferenciados por idiomas, no passo anterior (17), a opção "Ativar multilinguagem" deve ter sido ativada.

23. Na aba Configuração básica, clique em  .

Guia para integrar com Prestashop 2025 - 9-min.png

24. Em uma nova aba do navegador, acesse sua conta do Connectif no idioma correspondente e copie os dados de identificação ("Identificador do cliente" e "Chave secreta"), conforme indicado no passo 10.

25. Volte para o PrestaShop e cole os dados de identificação ("Client ID" e "Secret KEY").

26. Selecione o idioma e a moeda que deseja sincronizar com essa conta do Connectif.

27. No campo "Enabled", clique em YES.

28. Clique em   Salvar.

Guia para integrar com Prestashop 2025 - 10-min.png

 

 

 Sucesso!
A integração da sua conta no Connectif com seu PrestaShop está concluída.

 

Para verificar se a integração foi realizada corretamente e se os dados de interação já estão sendo coletados, clique aqui.

 


RESOLUÇÃO DE PROBLEMAS

Encontre soluções rápidas para os problemas mais comuns ao integrar com o PrestaShop.

1. Os dados de compras, contatos e/ou eventos do carrinho não estão sendo registrados

  • Em Parâmetros avançados, verifique se as seguintes opções estão ativadas:
      • "Eventos de compra", para registrar dados de compras.
      • "Eventos de registro", para coletar dados de contatos.
      • "Eventos do carrinho", para capturar estados do carrinho.

Se estiverem desativadas, clique em Yes nos campos necessários e em Salvar para habilitá-los.

Guia para integrar com Prestashop 2025 - 11-min.png

  • Verifique se o módulo do Connectif está ancorado no hook displayTop em "Design > Posições" do PrestaShop.

Integração_PrestaShop_-_16.png

  • Certifique-se de que seu template não modifica as páginas base do PrestaShop (como, por exemplo, o Checkout) e que executa o hook displayTop da seguinte maneira:
    {hook h='displayTop'}
  

Você pode consultar a documentação oficial do PrestaShop clicando aqui.

  • Configure sua plataforma de pagamento para que, após a transação, o contato seja redirecionado automaticamente para a página de Confirmação de compra do eCommerce.
 

Caso não seja possível executar o hook displayTop devido a incompatibilidades com outros módulos, recomenda-se executar o hook displayConnectifTags em todas as páginas e garantir que o módulo esteja corretamente ancorado nesse hook.

 

2. Os status de inscrição na newsletter não estão sendo sincronizados

  • Verifique se as URLs preenchidas automaticamente na integração com PrestaShop na sua conta do Connectif coincidem com as URLs do módulo instalado no seu PrestaShop em "Configuração > URLs públicas"
    Integração com PrestaShop - 4-min.png


    Guia para integrar com Prestashop 2025 - 12-min.png

  • Copie e cole as URLs no seu navegador para verificar se estão corretas. Se retornarem um erro 404, a correção deverá ser feita diretamente no seu eCommerce.

 

3. Como recuperar carrinhos abandonados com a URL de Recuperação de Carrinho

(Nesta seção, é explicado como funciona a URL de Recuperação de Carrinho para obter os itens associados a um carrinho específico).

Através da integração com PrestaShop, é enviada ao Connectif uma URL de Recuperação de Carrinho, ou seja, um link para recuperar os itens relacionados a esse carrinho, que pode ser utilizado em workflows e conteúdos.

Para obter a URL de recuperação de carrinho através de um workflow, deve-se utilizar o nó "Obter último carrinho" e "Ao abandonar carrinho", e depois mapeá-lo nas variáveis do conteúdo a ser exibido ou enviado.

  • Aprenda como essa URL funciona em diferentes CMS e como utilizá-la neste artigo

 

 

 


Continue aprendendo!

Para aproveitar todo o potencial da sua conta no Connectif, recomendamos continuar com os seguintes artigos: