# Campos Personalizados, Perfil de Lead e Notas Cada contacto tem os elementos básicos — nome, telefone, e-mail, canal. Mas, normalmente, sabe muito mais sobre as pessoas com quem fala: a empresa, a data de nascimento, o que compraram da última vez, de que conferência vieram. Esta página abrange as informações adicionais que pode anexar a um contacto e onde cada uma delas reside. --- ## Visão geral | O que é | Ideal para | Onde se encontra | |---|---|---| | **Campos Personalizados** | Factos estruturados curtos (empresa, cargo, data de nascimento, plano, etc.) | Uma lista de pares chave/valor no contacto | | **Notas (= Perfil do Lead)** | Uma descrição livre sobre quem é esta pessoa e porque é importante — lida pela IA ao personalizar respostas | Uma única área de texto no contacto | | **Estado** | Acompanhar em que fase da jornada se encontra um contacto, incluindo marcá-lo como spam | Um único valor no contacto | > **Se já utiliza a aplicação há algum tempo:** o que costumava ser duas coisas separadas — um "Perfil de Lead" detalhado e uma lista acumulada de Notas datadas — está agora fundido num **único campo**, designado **Notas** no registo completo do contacto. Já não existe um registo de notas separado com carimbos de data/hora e títulos; tudo o que escrever sobre um contacto vai para esta caixa. Consulte [Notas](#notes-lead-profile) abaixo para saber o que isto significa na prática. --- ## Definir Campos Personalizados Os campos personalizados são reutilizáveis em todos os seus contactos. Assim que cria um campo como `company`, este torna-se parte do esquema da sua conta e aparece como uma sugestão sempre que edita outro contacto. **Tipo de campo:** Os campos personalizados são apenas de texto livre — não existem tipos de menu pendente, botões de opção ou escolha múltipla. Se pretender que um campo contenha apenas um de alguns valores definidos (como uma origem de lead "Newsletter", "Referência" ou "Anúncio"), escreva o mesmo valor de forma consistente ou preencha-o em massa através da exportação/importação de uma folha de cálculo para que todos os contactos utilizem a redação exata que pretende. **Regras de nomenclatura:** - Os nomes dos campos devem utilizar apenas letras minúsculas, números e underscores, e devem começar por uma letra ou underscore (por exemplo, `lead_source`, não `Lead Source`). - **Apenas letras inglesas sem acentos** — espaços, maiúsculas e caracteres acentuados ou não latinos são rejeitados. Mesmo que o resto da sua conta esteja noutro idioma, nomeie o campo como `cumpleanos` ou `birthday`, não `cumpleaños`. Apenas o nome está restrito; o valor que guarda nele pode estar em qualquer idioma. - Uma conta pode ter até **50 campos personalizados**. - Escolha o nome cuidadosamente — uma vez que um campo seja utilizado num modelo ou campanha, não o pode eliminar sem primeiro remover essas referências. --- ## Preencher Campos Personalizados num Contacto 1. Na barra lateral esquerda, clique em **Contactos**. 2. Clique na linha de um contacto para abrir o [painel de visualização rápida](creating-contacts.md), depois clique em **Editar** — ou clique em **Novo contacto** para começar um do zero. 3. No formulário de contacto, encontre a secção **Campos personalizados**. 4. Escreva um nome em **Adicionar um campo** (os nomes de campos existentes aparecem como sugestões — clique num para reutilizá-lo), clique em **Adicionar** e, em seguida, escreva o valor. 5. Clique em **Guardar** no formulário para o gravar. Os campos que já têm um valor aparecem no painel de visualização rápida e no registo completo do contacto como linhas apenas de leitura — para alterar um valor, reabra a opção **Editar**. **Eliminar um campo** do formulário de edição remove esse valor do contacto. Remover um campo de todos os contactos e do esquema da sua conta ainda não é possível enquanto este for referenciado por um modelo ou campanha. --- ## Deixar a IA preencher campos personalizados por si O seu Agente de IA pode guardar informações diretamente em campos personalizados à medida que surgem na conversa — um aniversário, o nome de um parceiro, uma restrição alimentar, uma preferência de mesa — para que as possa utilizar mais tarde numa difusão ou num acompanhamento. Esta funcionalidade está desativada por predefinição e a IA apenas escreve nos campos que escolheu explicitamente. Duas coisas têm de estar configuradas, e **ambas** são necessárias — esta é a razão mais comum pela qual as pessoas descobrem que nada foi guardado: **1. Crie os campos primeiro.** A IA só pode escrever em campos que já existam na sua conta. Adicione-os da forma normal (veja [Preencher campos personalizados num contacto](#filling-in-custom-fields-on-a-contact) acima) — por exemplo, `customer_birthday`, `partner_name`, `dietary_notes`. Lembre-se das regras de nomenclatura: apenas letras minúsculas, números e underscores. **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á ao separador **Capacidades da IA**. 3. Em **Atualizações de contacto**, ative **Permitir que a IA recolha informações adicionais**. 4. Aparecerá um cartão intitulado **Recolher informações adicionais durante a marcação**, listando os seus campos personalizados. Ative o interruptor 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 é ignorado silenciosamente. (Se o cartão disser que ainda não tem campos personalizados, volte atrás e crie-os primeiro.) 5. Clique em **Guardar** e, em seguida, em **Publicar** o Agente. As alterações permanecem no rascunho até publicar, pelo que uma alteração não publicada não afetará as conversas em direto. Publicar envia **todas** as alterações pendentes para o estado ativo, não apenas esta, por isso dê uma vista de olhos nos outros separadores primeiro, caso tenha estado a editar. **Bom saber:** - **Funciona durante toda a conversa, não apenas durante a marcação.** Apesar da redação do cartão — as marcações foram onde a funcionalidade começou — a IA guarda um valor no momento em que o contacto o menciona, independentemente de estar envolvida uma marcação ou não. Não precisa de ter as marcações ativadas. - **Cada campo pode ser marcado como obrigatório.** Obrigatório significa apenas "deve ser recolhido antes de a IA confirmar uma marcação" — nunca bloqueia uma conversa normal e não faz nada num Agente que não aceite marcações. - **A IA dizer que "tomou nota" de algo não é o mesmo que guardá-lo.** Se o campo não estiver criado e ativado, a IA pode responder educadamente que tomou nota, mas nada é registado no contacto. Verifique o registo do contacto para confirmar se um valor foi realmente guardado. - **Diga ao Agente quando perguntar.** Nas instruções do Agente, descreva quando cada campo se aplica ("se o convidado mencionar uma alergia ou dieta, guarde-a em `dietary_notes`"). A IA lê isso em linguagem simples, por isso não interrogará todos com a mesma lista. - **Nada é preenchido retroativamente.** Apenas as conversas a partir do momento em que publica são capturadas — detalhes já mencionados em conversas passadas não são preenchidos retroativamente. - **Configure isto na conta que detém os contactos.** Os campos personalizados pertencem a uma única conta, por isso, numa configuração de agência, crie-os dentro da subconta cujo Agente está a realizar a conversa, não na conta da agência principal. - **Notas de formato livre também pertencem a um campo.** A IA conversacional não pode escrever na caixa **Perfil do lead / Notas** de um contacto (veja abaixo) — essa caixa é para si e para a sua equipa, embora [Automações](../automations/automations.md) e a API possam escrever nela. Se quiser que a própria IA registe algo como "pediu um prato para celíacos", torne-o um campo personalizado, como `dietary_notes`. --- ## O que a IA consegue ler durante uma conversa Se está a decidir onde deve ficar uma informação para que a IA possa **agir sobre ela durante o chat**, esta é a diferença que importa: - **Campos personalizados: a IA lê-os em cada resposta.** Todos os valores dos campos personalizados de um contacto estão disponíveis para a IA ao longo da conversa — independentemente de como o campo foi preenchido (por si, pela IA anteriormente, através de uma importação ou da API). Assim, uma regra nas instruções do seu Agente como "cumprimente os clientes recorrentes pelo seu `preferred_barber`" funciona, porque a IA consegue ver o valor nesse momento. - **Etiquetas: a IA não as vê durante o chat.** A etiquetagem funciona como um passo separado após o envio da resposta da IA — a IA aplica etiquetas com base nas suas descrições, mas não lhe é mostrado quais as etiquetas que um contacto já possui durante a conversa. Instruções como "se o contacto tiver a etiqueta VIP, ofereça o desconto" **não** funcionarão. A regra prática: tudo o que a IA deva ler e sobre o que deva agir durante a conversa deve ser colocado num **campo personalizado**. As **etiquetas** servem para tudo o que acontece em torno da conversa — filtrar e segmentar contactos, direcionar transmissões e disparar [webhooks de etiquetas](../integrations/webhooks.md) para os seus outros sistemas no momento em que a IA aplica uma. --- ## Carregamento em Massa de Campos Personalizados O assistente de importação apenas reconhece **nome próprio, apelido, telefone, e-mail, etiquetas e notas** no mapeamento de colunas — não existe um passo de "mapear esta coluna da folha de cálculo para um campo personalizado" (as etiquetas, por outro lado, são importadas como etiquetas reais). Para carregar valores de campos personalizados em massa atualmente, utilize a API — o método a seguir depende de os contactos já existirem ou não. **A adicionar novos contactos?** O endpoint de importação de contactos em massa da API aceita valores de campos personalizados na mesma chamada, pelo que não necessita de uma segunda passagem. Inclua um objeto `custom_fields` em cada registo juntamente com o nome, telefone e e-mail, e os contactos serão criados com os seus campos personalizados já preenchidos. O formato do pedido está documentado na secção Contactos da referência da API. **A preencher contactos que já possui?** 1. Liste os seus contactos através da API para obter o ID de cada contacto. A exportação CSV não inclui uma coluna de ID de contacto nem colunas de campos personalizados. Consulte [Acesso à API](../integrations/api-access.md) para saber como obter uma chave e chamar o endpoint. 2. Preencha os valores na sua folha de cálculo. 3. Utilize o endpoint de atualização de contactos da API (consulte [Acesso à API](../integrations/api-access.md)) para os escrever de volta por contacto, uma vez que o assistente de importação ainda não possui um mapeamento de colunas para campos personalizados. Cada atualização apenas altera as chaves que enviar — quaisquer campos personalizados que omita mantêm os seus valores atuais. --- ## Notas (= Perfil do Lead) No **registo completo** de um contacto (clique em **Abrir registo completo** a partir do painel de visualização rápida), o painel **Notas** é uma caixa de texto livre única — o mesmo campo subjacente também referido como "Perfil do Lead" noutros locais. No formulário de **Edição** do contacto, a mesma caixa é rotulada como **Perfil do lead**, descrita como "Notas internas sobre este contacto", por isso não procure um segundo campo. Escreva qualquer coisa relevante para a conversa: tipo de negócio, pontos de dor, dimensão da empresa, atividade recente, qualquer coisa que ajude a personalizar a abordagem. **Como a IA o utiliza:** num modelo de mensagem — uma mensagem de difusão, um seguimento, as instruções de um Agente de IA — pode incluir um marcador de posição como `{{personal_context|write a one-line opener that references their business}}`. Quando esse modelo é enviado para um contacto específico, a IA lê as suas Notas e escreve uma linha personalizada utilizando o que lá está. Se um contacto não tiver Notas, o marcador de posição é simplesmente removido da mensagem. A IA **não** escreve isto por si — você ou a sua equipa preenchem-no. Pense nisto como a cábula que gostaria que um representante de vendas lesse antes de atender o telefone. Se quiser que a própria IA registe algo que aprende numa conversa, utilize um campo personalizado — veja [Deixar a IA preencher campos personalizados por si](#letting-the-ai-fill-custom-fields-for-you). Editar é simples: escreva na caixa e, em seguida, clique em **Guardar nota** (ou **Descartar** para eliminar alterações não guardadas). Não existe um título ou data separado por entrada — é um bloco de texto contínuo por contacto, por isso, se pretender um registo datado, adicione a data manualmente no início de cada entrada. --- ## Estado Cada contacto tem um emblema de **Estado** que mostra em que fase do percurso se encontra: | Estado | O que significa | |---|---| | **Novo** | Acabou de chegar, ainda sem interação. | | **Em interação** | Em conversa ativa. | | **Potencial cliente** | Demonstra interesse de compra. | | **Cliente** | Convertido. | | **Perdido** | Foi cliente, já não está ativo. | | **Spam** | Oculto das suas listas principais; o bot de IA não interage com eles, a opção "Não incomodar" está ativada e são excluídos de campanhas. | Clique no emblema de **Estado** diretamente na tabela de contactos para o alterar na própria linha — para qualquer estado, exceto Spam, que define através da ação em massa **Marcar como spam** (e respetiva confirmação), uma vez que tem efeitos secundários adicionais. Desmarcar como spam está disponível da mesma forma, como **Desmarcar como spam**. --- ## Atribuir um Contacto a um Membro da Equipa A atribuição de propriedade — atribuir um contacto a um colega de equipa para que outros não respondam por engano — é definida a partir do ecrã de **Conversas** e não da página de Contactos: abra a conversa e utilize o controlo de atribuição aí existente. Consulte [Interface de Conversa](../chats/chat-interface.md) para o guia completo. Apenas os proprietários da conta e os utilizadores com a permissão correta podem alterar uma atribuição. --- ## Utilizar Campos Personalizados em Transmissões e Modelos Os campos personalizados são úteis em mensagens de saída. Onde quer que possa escrever uma mensagem — mensagens de transmissão, modelos de WhatsApp, instruções do Agente de IA — pode inserir um marcador de posição 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 contacto. Se um contacto não tiver esse campo preenchido, o marcador de posição fica em branco. Algumas dicas: - **Utilize nomes em minúsculas e com underscores** — o marcador de posição deve corresponder exatamente ao nome do campo (`{{company}}`, não `{{Company}}`). - **Os campos integrados também funcionam** — `{{first_name}}`, `{{last_name}}`, `{{email}}` e `{{phone_number}}` funcionam sem necessidade de os configurar como campos personalizados. - **Combine com Notas** — para linhas personalizadas por IA, utilize `{{personal_context|your instruction}}` em vez de um campo personalizado fixo; a IA escreve algo novo com base nas Notas do contacto. - **Não pode eliminar um campo que esteja a ser utilizado** — se um modelo utilizar `{{company}}`, o sistema bloqueia a eliminação de `company` até que o remova desses modelos. --- ## Precisa de ajuda? Uma boa regra prática sobre o que colocar em cada sítio: - Um **facto curto e estruturado que irá filtrar ou utilizar para fundir** → campo personalizado. - Um **parágrafo de contexto para a IA ou a sua equipa ler** → Notas. - **Quem é o responsável pela conversa** → o responsável, definido em Conversas. Continua com dificuldades? Contacte o apoio ao cliente e ajudá-lo-emos a configurar tudo. --- ## Próximos Passos - [Adicionar um Novo Contacto](creating-contacts.md) — adicione contactos um a um, além de uma visita guiada completa ao ecrã de Contactos. - [Importar Contactos de um Ficheiro](importing-contacts.md) — importe uma folha de cálculo. - [Interface de Conversa](../chats/chat-interface.md) — onde reside a atribuição de contactos.