E-mail com marca
send_email entrega um e-mail HTML com a marca (mais uma parte em texto simples). Quando não está, os e-mails saem em texto simples exatamente como antes — nada muda e nada quebra.
Como Funciona o Vínculo
A marca é dado que você possui, não um modelo fixo. Você a armazena uma vez em um registro de Marca e aponta um agente para ele. No momento do envio, a plataforma compõe o HTML a partir desse registro — o assistente nunca escreve HTML por conta própria, de modo que todo e-mail é consistente e seguro.
| Etapa da cadeia | O que significa |
|---|---|
| Registro de Marca | Contém a marca: URL do logotipo, cores, fontes, HTML de cabeçalho e rodapé, endereço da empresa, site, e-mail de contato e diretrizes opcionais. |
| Campo de pesquisa Agente → Marca | Na Definição de Agente, o campo Marca aponta para a marca que este agente deve usar. Deixe em branco para e-mail em texto simples. |
send_email resolve o vínculo | Quando o agente envia, a plataforma segue a conversa até o agente, lê a Marca vinculada a ele e — se a marca estiver Ativa — envolve a mensagem em HTML com a marca. |
| O destinatário recebe | Um e-mail HTML com a marca e uma versão em texto simples, para que seja renderizado em qualquer lugar. |
Como a referência fica no agente, um cliente que administra dois negócios em uma única organização simplesmente mantém dois registros de Marca e aponta cada agente para o correto. Agentes diferentes podem usar marcas diferentes; um agente sem marca vinculada continua enviando texto simples.
Passo a Passo: Dê Marca aos Seus E-mails
-
Abra a guia Marca › Novo
Dê à marca um Nome (por exemplo, “Acme Realty”). Você pode preencher os campos manualmente ou deixar a IA fazer isso — veja Otimizar a Marca com IA abaixo.
-
Defina uma URL de Logotipo pública
Informe Logo URL — uma URL de imagem absoluta e publicamente acessível (PNG/JPG) hospedada no seu site ou CDN. Os destinatários são externos e não conseguem carregar links de arquivo do Salesforce protegidos por permissão, então o logotipo precisa ser público.
-
Adicione cores e uma fonte
Primary Color (títulos/destaques), além das cores opcionais Accent, Text e Background como valores hexadecimais (por exemplo,
#0B5CAB), e uma Font Family segura para e-mail.Opcionalmente, defina o Website URL, o Contact Email e o Company Address — os dados públicos da marca, disponíveis para a marcação do seu cabeçalho e rodapé, para que os mesmos valores não precisem ser redigitados em cada modelo.
Há também um campo Guidelines para voz e tom da marca. Nada o lê hoje — ele não faz parte do layout do e-mail nem molda o texto gerado pela IA. Ele é capturado para referência e para futuros recursos que considerem a marca, então preencha-o se for útil para sua equipe, mas não espere que mude nenhum resultado.
-
Escreva o cabeçalho e o rodapé
Header HTML é o seu cabeçalho de marca (nome da marca / slogan). Footer HTML precisa incluir seu endereço postal e um link de cancelamento de inscrição — isso é exigido pela legislação antispam e pela ativação.
-
Ative a marca
Marque Is Active. A ativação fica bloqueada até que haja uma Primary Color, um Footer e uma Logo URL preenchidos, para que uma marca nunca seja enviada pela metade. Rascunhos podem ser salvos inativos enquanto você os constrói.
-
Vincule a marca a um agente
Abra o agente (Definições de Agente) e defina seu campo de pesquisa Marca (em Context & Persona) para este registro.
-
Envie um e-mail de teste
Peça ao agente para enviar um e-mail para um endereço que você possa verificar. O destinatário vê o seu e-mail com marca; um agente sem Marca definida continua enviando texto simples, para efeito de comparação.
Otimizar a Marca com IA
Em vez de digitar cada campo, você pode deixar a IA ler um documento de marca e propor os valores para você.
- No registro de Marca, abra o painel Optimize Branding with AI.
- Envie um documento de marca — um papel timbrado, um PDF de diretrizes de marca ou um folheto (PDF, imagem ou texto).
- Clique em Optimize with AI. O assistente lê o documento e propõe cores, fontes, cabeçalho/rodapé, endereço, site, e-mail de contato e diretrizes.
- Revise os valores propostos e depois Apply to Record (ou Discard). Você mantém o controle — nada é salvo até você aplicar.
- Defina sua Logo URL (a IA não extrai a imagem do logotipo) e ative a marca.
O Que o Destinatário Recebe
Para um agente com marca, send_email envia um e-mail multipart — uma parte em texto simples (para clientes sem HTML e acessibilidade) e a parte HTML com a marca, composta de cima para baixo como:
- Cabeçalho — seu logotipo e o HTML de cabeçalho, com um destaque na cor da marca.
- Mensagem — o texto do agente, seguido pela assinatura do remetente (a assinatura do Salesforce do usuário em execução, ou um nome / cargo / e-mail como alternativa).
- Rodapé — seu endereço e o link de cancelamento de inscrição.
A assinatura é o encerramento pessoal dentro da mensagem; o rodapé da marca (endereço, cancelamento de inscrição) fica separado, abaixo dela. A resolução do destinatário, o histórico de atividades, o endereço De para toda a organização e o rastreamento de respostas funcionam exatamente como em um e-mail simples — veja Canal de E-mail — Saída.
Avançado: Traga o Seu Próprio HTML
Para um controle perfeito ao pixel, coloque um e-mail HTML completo no campo Wrapper HTML do registro de marca, com um marcador {{body}} no ponto em que a mensagem deve entrar. Quando definido, a plataforma usa esse HTML literalmente — injetando a mensagem do agente em {{body}} — em vez de compor a partir dos campos individuais de cor e cabeçalho/rodapé. Deixe em branco para usar a composição padrão.
Escopo e Canais
- Todos os canais. A marca se aplica igualmente a agentes Internos, de Widget Externo, de Comunidade e de API — é controlada inteiramente pelo fato de o agente ter ou não uma marca ativa vinculada.
- Somente e-mail. WhatsApp e SMS permanecem em texto simples (não podem receber marca visual).
- Compatível com versões anteriores. Sem marca vinculada → e-mail em texto simples com a assinatura automática, exatamente como antes.
- A marca define como um e-mail parece, não de quem ele vem. O endereço de envio, o nome exibido e o endereço de resposta são configurações separadas e são definidos pelas instruções do agente — consulte Escolhendo o remetente e o endereço de resposta. Um e-mail com marca pode ser enviado a partir de qualquer identidade verificada, e um sem marca também.
Mudanças incluídas em 1.16000
Ferramentas de tarefas e eventos aceitam valores adicionais de campos, incluindo associações permitidas com Contato/Lead. E-mails do agente usam a marca configurada nas rotas suportadas executadas no servidor; teste com rascunho ou destinatário interno após mesclar as definições.
Checklist de atualização do cliente
Perguntas frequentes
Verifique se o campo de pesquisa Marca do agente aponta para um registro com Is Active marcado. Se algum dos dois estiver ausente, o agente envia texto simples. Confirme também que o envio partiu da conversa desse agente.
O visualizador nativo de EmailMessage do Salesforce bloqueia imagens externas. O logotipo é incorporado ao HTML do e-mail e é renderizado na caixa de entrada real do destinatário — confirme verificando o e-mail entregue, não a pré-visualização dentro do Salesforce.
Sim. Crie um registro de Marca para cada marca e aponte cada agente para o correto por meio do seu campo de pesquisa Marca. Não existe uma única marca padrão para toda a organização.
Não. O assistente escreve apenas a mensagem em texto simples. A plataforma compõe o HTML com a marca de forma determinística a partir do seu registro de Marca, de modo que todo e-mail seja consistente e o texto da mensagem nunca possa injetar marcação.
Próximos passos
Veja Canal de E-mail — Saída para saber como funcionam o envio, a resolução do destinatário e o rastreamento de respostas, ou Configuração do agente para definir o campo de pesquisa Branding no seu agente.