
# Excluindo contatos do bot de IA

Às vezes, você não quer que a IA responda em seu nome — um contato pode ser seu parceiro de negócios, um membro da família ou um cliente VIP que espera um toque pessoal. Esta página aborda as duas maneiras de manter o bot em silêncio para pessoas específicas, enquanto ele continua funcionando normalmente para todos os outros.


## Quando usar isso

Motivos comuns para excluir um contato do bot:

* **Contatos pessoais misturados em uma conta do WhatsApp Web.** Se você conectou seu número de WhatsApp do dia a dia, seus amigos e familiares agora também estão no sistema — e você quase certamente não quer que a IA envie mensagens diretas para eles.
* **Membros da equipe interna.** Colegas, parceiros, fornecedores, seu contador — qualquer pessoa com quem você converse como humano, não como empresa.
* **Contatos VIP.** Clientes de alto valor onde cada resposta precisa da sua atenção pessoal.
* **Qualquer pessoa que tenha solicitado explicitamente falar com uma pessoa.** Desative o bot para eles e assuma o controle manualmente pelo chat.

Em todos os casos abaixo, **as mensagens recebidas ainda chegam, são armazenadas e disparam notificações**. A única coisa que muda é que a IA permanece em silêncio. Você sempre pode responder pessoalmente a partir de Chats.

## Método 1: Controle o bot no momento do pareamento (apenas WhatsApp Web)

Ao parear um número do WhatsApp Web pela primeira vez (Configurações → Canais, ou o fluxo de Conexão), a caixa de diálogo de pareamento solicita um número de telefone e, em seguida, mostra uma opção **Importar contatos existentes**. Ativá-la revela mais três opções abaixo:

| Opção | O que faz | Padrão |
|---|---|---|
| **Importar contatos existentes** | Traz seus contatos do WhatsApp existentes para o aplicativo na primeira conexão. | Desativado |
| **Tornar contatos privados** | Contatos importados não terão mensagens armazenadas ou enviadas — use para contatos pessoais. | Desativado |
| **Importar histórico de chat** | Também traz as mensagens históricas dos contatos importados (pode levar alguns minutos). | Desativado |
| **Manter IA pausada para contatos importados** | Deixa a IA desativada para todos os importados desta forma, para que ela não envie mensagens automaticamente para seus contatos existentes. | **Ativado** (recomendado — deixe ativado) |


Ativar **Tornar contatos privados** desativa automaticamente **Importar histórico de chat** e ativa **Manter IA pausada para contatos importados** — contatos privados nunca têm suas mensagens importadas nem a IA liberada para eles.

**Deixe "Manter IA pausada para contatos importados" ativado** ao parear um número pessoal — esse é o padrão, e é o que impede que o bot envie mensagens para seus amigos e familiares. Novos leads que enviarem mensagens para você posteriormente nesse número ainda receberão o bot normalmente; esta opção afeta apenas os contatos trazidos no momento do pareamento.

> **Atenção:** Estas opções aplicam-se apenas no momento em que você pareia o número e não mudam retroativamente. Uma reconexão ou novo pareamento de um número já conectado ignora esta etapa e sempre usa os padrões acima — ele nunca mostra essas opções novamente. Se o bot acabar respondendo a contatos que você não queria, use o Método 2 abaixo para desativá-lo individualmente.

## Método 2: Chave seletora por contato (funciona para qualquer contato, a qualquer momento)

Todo contato possui uma opção **Bot Ativo**, disponível a qualquer momento, em qualquer canal.

1. Na barra lateral esquerda, clique em **Contatos**.
2. Clique na linha do contato para abrir o [painel de visualização rápida](creating-contacts.md).
3. Encontre **Bot Ativo** em **Configurações** no painel.
4. Desative-o para silenciar o bot para essa pessoa. Ative-o novamente sempre que quiser que a IA volte a atendê-la.


Este é o interruptor de "modo apenas humano" por contato — use-o para exceções pontuais após o fato.

### Versão em massa

Para alternar o Bot Ativo para vários contatos de uma vez:

1. Abra a página **Contatos**.
2. Marque as caixas de seleção dos contatos que deseja alterar — ou selecione uma lista primeiro e, em seguida, marque a caixa de seleção do cabeçalho para selecionar todos nela.
3. Na barra de ação flutuante que aparece na parte inferior, clique em **Bot desativado** (ou **Bot ativado** para reativá-lo para a seleção).

## O que "bot inativo" realmente significa

**Bot inativo não significa que o contato está silenciado, bloqueado ou oculto.** Quando um contato está com o bot desativado:

* As mensagens recebidas deles **ainda chegam** na sua caixa de entrada.
* As mensagens **ainda são armazenadas** no histórico de chat (a menos que o contato também esteja marcado como **Privado**).
* Você **ainda recebe notificações** (e-mail, no aplicativo, push — o que quer que você tenha configurado).
* O contato ainda conta como um contato normal em suas listas, tags e relatórios.
* As conversas deles **ainda são incluídas nos Resumos Diários** — e como ninguém automatizado está lidando com elas, o resumo tem mais probabilidade de sugerir uma tarefa de acompanhamento manual para eles.

Se você deseja que um contato fique de fora de tudo — histórico de chat, relatórios e Resumos Diários — marque-o como **Privado**: as mensagens de um contato privado não são armazenadas a partir desse momento (mensagens armazenadas antes de você definir isso permanecem). Marcar um contato como privado também desativa o bot dele automaticamente. Use Privado para contatos pessoais e membros da equipe; use Bot Ativo desativado para clientes que você deseja atender pessoalmente.

A única coisa que muda: a IA não redige nem envia uma resposta por conta própria. Responder agora é sua função, a partir dos Chats — no seu celular, da maneira que você trabalha normalmente.

## Guia de decisão rápida

| Situação | Use isto |
|---|---|
| Vincular um número pessoal do WhatsApp com amigos/familiares já existentes nele | Método 1 — deixe **Manter IA pausada para contatos importados** ativado no momento do vínculo |
| Um contato específico que você deseja gerenciar pessoalmente | Método 2 — desative **Bot Ativo** no perfil dele |
| Uma lista inteira de fornecedores, funcionários ou VIPs já no aplicativo | Versão em massa do Método 2 |

Se você não tiver certeza de qual usar, comece com o Método 1 ao parear um número pessoal e recorra ao Método 2 sempre que uma exceção surgir mais tarde.

> **Nota sobre importações de CSV:** não há uma coluna por linha para marcar contatos importados como inativos para o bot ao importar uma planilha. Importe a lista primeiro e, em seguida, use a versão em massa do Método 2 no lote importado — veja [Importando Contatos de um Arquivo](importing-contacts.md).

## Usando como uma lista de permissões (whitelist) de teste

Uma configuração de integração comum: você quer que a IA esteja ativa em um canal real, mas respondendo **apenas** a um punhado de números de teste (você, seu cliente, os assistentes deles) enquanto valida a configuração — permanecendo silenciosa para todos os outros. Ainda não existe um botão único de "whitelist" para isso, mas a alternância Bot Ativo resolve:

1. Na página **Contatos**, selecione todos os contatos existentes e use a ação em massa **Bot desligado**, então ative o **Bot Ativo** apenas para seus testadores.
2. Novas pessoas que enviarem mensagens começam com o bot **ligado**, então cubra-as com uma automação: gatilho **Novo contato** → ação **Ligar ou desligar IA para um contato**, definido como desligado. Veja [Automações](../automations/automations.md).

Uma ressalva honesta sobre o passo 2: a automação e a resposta da IA competem na **primeira mensagem** de um contato totalmente novo, então, ocasionalmente, essa primeira mensagem ainda recebe uma resposta antes que a configuração seja aplicada. A partir da segunda mensagem, o contato permanece em silêncio até que você o habilite.

Palavras-chave de [Pontos de Entrada](../ai-agents/entry-points.md) **não** são uma forma de fazer isso: palavras-chave apenas decidem qual agente assume uma *nova* conversa. Uma vez que um contato é roteado, a IA responde a todas as suas mensagens de acompanhamento, independentemente de conterem a palavra-chave ou não — e a correspondência de palavras-chave é deliberadamente flexível (erros de digitação, a palavra-chave dentro de uma frase mais longa), portanto, não pode atuar como um filtro rigoroso.

---

## Próximos passos

- [Adicionando um Novo Contato](creating-contacts.md) — um contato que você adiciona manualmente começa com o bot desligado; ative-o no painel de visualização rápida quando quiser que a IA responda a ele.
- [Organizando Listas e Contatos](list-and-contact-management.md) — crie uma lista de contatos que você planeja excluir em massa.
- [Agentes de IA](../ai-agents/ai-agents.md) — configure como o bot se comporta para os contatos que ele gerencia.
