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 #

Os 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 como uma sugestão toda vez que você edita outro contato.

Tipo de campo: Campos personalizados são apenas de texto livre — não existem tipos de menu suspenso, botão de opção ou múltipla escolha. Se você quiser que um campo contenha apenas um de alguns valores definidos (como uma origem de lead de “Newsletter”, “Indicação” ou “Anúncio”), digite o mesmo valor de forma consistente ou preencha em massa via exportação/reimportação de planilha para que cada contato use exatamente a redação que você deseja.

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 pode estar em qualquer idioma.
• Uma conta pode ter até 50 campos personalizados.
• Escolha o nome com cuidado — uma vez que um campo é usado em um modelo ou campanha, 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.
4. Digite um nome em Adicionar um campo (nomes de campos existentes aparecem como sugestões — clique em um para reutilizá-lo), clique em Adicionar e, em seguida, digite o valor.
5. Clique em Salvar no formulário para armazená-lo.

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.

Excluir um campo do formulário de edição remove esse valor do contato. Remover um campo de todos os contatos e do esquema da sua conta inteiramente ainda não é possível enquanto ele for referenciado por um modelo ou campanha.

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 gravar em campos que já existem na sua conta. Adicione-os da maneira normal (veja Preenchendo campos personalizados em um contato acima) — 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 desativado será ignorado silenciosamente. (Se o cartão disser que você ainda não tem campos personalizados, volte e crie-os primeiro.)
5. Clique em Salvar e, em seguida, 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 no ar, não apenas esta, então dê uma olhada nas outras abas primeiro se você estiver editando.

Bom saber:

• Funciona durante toda a conversa, não apenas ao agendar. Apesar da redação do cartão — os agendamentos foram onde o recurso começou — a IA salva um valor no momento em que o contato o menciona, independentemente de haver um agendamento 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 agendamento” — 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 anotou, mas nada é registrado no 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 ela 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 anteriores 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 formato livre também pertencem a um campo. A IA conversacional não pode gravar na caixa Perfil do lead / Notas de um contato (veja abaixo) — essa caixa é para você e sua equipe, embora Automações e a API possam gravá-la. Se você quiser que a própria IA registre algo como “pediu um prato celíaco”, transforme isso 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 mapeamento de colunas do assistente de importação reconhece apenas nome, sobrenome, telefone, e-mail, tags e notas — não há uma etapa de “mapear esta coluna da planilha para um campo personalizado” (tags, por outro lado, são importadas como tags reais). Para carregar valores de campos personalizados em massa hoje, use a API — o caminho que você deve seguir depende se os contatos já existem.

Adicionando novos contatos? O endpoint de importação de contatos em massa da API aceita valores de campos personalizados diretamente na mesma chamada, então você não precisa de uma segunda etapa. Inclua um objeto custom_fields em cada registro junto com o nome, telefone e e-mail, e os contatos chegarão com seus campos personalizados já preenchidos. O formato da solicitação está documentado na seção de Contatos da referência da API.

Preenchendo contatos que você já possui?

1. Liste seus contatos através da API para obter o ID de cada contato. A exportação CSV não inclui uma coluna de ID de contato ou quaisquer colunas de campos personalizados. Veja Acesso à API para saber como obter uma chave e chamar o endpoint.
2. Preencha os valores em sua planilha.
3. Use o endpoint de atualização de contato da API (veja Acesso à API) para gravá-los de volta por contato, já que o próprio assistente de importação ainda não possui um mapeamento de colunas para campos personalizados. Cada atualização afeta apenas as chaves que você enviar — quaisquer campos personalizados que você omitir manterão seus valores atuais.

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.

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 com sublinhado — o placeholder deve corresponder exatamente ao nome do campo ({{company}}, não {{Company}}).
• Campos integrados também funcionam — {{first_name}}, {{last_name}}, {{email}} e {{phone_number}} funcionam sem a necessidade de configurá-los como campos personalizados.
• Combine com Notas — para linhas personalizadas por 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.