Introdução à PrestaShop

O que você vai aprender

Saiba como integrar sua loja PrestaShop com a Klaviyo. A Klaviyo é parceira preferencial de automação de marketing da PrestaShop. A integração envolve duas etapas: instalar um módulo gratuito PrestaShop Automation with Klaviyo na PrestaShop e ativar a integração na Klaviyo. Este artigo também traz informações sobre o monitoramento da sincronização de dados, a configuração de e-mails transacionais e a atualização do módulo para que você possa crescer com a Klaviyo.

Antes de começar

Para usar o módulo Klaviyo, é preciso estar usando uma das versões da PrestaShop listadas abaixo:

• PrestaShop 1.7.0 e superior (usando PHP 7.1 ou superior)
  • Para usar o recurso de consentimento para SMS durante o checkout, é preciso usar a PrestaShop 1.7.6 ou superior.
• PrestaShop Edition 8.0 ou superior.
• PrestaShop Project 8.0 ou superior.

Se estiver usando uma versão da PrestaShop anterior à 1.7.0 e quiser fazer o upgrade para usar um módulo da Klaviyo, consulte o guia da PrestaShop para fazer o upgrade da sua loja.

Leia as informações a seguir antes de fazer a integração:

• Se estiver usando a PrestaShop Edition, o módulo PrestaShop Automation with Klaviyo já vem pré-instalado. Se estiver usando outra versão da PrestaShop, é preciso instalar o módulo (saiba mais na próxima seção). 
• O módulo PrestaShop Automation with Klaviyo foi criado para se integrar à funcionalidade de back office da PrestaShop, como a PrestaShop Account. As lojas que usarem a PrestaShop Project 8.0 precisam instalar o módulo PS_MBO para usar o módulo Klaviyo.
• Prefere não integrar a funcionalidade de back office na sua loja PrestaShop de código aberto? Você pode usar o módulo Klaviyo by PrestaShop Partners, que contém os mesmos recursos do PrestaShop Automation with Klaviyo e não exige PS_MBO.

Quer atualizar seu módulo Klaviyo? Confira o final deste artigo para saber mais. 

Vídeo tutorial

Instale o módulo na PrestaShop

1. No PrestaShop Edition, o módulo PrestaShop Automation with Klaviyo já vem pré-instalado. Para utilizá-lo:
1. Entre na sua loja da PrestaShop.
2. Em Configure, no menu à esquerda, selecione Klaviyo.
3. Pule para a próxima seção deste artigo para configurar o módulo.
2. Se você não usa a PrestaShop Edition, vá para a página do módulo PrestaShop Automation with Klaviyo na PrestaShop marketplace e prossiga para a próxima etapa.
   
3. Na página do módulo, clique em Download. Valide seus dados (se necessário), selecione a versão da PrestaShop que está usando e faça download do arquivo zip. Você não precisa extrair o arquivo compactado.
   
4. Faça login na sua loja da PrestaShop e vá até Modules > Module Manager. Clique em Upload a module e, em seguida, arraste e solte o arquivo zip no gerenciador.
   
5. O módulo exibirá uma mensagem de instalação bem-sucedida após a conclusão. Clique em Configure e siga para a próxima seção.

Configure o módulo na PrestaShop

1. É preciso recuperar sua chave de API pública da Klaviyo (ou ID do seu site) e gerar uma chave privada para usar na PrestaShop. 
   • Entre na Klaviyo e selecione o nome da sua organização no canto inferior esquerdo.
   • Selecione Configurações > Chaves de API.
   • Copie sua chave de API pública e cole-a na configuração correspondente da PrestaShop.
   • Volte à Klaviyo, clique em Criar chave de API privada, nomeie-a, selecione Chave de acesso total e clique em Criar.
   • Copie com segurança sua chave de API privada recém-criada e a cole-a na configuração correspondente da PrestaShop.
2. Ative a opção Send real-time order events to Klaviyo se quiser que eventos transacionais sejam sincronizados em tempo real. Esses eventos podem ser usados para enviar mensagens transacionais e aparecerão como um segundo conjunto de eventos rotulados como transacionais (por exemplo, você verá uma métrica na Klaviyo rotulada Transacional – Pedido Realizado, que será sincronizada em tempo real, e uma métrica rotulada Pedido Realizado, que será sincronizada a cada 30 minutos).
   
3. Se desejar, ative a opção Desative e-mails de pedidos transacionais gerados na PrestaShop. É recomendável deixar essa configuração desabilitada até que seus e-mails transacionais estejam prontos para serem usados na Klaviyo. Você pode voltar a qualquer momento e ativar a opção para desabilitar envios da PrestaShop. A ativação dessa configuração bloqueia os e-mails transacionais associados a Pedido Realizado, Pedido Atendido, Pedido Cancelado e Pedido Reembolsado, bem como e-mails de lembrete de pagamento. 
4. Habilite a opção Sincronizar assinantes de e-mail da PrestaShop com a Klaviyo se quiser sincronizar os assinantes de e-mail coletados durante o checkout ou por meio de um formulário de inscrição.
5. Habilite a opção Sync PrestaShop SMS subscribers to Klaviyo para permitir que os usuários aceitem receber marketing por SMS durante o checkout.
   
   Você deve configurar o SMS na Klaviyo antes de sincronizar os assinantes.
   
6. Salve para continuar.
7. Se você ativou a sincronização de assinantes de e-mail, é preciso selecionar uma lista da sua conta Klaviyo para adicionar esses assinantes de e-mail. Todos os novos assinantes serão adicionados à lista selecionada. É recomendável usar a Lista de e-mails.
   
8. Se quiser inscrever perfis em uma lista da Klaviyo usando o módulo PrestaShop Newsletter Subscription, verifique se ele está ativado e atualizado para a versão 2.6.0 ou superior.
9. Se você ativou a sincronização de assinantes de SMS:
1. Selecione uma lista da sua conta Klaviyo para adicionar assinantes de SMS. Todos os novos assinantes serão adicionados à lista selecionada. Recomendamos o uso de uma lista separada para assinantes de e-mail e SMS.
2. Escolha quando os clientes se inscrevem. Pode ser depois que o usuário inicia o checkout ou faz um pedido.
3. Adicione um rótulo de consentimento à caixa de seleção de marketing. Use um rótulo claro para que os usuários saibam o que estão aceitando. Por exemplo: “Inscreva-se para receber marketing por SMS”.
4. Adicione um texto de divulgação de consentimento. Use uma linguagem adequada para fins de conformidade. Inclua os termos do seu programa de marketing por SMS nos termos de serviço e na política de privacidade. É preciso usar HTML na caixa da divulgação. Exemplo de texto de divulgação de consentimento:
   Ao selecionar esta caixa e inserir o número de telefone acima, você aceita receber mensagens de texto de marketing (como promoções e lembretes de carrinho) da [nome da empresa] no número fornecido. Tarifas de dados e mensagens podem ser aplicadas. A frequência das comunicações pode variar. Você pode cancelar a inscrição a qualquer momento respondendo STOP ou clicando no link de cancelamento (quando disponível). <a href="link">Política de Privacidade</a> e <a href="link">Termos de Serviço</a>.
5. Use o botão à direita da caixa para adicionar um texto específico para cada idioma disponível na sua loja. 
   
10. Salve para continuar.
11. Em seguida, aceite os valores padrão ou selecione outros valores para completar o formulário de mapeamento do status dos pedidos. Os status dos pedidos correspondem aos eventos registrados na Klaviyo. Você pode selecionar diversos valores para cada evento de pedido. Para isso, pressione Cmd ou Ctrl enquanto seleciona. O mesmo valor não pode ser selecionado em vários eventos. A seleção de um valor duplicado resultará em uma mensagem de erro e não poderá ser salva. Os eventos transacionais e não transacionais obedecerão ao mapeamento de pedidos que você escolher.
12. Quando terminar de configurar os status dos pedidos, clique em Salvar.
13. Você verá a seção Cupons, onde é possível gerar cupons. No campo Limite da regra de carrinho, selecione Uma regra de carrinho por prefixo  ou Uma regra de carrinho por pedido  para limitar o uso dos cupons. Por padrão, a configuração deste campo é Uma regra de carrinho por prefixo. Isso impede que um cliente adicione mais de um código com o mesmo prefixo durante o checkout.
    
14. Se quiser gerar códigos de cupom e usar o campo Quantidade a gerar, basta voltar à página mais tarde. Para mais informações, leia Como criar cupons estáticos para a PrestaShop.
15. Em seguida, selecione Advanced Parameters na seção Configure à esquerda. Selecione Webservice. Copie a chave do serviço web da Klaviyo e avance para a próxima seção. 
    • Essa chave será usada ao ativar a integração na Klaviyo na próxima etapa. Recomendamos selecionar o ícone de lápis ao lado da chave do serviço web da Klaviyo para verificar se ela possui as permissões corretas. Na lista de todas as permissões, localize a Klaviyo. Verifique se todas as caixas de permissões estão marcadas. Salve para aplicar as alterações.

Habilite a integração na Klaviyo

1. Em seguida, habilite a integração da PrestaShop na sua conta Klaviyo. Na Klaviyo, selecione o nome da sua organização no canto inferior esquerdo e, em seguida, clique em Integrações. 
2. Clique em Adicionar integrações, procure a PrestaShop e selecione o cartão. Em seguida, clique em Instalar.
3. Na página seguinte, clique em Conecte-se à PrestaShop.
   
4. Na página seguinte, digite o URL da loja da PrestaShop no campo URL da loja. Para encontrar o URL, acesse Shop Parameters > Traffic & SEO > Shop URLs na sua conta da PrestaShop. Você também pode clicar em View my shop para navegar rapidamente para o site da PrestaShop a partir de qualquer página da sua conta e recuperar o URL da sua loja.
   
5. Cole a chave do serviço web que você copiou da PrestaShop no campo Webservice key.
6. Se quiser converter todas as moedas usadas em suas lojas em uma única moeda na Klaviyo, marque a opção Convert all currencies to one standard currency e selecione um código de moeda global na lista suspensa.
   • Isso não vai alterar a moeda na sua conta Klaviyo. Para mudar a moeda usada em toda a conta, consulte nosso guia sobre Como mudar a moeda em sua conta.
7. Obtenha uma lista das suas lojas da PrestaShop disponíveis selecionando Retrieve list of shops. Em seguida, marque as lojas que você deseja integrar. É preciso selecionar pelo menos uma loja para prosseguir.
8. Clique em Connect ta PrestaShop. Você verá uma mensagem de sucesso indicando que as contas foram conectadas.
   

Dados da PrestaShop na Klaviyo

Há três tipos de eventos sincronizados da PrestaShop para a Klaviyo: 

• Eventos de pedidos, sincronizados a cada 30 minutos (por exemplo, Pedido Realizado).
• Eventos de pedidos transacionais, sincronizados em tempo real, quando ativados (por exemplo, Transacional – Pedido Realizado).
• Eventos da Klaviyo no site (por exemplo, Ativo no Site, Produto Visualizado e Adicionado ao Carrinho). 

Além disso, as informações dos clientes são sincronizadas da PrestaShop para os perfis da Klaviyo, incluindo e-mail, telefone, consentimento para envio de e-mails e, se aplicável, consentimento para envio de SMS. 

Para visualizar todos esses eventos na Klaviyo, basta acessar Análises > Métricas. Filtre por PrestaShop para ver eventos de pedidos transacionais e não transacionais, que aparecerão com um ícone da PrestaShop, ou filtre por API para ver os eventos no site da Klaviyo (ícone de engrenagem). Para obter uma lista completa das métricas sincronizadas da PrestaShop, consulte nossa referência de dados da PrestaShop.

Na sua primeira integração com a PrestaShop, a Klaviyo sincronizará seus dados dos últimos 90 dias para que você possa envolver seus clientes mais recentes imediatamente. Após a sincronização desse período, a plataforma começará a sincronizar seu histórico completo de dados. Dependendo do número de pedidos, clientes e produtos da sua loja, a sincronização de todos os dados pode levar desde alguns minutos até vários dias.

Recomendamos que você tenha pelo menos 1024 MB de memória PHP alocada enquanto a sincronização do histórico estiver em andamento. Isso permite que o processo seja concluído em tempo hábil. Se desejar, o requisito inicial de memória pode ser reduzidos após a sincronização do histórico.

Quando a sincronização terminar, a integração da PrestaShop, na guia Integrations, será marcada como concluída. Para verificar se todos os dados da PrestaShop foram sincronizados, você pode fazer uma verificação do total de pedidos durante alguns dias ou uma semana. Antes de iniciar a validação, certifique-se de o fuso horário da sua conta corresponde às configurações da PrestaShop. Para conferir ou atualizar o fuso horário da sua conta:

1. Clique no nome da sua organização no canto inferior esquerdo.
2. Selecione Settings.
3. Selecione a guia Organization. 

Envie e-mails transacionais

Para enviar e-mails transacionais usando dados de pedidos em tempo real da PrestaShop, basta criar fluxos do zero na Klaviyo. Para mais informações, leia Como usar fluxos para enviar e-mails transacionais. Será preciso configurar esses fluxos e, depois, entrar em contato com a equipe de suporte da Klaviyo para aprová-los. Depois da aprovação, você pode desativar o envio de e-mails transacionais na PrestaShop e ativar seus fluxos transacionais na Klaviyo. 

Atualize seu módulo

Sua versão do módulo PrestaShop é anterior à 1.4.1? Recomendamos que você atualize para a versão 1.4.1 ou superior. As versões mais antigas usam as APIs v1 e v2 da Klaviyo, que foram descontinuadas e não funcionam adequadamente.

O upgrade para a versão 1.4.1 ou superior permite que você aproveite os recursos lançados na versão 1.3.0:

1. Exiba facilmente o preço real e o imposto sobre valor agregado (IVA) dos produtos promovidos em seus e-mails. O upgrade de uma versão inferior à 1.2.10 para a versão 1.2.10 ou superior pode causar imprecisões no modelo de e-mail. Leia nosso artigo para saber o que fazer nesse caso.
2. Envie e-mails transacionais para seus clientes com uma sincronização de eventos em tempo real.
3. Gere e importe rapidamente cupons em massa na Klaviyo.

Para atualizar seu módulo para a versão mais recente:

1. Entre na sua conta de administrador da PrestaShop.
2. Acesse Modules > Module Manager.
3. Role a tela até encontrar o módulo Klaviyo e selecione Upgrade. 
   

Para saber mais sobre as alterações de cada versão, acesse o módulo Klaviyo no marketplace da Addons, role até What's New e clique em Show changelog history. 

Tem interesse em uma versão aprimorada?

Se estiver usando a versão 1.2.18 ou 1.2.9 do módulo PrestaShop da Klaviyo, é possível usar o patch da versão correspondente, em vez do módulo Klaviyo mais recente. Como fazer o upgrade para esses módulos:

1. Faça login na sua conta de administrador da PrestaShop. 
2. Acesse Modules > Module Manager.
3. Localize o módulo Klaviyo, clique no menu suspenso ao lado de Upgrade e selecione Uninstall.
   
4. Use estes links para baixar a versão do seu patch:
   • 1.2.18+v3api.zip 
   • 1.2.9+v3api.zip
5. Faça upload do módulo no gerenciador de módulos da PrestaShop, começando pela etapa 4 na seção acima. 
6. Continue seguindo as etapas para reintegrar a PrestaShop à Klaviyo. 

Resultado 

Você já integrou a PrestaShop à Klaviyo e pode começar a usá-la para suas necessidades de marketing. 

Recursos adicionais

• Referência de dados da PrestaShop

• Como habilitar preços com IVA incluído na PrestaShop
• Como criar cupons na PrestaShop