Integrações Brevo: escolha uma conexão verificável

Envie o mesmo contato de teste duas vezes. Se a segunda execução criar outro registro ou desfizer um cancelamento de inscrição, o conector já falhou antes mesmo de o volume entrar na conversa.

“Só precisamos conectar os dois aplicativos.” É um ponto de partida razoável. Falta saber o que a conexão lembra depois da primeira solicitação.

Confira três aspectos antes de escolher o software

O transporte leva uma solicitação ou evento de um sistema a outro. O mapeamento define o significado dos campos. O estado registra qual versão da origem foi processada, o que falhou e qual registro de destino corresponde a ela.

Defina uma origem, um destino e os campos necessários ao primeiro resultado útil. Atribua a responsabilidade por cada campo. O sistema comercial pode controlar a etapa do ciclo de vida, enquanto a Brevo controla o cancelamento atual de e-mail. Um registro não precisa ter um único responsável por tudo.

Quatro caminhos para a Brevo

Um app nativo

Procure no marketplace da Brevo um app mantido e confira quem o publica. Leia as instruções dos campos e eventos de que você realmente precisa. Estar no marketplace não comprova uma integração da Tajo.

Para Shopify, comece pelo caminho documentado de configuração e migração do Brevo PushOwl. Teste o mapeamento antes de construir outra conexão. Um app nativo pode resolver toda a tarefa, mas os campos e controles de recuperação disponíveis dependem daquele app.

Um serviço de automação

Um serviço de automação pode receber um formulário, mapear os campos e chamar a Brevo. Antes de escolher, confira os controles reais de repetição, custos por tarefa e armazenamento. Nem baixo volume nem um editor visual tornam aceitável perder uma inscrição.

Para inscrições no site, o guia Webflow separa o formulário Brevo incorporado do formulário nativo tratado no servidor. Escolha o caminho que preserva o comportamento de envio e confirmação de que você precisa.

Uma camada de integração

Uma camada dedicada faz sentido quando vários mapeamentos, registros persistentes ou recuperação coordenada justificam outro serviço. Peça para ver os registros com falha e a repetição de um único registro rejeitado. Não deduza essas funções pelo nome da categoria.

A Tajo está em acesso antecipado. Leve uma origem, um destino e um critério de aceitação concretos a uma revisão de integração. Confira o conector e o caminho de execução disponíveis antes de depender deles. A documentação de uma combinação é um começo para essa revisão, não uma prova de que ela está pronta no seu espaço.

Código API direto

Escolha código quando precisar controlar identidade, transformações ou recuperação de uma forma que os outros caminhos não oferecem. Sua equipe passa a cuidar das credenciais, limites, estado salvo e procedimentos operacionais.

O guia da API da Brevo explica uma gravação de contato e os limites do tratamento de falhas. Se a origem for uma planilha, o exemplo Apps Script é um caminho separado por script; não exige um conector nativo da Tajo para Sheets.

Use o quadro de decisão

Decisão	App nativo	Serviço de automação	Camada de integração	API direta
Campos necessários	Confira o mapeamento do app	Confira os parâmetros das ações	Revise o mapa proposto	Implemente o mapa
Identidade do registro	Confira as regras de correspondência	Configure a correspondência explicitamente	Revise o contrato de identidade	Guarde o ID de destino
Recuperação	Confira os controles do app	Verifique tentativas e repetição	Demonstre a recuperação por registro	Construa e opere
Volume e limites	Confirme os limites do fornecedor	Estime tarefas e limites	Verifique a carga prevista	Respeite os limites do destino
Responsável operacional	Fornecedor do app e operador	Responsável pelo cenário	Fornecedor e responsável pela sincronização	Sua equipe

Qual caminho atende ao seu requisito real?

1. O app nativo cobre campos e verificações

   Use o app nativo

   Comece pela configuração documentada.

2. Um formulário ou evento pede uma pequena ação mapeada

   Avalie um serviço de automação

   Verifique confirmação e repetição.

3. Vários mapeamentos precisam de recuperação coordenada

   Avalie uma camada de integração

   Peça uma demonstração de falha e repetição.

4. A transformação necessária não está disponível

   Escreva o menor caminho API

   Planeje também o custo de operação.

Comprove a primeira sincronização com um registro

Use um destino isolado e um contato que você controla. Mantenha as automações de campanhas desativadas enquanto confere o caminho dos dados.

1. Registre ID de origem, lista de destino, atributos necessários e evidências atuais de consentimento. Crie os tipos de atributo antes de gravar.
2. Execute uma vez. Confira o registro de destino, não apenas o status do trabalho. Verifique valores e autorização de marketing separadamente.
3. Repita a mesma versão da origem. Deve existir uma identidade, sem outra confirmação ou mensagem de boas-vindas.
4. Altere um campo comum e sincronize. Depois deixe um campo vazio e confira a regra documentada de preservar ou apagar.
5. Registre um cancelamento posterior. Processe de novo a inscrição antiga e confirme que o cancelamento continua prevalecendo.
6. Simule uma solicitação rejeitada. Guarde identidade e resultado, recupere aquele registro e confira o destino antes de avançar o cursor salvo.

Esse é um procedimento de aceitação, não uma afirmação de que todo conector oferece os mesmos controles. Se uma verificação necessária não puder ser demonstrada, essa é a lacuna a resolver.

Não deixe novas tentativas mudarem o significado

O endpoint de contatos da Brevo aceita ext_id de origem e oferece updateEnabled. A correspondência continua sendo sua responsabilidade. Identificadores em conflito exigem revisão; forceMerge pode excluir um registro e não deve ser a recuperação padrão.

Repetir gravações e repetir efeitos colaterais são problemas diferentes. Um contato pode existir uma única vez e receber duas confirmações. Salve o identificador da submissão e o resultado de cada efeito. Um tempo limite deixa o resultado incerto: confira o destino antes de tentar enviar novamente.

Leia a tabela atual de limites para cada endpoint e nível da conta. Os limites variam; alguns caminhos têm limites por hora e por segundo. Não copie um teto numérico para todas as operações.

Webhooks também precisam de um responsável

Um evento informa que algo mudou. Ele não resolve disputas sobre quem controla os campos nem mantém sozinho uma sincronização bidirecional completa.

Autentique a entrega com o método oferecido pelo fornecedor, salve o trabalho válido e reconcilie atualizações perdidas. Quando o conector receber de volta sua própria atualização, compare a versão de origem registrada e os valores previstos antes de gravar de novo. Não suponha que todo fornecedor devolve um marcador de origem personalizado.

Para um novo assinante, siga o guia de double opt-in antes de incluir o endereço no público de marketing. Um endereço copiado é um resultado de dados. Um endereço confirmado e atualmente inscrito é outro resultado.

A conexão está pronta quando a segunda execução é tão explicável quanto a primeira.