Your AI Connector Docs

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 todas as listas, com uma contagem de membros e um indicador Feeds N 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 Feeds N: quantas transmissões ativas (incluindo entradas de campanhas clássicas) enviam mensagens automaticamente para qualquer pessoa nova que entrar nessa lista (veja Adicionando Contatos a uma Lista para saber por que isso é importante). Passe o mouse sobre ele para ver o detalhamento.

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 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 “nos últimos N horas/dias”, “não nos últimos N horas/dias” (o que também inclui pessoas que nunca fizeram isso), antes ou depois de uma data específica — com um horário 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, ou aniversário é nos próximos N dias (veja abaixo). 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 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; Agente de IA atribuído 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.

Regras para campos de Número, Data, Menu Suspenso e Caixa de Seleção

Quando o campo personalizado que você escolhe tem um tipo, a regra se adapta a ele:

  • Campos de Número recebem uma caixa de número e podem verificar é maior que, é pelo menos, é menor que ou é no máximo, bem como é / não é. “Contagem de pedidos é pelo menos 3” compara números reais, então 10 vem depois de 9.
  • Campos de Data recebem um seletor de data e podem verificar é antes de ou é depois de uma data, está nos últimos N dias, está nos próximos N dias, ou é mais antigo que N dias (há mais de N dias). “Data de renovação está nos próximos 30 dias” mantém-se atualizada: a cada dia a janela avança junto com o calendário, incluindo hoje. “Última visita é mais antiga que 90 dias” é a lista de recuperação; um contato sem nenhuma data nunca corresponderá a isso, então adicione uma segunda regra com está vazio se você quiser esses também.
  • Aniversários e datas comemorativas. Campos personalizados de data, e as datas integradas como Adicionado em, também possuem aniversário é nos próximos N dias. Ele ignora o ano, então “Aniversário é nos próximos 7 dias” captura todos cujo aniversário cai na semana que vem, incluindo hoje, todos os anos. Insira 0 apenas para hoje, até 366. Alguém nascido em 29 de fevereiro aparece em 28 de fevereiro em anos sem ano bissexto. Adicionado em com esta regra encontra os contatos cujo aniversário de cadastro está chegando.
  • Campos de Menu suspenso permitem que você escolha uma das opções do próprio campo em vez de digitá-la.
  • Campos de Caixa de seleção são um simples sim ou não.

Um contato cujo valor não se encaixa no tipo do campo (digamos, soon em um campo de Data, remanescente de antes do campo ser tipado) nunca corresponderá a uma comparação de número ou data. “Nos últimos N dias”, “nos próximos N dias”, “mais antigo que N dias” e “aniversário é nos próximos N dias” contam dias corridos em UTC.

Contatos que sua IA realmente atendeu

Conversou com a IA é sim para cada 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 transfira para outro agente.

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 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 nessa lista (ou uma entrada de campanha clássica) estiver com a opção Enviar para novos membros da lista ativada, então cada contato que corresponder às suas regras receberá automaticamente sua mensagem de abertura — esse é o objetivo de combiná-las, mas significa que as pessoas podem receber mensagens sem que você clique em nada, e cada mensagem consome créditos. Verifique o que uma lista alimenta (a coluna Feeds na página Listas) antes de ampliar suas regras.


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, 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 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.


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.
  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.

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 Selecionar todos os N contatos correspondentes aos seus filtros — um clique estende a seleção para cada correspondência, não apenas para a página visível, para que uma ação possa abranger milhares de contatos de uma só vez. Essa faixa apenas escolhe quem é selecionado; os botões que fazem 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.
    • DND / Desativar DND — alterna o Não Perturbe.
    • Marcar como spam / Desmarcar como spam.
    • Arquivar / Desarquivar — fecha o chat de cada contato selecionado e move-o para o arquivo de chats, ou traz todos de volta. É o mesmo arquivo da página de Chats — veja Encerrando uma Conversa.
    • Adicionar à lista.
    • Tag — aplica uma tag a cada contato selecionado.
    • Auto-tag — permite que o agente de IA de cada contato leia a conversa inteira e aplique suas próprias regras de tag, ou escolha as regras de um agente para todos os selecionados. Mesmo preço da marcação ao vivo: 1 crédito por tag aplicada, nada para contatos que não recebem novas tags. Até 500 contatos por execução. Veja Marcando uma conversa sob demanda.
    • 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.

Procurando por “Atribuir campanha”? Isso foi removido com as campanhas. Coloque os contatos em uma lista e, em seguida, envie para essa lista com uma Transmissão ou deixe que um Ponto de Entrada transfira novas conversas para o Agente certo. Mapeamento completo da forma antiga para a nova: Migrando de Campanhas para Transmissões e Agentes.

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. 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 no modo Drip processa uma lista grande em lotes para você.


Próximos passos