O plug-in do Brevo para Magento 2 permite que você sincronize os dados de clientes e pedidos da sua loja com sua conta Brevo. Isso permite que você envie e-mails e campanhas de SMS direcionados, crie automações de marketing e melhore o engajamento do cliente.

Antes de começar

Você precisa ter acesso ao painel de administração do Magento 2 e ao servidor Magento como proprietário de um sistema de arquivos.

Instalar o plug-in do Brevo para Magento 2

Etapa 1: verificar os pré-requisitos

Antes de instalar o plug-in do Brevo na sua loja do Magento, certifique-se de que os seguintes pré-requisitos sejam atendidos:

1. Faça login no seu servidor Magento como proprietário do sistema de arquivos.
2. Verifique o arquivo composer.json para garantir que o repositório repo.magento.com esteja incluído:
   

   repositories": [ { "type": "composer", "url": "https://repo.magento.com/" } ]

3. Crie novas chaves de autenticação na sua conta do Commerce Marketplace. Para saber mais, consulte a documentação dedicada da Adobe. 
4. Cole suas chaves de autenticação no arquivo auth.json na pasta de instalação do Magento. Se o arquivo estiver faltando, abra o seguinte menu suspenso para visualizar uma estrutura de exemplo que você pode usar:
   Exemplo de arquivo auth.json

   { "http-basic": { "repo.magento.com": { "username": "<public-key>", "password": "<private-key>" } } }

Etapa 2: instalar o plug-in do Brevo para Magento 2

Instale o plug-in do Brevo diretamente do servidor do Magento.

1. Faça login no seu servidor Magento como proprietário do sistema de arquivos.
2. Navegue até a pasta onde sua loja Magento está instalada.
3. Instale o plug-in do Brevo executando o seguinte comando:
   

   composer require brevo/magento2-extension

4. (Opcional) Se você encontrar um erro, execute o seguinte comando:
   

   sudo composer require brevo/magento2-extension

   e confirme para prosseguir como usuário raiz digitando yes.
5. Atualize sua instância do Magento executando esses comandos em sequência:

   sudo bin/magento module:enable Brevo_Core

   sudo bin/magento setup:di:compile

   setup:upgrade

6. Após a conclusão da configuração, acesse o painel de administração do Magento.

O plug-in do Brevo agora está instalado e precisa ser ativado. 

Etapa 3: ativar o plug-in do Brevo para Magento 2

Ative o plug-in do Brevo para conectar sua loja do Magento à sua conta Brevo.

1. No menu da barra lateral, vá até Stores > Brevo Configuration (Lojas > Configuração do Brevo).
2. Clique em Activate Plugin (Ativar plug-in).
3. Ao lado de Brevo Integration (Integração do Brevo), clique em Activate (Ativar).
4. Clique em Allow (Permitir) para conceder ao Brevo acesso às configurações necessárias para a integração.
5. Clique em Allow access (Permitir acesso) para conceder acesso do Magento 2 à sua conta Brevo.
6. Clique em Activate (Ativar) para conectar sua conta do Magento 2. Você será redirecionado para as configurações do plug-in.

Acessar as configurações do plug-in no Brevo

Acesse as configurações do plug-in no Brevo. A partir daí, você pode gerenciar as configurações do plug-in do Brevo, incluindo sincronização de clientes, rastreamento de visitantes para sua loja e muito mais.

1. Faça login em sua conta Brevo.
2. Clique no nome da sua conta e selecione Plugins & Integrations (Plug-ins e integrações).
3. Acesse a guia My Integrations (Minhas integrações).
4. Ao lado do plug-in do Magento 2, clique no ícone de três pontos e selecione Edit settings (Editar configurações).
   

Sincronizar clientes do Magento 2 com o Brevo

Sincronize os clientes novos e existentes da sua loja do Magento 2 com o Brevo.

1. Nas configurações do plug-in, vá até Contact Synchronization (Sincronização do contato).
2. Ative a opção Sync your store contacts to Brevo (Sincronizar contatos da loja com a Brevo). Ao ativar essa opção, todos os contatos da loja adicionados, atualizados ou excluídos no Magento 2 serão automaticamente refletidos no Brevo.
   
3. No menu suspenso, selecione se deseja realizar a sincronização de uma lista de clientes ou de um grupo.
4. Escolha como você deseja sincronizar seus contatos:
   
   Sincronizar todos os contatos com uma lista do Brevo Sincronizar grupos de lojas com listas do Brevo

   1. No menu suspenso, selecione a opção A list (Uma lista). Por padrão, contatos são adicionados à lista chamada Magento 2 na pasta Integrations (Integração).
   2. (Opcional) Para escolher uma lista diferente ou criar uma nova, clique em Select another list (Selecionar outra lista).
      

   1. No menu suspenso, selecione a opção A group (Um grupo). 
   2. Clique em Assignment settings (Configurações de atribuição).
      
   3. Escolha as listas do Brevo onde você deseja sincronizar grupos de lojas específicos.
5. (Opcional) Configure as seguintes opções, que são ativadas por padrão:
   
   1. Sincronizar o estado dos contatos (inscritos/não inscritos)
      Sincronize o status de assinatura atual de contatos do Magento 2 com o Brevo. Então, quando um contato se inscrever ou cancelar a assinatura no Brevo, a alteração será refletida no Magento 2.
      Se você não quiser sincronizar o status da assinatura atual no Brevo, desative esta opção.
   2. Atribuir automaticamente os atributos de contato da loja aos atributos de contato do Brevo
      Mapeie automaticamente o endereço de e-mail, nome e sobrenome dos contatos da sua loja no Magento 2 para atributos de contato no Brevo.
      Para mapear outros atributos manualmente, desative essa opção e selecione Map attributes (Mapear atributos).
      
      💡 É bom saber

      Somente os atributos padrão do Magento podem ser mapeados para os atributos de contato do Brevo. Atributos personalizados não podem ser mapeados.
      
6. Clique em Save (Salvar).

Sincronizar atributos de comércio eletrônico do Magento 2 com o Brevo

Sincronize os produtos, categorias, pedidos e clientes da sua loja do Magento 2 com o Brevo.

1. Nas configurações do plug-in, vá até Ecommerce Attribute Synchronization (Sincronização de atributos do eCommerce).
2. Ative a opção Enable the sync of e-commerce attributes to gain insights on your most valuable customers (Ativar a sincronização de atributos de e-commerce para obter informações sobre os seus clientes mais valiosos). Ative essa opção:
   • Todas as categorias de produtos da loja e os pedidos serão sincronizados com o Brevo. 
   • Todos os clientes da loja que fizeram pelo menos um pedido serão sincronizados com o Brevo.
   • Os contatos que optaram por receber comunicações por e-mail na interface da loja serão inscritos no Brevo, enquanto os demais contatos sincronizados serão colocados em lista bloqueada do Brevo.
     
3. Clique em Confirm (Confirmar).
4. Na seção Status de sincronização, monitore o status de sincronização do seu atributo de comércio eletrônico. A sincronização completa inicial de dados históricos pode levar algum tempo para ser concluída.
   
   
   💡 É bom saber

   Você também pode monitorar o status da sincronização selecionando o plug-in do Magento 2 na página Minhas integrações na sua conta Brevo.
5. (Opcional) Clique em View Ecommerce Analytics (Visualizar análises de e-commerce) para acessar o painel de comércio eletrônico, onde você pode analisar diferentes métricas, como receita, produto e desempenho de retenção. Para saber mais, consulte nossa seção dedicada no Centro de ajuda.

Após a conclusão da sincronização, qualquer novo produto, pedido e cliente será sincronizado em tempo real.

Gerenciar as configurações de confirmação de assinatura

O uso de uma das opções de confirmação de assinatura do Brevo e o envio de e-mails de confirmação dupla ou simples quando um contato envia um formulário em sua loja do Magento 2.

1. Nas configurações do plug-in, vá até Confirmação de assinatura.
2. Ative a opção Use Brevo subscription confirmation options to manage opt-in settings (Usar opções de confirmação da inscrição no Brevo para gerenciar as configurações de opt-in). Ao ativar essa opção, você pode escolher enviar e-mails de confirmação de inscrição dupla ou simples diretamente da Brevo.
3. Selecione se quer enviar e-mails de confirmação dupla ou simples. Para saber mais, confira nosso artigo dedicado Perguntas frequentes - por que usar um formulário de assinatura de confirmação de double opt-in?.
   
4. Configure sua confirmação de assinatura:
   
   E-mail de confirmação dupla E-mail de confirmação simples

   1. No menu suspenso, selecione o modelo de e-mail de confirmação double opt-in que deseja enviar para os contatos que enviaram seu formulário. Para aprender como criar um modelo de e-mail double opt-in, confira nosso artigo dedicado Crie um modelo de e-mail double opt-in (DOI) personalizado para um formulário de assinatura criado no Brevo.
   2. (Opcional) Insira o URL da página de confirmação ao qual os contatos serão redirecionados após clicar no link double opt-in no e-mail.
   3. (Opcional) Selecione os e-mails de confirmação final que deseja enviar aos contatos após clicarem no link double opt-in no e-mail.
      
   4. Clique em Save (Salvar).

   1. No menu suspenso, selecione o modelo de e-mail de confirmação simples que deseja enviar para os contatos que enviaram seu formulário.
      
   2. Clique em Save (Salvar).

Acompanhar as ações dos contatos na sua loja do Magento 2

Rastreie as ações dos contatos na sua loja do Magento 2 e sincronize os dados relacionados com o Brevo. Isso permite que você utilize os dados em automatizações, como enviar automaticamente um e-mail quando um contato abandona o carrinho ou conclui uma compra.

1. Nas configurações do plug-in, vá até Behavior tracking (Rastreamento de comportamentos.
2. Ative a opção Allow Brevo to track visitor actions on your store website in order to use this information for conditions and triggers in your marketing automation workflows (Permitir que a Brevo rastreie as ações dos visitantes no site da sua loja para usar essas informações para condições e ativar sua opção de cenário de automação de marketing). Ative essa opção:
   • O rastreador Brevo será instalado na sua loja para monitorar as ações do visitante em tempo real. Para saber mais, consulte nosso artigo dedicado Perguntas frequentes - O que é o rastreador Brevo e como instalá-lo?.
   • Os dados da atividade, como visualizações de produtos, adições ao carrinho e as compras, serão sincronizados diretamente no Brevo.
     
3. (Opcional) Configure as seguintes opções, que são ativadas por padrão:
   1. Track page visits (Rastrear visitas à página)
      Monitore quando um contato visita páginas específicas na sua loja.
   2. Track the actions related to an abandoned cart (Rastrear as ações relacionadas a um carrinho abandonado)
      Monitore quando um contato adiciona ou remove um produto do carrinho e rastreie quando ele conclui uma compra.
      
4. Clique em Save (Salvar).

Enviar e-mails transacionais do Magento 2 usando Brevo SMTP

Envie e-mails transacionais da sua loja usando Brevo SMTP. Isso ajuda a aprimorar a capacidade de entrega de seus e-mails.

1. Nas configurações do plug-in, vá até SMTP for transactional mailing (SMTP para envio de correspondência transacional).
2. Ative a opção Use Brevo to send your store's transactional emails (Usar a Brevo para enviar os e-mails transacionais da sua loja). Ative essa opção:
   • Seus e-mails transacionais serão enviados usando Brevo SMTP.
   • As estatísticas dos seus e-mails transacionais estarão disponíveis na sua conta Brevo.
   • Você pode usar IPs dedicados do Brevo e autenticar seu domínio para aprimorar a capacidade de entrega de seus e-mails.
3. Escolha o remetente que você deseja utilizar para seus e-mails transacionais. O nome e o endereço de e-mail do remetente selecionado aparecerão na caixa de entrada do destinatário como origem do e-mail.
   
4. Clique em Save (Salvar).

Criar automações para seus contatos do Magento 2

Crie automações usando os dados das ações de seus contatos na sua loja. Por exemplo, você pode automaticamente enviar um e-mail quando um contato abandonar o carrinho ou concluir uma compra na sua loja do Magento 2. 

Para saber mais, consulte nossos artigos dedicados:

Enviar mensagens SMS para confirmação de pedidos e envios usando Brevo

Envie mensagens SMS para confirmação de pedidos e envios usando Brevo.

1. Nas configurações do plug-in, vá até SMS Options (Opções de SMS).
2. Ative a opção Use Brevo SMS Options to send SMS to customers after order confirmation and shipment (Usar as opções de SMS Brevo para enviar SMS aos clientes após a confirmações e o envio de pedidos).
   Ative essa opção:
   • Suas mensagens SMS para confirmação de pedido e envio serão enviadas usando o Brevo.
   • As estatísticas dos SMS transacionais estarão disponíveis na sua conta Brevo.
     
3. Ative a opção Activate special characters (Ativar caracteres especiais) se sua mensagem de SMS contiver caracteres especiais, como caracteres GSM, conteúdo Unicode usado em alfabetos não latinos (por exemplo, árabe, russo) e emojis. Caso contrário, os caracteres especiais poderão ser substituídos durante o envio.
   
   
   ❗️ Importante

   A ativação desta opção reduzirá o limite de caracteres do SMS de 160 para 70 caracteres.
4. Escolha se deseja enviar mensagens SMS para confirmação e/ou envio de pedido / para quais eventos deseja usar o Brevo para enviar suas mensagens SMS: 
   • Confirmação de pedido
     Os clientes receberão um SMS quando o pedido deles for confirmado pelo seu servidor.
   • Envio de pedido
     Os clientes receberão um SMS quando o pedido for enviado por sua empresa. 
5. Personalize suas mensagens SMS:
   
   
   1. Remetente: insira um nome personalizado de 3 a 11 letras ou 15 dígitos para seu remetente. Recomendamos usar o nome da sua empresa para ajudar o remetente a reconhecer sua marca. Evite caracteres especiais, como caracteres GSM, Unicode em alfabetos não latinos (por exemplo, árabe, russo) e emojis.
      
      💡 É bom saber

      Os destinatários em alguns países (incluindo os EUA e o Canadá) não podem ver a personalização do remetente, que será exibida como um código curto numérico. Para saber mais, consulte nosso artigo dedicado Códigos curtos, longos e remetentes personalizados de SMS.
   2. Mensagem: insira o conteúdo da mensagem SMS que o destinatário receberá. Você pode personalizar seu SMS usando variáveis predefinidas, como {first_name} para incluir o primeiro nome do cliente. Cada mensagem SMS pode conter até 160 caracteres (ou 70 caracteres se caracteres especiais estiverem ativados), incluindo espaços e quebras de linha.
      ❗️ Importante

      Você deve incluir uma opção de cancelamento de assinatura no conteúdo da SMS. Para saber mais, consulte o artigo dedicado Inclua uma opção de cancelamento de inscrição em suas mensagens por SMS.
   3. Enviar um SMS de teste: envie um SMS de teste para o número de telefone de sua preferência para verificar a exibição do seu SMS transacional.
      
      ❗️ Importante

      O envio do SMS de teste será deduzido de seus créditos de SMS. 
6. Clique em Save (Salvar).

Solucionar problemas de instalação do plug-in do Brevo

• Solução de problemas gerais
• Problema com a versão correspondente do pacote

Solução de problemas gerais

Se você tiver algum problema durante a instalação:

1. Limpe o cache do Magento:
   1. No painel de administração do Magento, vá para System > Cache Management (Sistema > Gerenciamento de cache).
   2. Clique em Flush Magento Cache (Limpar cache do Magento).
      
2. Saia e entre novamente no painel de administração do Magento.
3. Se o problema persistir, tente reinstalar a extensão.
4. Se você ainda tiver problemas, entre em contato com nossa equipe de suporte criando um ticket na sua conta.

Problema com a versão correspondente do pacote

Não foi possível encontrar uma versão correspondente do pacote brevo/magento2-extension. 
Verifique a ortografia do pacote, sua restrição de versão e se o pacote 
está disponível em uma estabilidade que corresponde à sua estabilidade mínima (estável)

Se você encontrar essa mensagem de erro durante a instalação, isso significa que suas chaves de autenticação podem estar desatualizadas ou corrompidas. Para resolver o problema, crie novas chaves de autenticação na sua conta do Commerce Marketplace. Para saber mais, consulte a documentação dedicada da Adobe. 

🤔 Dúvidas?

Em caso de dúvida, sinta-se à vontade para entrar em contato com nossa equipe de suporte, criando um tíquete a partir da sua conta. Caso ainda não tenha uma conta, entre em contato conosco aqui.

Se você está procurando ajuda com um projeto usando o Brevo, podemos encontrar à agência parceira da Brevo certa.