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 multi-idioma: coletar dados de interação dos contatos diferenciando por idiomas.
  • Incluir categoria raiz na categoria da página: incluir a categoria “Raiz” nas categorias da tag cn_page_category.
  • Verificar se o hook top não é renderizado mais de uma vez: ativar/desativar cálculo de percentual 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 que estiverem ativados no módulo na aba «Campos do formulário de registro» da seção «Campos do contato». Se a opção multi-idioma estiver ativada, a sincronização será feita em cada loja do Connectif onde existir o email do contato.

 

Essas alterações não são enviadas ao Connectif se for feita 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, quando o Connectif receber as informações do carrinho, irá coletar o produto padrão ou a combinação específica (tamanho, cor, etc.).
  • Usar SKU como identificador do produto: usar o SKU dos seus produtos PrestaShop como ID de produto no Connectif.
  • Incluir categoria raiz sem precisar selecioná-la nas configurações do produto: enviar ao Connectif a categoria raiz dentro das categorias do produto.

  • Incluir categoria somente se estiver ativa: enviar ao Connectif a categoria do produto somente se estiver ativa no PrestaShop.
  • Calcular percentual de desconto com base nos preços: ativar/desativar o cálculo automático.
  • Incluir imposto no desconto: incluir o IVA em produtos com desconto.
  • Arredondar preços: arredondar os preços dos produtos no Connectif.
  • Máxima disponibilidade em dias: definir o período, em dias antes da data de reposição, em que um produto ficará disponível para compra antecipada.
  

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

  • Selecionar tamanho da imagem do produto: indicar o tipo de imagem do produto a ser sincronizada (recomenda-se selecionar a mesma utilizada na ficha do produto do PrestaShop).

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

3.7. Envio de Compras

(Nesta seção, você configura o envio das compras para o Connectif a partir do módulo PrestaShop).

23. Através da seção Envio de Compras, você pode enviar as compras realizadas em sua loja para o Connectif, especificando um intervalo de datas e os status a serem importados.

 

Para aprender como realizar o envio das compras do PrestaShop para o Connectif, consulte este artigo.

Envio de compras do PrestaShop - 3.png

 

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

 

Você deve realizar esta etapa somente se o seu PrestaShop tiver vários idiomas e/ou moedas.

 

Os e-commerces com multi-idioma requerem 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 idioma, a opção “Ativar multi-idioma” deve ter sido ativada no passo anterior (17).

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

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

25. Em uma nova janela do navegador, acesse sua conta Connectif para o idioma correspondente e copie os dados identificadores (“Identificador do Cliente” e “Chave Secreta”), conforme indicado no passo 10.

26. Volte para o PrestaShop e cole os dados identificadores (“Client ID” e “Secret KEY”).

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

28. No campo “Enabled”, clique em YES.

29. Clique em   Salvar.

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

 

 

 Sucesso!
A integração da sua conta Connectif com o seu PrestaShop está agora completa.

 

Para verificar se a integração foi concluída corretamente e que os dados de interação estão sendo coletados, clique aqui.

 


RESOLUÇÃO DE INCIDÊNCIAS

Encontre soluções rápidas para os incidentes mais comuns durante a integração com PrestaShop.

 

1. Quais informações o Connectif coleta através dessa integração?

a. Informações coletadas dos Contatos

Nas integrações com PrestaShop, através da etiqueta cn_client_info, são transferidas, por padrão, algumas informações sobre os Contatos:

  • email

  • _name

  • _surname

  • _birthdate

  • _newsletter_subscription_status

Além disso, nas configurações do módulo Connectif no PrestaShop, existe uma seção que permite habilitar outros campos de contato. Esses campos serão adicionados à etiqueta cn_client_info com o mesmo identificador presente nessa seção. Para que o Connectif armazene o valor, deve existir um campo personalizado na loja Connectif com o mesmo ID (ver passo 3.5).

b. Informações coletadas dos Produtos

Nas integrações com PrestaShop, através da etiqueta cn_product_visited e da sincronização diária do catálogo, são coletadas, por padrão, algumas informações sobre os Produtos:

  • quantity

  • price url

  • product_id

  • name

  • description

  • image_url

  • unit_price

  • availability

  • brand

  • published_at

  • category

  • related_external_product_id

  • tag

c. Informações coletadas dos Compras

Nas integrações com PrestaShop, através da etiqueta cn_purchase, são coletadas, por padrão, algumas informações sobre as Compras:

  • purchase_id

  • purchase_date

  • payment_method

  • cart_id

  • total_quantity

  • total_price

 

2. Nenhum dado de compras, contatos e/ou eventos de carrinho está sendo registrado

  • Em Parâmetros avançados, verifique se as opções abaixo 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.

Caso estejam desativados, clique em Yes nos campos que precisar e em Salvar para ativá-los.

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

  • Verifique se o módulo Connectif está vinculado ao hook displayTop em “Design > Positions” do PrestaShop.

Integração PrestaShop - 16.png

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

Você pode consultar as informações oficiais do PrestaShop clicando aqui.

  • Configure sua plataforma de pagamento para que, após uma transação, o contato seja automaticamente redirecionado 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 vinculado a esse hook.

 

4. Como recuperar carrinhos abandonados utilizando a URL de Recuperação de Carrinho

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

Através da integração com PrestaShop, é enviada para o 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 do carrinho através de um workflow, deve ser feito por meio do nó "Obter último carrinho" e "Abandono de carrinho", e posteriormente mapeado nas variáveis do conteúdo a ser exibido ou enviado.

  • Aprenda como funciona essa URL nos diferentes CMS e como usá-la neste artigo

 

 

 


Continue aprendendo!

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