Importe automaticamente dados de contato para sua conta Brevo de sistemas externos usando servidores FTP ou bancos de dados. Isso permite configurar um fluxo de dados automatizado que funciona sem intervenção manual.

Antes de começar

• Você precisa de uma conexão com uma das seguintes opções: 
  • Um servidor FTP (seu ou um fornecido pela Brevo) 
  • Um banco de dados compatível (PostgreSQL, MongoDB, BigQuery ou Snowflake)
• Atualmente, apenas dados de contato são compatíveis. O suporte para objetos de e-commerce e objetos personalizados estará disponível posteriormente.
• Você pode criar várias fontes dentro de uma única integração para importação de dados de diferentes arquivos ou tabelas de banco de dados.

ℹ️ Sobre a importação de dados por meio da integração

O Brevo suporta dois tipos de fontes de dados para importação automatizada: servidores FTP e bancos de dados.

❓Como funciona?

A integração importa automaticamente dados do seu sistema externo para o Brevo em intervalos que você definir. Uma vez configurada, a integração:

• Verifica se há novos dados na frequência que você definir (por hora, diariamente ou sob demanda)
• Processa e importa registros novos ou atualizados
• Mapeia seus campos de dados externos para atributos de contato do Brevo
• Aplica as regras de transformação de dados que você definiu.
• Envia alertas caso ocorra algum problema durante a importação

Você pode monitorar toda a atividade de importação no painel de controle de integração e baixar relatórios de erros se necessário.

🖱️ Etapa 1: acesse a integração

1. No Brevo, clique no menu suspenso da conta e selecione Integrations (Integrações).
2. Na barra de pesquisa, digite o nome da integração que deseja instalar e clique nela:
   1. Servidor FTP para importação baseada em arquivo.
   2. PostgreSQL, MongoDB, BigQuery ou Snowflake para importação de bancos de dados.
      
3. Clique em Set up integration (Configurar integração).

⚙️ Etapa 2: conecte sua fonte ao Brevo

A integração criará a conexão entre o Brevo e seu sistema externo:

1. Insira um nome para sua integração e clique em Continue (Continuar).
   
2. Insira suas credenciais para conectar seu banco de dados ao Brevo. 
   
3. Se o seu arquivo estiver em uma subpasta, abra Optional fields (Campos opcionais) e preencha o campo Folder path (Caminho da pasta). Preencha outros campos opcionais, se necessário. 
4. Clique em Test integration (Testar integração) para garantir que sua conta e servidor Brevo estejam conectados.
5. Clique em Add integration (Adicionar integração). 

🛢️ Etapa 3: adicione uma fonte

Agora que seu servidor e sua conta Brevo estão conectados, você precisa adicionar sua fonte de dados. Uma fonte define quais dados importar e como processá-los.

Configuração da fonte

1. Acesse Integrations > My integrations (Integrações > Minha integrações) e clique no nome da integração que você acabou de criar. 
2. Clique em Create source (Criar fonte). 
3. Insira um nome para sua fonte. 
   
4. Selecione o objeto no Brevo com o qual deseja sincronizar sua fonte. Pode ser contato, produto, pedido ou item do pedido. 
5. Na lista suspensa File to sync (Arquivo a sincronizar), selecione o arquivo da fonte que você deseja sincronizar com o Brevo. Clique no menu suspenso e em Refresh list (Atualizar lista) se o seu arquivo não aparecer na lista. 
6. (Opcional) No menu suspenso Field to check for updates (Campo para verificar atualizações), selecione o campo da sua fonte que o Brevo deve verificar durante cada sincronização para obter informações novas ou atualizadas. 
7. No menu suspenso Sync frequency (Frequência de sincronização), escolha com que frequência deseja coletar dados da sua fonte para o Brevo. Pode ser feito manualmente, a cada hora ou todos os dias. Você poderá alterar essa frequência posteriormente, se necessário. 
8. Clique em Continue (Continuar). 

Seleção de dados 

Na lista suspensa Fields to sync (Campos a sincronizar), selecione qual campo da sua fonte de banco de dados será sincronizado com o Brevo e clique em Continue (Continuar). 

Transformação de dados

Aplique a fórmula aos seus diferentes atributos para limpá-los e padronizá-los com os que você já possui no Brevo.

Para aplicar uma fórmula a um atributo: 

1. Clique em Add formula (Adicionar fórmula).

   

2. No campo do editor, insira sua fórmula de transformação usando CEL (Common Expression Language).
   💡 É bom saber

   Insira . no editor para exibir as fórmulas e os campos disponíveis.
   Abra o item abaixo para conferir nossos exemplos de fórmulas transformação:
   ➕ Exemplos de fórmulas de transformação

   • .normalizeEmail() - Remove espaços e converte endereços de e-mail em letras minúsculas
   • .normalizePhoneNumber()- Converte números de telefone no formato internacional E.164
   • .normalizePhoneNumber("FR") - Normaliza números de telefone locais usando um código de país específico
   • .normalizePhoneNumber(["FR", "BE", "CH"]) - Tenta vários códigos de país em sequência
   • (nome + ' ' + sobrenome).trim() - Combina nome e sobrenome
   • email.isNull() || phone.isNull() - Identifica registros com dados faltantes
   • maritalStatus.ifNull('unknown') - Substitui valores nulos por um valor padrão
   • variable.asInt() - Converte um valor em inteiro
   ➡️ Para saber mais sobre as funções de CEL, consulte nosso artigo dedicado Referência das funções de CEL.
3. Reordene os campos, se necessário, usando o ícone de arrastar e soltar . 
4. Clique em Add field (Adicionar campo) para adicionar um novo campo à sua fonte e sincronize-a com um atributo Brevo.
5. Clique em Continue (Continuar). 

Mapeamento de atributos 

Associe os campos da sua fonte aos atributos Brevo. 

1. Ao lado de cada nome de campo da fonte, selecione no menu suspenso o atributo Brevo correspondente. 
   ❗️ Importante

   Para garantir que a sincronização funcione corretamente, você precisa selecionar pelo menos um campo de cada grupo obrigatório mostrado na legenda de informação em roxo. Ao mapear os campos, garanta que o tipo de atributo Brevo corresponda ao tipo de dados do campo na sua fonte. Por exemplo, se o campo Nome na sua fonte for um campo texto (string) , você deve selecionar um atributo Brevo com um tipo string.

   

2. Desative um atributo se não quiser mais sincronizá-lo. 
3. Clique em Continue (Continuar). 

Você pode verificar o status de sua importação diretamente nas configurações de integração, verificando a lista de suas fontes. 

▶️ Etapa 4: ative e monitore sua fonte

Depois de configurada, sua fonte aparecerá no painel de controle de integração. Aqui você pode:

• Ver as configurações de fonte e verificar quando os dados foram importados pela última vez
• Acionar manualmente uma importação para testar sua configuração ou obter atualizações imediatas
• Visualizar alertas e erros de importações recentes e baixar relatórios de erros
• Editar as configurações de fonte para ajustar frequência, transformações ou mapeamentos de campo
• Excluir a fonte se não for mais necessária
• Adicionar fontes adicionais à mesma integração

Sua importação automatizada será executada de acordo com a programação que você configurou.

⏭️ O que vem a seguir? 

• Explore e analise seus dados com o Analytics

🤔 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.