> ## Documentation Index > Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt > Use this file to discover all available pages before exploring further. # Leads > Como ver, filtrar e gerenciar os contatos que seus agentes capturam. # Leads A seção **Leads** reúne os contatos que seus visitantes deixaram ao conversar com seus agentes, em todos os canais (web, WhatsApp, Instagram, Telegram, Messenger e Email). Aqui você pode classificá-los com status e etiquetas, revisar a conversa, ver os agendamentos e pagamentos e exportá-los. * **Todos os agentes:** menu lateral → **Leads**. * **Um único agente:** **Meus agentes → \[seu agente] → Leads**. Mostra o mesmo, mas apenas com os leads desse agente (sem o filtro de agente). ![TODO: captura de tela de Leads com os indicadores, as abas por status, os filtros e a tabela](https://mintcdn.com/chatnorris/_RNPg7jBCB9AE-Bf/images/PLACEHOLDER-lista-leads.png?fit=max\&auto=format\&n=_RNPg7jBCB9AE-Bf\&q=85\&s=eef0f439da13a399d9bee05927dd160e) ## Como um lead é capturado? Um lead é registrado de duas formas: 1. **Lead Form** — o agente mostra um formulário de contato, seja ao abrir o chat (se você o configurou como obrigatório) ou no momento da conversa que você definir. 2. **Captura passiva** — o visitante menciona seus dados durante a conversa ("meu email é...") e o ChatNorris os reconhece e salva sem mostrar nenhum formulário. Ambas são configuradas na Ação **Lead Form** do agente: `Meus agentes → [seu agente] → Ações → Lead Form`. Veja [Ações do agente → Lead Form](https://docs.chatnorris.ai/pt/guias/acciones.md#lead-form). > [!NOTE] > > Há um lead por conversa. Se a mesma pessoa deixar o mesmo email ou telefone em várias conversas, cada uma gera seu próprio lead, e a tabela indica isso com **N capturas** (veja [Clientes recorrentes](#clientes-recorrentes)). No WhatsApp, Instagram, Messenger, Telegram e Email, o Lead Form é preenchido conversando: o agente pede um dado obrigatório por mensagem. Veja [Lead Form nos canais](https://docs.chatnorris.ai/pt/guias/acciones.md#lead-form-no-whatsapp-instagram-messenger-telegram-e-email). ## Indicadores e botões superiores Acima da tabela você verá: * **leads no total** * **novos em 7 dias** * **com telefone** * **qualificados** — só aparece se você tiver um status chamado "Qualificado". Os indicadores respeitam os filtros de agente e canal. À direita ficam os botões **Status e etiquetas** e **Exportar CSV · N** (N é a quantidade de leads que correspondem aos filtros). ## Abas por status Abaixo dos indicadores há uma aba para cada status do pipeline, além de **Todos** e **Sem status** (leads aos quais você ainda não atribuiu nenhum). Cada aba mostra quantos leads tem, considerando a busca e os filtros aplicados. ## Buscar e filtrar A barra de filtros inclui um campo de busca (**Nome, email ou telefone…**) e filtros em forma de pílula: | Filtro | O que faz | | - | - | | **Novos 7 dias** | Mostra apenas os leads capturados na última semana. | | **Com agendamento próximo** | Leads com um agendamento futuro marcado pelo agente. | | **Com pagamento** | Leads com pelo menos um pagamento confirmado na conversa. | | **Recorrentes** | Leads de pessoas que têm mais de uma conversa (mesmo email ou telefone). | | **Agente** | Leads de um agente. Só aparece na visão de todos os agentes. | | **Canal** | Web, WhatsApp, Instagram, Telegram, Messenger, Email ou API. | | **Etiqueta** | Leads que têm uma etiqueta. | | **Data** | Últimos 7 dias, Últimos 30 dias, Este mês, Mês anterior ou um período personalizado. | Os filtros se combinam entre si. Para remover um, clique no **X** da pílula dele. Você também pode escolher quantos leads ver por página. ## Colunas da tabela A primeira coluna, **Contato**, está sempre visível: mostra o nome e o email do lead. Se esse email ou telefone foi capturado em várias conversas, aparece a marca **N capturas**. Se faltar ao lead o nome, o email ou o telefone, mas a mesma pessoa o deixou em outra conversa, o dado é exibido em itálico, com o canal e a data de onde vem. As demais colunas podem ser exibidas ou ocultadas: | Coluna | Descrição | | - | - | | **Telefone** | Número que o visitante deixou. | | **Status** | Status do pipeline. Clique nele para alterá-lo sem abrir o lead. | | **Etiquetas** | Etiquetas atribuídas. | | **Origem** | Canal e agente pelo qual o lead chegou. | | **Agendamento** | Próximo agendamento, pagamento pendente ou último agendamento. Apenas agendamentos marcados pelo agente com Google Calendar ou Encuadrado. | | **Pagamento** | Total pago e quantidade de pagamentos. Apenas pagamentos confirmados com a Ação Pagamento (SumUp, Mercado Pago, Flow ou Wompi) na conversa do lead. | | **Capturado** | Data de captura. Clique no cabeçalho para ordenar do mais recente para o mais antigo ou vice-versa. | | **Empresa**, **Cargo**, **Site**, **Setor**, **Endereço**, **Cidade**, **Região/Estado**, **CEP**, **País** | Dados adicionais do contato, ocultos por padrão. | | **Colunas personalizadas** | Campos próprios da sua organização (Premium, veja abaixo). | ### Painel Colunas Clique em **Colunas** (à direita da barra de filtros) para abrir o painel lateral. Nele você pode: * Ativar ou desativar cada coluna com o interruptor dela. * **Reordená-las arrastando** pelo ícone da esquerda (ou com as setas do teclado sobre esse ícone). As padrão e as personalizadas são ordenadas cada uma dentro do seu grupo. * Criar e excluir colunas personalizadas. ## Colunas personalizadas (Premium) > [!NOTE] > > As colunas personalizadas estão disponíveis exclusivamente no plano **Premium**. No painel **Colunas**, seção **Nova coluna personalizada**, escreva um nome (por exemplo, "Orçamento" ou "Bairro"), escolha o tipo (**Texto**, **Número**, **Data** ou **Sim/Não**) e clique em **Adicionar**. Você pode ter até 20 por organização. O agente tentará preenchê-las nas novas conversas. Você também pode preenchê-las manualmente no painel do lead. Excluir uma coluna apaga seus valores. ## Painel do lead Clique em uma linha para abrir o painel lateral do lead. Ele inclui: * **Dados** — Nome, Email, Telefone, Empresa, Cargo e suas colunas personalizadas. Clique no lápis de um campo para editá-lo. * **Agendamentos** — os agendamentos do lead (próximo, realizado, cancelado ou com pagamento pendente), com link para a conversa. Aparece se o agente tiver Google Calendar ou Encuadrado conectado, ou se o lead já tiver agendamentos. * **Pagamentos** — valor, item, data, gateway e link para a conversa. Aparece se o lead tiver pagamentos ou se o agente tiver a Ação Pagamento habilitada. * **Status** — escolha um status; clique novamente no ativo para deixá-lo sem status. * **Etiquetas** — adicione ou remova etiquetas. * **Conversa** — o agente e o canal pelo qual foi capturado, a última pergunta do visitante e a última resposta do agente, e o link **Abrir conversa completa →**. * **Histórico** — quando e por qual agente esse email foi capturado. Se foi capturado várias vezes, indica quantas e a data da primeira. Se a pessoa tiver outras conversas, o painel mostra também o resumo **Cliente recorrente**: quantas conversas e compras ela tem, e o total pago. Pelo ícone de lixeira do painel você pode **excluir o lead** (pede confirmação). Excluir leads é exclusivo de Owners e Admins. ## Clientes recorrentes O ChatNorris reconhece como a mesma pessoa os leads que compartilham email ou telefone (de pelo menos 8 dígitos) em qualquer agente ou canal da sua organização. Ele não os mescla: cada conversa continua sendo seu próprio lead, os dados não são copiados de um lead para outro e o agente de IA não os recebe. O que muda é o que você vê: * A marca **N capturas** soma também as capturas por telefone, e o filtro **Recorrentes** mostra apenas essas pessoas. * Os dados que faltam a um lead são completados em itálico com os de outra conversa (com o canal e a data). * O painel do lead e o painel **Detalhes** da conversa mostram o resumo **Cliente recorrente** e as outras conversas dessa pessoa. Confirme com a pessoa antes de usar um dado que vem de outra conversa. ## Ações em massa Marque a caixa de uma ou várias linhas (ou a do cabeçalho para selecionar todos os da página). A barra de filtros é substituída por uma barra com: * **Alterar status** * **Etiquetar** — adiciona etiquetas aos leads selecionados. * **Exportar CSV** — exporta apenas os selecionados (Premium). * **Excluir** — pede confirmação. ## Status e etiquetas Clique em **Status e etiquetas** para abrir o painel de gerenciamento, com duas abas: * **Status** — seu funil de acompanhamento (por exemplo, "Novo" → "Contatado" → "Ganho"). Um lead tem **um único status** por vez. **Arraste** os status para mudar a ordem das abas. * **Etiquetas** — classificações livres para segmentar e filtrar. Um lead pode ter **várias**. Excluir uma etiqueta a remove dos leads, mas não exclui nenhum lead. Cada status e etiqueta mostra quantos leads o usam. Você pode criá-los, renomeá-los, mudar a cor e excluí-los. > [!NOTE] > > Apenas os owners e admins podem gerenciar status e etiquetas. ## Exportar leads para CSV > [!NOTE] > > A exportação está disponível no plano **Premium**. * **Exportar CSV · N** (no canto superior direito) baixa todos os leads que correspondem à busca, à aba e aos filtros aplicados. * **Exportar CSV** na barra de ações em massa baixa apenas os leads selecionados. O arquivo é compatível com Excel, Google Sheets e a maioria dos CRMs. ## Perguntas frequentes > [accordion] Os leads do WhatsApp, Instagram e outros canais também aparecem aqui? > > Sim. Os leads de todos os canais são consolidados na mesma seção. Use o filtro **Canal** para vê-los separadamente. > [accordion] O que significa “N capturas”? > > Que o mesmo email foi capturado em várias conversas. Cada conversa gera seu próprio lead; a tabela marca isso para que você saiba que é a mesma pessoa. No painel do lead, a seção **Histórico** mostra cada captura. > [accordion] Qual é a diferença entre status e etiquetas? > > Um lead tem **um único status** (em que etapa do funil está) e pode ter **várias etiquetas** (classificações livres). Use status para o acompanhamento e etiquetas para segmentar. > [accordion] O bot pede os dados de contato automaticamente? > > Se você ativar o Lead Form em Ações, o formulário aparece de acordo com o critério que você definir. Além disso, com a captura passiva o agente salva os dados que o visitante menciona na conversa, sem mostrar nenhum formulário. > [accordion] Posso excluir um lead? > > Sim, se você for Owner ou Admin. Pelo painel do lead (ícone de lixeira) ou selecionando vários e usando **Excluir** na barra de ações em massa. Pede confirmação. Os Operadores não podem excluir leads. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.