Campos Personalizados, Perfil do Lead e Notas #

Todo contato tem o básico — nome, telefone, e-mail, canal. Mas você geralmente sabe muito mais sobre as pessoas com quem fala: a empresa delas, a data de nascimento, o que compraram da última vez, de qual conferência vieram. Esta página aborda as informações extras que você pode anexar a um contato e onde cada uma delas fica.

Visão geral #

Se você usa o aplicativo há algum tempo: o que costumava ser duas coisas separadas — um “Perfil do Lead” de formato longo e uma lista acumulada de Notas datadas — agora estão mescladas em um único campo, rotulado como Notas no registro completo do contato. Não existe mais um log de notas separado com carimbo de data/hora e títulos; tudo o que você escrever sobre um contato vai nesta única caixa. Veja Notas abaixo para saber o que isso significa na prática.

Definindo Campos Personalizados #

Campos personalizados são reutilizáveis em todos os seus contatos. Assim que você cria um campo como company, ele se torna parte do esquema da sua conta e aparece no formulário de edição de cada contato.

Tipos de campo #

Todo campo personalizado tem um tipo, e o tipo decide o que um campo pode conter e como ele é inserido — por você no aplicativo, por uma importação ou pela API, e pela IA quando ela salva algo que aprendeu em um chat:

Um campo tipado é validado onde quer que seja escrito: o formulário de contato não salvará February 1st em um campo de Data, a API responde com um erro que nomeia o campo e o que ele espera, uma importação de arquivo pula essa linha e a lista na tela de resultados, e a IA é informada do formato antecipadamente e recebe uma correção caso ainda envie algo diferente. Valores que chegam em um formato humano reconhecível são convertidos para você — 01/02/1990 torna-se 1990-02-01 seguindo o formato de data da sua conta (dia primeiro ou mês primeiro, em Configurações → Conta), yes torna-se uma caixa de seleção marcada, newsletter é armazenado como Newsletter se foi assim que você escreveu a opção. Como toda data é armazenada da mesma forma, “aniversário antes de 1990-01-01” em uma lista inteligente ou condição de automação compara datas reais em vez de três grafias do mesmo dia.

Criando e gerenciando campos #

1. Na barra lateral esquerda, clique em Contatos.
2. Abra qualquer contato e clique em Editar (ou clique em Novo contato).
3. Na seção Campos Personalizados, digite um nome em Adicionar um campo, escolha seu tipo (Menu suspenso solicitará as opções) e clique em Adicionar. O campo é criado para toda a conta e aparece imediatamente neste contato.
4. Para alterar o tipo ou as opções de um campo mais tarde, não renomeie nada — clique em Gerenciar campos na mesma seção. O gerenciador lista cada campo com seu tipo; escolha um novo tipo, edite as opções de um menu suspenso ou remova um campo da lista.

Alterar um tipo mantém os valores existentes como estão. Se birthday continha 1 Feb 1990 como texto livre antes de você alterá-lo para Data, esse valor permanece até a próxima vez que for editado (por você, pela API ou pela IA), momento em que precisará ser uma data real. Nada é reescrito sem o seu conhecimento. Para converter os valores antigos de uma só vez, use Normalizar valores existentes abaixo.

Normalizando valores existentes #

Depois que você define um tipo para um campo, os valores antigos mantêm a grafia com a qual foram salvos. Um campo de Data ainda pode conter 01/02/1990 em um contato e 1 February 1990 em outro, e uma lista inteligente ou regra de data de automação só corresponde a datas armazenadas como YYYY-MM-DD. Normalizar valores existentes converte todos eles de uma vez.

1. Abra Gerenciar campos (veja acima). Cada campo de Data, Número, Menu suspenso e Caixa de seleção tem um link Normalizar valores existentes abaixo dele. Campos de texto não têm, porque o texto é armazenado exatamente como foi escrito.
2. Clique nele. Nada muda ainda: o aplicativo verifica seus contatos e informa quantos valores serão alterados, mostra um exemplo (por exemplo, "01/02/1990" becomes "1990-02-01") e lista os valores que não consegue ler.
3. Clique em Alterar N valores para convertê-los, ou em Cancelar para deixar tudo como está.

Bom saber:

• Apenas valores que podem ser lidos como o tipo do campo são alterados. Datas escritas com barras seguem o formato de data da sua conta (dia primeiro ou mês primeiro, em Configurações → Conta). Um valor que não pode ser lido, como next spring em um campo de Data, é deixado intocado e mostrado na lista para que você possa corrigi-lo manualmente naquele contato.
• Valores que já estão no formato correto e valores vazios não são tocados. Executar isso duas vezes é inofensivo.
• Se você acabou de alterar o tipo de um campo, clique em Salvar campos primeiro. O link só aparece depois que o novo tipo é salvo.
• Funciona em todos os contatos da conta em que você está. Em uma configuração de agência, execute dentro da subconta que possui os contatos.
• A mesma ação está disponível na API como POST /users/me/custom-fields/{key}/normalize, com dry_run para visualizar.

Remover um campo da lista oculta-o do formulário de edição e do seletor de campos da IA; os valores já armazenados nos contatos são mantidos, e adicionar o mesmo nome novamente os exibe novamente. Para apagar os valores de um campo de todos os contatos permanentemente, use a chamada Excluir um campo personalizado da API.

Regras de nomenclatura:

• Nomes de campos devem usar apenas letras minúsculas, números e sublinhados, e devem começar com uma letra ou sublinhado (por exemplo, lead_source, não Lead Source).
• Apenas letras inglesas sem acento — espaços, maiúsculas e caracteres acentuados ou não latinos são rejeitados. Mesmo que o restante da sua conta esteja em outro idioma, nomeie o campo como cumpleanos ou birthday, não cumpleaños. Apenas o nome é restrito; o valor que você armazena nele (e as opções de um menu suspenso) pode estar em qualquer idioma.
• Uma conta pode ter até 50 campos personalizados; um menu suspenso pode ter até 100 opções.
• Escolha o nome com cuidado — uma vez que um campo é usado em um modelo ou agente de IA, você não pode excluí-lo sem antes remover essas referências.

Preenchendo Campos Personalizados em um Contato #

1. Na barra lateral esquerda, clique em Contatos.
2. Clique na linha de um contato para abrir o painel de visualização rápida, depois clique em Editar — ou clique em Novo contato para começar um do zero.
3. No formulário de contato, encontre a seção Campos Personalizados. Cada campo na sua conta é listado com o controle que corresponde ao seu tipo: uma caixa de texto ou número, um seletor de data, um menu suspenso com suas opções ou um menu suspenso Sim/Não para um campo de caixa de seleção.
4. Preencha os valores e clique em Salvar no formulário para armazená-los. Um valor que não se encaixa no tipo do campo é sinalizado na hora e o formulário não é salvo até que seja corrigido.

Campos que já possuem um valor aparecem no painel de visualização rápida e no registro completo do contato como linhas somente leitura — para alterar um valor, reabra o Editar.

Limpando um valor: uma vez que um campo contém algo, um pequeno × aparece dentro da sua caixa no formulário de edição. Clique nele para limpar esse valor apenas para este contato; o campo em si permanece na sua conta e em todos os outros contatos. Remover um campo de todos os contatos e do esquema da sua conta inteiramente ainda não é possível enquanto ele estiver referenciado por um modelo ou agente de IA.

Deixando a IA preencher campos personalizados para você #

Seu Agente de IA pode salvar informações diretamente em campos personalizados conforme elas surgem na conversa — um aniversário, o nome de um parceiro, uma restrição alimentar, uma preferência de mesa — para que você possa usá-las mais tarde em uma transmissão ou acompanhamento. Isso está desativado por padrão e ele só grava nos campos que você escolheu explicitamente.

Duas coisas precisam estar configuradas, e ambas são necessárias — este é o motivo mais comum pelo qual as pessoas descobrem que nada foi salvo:

1. Crie os campos primeiro. A IA só pode escrever em campos que já existam na sua conta. Adicione-os a partir do formulário de edição de um contato (veja Preenchendo Campos Personalizados em um Contato acima), ou diretamente do Agente na etapa 4 abaixo, que é a maneira mais rápida em uma nova conta que ainda não possui contatos — por exemplo customer_birthday, partner_name, dietary_notes. Lembre-se das regras de nomenclatura: apenas letras minúsculas, números e sublinhados.

2. Dê permissão ao Agente e escolha os campos.

1. Clique em Agentes de IA na barra lateral e abra o Agente.
2. Vá para a aba Habilidades de IA.
3. Em Atualizações de contato, ative Permitir que a IA colete informações extras.
4. Um cartão intitulado Coletar informações extras durante o agendamento aparecerá, listando seus campos personalizados. Ative a chave ao lado de cada campo que a IA tem permissão para preencher — criar um campo não é suficiente por si só, e qualquer campo deixado de fora será ignorado silenciosamente. Precisa de um campo que não está na lista, ou começando sem nenhum? Clique em Gerenciar campos personalizados no mesmo cartão, adicione o campo com seu tipo e salve: ele aparecerá na lista imediatamente, desativado, e estará disponível em todos os contatos a partir de então.
5. Clique em Salvar, depois em Publicar o Agente. As alterações ficam no rascunho até que você publique, portanto, uma alteração não publicada não afetará as conversas ao vivo. Publicar coloca todas as alterações pendentes do rascunho no ar, não apenas esta, então dê uma olhada nas outras abas primeiro, caso você as tenha editado.

Bom saber:

• A IA é informada sobre o tipo de cada campo. Para um campo de Data, ela converte o que o contato diz (“el 1 de febrero del 90”) em 1990-02-01 antes de salvar; para um Menu suspenso, ela só pode escolher uma das suas opções; para uma Caixa de seleção, ela salva sim ou não. Se ela ainda enviar algo que não se encaixa, o salvamento é recusado com o formato esperado e a IA pergunta novamente ou se corrige — um valor não analisável nunca chega ao contato.
• Funciona durante toda a conversa, não apenas ao agendar. Apesar da redação do cartão — agendamentos são onde o recurso começou — a IA salva um valor no momento em que o contato o menciona, independentemente de um compromisso estar envolvido ou não. Você não precisa ter agendamentos ativados.
• Cada campo pode ser marcado como obrigatório. Obrigatório significa apenas “deve ser coletado antes que a IA confirme um compromisso” — nunca bloqueia uma conversa normal e não faz nada em um Agente que não aceita agendamentos.
• A IA dizer que “anotou” algo não é o mesmo que salvá-lo. Se o campo não for criado e ativado, a IA ainda pode responder educadamente que tomou nota, mas nada chega ao contato. Verifique o registro do contato para confirmar se um valor foi realmente salvo.
• Diga ao Agente quando perguntar. Nas instruções do Agente, descreva quando cada campo se aplica (“se o convidado mencionar uma alergia ou dieta, salve em dietary_notes”). A IA lê isso em linguagem simples, então não interrogará todos com a mesma lista.
• Nada é preenchido retroativamente. Apenas conversas a partir do momento em que você publica são capturadas — detalhes já mencionados em chats passados não são preenchidos retroativamente.
• Configure isso na conta que possui os contatos. Campos personalizados pertencem a uma única conta, portanto, em uma configuração de agência, crie-os dentro da subconta cujo Agente está conversando, não na conta da agência principal.
• Notas de forma livre também pertencem a um campo. A IA conversacional não pode escrever na caixa Perfil do Lead / Notas de um contato (veja abaixo) — essa é para você e sua equipe, embora Automações e a API possam escrevê-la. Se você quiser que a própria IA registre algo como “pediu um prato celíaco”, transforme-o em um campo personalizado como dietary_notes.

O que a IA pode ler durante uma conversa #

Se você está decidindo onde uma informação deve ficar para que a IA possa agir sobre ela durante o chat, esta é a diferença que importa:

• Campos personalizados: a IA os lê a cada resposta. Todos os valores dos campos personalizados de um contato estão disponíveis para a IA durante toda a conversa — independentemente de como o campo foi preenchido (por você, pela IA anteriormente, por meio de uma importação ou pela API). Portanto, uma regra nas instruções do seu Agente como “cumprimente clientes recorrentes pelo preferred_barber” funciona, porque a IA consegue ver o valor naquele momento.
• Tags: a IA não as vê durante o chat. A marcação de tags ocorre como uma etapa separada após o envio da resposta da IA — a IA aplica tags com base nas suas descrições, mas não é mostrado quais tags um contato já possui durante a conversa. Instruções como “se o contato tiver a tag VIP, ofereça o desconto” não funcionarão.

A regra prática: tudo o que a IA deve ler e sobre o que deve agir no meio da conversa deve ser colocado em um campo personalizado. Tags servem para tudo o que acontece em torno da conversa — filtrar e segmentar contatos, direcionar transmissões e disparar webhooks de tag para seus outros sistemas no momento em que a IA aplica uma delas.

Carregamento em Massa de Campos Personalizados #

O assistente de importação mapeia colunas de planilhas diretamente para campos personalizados. Uma coluna cujo cabeçalho é o nome de um campo (maiúsculas e acentos não importam) é correspondida automaticamente, qualquer outra coluna pode ser apontada para um campo manualmente, e Novo campo personalizado cria um campo a partir de uma coluna durante a importação.

Adicionando novos contatos? Coloque uma coluna por campo personalizado no seu arquivo e importe-o. Novos contatos chegam com esses campos já preenchidos.

Preenchendo contatos que você já possui?

1. Exporte seus contatos: a exportação de contatos em CSV possui uma coluna por campo personalizado.
2. Preencha os valores na sua planilha. Mantenha a coluna de número de telefone como está, pois é assim que os contatos são correspondidos.
3. Importe o arquivo com Atualizar contatos existentes ativado na etapa de Revisão. Cada linha atualiza apenas os campos personalizados que possuem um valor no arquivo; células vazias mantêm o valor atual.

O endpoint de importação de contatos em massa da API aceita os mesmos valores que um objeto custom_fields em cada registro, caso prefira fazer isso a partir de suas próprias ferramentas (veja Acesso à API).

Notas (= Perfil do Lead) #

No registro completo de um contato (clique em Abrir registro completo no painel de visualização rápida), o painel Notas é uma caixa de texto livre — o mesmo campo subjacente também referido como “Perfil do Lead” em outros lugares. No formulário de Edição do contato, a mesma caixa é rotulada como Perfil do lead, descrita como “Notas internas sobre este contato”, então não procure por um segundo campo. Escreva qualquer coisa relevante para a conversa: tipo de negócio, pontos problemáticos, tamanho da empresa, atividade recente, qualquer coisa que ajude a personalizar o contato.

Como a IA usa isso: em um modelo de mensagem — uma mensagem de transmissão, um acompanhamento, as instruções de um Agente de IA — você pode incluir um placeholder como {{personal_context|write a one-line opener that references their business}}. Quando esse modelo é enviado para um contato específico, a IA lê as Notas dele e escreve uma linha personalizada usando o que está lá. Se um contato não tiver Notas, o placeholder é simplesmente removido da mensagem.

A IA não escreve isso para você — você ou sua equipe preenchem. Pense nisso como a “cola” que você gostaria que um representante de vendas lesse antes de atender o telefone. Se você quiser que a própria IA registre algo que aprende em uma conversa, use um campo personalizado — veja Deixando a IA preencher campos personalizados para você.

Editar é simples: digite na caixa e clique em Salvar nota (ou Descartar para ignorar alterações não salvas). Não há título ou data separados por entrada — é um bloco de texto contínuo por contato, portanto, se você quiser um registro datado, adicione a data manualmente no início de cada inserção.

Ao lado de Notas, o painel lateral de contato em Chats possui uma seção de Pesquisa. Ela exibe o resumo que um Agente escreve automaticamente quando Pesquisar novos contatos antes da primeira resposta está ativado, e um botão Pesquisar agora para executá-lo ou atualizá-lo manualmente.

Status #

Cada contato possui um selo de Status que mostra em que estágio eles estão na sua jornada:

Clique no selo de Status diretamente na tabela de contatos para alterá-lo inline — para qualquer status, exceto Spam, que você define através da ação em massa Marcar como spam (e sua confirmação), já que possui efeitos colaterais adicionais. Desmarcar como spam está disponível da mesma forma, como Desmarcar como spam.

Atribuindo um contato a um membro da equipe #

A atribuição de propriedade — designar um contato a um membro da equipe para que outros não respondam por acidente — é definida na tela de Chats em vez da página de Contatos: abra a conversa e use o controle de responsável disponível nela. Veja Interface de Chat para o passo a passo completo. Apenas proprietários da conta e usuários com a permissão correta podem alterar uma atribuição.

Usando Campos Personalizados em Transmissões e Modelos #

Campos personalizados são úteis dentro de mensagens enviadas. Onde quer que você possa escrever uma mensagem — mensagens de transmissão, modelos de WhatsApp, instruções do Agente de IA — você pode inserir um placeholder como:

Hey {{first_name}}, hope things are going well at {{company}}!

Quando a mensagem é enviada, {{first_name}} e {{company}} são substituídos pelos valores de cada contato. Se um contato não tiver esse campo preenchido, o marcador de posição permanecerá em branco.

Algumas dicas:

• Use nomes em minúsculas e estilo sublinhado — o marcador deve corresponder exatamente ao nome do campo ({{company}}, não {{Company}}).
• Campos tipados são renderizados da maneira que você os escreveria — um campo de Data aparece no formato de data da sua conta (01/02/1990 ou 02/01/1990, conforme Configurações → Conta), uma Caixa de seleção como Yes ou No, um Menu suspenso como a redação exata da opção.
• Campos integrados também funcionam — {{first_name}}, {{last_name}}, {{email}} e {{phone_number}} funcionam sem configurá-los como campos personalizados.
• Combine com Notas — para linhas personalizadas pela IA, use {{personal_context|your instruction}} em vez de um campo personalizado fixo; a IA escreve algo novo com base nas Notas do contato.
• Você não pode excluir um campo que está em uso — se um modelo usa {{company}}, o sistema bloqueia a exclusão de company até que você o remova desses modelos.

Precisa de ajuda? #

Uma boa regra prática sobre o que colocar onde:

• Um fato curto e estruturado que você usará para filtrar ou mesclar → campo personalizado.
• Um parágrafo de contexto para a IA ou sua equipe ler → Notas.
• Quem é o responsável pela conversa → o responsável, definido em Chats.

Ainda com dificuldades? Entre em contato com o suporte e nós o ajudaremos a configurar.

Próximos passos #

• Adicionando um Novo Contato — adicione contatos um por um, além de um tour completo pela tela de Contatos.
• Importando Contatos de um Arquivo — importe uma planilha.
• Interface de Chat — onde fica a atribuição de contatos.