# Listas e tags

Na **Listas** seção, 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 arquivo e importá-la para outro projeto do MaviBot.

<div data-with-frame="true"><figure><img src="/files/1a7ab082725f3c9f9bd9d3a0f5460c5077ab2787" alt=""><figcaption></figcaption></figure></div>

#### **Vantagens de usar listas:**

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

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

## Como criar uma lista

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

<div data-with-frame="true"><figure><img src="/files/825c3e8e7f93fc472cbc1bc5e65498f5f3dfb984" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/955c11d12675cb4051d8a1d93afcd0ce32f23da2" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/e29473295519f889ef794172fdf93b118cac060f" alt="" width="212"><figcaption></figcaption></figure></div>

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 de uma lista** do projeto

<div data-with-frame="true"><figure><img src="/files/2695d438834cdd32b5ef2fd6fec4da5627906754" alt="" width="563"><figcaption></figcaption></figure></div>

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

Para visualizar os clientes dentro de uma lista:

1. Clique na lista para abrir o menu do lado direito.
2. Clique no **"Ver lista de clientes"** .

<div data-with-frame="true"><figure><img src="/files/6e8b3dc96b9e4192df6194d05b1f71c7ea3f5742" alt="" width="563"><figcaption></figcaption></figure></div>

Em seguida, uma nova janela será aberta a partir da **"Clientes"** seção, onde você pode visualizar todos os usuários dessa 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 da lista** em qualquer bloco do construtor:

<div data-with-frame="true"><figure><img src="/files/80501e3801f91d4f3a8716e4600b83f2150f8c14" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/ddfa65d80cc5dceb0b9399a939578b47eb828c87" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/586038f946943dc72864f67dbfb9c3450515b503" alt="" width="375"><figcaption></figcaption></figure></div>

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

### Verificando se uma pessoa está na lista

Para <mark style="color:verde;">**verificar se um cliente está na lista**</mark>, você pode usar o <mark style="color:verde;">**`inlist (list_number)`**</mark> na **"Variável"** campo 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.

<figure><img src="/files/35d6ed369fd6614dc99341d6fb3f002c0fcabacf" alt=""><figcaption></figcaption></figure>

O número da lista pode ser encontrado clicando na lista desejada. Nesse caso, o menu à direita é aberto com informações sobre a lista:

<div data-with-frame="true"><figure><img src="/files/b1759f154866067ebcb3f1d28e98db55258d9a61" alt=""><figcaption></figcaption></figure></div>

### Outras funções relacionadas a listas

{% hint style="info" %}
[Você pode encontrar aqui as instruções detalhadas para trabalhar com as funções de lista e tag.](/doc/pt/chatbot/functions/calculadora/lists.md)
{% endhint %}

## **Como trabalhar com listas manualmente**

Cada lista tem botões para:

* Adicionar/remover clientes da lista
* Iniciar uma mala direta com base na lista
* Baixar a lista como 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 da lista do projeto

{% hint style="danger" %}

#### **Aviso**

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

### Adicionar clientes a uma lista

<div data-with-frame="true"><figure><img src="/files/0498b655bb28118a859445366f5bc3668bb7de3c" alt="" width="375"><figcaption></figcaption></figure></div>

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

{% hint style="warning" %}

#### Importante

Ao adicionar clientes existentes a uma lista **a partir de um arquivo**, a primeira coluna deve conter os **IDs internos dos clientes** (o `client_id` ).
{% endhint %}

#### Como adicionar clientes a partir de um arquivo:

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

<div data-with-frame="true"><figure><img src="/files/445668c149a497784ded4d57c100374aacd67e2f" alt="" width="375"><figcaption></figcaption></figure></div>

2. Em seguida, carregue uma lista de clientes em formato .CSV

<div data-with-frame="true"><figure><img src="/files/34a31d46de4f024ff8d3db0fbb118ffa70b44d43" alt="" width="375"><figcaption></figcaption></figure></div>

Para <mark style="color:verde;">**adicionar novos clientes**</mark> 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 você deseja enviar 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.

<div data-with-frame="true"><figure><img src="/files/b3f21a170c36109b5b94940b96d9a93b1937ea48" alt="" width="375"><figcaption></figcaption></figure></div>

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

{% hint style="danger" %}
**Por favor, tenha cuidado ao preencher o formulário.**

Se você deixar os campos de filtro em **"Remover da lista"** formulário **vazio**, **todos os clientes** dessa 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
* **Registrado antes/depois** — defina o intervalo de datas relevante
* **Excluir listas** — se os números das listas forem inseridos, apenas clientes **não** presentes em qualquer uma dessas listas de exclusão serão removidos da lista atual.
  {% endhint %}

## Como criar uma campanha

Quando você clicar na lista, também verá o **"Criar uma campanha"** botão na barra lateral direita.

<div data-with-frame="true"><figure><img src="/files/23e1cde47e17a2cb61408bec704b5ca535a72ecf" alt="" width="563"><figcaption></figcaption></figure></div>

Você pode criar uma campanha para ambos os **mensageiros** e **email** (se o e-mail estiver habilitado no seu projeto).

## Como transferir clientes de outras plataformas

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

Para fazer isso:

1. Vá para a guia **"Mensageiros"** seção.
2. Selecione o mensageiro conectado para o qual você deseja enviar os clientes.

<div data-with-frame="true"><figure><img src="/files/d489f43ed0cef9ff5eb761da7f2c5424641686e8" alt=""><figcaption></figcaption></figure></div>

Clique no **"Enviar clientes"** botão e configure as definições de envio (codificação, lista de destino etc.) para importar sua lista.

<div data-with-frame="true"><figure><img src="/files/1125481f2e3c8983b69f14ce4a37c75be0191c68" alt="" width="563"><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/pt/crm/tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.