Contatos ocultos

Nem toda conversa é um lead. Mensagens da equipe, da família ou de um fornecedor chegam pelo mesmo WhatsApp e acabam virando cadastro. Ocultar contato tira essas pessoas de tudo o que você vê e mede, sem apagar nada.

O que acontece com um contato oculto

• Some das telas: das tabelas e contagens de Leads (Todos, origens, pastas, listas e Sem lista), do quadro do funil, da busca, da barra lateral, dos relatórios, do Dashboard, da exportação, do seletor de Mesclar leads e das sugestões de valores nas automações.
• Não entra em campanha de e-mail: fica fora do público calculado, e o envio confere de novo na hora de mandar.
• Não reaparece: quando chega uma mensagem nova de WhatsApp ou Instagram, um formulário, uma venda, um webhook ou uma importação com o mesmo telefone ou e-mail, os dados novos são guardados, mas o contato não entra em lista, não muda de etapa, não dispara automações, webhooks de saída nem conversões de rastreamento. Os fluxos de Instagram também não respondem a ele.
• Não conta no limite de leads do plano. Mostrar o contato volta a contar.
• Os registros continuam: vendas, envios de formulário, execuções de automação e a atividade dos leads seguem mostrando o contato, porque são histórico.
• Os negócios ficam parados: enquanto oculto, a etapa dele não muda, e o bloco Funil some da ficha. Ao mostrar, os negócios voltam como estavam.

Ocultar e mostrar não avisam nenhum sistema conectado: só gravam a marca e uma linha no histórico do lead, com quem fez.

Passo a passo

Ocultar um contato pela ficha

1. Abra a página do lead.
2. No menu ⋯ do topo, clique em Ocultar contato.
3. Se quiser, escreva um Motivo (até 60 caracteres, por exemplo “Equipe” ou “Pessoal”). Ele serve só de lembrete.
4. Clique em Ocultar.

A ficha continua abrindo pelo link, com o selo Contato oculto e um aviso com a data, o motivo e o botão Mostrar.

Ocultar vários de uma vez

Na tabela de leads, selecione os contatos, abra Ações em massa e escolha Ocultar. O motivo é opcional e vale para todos.

Ver e mostrar os contatos ocultos

Os contatos ocultos ficam em Leads › Contatos ocultos, uma aba ao lado de Tags e Campos e um link no rodapé da barra lateral. A aba aparece mesmo com o funil de atendimento desligado.

1. Em Leads, abra a aba Contatos ocultos.
2. Use a busca para achar pelo nome, telefone, e-mail ou motivo.
3. Clique em Mostrar na linha, ou marque vários e clique em Mostrar selecionados.

O contato volta para as listas, o funil e as contagens, com os dados que acumulou enquanto estava oculto. Também dá para mostrar pela ficha: no aviso Contato oculto ou no menu ⋯ › Mostrar contato.

Na API

• O lead da API traz hidden e hiddenAt.
• GET /leads não traz contatos ocultos, a não ser com includeHidden=true. GET /leads/{id} traz o contato oculto com hidden: true.
• O POST /leads que casa com um contato oculto responde normalmente, com hidden: true, e não aplica listas nem etapa.
• Mudar a etapa do negócio de um contato oculto (PATCH /leads/{id}/lists/{listId}) responde 409 lead_hidden.
• Ocultar e mostrar não existem na API: só nas telas.

Problemas comuns

Tentei criar um lead e o CRM diz que o contato está oculto

Já existe um contato oculto com esse telefone ou e-mail. Abra Contatos ocultos, ache a pessoa e clique em Mostrar.

Ao salvar um lead aparece “Esse e-mail pertence a um contato oculto”

Cada conta tem um lead por e-mail, e o contato oculto entra nessa conta. Abra Contatos ocultos, ache a pessoa e clique em Mostrar; depois mescle os dois leads (se for a mesma pessoa) ou use outro e-mail. Pela API, o mesmo caso responde 409 conflict.

Cliquei em Mostrar e apareceu o aviso do limite do plano

Mostrar volta a contar o contato no limite de leads do plano, como uma criação. Libere espaço ou veja os planos em Cobrança.

Onde foi parar a etapa “Ignorar”?

Ela saiu com o funil por lista. Quem estava em Ignorar virou contato oculto, com o motivo “Ignorar”, e os negócios dele voltaram para a primeira etapa.

Próximo passo

Todos os leads A tabela de leads, com as ações em massa.