O Tajo move dados do seu sistema de origem para a Brevo por meio de regras de sincronização controladas: aprovadas por humanos, unidirecionais, executadas em uma programação e registradas do início ao fim. Este artigo explica o que isso significa na prática e o que não está incluído.
Verificação rápida Este artigo pressupõe que você já conectou o Shopify e a Brevo e publicou pelo menos uma regra de sincronização. Se ainda não fez isso, comece por conectar o Tajo ao Shopify.
O formato de uma sincronização
Toda sincronização no Tajo é uma regra de sincronização: uma definição revisada e aprovada de exatamente o que se move e como. Uma regra tem quatro partes que você pode inspecionar na sua página, em Conectores > Sincronizações:
| Parte | O que faz |
|---|---|
| Mapeamento de campos | Cada campo de origem, o campo da Brevo em que ele grava e qualquer transformação intermediária |
| Expressão de filtro | Avaliada por registro; registros que não correspondem são ignorados |
| Cursor | Rastreia até onde a sincronização avançou, para que cada execução continue de onde a última parou |
| Histórico de execuções | Cada execução, com registros lidos, gravados e com falha, além de duração e status |
Os dados fluem em uma única direção: da sua fonte para a Brevo. O Tajo não grava dados de volta no Shopify.
Quando os dados sincronizam
As execuções de sincronização acontecem em lotes programados, ou sob demanda quando você dispara uma execução na página da regra. O Tajo não é um pipeline em tempo real: uma mudança no Shopify chega à Brevo na próxima execução, não em segundos. Isso é proposital: execuções em lote são o que torna cada gravação revisável, sujeita a orçamento e atribuível a uma execução específica no audit trail.
Cada execução lê registros novos e alterados desde o cursor, aplica o filtro, mapeia os campos e grava na Brevo. O registro da execução mostra exatamente quantos registros foram lidos, gravados e com falha.
As garantias de governança
O consentimento falha fechado
Uma regra de sincronização não pode ser publicada sem uma política de consentimento e, em tempo de execução, um registro sem consentimento comprovável não é gravado. Quando o consentimento não pode ser estabelecido, o Tajo recusa a gravação em vez de adivinhar. O modo de falha é sempre “cauteloso demais”, nunca “enviado demais”.
As execuções são idempotentes
Toda gravação carrega uma chave de proveniência derivada do registro de origem (construída para ser segura em relação a dados pessoais), então executar a sincronização novamente, depois de uma falha, uma pausa ou manualmente, não cria gravações duplicadas. É sempre seguro executar uma regra de novo.
Tudo é auditado
A publicação de uma regra, cada decisão de aprovação (com sua justificativa escrita) e cada execução são registradas no audit trail. A aprovação que autorizou uma publicação fica vinculada à versão exata da regra que foi revisada; editar a regra invalida a aprovação, então o audit trail sempre reflete o que foi realmente autorizado.
Falhas pausam a regra
Se várias execuções seguidas falharem, um circuit breaker pausa a regra automaticamente e exibe o último erro na página da regra. Corrija a causa e publique novamente para retomar. Uma execução parcialmente falha reporta sua contagem de falhas, para que você veja exatamente o que não chegou ao destino.
Como os descadastramentos são respeitados
O Tajo trata a Brevo como a fonte da verdade para o consentimento de e-mail:
- Quando um contato se descadastra pelo link no rodapé de um e-mail da Brevo, esse opt-out é registrado no contato e a Brevo o exclui de campanhas futuras.
- Contatos na lista de bloqueio da Brevo permanecem excluídos: envios futuros não os trazem de volta.
- O Tajo não envia o status de descadastramento de volta para o Shopify. Se você também coleta consentimento de e-mail no Shopify, gerencie-o lá separadamente; não presuma que os dois sistemas se espelham.
Quais dados estão disponíveis
O que sincroniza depende dos modelos disponíveis para sua fonte. Para o Shopify, o formato típico são registros de clientes: campos de identidade e atributos derivados de pedidos, como total gasto e número de pedidos, mapeados para atributos de contato da Brevo que você pode usar em segmentos e campanhas. O mapeamento exato para o seu workspace não fica escondido em uma descrição: abra a regra de sincronização e leia a tabela de mapeamento de campos. Essa tabela é a resposta definitiva para “o que sincroniza”.
O que o Tajo não faz hoje
Ser preciso sobre os limites importa mais do que uma longa lista de recursos:
- Nenhuma sincronização bidirecional. Nada é escrito de volta no Shopify: nem descadastramentos, nem tags, nem pontuações de engajamento.
- Nenhuma sincronização em tempo real. As execuções são lotes programados ou disparados manualmente, não streaming de subminutos.
- Nenhum monitoramento de estoque. Os níveis de estoque dos produtos não são monitorados, e não há gatilhos de volta ao estoque.
Se um desses limites bloqueia um caso de uso para você, avise a equipe: as prioridades do acesso antecipado são moldadas exatamente por esse tipo de feedback.
Onde ver seus dados
- No Tajo: abra a regra de sincronização em Conectores > Sincronizações para ver histórico de execuções, posição do cursor e contagens por execução. O audit trail registra publicações e aprovações.
- Na Brevo: abra Contatos e inspecione os atributos de qualquer contato para confirmar que os campos mapeados estão sendo preenchidos. Construa segmentos sobre esses atributos para segmentação de público.
Solução de problemas
- Contatos não aparecendo na Brevo: verifique a execução mais recente da regra em busca de falhas e o seu status (uma regra pausada não está em execução). Veja contatos ausentes na Brevo.
- Execuções falhando repetidamente: o circuit breaker vai pausar a regra e mostrar o último erro. Veja dados não sincronizando.
- Contatos duplicados: as gravações são idempotentes por registro de origem, mas duplicatas já existentes na Brevo permanecem. Veja contatos duplicados.
Perguntas frequentes
Posso deixar a sincronização mais rápida? Você pode disparar uma execução sob demanda a qualquer momento na página da regra de sincronização. Não existe um modo em tempo real.
O que acontece se uma execução falhar no meio do caminho? A execução reporta sua contagem de falhas, o cursor avança apenas sobre o que foi processado, e a próxima execução recobre o terreno com segurança: as chaves de idempotência evitam duplicatas.
Posso mudar o que sincroniza? Sim: edite o mapeamento de campos ou o filtro da regra. A edição gera uma nova versão que precisa passar novamente pela aprovação de publicação antes de entrar em vigor.
Por que minha regra se pausou sozinha? Falhas consecutivas de execução acionam o circuit breaker. A página da regra mostra a contagem de falhas e o último erro; corrija o problema e publique novamente.
Artigos relacionados
- Conectar o Tajo ao Shopify
- Fundamentos de segmentação
- Solução de problemas: dados não sincronizando
- Solução de problemas: contatos ausentes na Brevo
Obtenha ajuda
- Chat ao vivo: disponível no painel do Tajo (canto inferior direito)
- Suporte por e-mail: [email protected]
- Documentação: docs.tajo.io