Usar campos de mesclagem nos modelos

Os campos de mesclagem transformam um modelo em uma mensagem pessoal para cada cliente. Você escreve um marcador como {{FirstName}} no Corpo do modelo e, ao enviar, o REDA Connect consulta o registro associado à mensagem e substitui o marcador pelo valor real. Este artigo explica a sintaxe, as duas configurações que permitem a mesclagem e o erro mais comum com modelos do REDA Connect.

Sintaxe: um caminho de campo entre chaves duplas

Um campo de mesclagem é um caminho de campo resolvido com base no objeto aplicável do modelo:

{{<Nome de API do campo>}} — um campo do próprio objeto aplicável
{{<Nome do relacionamento>.<Nome de API do campo>}} — um campo de um registro relacionado

Por exemplo, em um modelo de Contact: Olá {{FirstName}}, seu saldo é {{Outstanding_Balance__c}}.. Os caminhos começam diretamente no campo, pois o objeto aplicável já indica a qual objeto pertencem.

Três erros comuns entre quem vem de outras ferramentas do Salesforce:

• Chaves duplas, não {!...}. O REDA Connect não usa a sintaxe de fórmulas {!Object.Field} que você talvez conheça dos modelos de email e botões. Aqui, {!FirstName} é apenas texto e será enviado ao cliente sem alterações.
• Nunca coloque o nome do próprio objeto como prefixo. Escrever {{Lead.FirstName}} em um modelo de Lead parece natural, mas o REDA Connect interpreta tudo antes do primeiro ponto como um relacionamento a percorrer, e Lead não tem um relacionamento chamado "Lead". O teste falha com: Invalid relationship Lead for Lead. Em um modelo de Lead, o marcador é simplesmente {{FirstName}}.
• Os registros relacionados são acessados pelo nome do relacionamento, exatamente como em SOQL: {{Owner.Name}} mescla o nome do proprietário do registro; em um modelo de Opportunity, {{Account.Name}} percorre o relacionamento Account da oportunidade e mescla o nome da conta.

Os campos de registros relacionados aceitam somente valores de texto (a ajuda na tela indica que somente campos relacionais do tipo de dados "Text" são aceitos). Um campo numérico, de data ou de caixa de seleção de um registro relacionado não é confiável por meio de um caminho de relacionamento: copie primeiro esses valores para o próprio objeto do modelo ou mescle-os diretamente a partir do objeto aplicável.

As duas configurações que permitem a mesclagem

1. Objeto aplicável: deve indicar o objeto ao qual pertencem seus campos de mesclagem (nome de API exato). Salvar um modelo com a caixa de mesclagem marcada e sem objeto aplicável falha com: Se houver campos de mesclagem no corpo do modelo, o "Objeto aplicável" deve ser informado.
2. Campo(s) de mesclagem: a caixa de seleção que habilita a mesclagem. É inteiramente manual, o que nos leva ao erro a seguir.

Três campos de mesclagem em um corpo: {{FirstName2}}, {{Owner.Name}} e {{Owner.Phone}}. Campo(s) de mesclagem está marcado e Objeto aplicável indica o objeto com base no qual os caminhos de campo são resolvidos.

Como os valores são apresentados

Como os campos vazios são mesclados silenciosamente como um espaço, modelos que dependem de campos opcionais podem produzir frases estranhas ("Olá , seu..."). Use campos que seu processo garanta que estarão preenchidos, ou redija a frase para que continue natural mesmo sem o valor.

Exemplo prático: três campos de mesclagem

Modelo (objeto aplicável Contact, Campo(s) de mesclagem marcado):

Olá {{FirstName}}, obrigado por visitar {{Account.Name}}.
Seu consultor {{Owner.Name}} ligará para você dentro de um dia útil.

{{FirstName}} é um campo do próprio Contato; {{Account.Name}} e {{Owner.Name}} percorrem seus relacionamentos Account e Owner.

Enviado ao contato Maria Silva (conta Acme Rentals, proprietário Alex Chen):

Olá Maria, obrigado por visitar Acme Rentals.
Seu consultor Alex Chen ligará para você dentro de um dia útil.

Enviado a um contato cujo FirstName está vazio:

Olá  , obrigado por visitar Acme Rentals.
Seu consultor Alex Chen ligará para você dentro de um dia útil.

Observe o espaço isolado após "Olá". É o comportamento silencioso dos campos vazios descrito acima.

A mesclagem comprovada: {{FirstName}} no corpo do modelo virou Maya. O teste foi executado com o Lead cujo ID de 18 caracteres foi colado em ID do registro de mesclagem, e Teste de modelo concluído com sucesso aparece acima da mensagem totalmente mesclada.

Testar um modelo com mesclagem exige um registro

Ao executar Testar modelo em um modelo com campos de mesclagem, você deve fornecer um registro para mesclar seus dados. O texto na tela diz: Forneça um ID de registro de 18 caracteres do objeto aplicável para testar o modelo. Copie um ID de registro do objeto aplicável da barra de endereços do navegador (o valor de 18 caracteres na URL do registro). Testar com um ID de outro objeto falha com Os parâmetros de entrada fornecidos são inválidos. O processo completo está em Testar e ativar um modelo.

Solução de problemas

Perguntas frequentes

Próximos passos

• Testar e ativar um modelo: todo modelo com mesclagem deve ser testado com um registro real antes de ser usado.
• Criar um modelo: os demais campos do modelo.