# Organizando Listas e Contatos As listas agrupam seus contatos para que você possa enviar as mensagens certas para as pessoas certas — uma lista de "Novos Leads", uma lista de "Clientes VIP", uma lista de "Assinantes da Newsletter", e assim por diante. Este guia aborda como encontrar e gerenciar suas listas, navegar pelos contatos dentro de uma delas, editar um contato e gerenciar contatos em massa a partir da tabela principal. --- ## Onde encontrar suas listas Ambos residem na mesma área de **Contatos**, alternados pelas duas abas na parte superior da página: - **Aba Contatos** — um seletor de lista compacto fica acima da tabela, além de um botão **+ Criar lista** sempre visível ao lado. - **Aba Listas** (clique em **Listas** ao lado de **Contatos**) — uma página dedicada para criar, renomear, excluir e navegar por cada lista, com uma contagem de membros e um indicador **"Alimenta N campanhas/transmissões"** por linha. ### O seletor de lista (aba Contatos) 1. Na barra lateral esquerda, clique em **Contatos**. 2. Acima da tabela, clique na pílula do **seletor de lista**. Ele abre um menu suspenso com todas as listas, cada uma mostrando seu nome e contagem de contatos. Escolha uma para filtrar a tabela apenas para essa lista, ou escolha **Todos os Contatos** para limpar o filtro. 3. Uma vez que uma lista esteja selecionada, clique no menu suspenso novamente para **Editar lista**, **Copiar ID da lista**, **Excluir lista** e **Excluir lista e contatos** — as mesmas ações abordadas abaixo, sem sair da página de Contatos. Ao lado do seletor há um botão permanente **+ Criar lista** — não é necessário selecionar nada primeiro. ### A página de Listas Clique na aba **Listas** ao lado de **Contatos**. Cada lista aparece como uma linha com seu nome, contagem de membros e o indicador **"Alimenta N campanhas/transmissões"** — que mostra quantas transmissões ou campanhas ativas enviam mensagens automaticamente para qualquer pessoa nova que entrar nessa lista (veja [Adicionando Contatos a uma Lista](#adding-contacts-to-a-list) para saber por que isso é importante). Abra o **menu da linha** ("⋯") de uma lista para ver suas ações: | Opção | O que faz | |---|---| | **Editar lista** | Renomeia a lista e permite alterar quais contatos estão nela. | | **Copiar ID da lista** | Copia o ID interno da lista para sua área de transferência (útil para a API ou webhooks). | | **Excluir lista** | Exclui a lista em si, mas **mantém todos os contatos** em sua conta — eles são simplesmente removidos desta lista. | | **Excluir lista e contatos** | Exclui a lista **e exclui permanentemente todos os contatos** nela. Isso não pode ser desfeito. | As duas opções de exclusão estão marcadas em vermelho e cada uma abre sua própria confirmação — excluir uma lista e excluir os contatos de uma lista são sempre duas etapas separadas de "tem certeza?", para que você não apague os contatos de uma lista por engano quando pretendia apenas remover a lista. > **Se uma lista estiver sendo usada por uma transmissão**, você ainda não pode excluí-la — a caixa de diálogo nomeia essa transmissão. Abra a página **Transmissões** para desvinculá-la lá, excluindo a transmissão ou apontando-a para uma lista diferente, depois volte e tente novamente. --- ## Criando uma nova lista A partir do seletor de lista (aba Contatos) ou do botão **+ Nova Lista** no topo da página de Listas: 1. Clique em **+ Criar lista** / **+ Nova lista**. 2. Em **Tipo de lista**, mantenha **Lista estática** selecionada — essa é uma lista normal, onde você escolhe os contatos manualmente. (**Lista inteligente** preenche-se automaticamente a partir de regras — veja [Listas inteligentes](#smart-lists-auto-updating) abaixo.) 3. Digite um nome (por exemplo, `Summer Sale Contacts`). 4. *(Opcional)* Adicione contatos imediatamente se a caixa de diálogo oferecer essa opção. 5. Clique em **Criar lista**. A nova lista aparece imediatamente tanto no seletor quanto na página de Listas. > **Se a opção Criar Lista não estiver disponível:** sua conta não tem permissão para editar contatos. Peça ao proprietário da conta para atualizar sua função na equipe. --- ## Listas inteligentes (Atualização automática) Uma **lista inteligente** é uma lista que você não preenche manualmente. Você define as regras uma vez — "tem a tag `hot-lead` e esteve ativo nos últimos 90 dias" — e a lista mantém-se atualizada: as pessoas que correspondem aos critérios entram, as que deixam de corresponder saem, sem que você precise fazer nada. Uma lista normal (**estática**) é o oposto: quem você adiciona nela permanece até que você remova. Ambos os tipos funcionam da mesma forma em todo o restante — você pode enviar uma transmissão para uma lista inteligente, filtrar a tabela de Contatos por ela e exportá-la, exatamente como qualquer outra lista. ### Criando uma lista inteligente 1. Na aba **Listas**, clique em **+ Nova lista**. 2. Em **Tipo de lista**, escolha **Lista inteligente**. 3. Dê um nome a ela (por exemplo, `Hot leads (active)`). 4. Em **Regras**, escolha **Corresponder: Todas as regras** ou **Qualquer regra** (veja abaixo), então crie sua primeira regra: escolha o que verificar, como comparar e o valor. 5. Clique em **+ Adicionar regra** para cada condição extra. Uma lista inteligente pode usar até 20. 6. Observe a linha abaixo das regras — ela conta os contatos que correspondem no momento ("≈ 3 contatos correspondem") e nomeia alguns deles, para que você possa saber antes de salvar se as regras capturam o que você pretendia. 7. Clique em **Criar lista**. A lista é preenchida no momento em que você a cria, portanto, ela abre já com seus membros incluídos. ### Corresponder a todas as regras vs. Qualquer regra - **Todas as regras** — um contato está na lista apenas quando *todas* as regras são verdadeiras. Use isso para restringir ("marcado com `hot-lead` **e** ativo nos últimos 90 dias"). - **Qualquer regra** — um contato está na lista quando *pelo menos uma* regra é verdadeira. Use isso para agrupar ("marcado com `newsletter` **ou** marcado com `webinar`"). ### Em que você pode basear as regras | Grupo | O que você pode verificar | |---|---| | **Quem eles são** | **Tags** (tem qualquer uma de / tem todas de / não tem nenhuma de), **Listas** (está em / não está em — apenas listas normais), **Canal** (WhatsApp, SMS, Instagram, etc.), **Status** | | **O que fizeram** | **Adicionado em**, **Última atividade**, **Última mensagem recebida**, **Última mensagem enviada**, **Primeira conversa com IA**, **Última conversa com IA** — cada uma como "nas últimas N horas/dias", "não nas últimas N horas/dias" (que também inclui pessoas que nunca fizeram isso), antes ou depois de uma data específica — com uma hora do dia opcional, e um botão **Agora** que preenche o momento atual (útil para capturar apenas os contatos adicionados a partir de agora, por exemplo, logo antes de uma grande importação), ou simplesmente preenchido / vazio. Também **Conversou com a IA**, definido como Ativado ou Desativado | | **Configurações** | **Respostas da IA** ativadas ou desativadas, **Não perturbe**, **Contato privado**, **Já respondeu alguma vez** | | **Negócios deles** | **Etapa do negócio** — tem um [negócio](../deals/sales-pipeline.md) em qualquer (ou nenhuma) das etapas do funil que você escolher, ou simplesmente **tem qualquer negócio** / **não tem nenhum negócio** | | **Detalhes** | **E-mail**, **Número de telefone**, **Nome**, **Sobrenome** — preenchido, vazio, contém ou não contém algum texto; **Campanha atribuída** e **Membro da equipe atribuído**; e qualquer um dos seus próprios **Campos personalizados** por nome | Maiúsculas e minúsculas nunca importam em uma comparação de texto, e uma regra que solicita algo "não nos últimos 30 dias" também corresponde a contatos para os quais isso nunca aconteceu. #### Contatos que sua IA realmente atendeu **Conversou com a IA** é sim para todo contato para o qual sua IA enviou pelo menos uma mensagem, e não para todos os outros — incluindo pessoas que apenas sua equipe respondeu. Isso é definido na primeira vez que a IA escreve para alguém e nunca desaparece depois, mesmo que você desative as respostas da IA desse contato ou o mova para outra campanha posteriormente. Se você precisa dos contatos que sua IA atendeu **em um período específico** — o motivo comum pelo qual as agências querem isso — use **Última conversa com IA** com "nos últimos 30 dias" em vez disso. Essa é uma janela móvel que sempre reflete o último mês. Duas regras que as pessoas frequentemente confundem com isso: - **Respostas da IA** (em Configurações) é um interruptor: ele diz que a IA tem *permissão* para responder a esse contato, não que ela já tenha respondido. - **Já respondeu alguma vez** é sobre o *contato* escrever de volta — para qualquer pessoa, incluindo sua equipe. Você também pode filtrar a tabela de Contatos da mesma maneira sem criar uma lista: abra **Filtro** e defina **Conversou com a IA** como Ativado, ou clique no botão rápido **Conversou com a IA** acima da tabela. O mesmo filtro está na [página de Chats](../chats/chat-interface.md#chat-filters) como um botão **Conversou com a IA**, para quando você quiser as conversas em vez dos registros de contato. ### Identificando uma lista inteligente Na página Listas, uma lista inteligente possui um selo **Inteligente**, um resumo em linguagem simples de suas regras abaixo do nome e a informação de quando foi atualizada pela última vez ("Atualizado há 4 minutos"). A contagem de membros é a contagem em tempo real. ### Quando uma Lista Inteligente é Atualizada - **Imediatamente quando um contato muda.** Adicione uma tag a alguém, altere seu status, preencha um campo personalizado — se isso fizer com que ele corresponda (ou pare de corresponder), a lista é atualizada em poucos segundos. Arrastar um negócio para outra etapa do funil também conta: uma regra de **Etapa do negócio** reage no momento em que o quadro muda. - **A cada 15 minutos para regras baseadas em tempo.** Regras como "sem atividade nos últimos 30 dias" tornam-se verdadeiras conforme o tempo passa, sem que ninguém toque no contato, portanto, cada lista inteligente também é verificada novamente em um ciclo de 15 minutos. - **Sob demanda.** Abra o menu **⋯** da lista e clique em **Atualizar agora** para executar as regras imediatamente, e a contagem de membros da linha e a linha "Atualizado…" são atualizadas instantaneamente. ### Você não pode adicionar ou remover pessoas manualmente Esse é o objetivo de uma lista inteligente: seus membros são definidos pelas regras, portanto, qualquer alteração feita manualmente seria desfeita na próxima verificação. Na prática: - A lista expandida não possui um botão **Adicionar contatos** nem a opção **Remover** em um membro — em vez disso, ela exibe *"Os membros são calculados a partir das regras desta lista"*. - Listas inteligentes não aparecem na ação em massa **Lista** na página de Contatos, no seletor de listas de um contato ou como destino de importação. Para alterar quem está na lista, abra o menu **⋯** dela e clique em **Editar regras**. ### Listas Inteligentes e Transmissões Uma transmissão pode ter como alvo uma lista inteligente como qualquer outra lista, que é onde elas são mais úteis: aponte uma para "marcado com `hot-lead`, sem resposta em 7 dias" e o público se mantém sozinho. > **Atenção: isso pode enviar mensagens por conta própria.** Se uma transmissão ao vivo ou campanha nessa lista estiver com a opção **Enviar para novos membros da lista** ativada, cada contato que passar a corresponder às suas regras receberá a mensagem inicial automaticamente — esse é o objetivo de combiná-las, mas significa que as pessoas podem ser contatadas sem que você clique em nada, e cada mensagem consome créditos. Verifique o que uma lista alimenta (a coluna **Alimenta** na página de Listas) antes de ampliar suas regras. --- ## Navegando e pesquisando membros da lista Na página de Listas, clique na linha de uma lista para expandi-la e ver todos os integrantes, com uma caixa de pesquisa para encontrar alguém por nome, telefone ou e-mail. A partir daí, você pode **remover um contato individual da lista** — isso apenas o remove da lista, não exclui o contato nem afeta suas outras listas. Em uma [lista inteligente](#smart-lists-auto-updating), o mesmo painel é somente leitura: você pode navegar e pesquisar seus membros, mas não há opção de Remover, pois seus membros vêm de suas regras. --- ## Adicionando contatos a uma lista Adicione contatos a uma lista a partir da visualização de lista expandida, do painel de visualização rápida ou registro completo de um contato, ou com a ação em massa **Adicionar à Lista** abaixo. [Listas inteligentes](#smart-lists-auto-updating) não são oferecidas em nenhum desses locais — elas se preenchem automaticamente a partir de suas regras. > **Atenção: adicionar alguém a uma lista pode enviar uma mensagem para essa pessoa.** Se uma transmissão ao vivo nessa lista estiver com a opção **Enviar para novos membros da lista** ativada, adicionar um contato envia a mensagem de abertura imediatamente, utiliza créditos e encaminha as respostas para o agente dessa transmissão. > > Você verá um aviso antes que isso aconteça. Independentemente de como você adicione alguém — pela ação em massa **Adicionar à lista**, pela tela **Adicionar membros** da própria lista ou pelos seletores de lista em um contato — a tela informará qual transmissão será enviada e solicitará sua confirmação. Remover alguém de uma lista nunca envia nada, portanto, isso permanece instantâneo. > > Se **mais de uma** transmissão ao vivo na mesma lista estiver com o seletor ativado, o novo contato receberá **uma mensagem de abertura de cada uma delas**, cobradas separadamente. O aviso informa a quantidade. Você pode impedir isso na etapa de Público da transmissão — consulte [Transmissões](../broadcasts/broadcasts.md). --- ## Editando um Contato 1. Na tabela de Contatos, clique em qualquer lugar na **linha** do contato para abrir o [painel de visualização rápida](creating-contacts.md). 2. Clique em **Editar**. 3. Atualize o nome, número de telefone, e-mail, canal, tags ou Notas. 4. Clique em **Salvar**. > **Clique na linha vs. clique no nome.** Clicar em uma linha abre o painel de visualização rápida. Clicar no **nome** do contato abre um chat com ele — veja [Adicionando um Novo Contato](creating-contacts.md). A participação em listas é editada na seção **Listas** do painel de visualização rápida, não no formulário de edição em si — clique no **+** ao lado de **Listas** no painel e marque ou desmarque as listas. --- ## Ações em Lote (Selecionando Vários Contatos de uma Vez) 1. Marque a caixa de seleção no início da linha de um contato. Marque quantos desejar ou use a caixa de seleção do cabeçalho para selecionar todos os contatos exibidos no momento. Com a página inteira marcada, uma **faixa azul aparece logo acima das linhas da tabela**, oferecendo a opção **Selecionar todos os N contatos que correspondem aos seus filtros** — um clique estende a seleção para todas as correspondências, não apenas para a página visível, permitindo que uma ação abranja milhares de contatos de uma só vez. Essa faixa apenas escolhe *quem* está selecionado; os botões que *executam* algo ficam na barra de ações abaixo. 2. Uma **barra de ações flutuante aparece na parte inferior da tela** com: - **Bot ligado / Bot desligado** — alterna o bot de IA para cada contato selecionado. - **Privado / Tornar público** — alterna a privacidade. - **Não perturbe (DND) / Desativar DND** — alterna o modo Não perturbe. - **Marcar como spam / Desmarcar como spam**. - **Arquivar / Desarquivar** — fecha o chat de cada contato selecionado e o move para o arquivo de chats, ou traz todos de volta. É o mesmo arquivo da página de Chats — veja [Encerrando uma conversa](../chats/chat-interface.md#closing-a-conversation-when-youre-done). - **Atribuir campanha** — encaminha a seleção para uma campanha. **Apenas contas de campanha clássicas** — veja a nota abaixo. - **Adicionar à lista**. - **Etiquetar** — aplica uma etiqueta a cada contato selecionado. - **Autoetiquetar** — permite que o agente de IA de cada contato leia a conversa inteira e aplique suas próprias regras de etiqueta, ou escolha as regras de um agente para todos os selecionados. O mesmo preço da etiquetagem ao vivo: 1 crédito por etiqueta aplicada, nada para contatos que não recebem novas etiquetas. Até 500 contatos por execução. Veja [Etiquetando uma conversa sob demanda](../get-started/creating-tags.md#tagging-a-conversation-on-demand). - **Automação** — adiciona a seleção a uma automação. Só aparece se sua conta tiver Automações. - **Exportar** — baixa a seleção como um arquivo. - **Excluir** — exclui permanentemente cada contato selecionado. 3. Clique na ação desejada. Ações destrutivas (Excluir, Marcar como spam) solicitam confirmação primeiro. > **Não vê o botão "Atribuir campanha"? Isso é esperado em uma conta de Agentes de IA.** Se o seu menu mostra **Agentes de IA** e não há entrada de **Campanhas**, a atribuição de contatos a uma campanha não se aplica mais. Em vez disso, coloque os contatos em uma **lista** e, em seguida, envie para essa lista com uma [Transmissão](../broadcasts/broadcasts.md) ou permita que um [Ponto de Entrada](../ai-agents/entry-points.md) encaminhe novas conversas para o Agente correto. Mapeamento completo da forma antiga para a nova: [Migrando de Campanhas para Transmissões e Agentes](../moving-from-campaigns.md). Clique no pequeno **×** no final da barra ou desmarque as caixas de seleção para limpar sua seleção. > **Não é o mesmo que a página de Chats.** Em **Contatos**, a barra de ações em massa flutua na parte inferior da tela. Na página de **Chats**, a barra equivalente fica *acima da lista de chats*, dentro da coluna da lista, com sua própria caixa de seleção principal — veja [Ações em Massa na Caixa de Entrada](../chats/chat-interface.md#bulk-inbox-actions). Ambas as páginas mostram o mesmo tipo de faixa "selecionar todos os N" acima de suas linhas quando a página visível está totalmente marcada. > **Dica: dividindo contatos em lotes iguais.** Não existe um botão automático de "dividir em listas de 50", mas a própria tabela permite que você faça isso rapidamente: ela exibe exatamente **50 contatos por página**, e a caixa de seleção no cabeçalho seleciona a página inteira. Portanto, marque a caixa de seleção do cabeçalho, clique em **Adicionar à lista**, selecione **+ Nova lista** no pop-up e dê um nome a ela (por exemplo, "Lote 1") — no momento em que você cria a lista, os contatos selecionados são adicionados a ela automaticamente. Em seguida, vá para a próxima página e repita o processo. Algumas centenas de contatos são divididos em listas iguais de 50 em poucos minutos — sem precisar adicionar contatos um por um. Se você só precisa de lotes para *envio* (não para organização), você pode ignorar as listas completamente: uma [Transmissão](../broadcasts/broadcasts.md) no **modo Drip** processa uma lista grande em lotes para você. --- ## Próximos passos - [Adicionando um Novo Contato](creating-contacts.md) — adicione contatos um por um, além de um tour completo pela tela de Contatos. - [Importando Contatos de um Arquivo](importing-contacts.md) — carregue uma planilha de contatos. - [Exportando Seus Contatos](exporting-contacts.md) — baixe seus contatos para um arquivo.