Principal Primeiros passos do agente Como usar campos dinâmicos no Cloud Chat

Como usar campos dinâmicos no Cloud Chat

Última atualização em May 21, 2026

Quando usar

  • Você quer personalizar mensagens com nome do cliente, e-mail ou outro dado automaticamente
  • Você está criando atalhos, macros ou automações com placeholders
  • Você precisa puxar atributos personalizados da conversa ou contato em uma resposta

Sobre este artigo

Os campos dinâmicos servem para puxar informações automaticamente de uma conversa, contato ou agente — como nome do cliente, telefone, e-mail. Você pode usar em respostas, atalhos, macros e automações.

O que são campos dinâmicos

São pedacinhos de texto entre chaves duplas que o sistema troca automaticamente por dados reais.

Por exemplo:

Olá, {{contact.first_name}}! Como posso te ajudar hoje?

Se o nome do contato for Matheus, a mensagem vai sair assim:

Olá, Matheus! Como posso te ajudar hoje?

Campos nativos disponíveis

Conversa

  • {{conversation.display_id}} — ID da conversa (o que aparece pra você)

  • {{conversation.id}} — ID interno da conversa (mais técnico)

Contato (quem está falando com você)

  • {{contact.id}} — ID da pessoa

  • {{contact.name}} — Nome completo

  • {{contact.first_name}} — Primeiro nome

  • {{contact.last_name}} — Sobrenome

  • {{contact.email}} — E-mail

  • {{contact.phone}} — Telefone

Agente (você ou alguém do seu time)

  • {{agent.name}} — Nome completo

  • {{agent.first_name}} — Primeiro nome

  • {{agent.last_name}} — Sobrenome

  • {{agent.email}} — E-mail

Exemplo prático

Você pode criar um atalho ou macro assim:

Oi {{contact.first_name}}, tudo certo?

Aqui é o {{agent.first_name}} do time de suporte. Já estamos olhando seu caso com carinho.

A mensagem enviada será:

Oi Matheus, tudo certo?

Aqui é o Ernesto do time de suporte. Já estamos olhando seu caso com carinho.

Atributos personalizados

Você também pode usar os campos customizados criados pelo administrador, tanto para contato quanto para conversa.

Sintaxe

  • Contato: {{contact.custom_attribute.nome_do_campo}}

  • Conversa: {{conversation.custom_attribute.nome_do_campo}}

Exemplo

Se você criou um campo de contato chamado plano:

Seu plano atual é o {{contact.custom_attribute.plano}}, certo?

Onde usar campos dinâmicos

  • Caixa de resposta (quando estiver escrevendo para o cliente)

  • Atalhos (snippets)

  • Macros

  • Automações

Boas práticas

  • Se o campo estiver vazio (ex: telefone não preenchido), o sistema não mostra nada no lugar — não exibe {{contact.phone}} literal

  • Teste suas automações e mensagens com campos dinâmicos antes de ativar

  • Evite nomes muito longos ou com caracteres complicados em campos personalizados — mantenha simples (ex: plano, não plano_de_assinatura_atual_v2)

Observações