Na seção Listas, você pode criar, editar e usar listas personalizadas de clientes para automação.
Adicionar clientes a uma lista pode ser automatizado com base nas etapas do fluxo do bot — acionado por condições específicas ou ações do usuário.

As listas podem ser usadas para:

  • Filtrar e segmentar clientes dentro de um projeto
  • Exportar dados

Você pode exportar uma lista como um arquivo e importá-la para outro projeto MaviBot.

Vantagens de usar listas:

  • Automação: Os clientes são automaticamente adicionados ou removidos das listas com base na lógica do bot.
  • Portabilidade: As listas podem ser exportadas e importadas entre diferentes projetos.
  • Comunicação direcionada: Envie transmissões ou mensagens de funil específicas diretamente para listas de clientes filtradas.

O uso de listas simplifica a segmentação do público e torna a interação com o cliente mais precisa e eficiente.

Como criar uma lista

As listas são criadas na guia "Listas" dentro da mesma seção.

Clique no botão "Criar uma lista" para abrir uma janela com campos de entrada onde você pode inserir o nome da lista e selecionar uma pasta (se houver) para adicionar a lista.

Na seção "Listas", você pode classificar as listas por ID da lista ou em ordem alfabética (por nome):

O poder das listas de clientes está na sua flexibilidade. Você pode, por exemplo, adicionar um único cliente a várias listas simultaneamente.

As listas podem ser:

  • Agrupadas em pastas
  • Renomeadas
  • Excluídas (os próprios clientes permanecem no banco de dados)
  • Usadas para remover todos os clientes dentro de uma lista do projeto

Você pode incluir ou excluir clientes aplicando tipos de filtro — manualmente por meio de um formulário ou carregando um arquivo.

Para visualizar os clientes dentro de uma lista:

  1. Clique na lista para abrir o menu lateral direito.
  2. Clique no botão "Visualizar lista de clientes".

Em seguida, uma nova janela será aberta na seção "Clientes", onde você pode visualizar todos os usuários nessa lista.

Como automatizar seu trabalho com listas

Você pode adicionar, remover ou mover clientes automaticamente entre listas enquanto o chatbot está em execução.

Encontre o conjunto de ações de lista em qualquer bloco do construtor:

Quando a seção "Ação" estiver ativada, você pode escolher quais ações realizar em suas listas.

Após selecionar uma ação, você pode escolher em qual lista específica aplicá-la. Você também pode especificar várias ações diferentes dentro do mesmo bloco — não há limite para o número de ações que você pode adicionar em um bloco.

Os comandos são executados na ordem em que aparecem nas configurações do bloco.

Verificando se uma pessoa está na lista

Para verificar se um cliente está na lista, você pode usar a função inlist (número_da_lista) no campo "Variável" para comparação dentro de blocos e conexão.

O resultado da execução da função é um valor booleano (Verdadeiro ou Falso).

inlist(número da lista) == True - o cliente ESTÁ na lista ou

inlist(número da lista) == False - o cliente NÃO está na lista.

O número da lista pode ser encontrado clicando na lista desejada. Neste caso, o menu direito abre com informações sobre a lista:

Outras funções relacionadas a listas

Você pode encontrar as instruções detalhadas para trabalhar com funções de lista e etiqueta aqui.

Como trabalhar com listas manualmente

Cada lista possui botões para:

  • Adicionar/remover clientes da lista
  • Iniciar um mailing com base na lista
  • Baixar a lista como um arquivo

O menu de contexto inclui opções para:

  • Adicionar a lista a uma pasta
  • Editar a lista
  • Excluir a lista (os clientes permanecem no projeto)
  • Remover todos os clientes na lista do projeto

Aviso

"Remover membros da lista do projeto" exclui permanentemente esses clientes do projeto. Esta ação não pode ser desfeita.

Adicionar clientes a uma lista

Você pode adicionar manualmente clientes existentes a uma lista filtrando-os por meio de um formulário, carregando um arquivo ou selecionando de outra lista.

Importante

Ao adicionar clientes existentes a uma lista a partir de um arquivo, a primeira coluna deve conter os IDs internos dos clientes (a variável client_id).

Como adicionar clientes a partir de um arquivo:

  1. Selecione o tipo de filtro "Clientes de um arquivo":

  1. Em seguida, carregue uma lista de clientes no formato .CSV

Para adicionar NOVOS clientes a uma lista específica, vá para a seção "Canais". Em seguida, clique no botão "Carregar lista de clientes" e selecione a lista para a qual deseja carregar os clientes.

Como remover clientes de uma lista

Você pode remover clientes de uma lista da mesma forma: clique no botão "— Remover da lista" e aplique filtros, se necessário.

Aplique os filtros necessários para remover um grupo específico de clientes DESTA LISTA (não do banco de dados de clientes).

Tenha cuidado ao preencher o formulário.

Se você deixar os campos de filtro no formulário "Remover da lista" vazios, todos os clientes nessa lista serão removidos.

Para remover apenas uma parte da lista, preencha os filtros relevantes:

  • Por mensageiros conectados — selecione um bot específico
  • Clientes em um bloco — especifique o(s) número(s) do bloco no funil (vários blocos podem ser adicionados)
  • Por variáveis do cliente — insira um valor exato da variável
  • Registrados antes/depois — defina o intervalo de datas relevante
  • Excluir listas — se os números das listas forem inseridos, apenas os clientes não presentes em nenhuma dessas listas de exclusão serão removidos da lista atual.

Como criar um mailing

Ao clicar na lista, você também verá o botão "Criar um mailing" na barra lateral direita.

Você pode criar um mailing tanto para mensageiros quanto para e-mail (se o e-mail estiver ativado no seu projeto).

Como transferir clientes de outras plataformas

Ao carregar clientes de outras plataformas na seção "Mensageiros", você pode selecionar uma ou mais listas onde os clientes serão colocados após o upload.

Para fazer isso:

  1. Vá para a seção "Mensageiros".
  2. Selecione o mensageiro conectado para o qual deseja carregar os clientes.

Clique no botão "Carregar clientes" e configure as configurações de upload (codificação, lista de destino, etc.) para importar sua lista.