O Joomla é um sistema de gerenciamento de conteúdo de código aberto para gerenciar conteúdo de sites. Ele usa uma estrutura de modelo-exibição-controlador que pode ser usada sozinha para criar aplicativos online robustos. Você pode instalar e configurar o pacote Brevo em seu site do Joomla para:

• Sincronizar seus usuários e contatos com a Brevo.
• Criar um formulário e adicioná-lo ao seu site.
• Enviar e-mails transacionais via Brevo.
• Acompanhar a atividade do seu site.

Para conectar sua conta Brevo ao site do Joomla, siga o procedimento abaixo.

Antes de começar

Reúna as seguintes informações antes da instalação:

• As credenciais da sua conta Brevo.
• Sua chave API v3. Para saber mais, consulte nosso artigo dedicado Criar e gerenciar sua chave API.
• Sua senha SMTP. Para saber mais, consulte nosso artigo dedicado O que é Brevo SMTP?
• Acesso ao painel de administração do site Joomla.

Para utilizar os recursos do pacote, certifique-se de que sua conta Brevo foi validada e que você é capaz de enviar e-mails por meio das plataformas de campanhas e transacionais da Brevo.

O pacote Brevo também está disponível no Diretório de extensões do Joomla.

Etapa 1: instalar e configurar o pacote Brevo

O processo é similar a outros pacotes Joomla. Depois de fazer login no back office do Joomla, clique em Extensions (Extensões) > Manage (Gerenciar) > Install (Instalar).

A instalação do pacote:

• Adiciona arquivos e tabelas ao seu site.
• Cria uma guia Brevo no menu Components (Componentes).
• Cria submenu de itens para partes específicas do componente Brevo.

Na página de instalação, dependendo dos plug-ins de instalação habilitados, quatro opções comuns de instalação são:

1. Instalar via Internet
2. Carregar o arquivo do pacote
3. Instalar via pasta
4. Instalar via URL

1. Instalar via Internet

Se seu site tiver o recurso "Instalar via Internet" ativado, vá até a guia Install from Web (Instalar da Internet) e digite "Brevo" na caixa de pesquisa. Clique no nome do pacote para abrir a lista e clique no botão Install (Instalar). Depois de confirmado, o pacote será instalado automaticamente.

2. Carregar o arquivo do pacote

• Baixe o arquivo do pacote aqui: https://github.com/brevo/joomla-plugin/tree/master/build/J3/package
• Escolha a versão mais recente do pacote e clique em "Download link" (Baixar link) para salvar o pacote no seu computador.
• Quando o download tiver terminado, carregue o arquivo.

3. Instalar via pasta

Se você tiver feito o download do pacote de instalação em uma pasta específica do servidor, poderá usar essa opção de instalação. Insira o caminho do arquivo para essa pasta específica e, em seguida, clique no botão Check and install (Verificar e instalar). O Joomla tentará automaticamente abrir o pacote e executar a instalação.

4. Instalar via URL

Para usar essa opção, você deve fornecer ao Joomla o link do URL direto para o pacote de instalação. O link de instalação do pacote é: https://raw.github.com/brevo/joomla-plugin/master/build/J3/package/pkg_sendinblue_v1_0_0.zip

Após você clicar no botão Check and Install (Verificar e instalar), o Joomla tentará automaticamente abrir o pacote e executar a instalação:

Configurando o componente Brevo

Primeiro, copie sua chave API v3 da sua conta Brevo seguindo este tutorial.

Vá para o administrador do Joomla e clique em Components (Componentes) > Brevo. No painel de controle da Brevo, selecione o ícone de configurações da chave API.

Cole sua chave API v3 na caixa.

Clique no botão Save (Salvar) na parte superior.  Você verá os dados da sua conta Brevo no painel de controle. Se os dados não forem exibidos, é provável que você não esteja usando uma chave API válida.

Configurando opções avançadas

Recomendamos manter todas as opções avançadas nos valores padrão. Se quiser editar os parâmetros do componente em um nível global, clique no botão Options (Opções) no canto superior direito no painel de controle.

Nesta página, você será capaz de editar:

1. Parâmetros globais

• Base URL (URL base): o URL usado para todas as chamadas à API. Deve ser mantido no valor padrão.
• Connection timeout (seconds) (Tempo limite de conexão (segundos)): em caso de problemas de conexão, tente aumentar esse valor.

2. Parâmetros avançados

• Opt-in template link tag (Etiqueta do link do modelo de opt-in): a etiqueta usada nos modelos de e-mail da Brevo
• Double opt-in attribute name (Nome do atributo de double opt-in): nome do atributo da Brevo que será usado no processo de confirmação
• Opt-in link validity period (minutes) (Período de validade do link de opt-in (minutos)): período que um assinante terá para confirmar a assinatura
• Double opt-in temporary folder & double opt-in temporary list (Pasta temporária de double opt-in e lista temporária de double opt-in): usado para armazenar temporariamente os dados sobre o assinante até que ele confirme a assinatura

Etapa 2: sincronizar usuários e contatos com a Brevo

Vá para o administrador do Joomla e, em seguida, para o painel de controle da Brevo. Selecione o ícone Export contacts (Exportar contatos).

• O recurso permitirá que você exporte o usuário/contato do Joomla e os dados (ou seja, endereços de e-mail e nomes).
• Lembre-se de que o identificador exclusivo de um usuário/contato é o respectivo endereço de e-mail.

No lado esquerdo, você escolherá as opções de exportação para os usuários e contatos do Joomla. No lado direito, você escolherá a quais listas da Brevo eles serão adicionados, bem como a forma de gerenciar usuários/contatos existentes.

1. Exportar usuários do Joomla

Defina "Yes" (Sim) ou "No" (Não) para cada opção.

• Export all user groups (Exportar todos os grupos de usuários)
• Se você selecionar "Yes" (Sim), todos os grupos de usuários serão adicionados à Brevo.
• Se você selecionar "No" (Não), terá a opção de escolher grupos de usuários específicos que serão adicionados à Brevo.
• Export blocked (Exportar bloqueados): "No" (Não) está selecionado por padrão, o que significa que os usuários bloqueados não são adicionados à Brevo.  Se você selecionar "Yes" (Sim), todos os contatos bloqueados serão adicionados à Brevo.
• Export ungrouped (Exportar não atribuídos a grupos): "No" (Não) é selecionado por padrão. Isso significa que os usuários que não estiverem atribuídos a nenhum grupo de usuários não serão adicionados à Brevo. Se você selecionar "Yes" (Sim), eles serão adicionados à Brevo.

2. Exportar contatos do Joomla

Defina "Yes" (Sim) ou "No" (Não) para cada opção.

• Export all contacts categories (Exportar todas as categorias de contato)
• Se você selecionar "Yes" (Sim), todas as categorias de contato serão adicionadas à Brevo.
• Se você selecionar "No" (Não), terá a opção de selecionar as categorias de contato que serão adicionadas à Brevo.
• Export unpublished (Exportar não publicados): "No" (Não) é selecionado por padrão. Isso significa que os contatos não publicados não serão adicionados à Brevo. Se você selecionar "Yes" (Sim), eles serão adicionados à Brevo.

3. Opções de listas

• Export mode (Modo de exportação): determina o que fazer com os contatos que já existem na Brevo
• "Add to lists" (Adicionar a listas): o usuário/contato permanecerá nas listas existentes da Brevo, além de ser adicionado a todas as listas recém-selecionadas.
• "Reassign to lists" (Reatribuir a listas): o usuário/contato será removido das listas existentes da Brevo e será adicionado a todas as listas recém-selecionadas.
• Use all lists (Usar todas as listas)
• Se você selecionar "Yes" (Sim), os usuários/contatos do Joomla serão adicionados a todas as suas listas da Brevo.
• Se você selecionar "No" (Não), terá a opção de escolher as listas da Brevo em que seus usuários/contatos do Joomla serão adicionados. As opções da lista serão exibidas no campo suspenso.

Exemplo:

Nosso contato, example@brevo.com, está atualmente na Lista 1, na Lista 2 e na Lista 3.

Se ele estiver em um grupo que deve ser adicionado à Lista 1, Lista 3 e Lista 4:

• Se o modo de exportação estiver definido como "add to lists" (adicionar a listas): example@brevo.com será inscrito nas quatro listas: Lista 1, Lista 2, Lista 3 e Lista 4.
• Se o modo de exportação estiver definido como "reassign to lists" (reatribuir a listas): example@brevo.com só será inscrito em Lista 1, Lista 3 e Lista 4.

4. Opções de nome do usuário/contato

Essa opção gerencia como o nome do usuário/contato do Joomla será dividido em atributos da Brevo.

• Attribute first word (Primeira palavra do atributo): selecione FIRSTNAME no menu suspenso
• Attribute rest of words (Restante das palavras do atributo): selecione LASTNAME no menu suspenso

Quando terminar de selecionar as opções de exportação, clique no botão Export contacts (Exportar contatos).

Criar um formulário com o pacote Joomla

1. Criação de um formulário

No administrador do Joomla, clique em Components (Componentes) > Brevo. Selecione o ícone Subscription forms (Formulários de inscrição). Para criar um novo formulário de inscrição, clique no botão New (Novo) no canto superior esquerdo.

Nesta página, você verá todos os seus formulários. Você pode usar os botões de edição padrão do Joomla para gerenciá-los.

2. Atribua um nome ao seu formulário

Comece escolhendo um nome para seu formulário.

3. Selecione suas listas

Aqui você deverá selecionar as listas da Brevo nas quais o visitante será inscrito quando enviar o formulário. Você pode escolher qualquer número de listas de diferentes pastas.

4. Configurar o e-mail de confirmação

Vá até a guia Confirmation (Confirmação).

Quando um novo assinante envia um formulário, há várias maneiras de fazer o acompanhamento:

• No confirmation (Sem confirmação): os visitantes serão inscritos nas listas selecionadas sem nenhuma notificação
• Simple confirmation (Confirmação simples): os visitantes serão inscritos nas listas selecionadas e notificados por:
• Um Follow-up email (E-mail de acompanhamento): selecione um modelo de e-mail da sua conta Brevo que será enviado para dar as boas-vindas ao novo assinante.
• Uma Confirmation page (Página de confirmação): ao selecionar "Yes" (Sim), você pode especificar a página para a qual o visitante será redirecionado após o envio bem-sucedido de um formulário. Basta digitar o URL no campo "Custom confirmation page" (Página de confirmação personalizada).

• Double confirmation (Confirmação dupla): os visitantes que enviarem um formulário serão adicionados à lista Temp - DOUBLE OPTIN e um e-mail de confirmação solicitando que eles cliquem para confirmar a assinatura será enviado. Depois de clicar, eles serão adicionados às listas da Brevo selecionadas.
• Opt-in email (E-mail de opt-in): selecione um modelo de e-mail de sua conta Brevo que será usado para que seu novo assinante confirme a assinatura. Observação: o modelo deve conter a etiqueta double opt-in, pois ela será substituída por um link de confirmação gerado.
• Form redirect page (Página de redirecionamento do formulário): ao selecionar "Yes" (Sim), você pode especificar a página para a qual o visitante será redirecionado após o envio bem-sucedido do formulário. Basta digitar o URL no campo "Custom form redirect page" (Página de redirecionamento de formulário personalizada).
• Final confirmation (Confirmação final): ao selecionar "Yes" (Sim), seu novo assinante receberá um e-mail de confirmação final depois de confirmar o e-mail de opt-in. Selecione um modelo de e-mail em sua conta Brevo.
• Confirmation page (Página de confirmação): ao selecionar "Yes" (Sim), seu novo assinante será redirecionado para uma página de confirmação após confirmar o e-mail de opt-in.  Basta digitar o URL no campo "Custom confirmation page" (Página de confirmação personalizada). Ele pode apontar para uma página de agradecimento ou uma landing page em que você fornece informações adicionais.

5. Personalizar mensagens informativas

Vá até a guia Messages (Mensagens). Essa guia permite personalizar mensagens básicas.

6. Adicionar blocos e campos de formulário

Vá para a guia Form blocks and fields (Blocos e campos do formulário) para criar seu formulário. Cada formulário é composto por blocos. Você pode personalizar cada bloco para ter opções e representações visuais diferentes.

• Para criar o primeiro bloco, clique no ícone "+" no canto superior esquerdo de Blocks subform (Subformulário de blocos).
• Para criar o próximo bloco, clique no ícone "+" no canto inferior direito do último bloco.
• Para excluir um bloco, use o "X" vermelho no canto superior direito do bloco.
• Ao usar o ícone de três pontos no lado esquerdo de cada bloco, você pode arrastar e soltar para reordenar os blocos. 

Há dois grupos básicos de tipos de blocos:

1. Blocos "Tipo atributo": os blocos do tipo atributo terão a palavra "attribute" como prefixo.  Esses tipos de blocos permitem que os visitantes insiram dados específicos.
2. Blocos "Tipo específico": os blocos de tipo específico são usados para criar elementos no formulário, por exemplo, texto, imagens, um separador etc.

Tipos de blocos:

Blocos de tipo específico:

• Texto e imagem: usado para adicionar texto ou imagens personalizados ao formulário, adicionar conteúdo com o editor de texto. Certifique-se de que o editor esteja configurado nos parâmetros do usuário.
• Divisor: usado para adicionar um divisor (separador), tornando o formulário mais legível visualmente.
• Opt-in: usado para adicionar uma caixa de seleção de opt-in.  Os visitantes não poderão enviar um formulário se essa caixa de seleção não estiver marcada.
• Captcha: usado para adicionar captcha a um formulário.  Para usar esse tipo de bloco, você deve ter o plug-in captcha em seu site instalado e ativado. É altamente recomendável que cada formulário tenha um campo captcha.

Blocos do tipo atributo:

• E-mail: usado para permitir que os visitantes insiram o endereço de e-mail. É necessário um endereço de e-mail válido, que será sinalizado se não for inserido corretamente.
• Atributo de texto: usado para permitir que os visitantes insiram um valor textual, por exemplo, "Nome".
• Número do atributo: usado para permitir que os visitantes insiram um valor numérico; a entrada será validada quando for um valor numérico.
• Atributo de data: usado para permitir que os visitantes insiram um valor de data; os visitantes terão um calendário apresentado para inserir o valor, por exemplo, "Data de nascimento".
• Atributo de alternância: usado para permitir que os visitantes insiram o valor Yes/No (Sim/Não).  O visitante verá a caixa de seleção.
• Atributo de opção única: usado para permitir que os visitantes façam uma seleção em uma lista de opções. O visitante verá os botões de opção ou a caixa de seleção.

Os blocos de tipo específico e atributo têm os seguintes parâmetros:

• visible (visível): com esse botão, você pode facilmente ativar ou desativar um bloco.
• block class (classe de bloco): classe adicionada ao bloco.
• style (estilo): regras específicas de estilo CSS adicionadas a um bloco, atributo de estilo do elemento do bloco.
• block control class (classe de controle de bloco): classe adicionada aos elementos de controle dentro de um bloco.

A maioria dos blocos do tipo atributo tem os seguintes parâmetros e opções:

• required switch (opção obrigatória): os visitantes devem inserir um valor nesse campo.
• show label switch with the option to enter label text (mostrar o botão de rótulo com a opção de inserir o texto do rótulo): você pode definir e selecionar se o rótulo será exibido ao lado de um campo.
• show help switch with the option to enter help text (mostrar o botão de ajuda com a opção de inserir texto de ajuda): você pode definir e selecionar se uma explicação adicional será exibida.

Quando terminar de criar o formulário, clique no botão Save (Salvar) no canto superior esquerdo.

7. Adicionar um formulário

Para mostrar os formulários que você criou, faça login no administrador do Joomla:

1. Acesse Extensions (Extensões) > Modules (Módulos).
2. Clique no botão +New (Novo) no canto superior esquerdo.
3. Selecione Brevo subscription form (Formulário de inscrição Brevo).

Comece adicionando um título.

Nesse módulo, você precisará selecionar o formulário de inscrição que acabou de criar.

Também há parâmetros adicionais para adicionar texto antes e depois do módulo. Se o seu site não estiver em inglês, recomendamos que você configure o parâmetro do módulo para o rótulo do botão.

Defina outros parâmetros padrão, como:

• Show Title (Mostrar título): se você selecionar "Show" (Mostrar), o título será exibido em seu site.
• Position (Posição): escolha onde o formulário aparecerá em seu site.

Dependendo do modelo do Joomla que seu site usa e de outros estilos adicionais, é importante entender a representação visual do formulário finalizado. 

O módulo usa controles e classes de formulário padrão do Joomla para renderização de formulários, e há opções para adicionar classes e estilos a cada bloco de formulário. Por esse motivo, seu formulário pode ser facilmente personalizado de acordo com suas preferências.

Por exemplo, se você tiver o tipo de bloco "Atributo de opção única" em seu formulário e estiver usando o modelo padrão do Joomla "Protostar", ao configurar o parâmetro "Block control class (Classe de controle de bloco)" para "btn-group btn-group-yesno" para esse bloco, obterá botões de opção renderizados com as classes de botões padrão do Joomla, que também devem existir em muitos outros modelos.

Enviar e-mails transacionais via Brevo

1. Configurar a senha do SMTP

No administrador do Joomla, no painel de controle da Brevo, clique no ícone SMTP Settings (Configurações de SMTP) para configurar seus e-mails transacionais.

Cole sua senha SMTP e clique no botão Set Joomla mail settings (Definir configurações de e-mail do Joomla). A configuração do Joomla será atualizada.

2. Enviar um e-mail de teste

Você pode enviar um e-mail de teste para confirmar que tudo está funcionando sem problemas: 

• Digite seu endereço de e-mail no campo Test email (E-mail de teste).
• Clique no botão Send test email (Enviar e-mail de teste).
• Verifique seus e-mails.

Esse e-mail de teste também será registrado nos logs transacionais da sua conta Brevo.

Acompanhar a atividade do seu site com a automação de marketing

Configuração da automação de marketing

Primeiro, verifique se você ativou a automação de marketing em sua conta Brevo. Para isso, faça login, acesse a guia Automation (Automação) no menu superior e clique no botão TRY FOR FREE (EXPERIMENTAR GRATUITAMENTE). 

Quando você instalar o pacote Joomla, o plug-in de automação de marketing da Brevo estará automaticamente disponível para uso. Agora, você só precisa ativá-lo. 

No administrador do Joomla, no painel de controle da Brevo. Clique no ícone Marketing automation (Automação de marketing).

1. Clique no botão Enable plugin (Ativar plug-in).
   
2. Clique no botão Set plug-in Tracking ID (Definir ID de rastreamento do plug-in). Isso recuperará o ID de rastreamento da automação de marketing de sua conta Brevo.

Monitoramento da atividade do site

Agora que o rastreador de automação Brevo está integrado ao seu site, todas as páginas visitadas por seus contatos serão automaticamente rastreadas. Você encontrará esses logs na sua conta Brevo em Automation (Automação) > Logs > Event logs (Logs de evento):

• página
• identificação

Consulte este guia para saber mais sobre como usar seus logs de automação. 

Automatização das comunicações de marketing

A automação usa "fluxos de trabalho" para criar experiências de marketing em várias etapas para seus contatos como:

• Enviar uma mensagem de boas-vindas para os novos assinantes da lista de e-mail  
• Criar uma série de e-mails de integração para novos usuários do site

Os fluxos de trabalho também podem ajudar você a gerenciar processos internos de marketing como: 

• Pontuar novos leads com base em como eles se comportam em seu site
• Adicionar novos atributos aos seus contatos atuais ou movê-los para uma nova lista com base em uma compra recente 

Você pode acionar o início de um fluxo de trabalho com base em muitas coisas, inclusive quando os contatos: 

• São identificados em seu site.
• Visitam uma página.
• São adicionados a uma lista de contatos.
• E muito mais!

A Brevo oferece modelos de fluxo de trabalho prontos para uso, ou você pode deixar sua criatividade trabalhar e criar um fluxo de trabalho personalizado para suas necessidades exatas.

Consulte este guia para saber mais sobre a criação de cenários de automação ou visite Automação e crie seu primeiro fluxo de trabalho hoje mesmo. 

⏭️ O que vem a seguir?

• Seis motivos para adotar a automação de marketing
• Qualifique seus contatos usando o sistema de pontuação da Brevo

🤔 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 o parceiro especialista certificado em Brevo.