Variáveis, campos personalizados e tags

Para administradores10 minutos

Três recursos ajudam a organizar e a automatizar: as tags (etiquetas), os campos personalizados (dados extras do cliente) e as variáveis da empresa (valores guardados, como tokens). Os três ficam no grupo Automação do menu.

Tags

Tags são etiquetas coloridas que você coloca nos clientes para organizá-los: "VIP", "convênio", "retorno". Elas ajudam a filtrar listas e podem disparar fluxos.

No menu, abra Automação → Tags.

O catálogo de tags. Uma tag vale para todos os clientes.

Para criar, escreva o Nome (por exemplo, "cliente"), escolha a Cor e clique em Criar. Uma prévia mostra como a tag vai aparecer. O catálogo é único para a empresa inteira.

Excluir uma tag a remove de todos os clientes

A tela avisa: "excluir uma tag remove a associação de todos os leads que a usam". Antes de excluir, confira em quantos clientes ela está.

Para aplicar uma tag, use o campo + tag na ficha do cliente, ou o bloco Ação de um fluxo.

Campos personalizados

Os campos personalizados guardam dados que o cadastro padrão não tem: o convênio do paciente, a data da última consulta, o plano contratado. O valor de cada campo é independente por pessoa, mas o campo em si é criado uma vez, para todos.

No menu, abra Automação → Campos Personalizados.

Dois tipos de campo: do lead e de fluxo.

Há dois tipos:

Tipo	Para que serve
Campo do Lead	Dado que a equipe preenche. Aparece no cadastro do lead e, se você marcar, no cadastro do contato. Os fluxos também podem ler e gravar.
Campo de fluxo	Variável interna dos fluxos: guarda o que acontece durante a conversa (a resposta do cliente, a etapa do funil, um protocolo). Não aparece no cadastro, mas o valor pode ser visto em Dados dos fluxos, na ficha.

Para criar um campo, escreva o Rótulo, escolha o Tipo e, para campo do lead, marque onde ele deve aparecer: Visível na ficha do lead e Visível no cadastro do contato. O sistema mostra a chave que será usada, por exemplo convenio.

Use a chave entre chaves duplas, como {{convenio}}, nas mensagens e nas condições dos fluxos.

Variáveis da empresa

As variáveis da empresa são valores globais, independentes de cliente, para usar em qualquer integração com {{chave}}. São úteis para guardar um token de acesso a outro sistema e reaproveitá-lo em várias requisições. Uma integração também pode gravar aqui o resultado, por exemplo um token novo.

No menu, esta tela se chama Variáveis do Tenant e o título dela é Variáveis da empresa.

Uma variável sensível, que só vale no cabeçalho e para o endereço permitido.

Há dois tipos:

Tipo	Como pode ser usada
Sensível (recomendado)	Só no valor de um cabeçalho e só em requisições para os endereços permitidos dela. Nunca na URL, no corpo ou para outro endereço. Sem nenhum endereço permitido, ainda não pode ser usada.
Livre	Em qualquer parte da requisição.

A regra da variável sensível protege você: quem monta um fluxo não consegue enviar um token para um sistema qualquer.

Criando uma variável

1. Escreva a Chave (por exemplo, token_agenda) e o Valor.
2. Deixe Sensível marcado e informe os Endereços permitidos, um por linha ou separados por vírgula. Informe só o endereço, sem https:// nem caminho. *.exemplo.com vale para subdomínios.
3. Clique em Criar.

O valor não é mostrado nem editado

Depois de criado, o valor não aparece e não pode ser editado por aqui. Para trocá-lo, exclua e crie de novo. A atualização automática, feita por uma integração, sempre pode sobrescrever.

Conferido no sistema em 26/10/2026.