Campos personalizados guardam o que só o seu negócio precisa saber sobre o cliente: o convênio do paciente, o número do contrato, o orçamento previsto, quem indicou. Você define o campo uma vez, em Configurações, e ele aparece na ficha de todos os contatos, pronto para virar coluna, filtro, variável de mensagem e condição de automação.
O que é
São duas coisas separadas:
- A definição mora em Configurações → Campos Personalizados: nome, tipo, opções e onde o campo aparece. Vale para a empresa inteira.
- O valor é preenchido na ficha de cada contato, na aba Personalizados.
Por isso o campo existe para todo mundo: a lista de contatos, as automações, as Transmissões e as mensagens leem o mesmo catálogo.
A empresa pode ter até 50 campos ativos, e a tela mostra quantos já usou (por exemplo, "12 de 50"). Campos personalizados existem só no contato: negociação e conversa não têm.
Os 18 tipos
| Grupo | Tipos |
|---|---|
| Texto | Texto, Texto longo, E-mail, Telefone, Link, CPF / CNPJ (confere o dígito verificador), CEP |
| Número | Número, Moeda (R$), Percentual (%) |
| Data | Data, Data e hora |
| Escolha | Seleção, Seleção múltipla, Sim / Não |
| Referência | Usuário, Equipe, Contato |
Os tipos de Referência apontam para algo que já existe no Codewo: um colega ("Consultor responsável"), uma equipe ou outro contato ("Indicado por"). A ficha mostra o nome, e ele acompanha se a pessoa for renomeada.
Como criar um campo
Pela tela de configuração
- Vá em Configurações → Campos Personalizados e clique em Novo campo.
- Preencha:
- Rótulo: o nome que aparece na ficha, como "Convênio".
- Texto de ajuda (opcional): aparece abaixo do campo na ficha.
- Tipo: um dos 18.
- Aplica-se a: Todos os contatos, Só pessoa física ou Só pessoa jurídica.
- Opções: só em Seleção e Seleção múltipla. Use "Adicionar opção" para cada uma.
- Limites (opcional): mínimo, máximo e casas decimais nos números; primeira e última data aceitas nas datas; tamanho máximo nos textos.
- Escolha o comportamento:
- Obrigatório: impede salvar a ficha sem preencher o campo.
- Mostrar no painel da conversa: o valor aparece na lateral do atendimento quando está preenchido. Vem ligado.
- Coluna na lista de contatos: o campo vira coluna e filtro em Contatos. Vem desligado.
- Clique em Criar campo.
A lista mostra cada campo com o tipo, a variável para mensagens e quantos contatos já têm valor. As setas mudam a ordem em que os campos aparecem na ficha e no painel.
Pela própria ficha
Na aba Personalizados de qualquer contato, quem pode gerenciar campos vê o botão Novo campo, que cria o campo ali mesmo, com nome, tipo e, se for seleção, as opções. O campo nasce valendo para todos os contatos e com "Mostrar no painel da conversa" ligado. O resto (texto de ajuda, obrigatório, coluna na lista) você ajusta depois em Configurações, pelo botão Gerenciar campos.
Quem pode
- Criar, editar e desativar campos: Super Administrador, Administrador e Gerente, nos cargos que vêm prontos.
- Preencher valores: quem pode editar o contato.
- Ver valores: todos que veem o contato veem todos os campos dele.
Onde o valor aparece e é usado
| Onde | Como |
|---|---|
| Ficha do contato | Aba Personalizados, para preencher e editar. |
| Painel do contato na conversa | Com "Mostrar no painel da conversa" ligado, quando o campo está preenchido. |
| Lista de Contatos | Coluna e filtro, com "Coluna na lista de contatos" ligado. |
| Mensagens | Variável como {{contact.custom.convenio}} em modelos de mensagem, templates de e-mail, respostas automáticas, Transmissões e mensagens de automação. |
| Automações | Condição em todo gatilho que traz o contato. A ação "Atualizar contato" também preenche campo personalizado. |
| Transmissões | Filtro do público, no grupo "Personalizados". |
| Preencher ficha com IA | Na conversa, a IA sugere valores para os campos vazios e só grava o que você confirmar. |
A variável
O nome da variável sai do rótulo, sem acento e com sublinhado no lugar do espaço: "Orçamento previsto" vira {{contact.custom.orcamento_previsto}}. Se já existir um campo com o mesmo nome, o novo ganha um número no fim, como {{contact.custom.orcamento_previsto_2}}. Na lista de campos, clique na variável para copiar.
Na mensagem, o valor sai como aparece na ficha: moeda como R$ 5.000,00, data como 30/09/2026, seleção pelo rótulo da opção e referência pelo nome.
Exemplo prático: uma clínica odontológica
A recepção quer saber, antes de responder, o convênio do paciente e quem é o dentista dele.
- Em Configurações → Campos Personalizados, crie Convênio: tipo Seleção, opções "Particular", "Convênio empresarial" e "Convênio individual", aplica-se a Só pessoa física, com "Mostrar no painel da conversa" e "Coluna na lista de contatos" ligados.
- Crie Dentista de referência: tipo Usuário, com "Mostrar no painel da conversa" ligado.
- Crie Última limpeza: tipo Data.
- Quando um paciente escreve, a recepcionista abre a ficha pelo painel da conversa, vai na aba Personalizados e preenche os três campos. Da próxima vez, o convênio e o dentista aparecem na lateral da conversa, sem abrir nada.
- Em Contatos, o filtro da coluna Convênio separa os pacientes particulares.
- Num modelo de mensagem, a equipe escreve: "Oi, {{contact.first_name}}! Aqui é da clínica. Quem vai te atender é {{contact.custom.dentista_de_referencia}}." Na hora de enviar, as variáveis viram o primeiro nome do paciente e o nome do dentista.
Desativar e excluir um campo
| Ação | Onde | O que acontece |
|---|---|---|
| Desativar | Ícone de lixeira na lista de campos ativos | O campo some da ficha, do painel e da lista de contatos, mas os valores continuam guardados. Ele vai para "Desativados" e deixa de contar no limite de 50. |
| Reativar | Em "Desativados" | Tudo volta como estava. |
| Excluir definitivamente | Ícone de lixeira em "Desativados" | Apaga o campo e o valor dele em todos os contatos. Antes, a tela mostra quantos contatos têm valor. Não pode ser desfeito. |
Pegadinhas comuns
- Obrigatório só vale na ficha. Contato criado pelo cadastro Rápido, pela primeira mensagem, pela API ou por automação pode ficar sem o campo.
- Obrigatório criado depois vale para os contatos antigos. A partir dele, qualquer contato editado pela ficha só salva com o campo preenchido.
- Mudar o rótulo não muda a variável. "Orçamento" renomeado para "Orçamento previsto" continua sendo {{contact.custom.orcamento}}. Copie a variável da lista antes de usar.
- Campo vazio sai vazio na mensagem. Se o contato não tem o valor, a frase fica com um buraco. Use a variável onde o campo costuma estar preenchido, ou filtre o público por ele.
- A condição de automação compara o que aparece na ficha. Seleção compara pelo rótulo da opção, Sim / Não por "Sim" ou "Não", e referência pelo nome. Moeda e percentual comparam como número: escreva 5000, e não R$ 5.000,00.
- Não existe gatilho "campo personalizado mudou". O gatilho "Contato atualizado" acompanha nome, e-mail, telefone, status, origem, empresa e carteira. Para reagir a um campo personalizado, use-o como condição em outro gatilho.
- "Atualizar contato" grava o valor como você escreveu, sem conferir o tipo. Depois do primeiro teste, confira o resultado na ficha.
- Ficam de fora da API, dos filtros da Caixa de Entrada e do Smart Merge. Ao mesclar contatos, ficam os valores do contato principal.
- Não dá para esconder um campo por cargo. Quem vê o contato vê todos os campos. Não guarde ali o que parte da equipe não pode ler.
Boas práticas
- Prefira Seleção a Texto quando as respostas se repetem: filtro e condição funcionam melhor com opções fixas.
- Use Referência para "Indicado por" ou "Consultor responsável": o nome não é escrito de dez jeitos diferentes.
- Ligue "Coluna na lista de contatos" só no que você filtra. O resto fica na ficha e no painel.
- Desative antes de excluir. Desativar guarda os valores; excluir definitivamente apaga de todos os contatos.
- Dono do cliente é carteira, não campo. Para dizer de quem é o cliente, use a carteira, que tem histórico e pode distribuir as conversas.