White label? A gente resolve: cada e-mail com o logo e as cores do seu lojista

Se a sua plataforma envia e-mails em nome dos seus clientes, cada um quer que o cliente final veja a marca dele, não a sua. Com cinco lojistas, cinco templates ainda dão conta. Com cem, cada mudança de texto vira cem mudanças, e alguém acaba recebendo o logo errado.

Agora uma única jornada e um único template saem com o logo e as cores de cada lojista. A marca fica nos seus dados, não no template.

Como funciona

1. Guarde a marca de cada lojista em um objeto personalizado, por exemplo merchant_brand, com campos como logo_url, primary_color e name. Ela chega pela API, por uma importação ou por uma sincronização, como o resto dos seus dados.
2. Adicione um passo Buscar registro na sua jornada, logo antes do e-mail. Escolha o tipo de registro, como encontrá-lo e quais campos carregar, e salve com um nome, por exemplo brand.
3. No editor de e-mail, ligue as cores e o logo a esse nome. Ao lado de qualquer cor há um botão { } (Usar uma variável para…): digite brand.primary_color, e as cores que você escolher viram a alternativa. Em uma imagem, use brand.logo_url, com a imagem que você já tinha como URL da imagem alternativa.

Cada execução busca a marca do seu lojista e o e-mail sai com ela. O texto também pode usá-la: {{brand.name}} no assunto ou no corpo.

Como encontrar o registro

• Por um ID que esta execução traz: o ID do lojista no evento que disparou a jornada (event.merchant_id), um atributo da pessoa ou um campo de outro registro que você já buscou.
• Vinculado à pessoa: siga os relacionamentos do seu CDP, até três saltos (pessoa → lojista → marca do lojista).

Se vários registros combinarem, Se houver vários escolhe um por um campo, o mais recente por exemplo. Sem essa regra nenhum é carregado: nunca um aleatório.

O que acontece quando algo falta

• A jornada nunca para. Se um lojista não tem registro, os campos ficam vazios e o e-mail sai com a sua marca padrão.
• Uma cor que não é cor (vazia, digitada errado) usa a alternativa em vez de quebrar o design.
• Antes de enviar, a Boom verifica cada valor: se um campo traz código, um script ou um link javascript:, ele é removido.
• Ao publicar, a Boom verifica o contrato: se o seu e-mail usa brand.primary_color e o passo não o carrega, a publicação é recusada e diz qual campo adicionar.

A pré-visualização do passo de e-mail roda a busca com um evento real, então você vê o e-mail com a marca daquele lojista. As variáveis ficam separadas em Conteúdo e Estilo, para distinguir o texto do visual.

Não só para marcas

Buscar registro carrega qualquer objeto personalizado. Busque o pedido que o evento traz e envie {{order.total}} pelo WhatsApp, ou carregue o plano da conta antes de um lembrete. Os campos funcionam em e-mails, mensagens de WhatsApp, SMS, Instagram e Messenger, requisições HTTP e eventos.

Pela API e MCP

Os registros são carregados com POST /api/v1/cdp/custom-objects. Pelo MCP, um agente pode criar o tipo, carregar as marcas e montar a jornada inteira com o passo Buscar registro, e a publicação aplica as mesmas validações.

Já está disponível

Buscar registro está ativo em todos os espaços de trabalho. No editor você vê as cores alternativas; para ver a marca real de um lojista, use a pré-visualização do passo de e-mail na jornada. Os detalhes do passo estão na documentação de jornadas.