# Incluir Contatos

A inclusão de contatos em uma sequência é feita manualmente, diretamente na página da sequência. Você pode adicionar contatos de três formas diferentes, de acordo com a sua necessidade.

## **Passo 1: Abrir o modal de adição**

1. Na página da sequência, clique no botão **+ Adicionar contatos** no canto superior direito da tela.
2. O modal **Adicionar contatos** será exibido com três opções de inclusão.

<figure><img src="/files/1cILvQUuz2EIPRdEFZ8d" alt=""><figcaption></figcaption></figure>

## **Passo 2: Selecionar a forma de inclusão**

Escolha uma das opções abaixo de acordo com a sua necessidade.

### **Filtro por contato**

Utilize os filtros da sua base de contatos salvos para selecionar quem receberá a sequência.

1. Selecione **Filtro por contato**.
2. No modal **Filtrar contatos**, preencha os campos desejados para filtrar sua base:
   * **Nome, Telefone, Instagram ou E-mail**
   * **Origem:** Criado manualmente, Criado automaticamente ou Importado
   * **Data de importação**
   * **Etiquetas:** selecione as etiquetas e defina a condição de filtro
   * **Carteiras:** selecione uma ou mais carteiras
   * **Campos personalizados**
3. Clique em **Aplicar filtros**.
4. Confira os contatos encontrados e clique em **Adicionar**.
5. Um modal de confirmação será exibido com a quantidade de contatos que serão adicionados. Se houver contatos que já fazem parte da sequência, o sistema informará quantos não serão adicionados novamente.
6. Clique em **Continuar** para confirmar. Para adições acima de 10 contatos, será solicitado um **código de validação (OTP)** enviado para o seu e-mail.
7. Após a confirmação, os contatos serão adicionados à sequência.

<figure><img src="/files/50vK3UZyy0X60cBABSp2" alt=""><figcaption></figcaption></figure>

### **Lista de números**

Adicione contatos informando diretamente os números de telefone.

1. Selecione **Lista de números**.
2. No campo **Números de telefone**, cole ou insira os números desejados — um por vez ou copiados de uma tabela.
3. Clique em **Adicionar**.
4. Um modal de confirmação será exibido com a quantidade de contatos que serão adicionados. Se houver duplicatas, o sistema informará quantos não serão adicionados novamente.
5. Clique em **Continuar** para confirmar. Para adições acima de 10 contatos, será solicitado um **código de validação (OTP)** enviado para o seu e-mail.
6. Após a confirmação, os contatos serão adicionados à sequência.

<figure><img src="/files/E2xuP4HejMCoNfED32B4" alt=""><figcaption></figcaption></figure>

### **Todos os contatos**

Adiciona todos os contatos cadastrados na plataforma à sequência de uma só vez.

1. Selecione **Todos os contatos**.
2. Um modal de confirmação será exibido com a quantidade total de contatos que serão adicionados.
3. Clique em **Adicionar X contatos** para confirmar. Será solicitado um **código de validação (OTP)** enviado para o seu e-mail.
4. Após a confirmação, todos os contatos serão adicionados à sequência.

<figure><img src="/files/YHp4y7u8NaEkY8KDJH4V" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
**Atenção:** Os disparos das mensagens para os contatos adicionados acontecerão todos em um mesmo momento, conforme programado nas etapas. Atente-se às regras dos canais de atendimento configurados para evitar bloqueios, banimentos e uso indesejado de limites do canal.
{% endhint %}

{% hint style="info" %}
Contatos que já fazem parte da sequência não serão adicionados novamente.
{% endhint %}

## Acompanhando o progresso da adição

Ao adicionar mais de 10 contatos, o sistema exibe automaticamente uma notificação na **Central de Notificações** (ícone de sino). Por ela você acompanha o andamento da ação em tempo real e pode cancelá-la se necessário.

Quando o processo é concluído, a notificação é atualizada informando a quantidade de contatos adicionados com sucesso. Caso ocorra algum erro ou a ação seja cancelada, a notificação informará quantos contatos foram processados e quantos não foram concluídos.

<figure><img src="/files/fI3djSRdfYaLZfnJzlof" alt=""><figcaption></figcaption></figure>

## Auditoria

Todas as ações de adição de contatos são registradas automaticamente em **Ajustes > Auditoria > Histórico de alterações**, na entidade **Sequências | Contato**.

Cada registro contém:

* **Data da ação**
* **Tipo da ação** (adição)
* **Alterado por** — usuário responsável ou sistema, quando a remoção for executada automaticamente pela sequência
* **Entidade**
* **Campo de alterações** — indica qual contato foi adicionado ou removido

Também é possível identificar a **origem da inserção**, informando por qual meio o contato foi adicionado à sequência — como pelo cadastro da sequência, cadastro do contato, chatbot ou API.


---

# 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.flw.chat/guide/documentacao/apps/sequencia/incluir-contato-na-sequencia.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.