> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morada.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Opt-out e contatos bloqueados

> Quando o contato pede para não receber mais mensagens, a Mia para de conversar na hora e aquele número não recebe nenhuma mensagem nova. Veja quem está bloqueado, por quê, e como desbloquear.

## O que é?

Quando um contato pede para não receber mais mensagens, a Mia para de conversar na hora: confirma o pedido em uma frase curta e encerra a conversa. O pedido fica registrado como **opt-out**, e a partir dele aquele número não recebe nenhuma mensagem nova. Nenhum disparo sai: campanhas, reabordagens, mensagens ativas do Talk, lembretes, fluxos de automação e mensagens de integrações.

Na página **Contatos** você vê quem pediu para sair, quando, onde o pedido foi registrado e a mensagem que o originou, e pode desbloquear quando o próprio contato pedir para voltar a ser contatado.

Atender esse pedido é uma exigência da LGPD e também protege o seu número: mensagem para quem pediu para parar vira bloqueio e denúncia no WhatsApp, e isso derruba a qualidade do número. Veja [Mensagens ativas](/guia-whatsapp/mensagens-ativas).

<Info>
  Não há nada para ativar. O opt-out vale para o número em todo o workspace, em todos os agentes e canais.
</Info>

## Opt-out e bloqueio

A plataforma trata dois casos:

| | Pediu para não receber mensagens (opt-out) | Contato bloqueado |
| - | - | - |
| **Quando acontece** | O contato pede para parar de receber mensagens | Envio de spam, mensagem de assédio, conteúdo impróprio ou bloqueio manual feito pela equipe |
| **Conversa com a Mia** | Encerrada na hora, depois de uma confirmação curta | A Mia para de responder na hora |
| **Mensagens novas** | Nenhuma: todo disparo é barrado | Nenhuma: todo disparo é barrado |
| **Se o próprio contato escrever de novo** | A Mia atende, porque foi ele quem chamou. O opt-out continua valendo | A Mia não responde |
| **Na página Contatos** | Ícone de balão riscado ao lado do nome | Cadeado, com o nome em vermelho e riscado |

## Como o opt-out é registrado

### Pela Mia, na conversa

A Mia registra o opt-out quando o contato pede com clareza para não receber mais mensagens. Por exemplo:

* "pare de me mandar mensagem", "não quero receber mais mensagens", "tira meu número da lista";
* uma resposta só com "sair", "parar", "pare", "stop", "bloquear", "descadastrar" ou "cancelar inscrição";
* o toque no botão **Parar promoções** de um modelo de marketing. Veja [Modelos de mensagem](/guias/canais/whatsapp-mensagens).

Na mesma resposta, a Mia confirma em uma frase curta que o contato não vai mais receber mensagens e para de conversar. Ela não insiste nem tenta reverter o pedido: a conversa é encerrada na hora, e o deal daquela conversa também.

<Frame>
  <img src="https://mintcdn.com/moradaai-f7bfc739/uTh8bSYnpBPT5o8O/images/leads/conversa-opt-out-mia.png?fit=max&auto=format&n=uTh8bSYnpBPT5o8O&q=85&s=f7aaa70e0e20446fee8dbc3e0b859cfd" alt="O contato toca em Parar promoções num modelo de marketing e a Mia responde que ele não receberá mais mensagens" width="385" data-path="images/leads/conversa-opt-out-mia.png" />
</Frame>

Desinteresse não gera opt-out. Frases como "não tenho interesse agora", "só estou olhando", "vou pensar" ou "agora não tenho dinheiro" mantêm o contato ativo. Nesses casos, a [reabordagem inteligente](/guias/mia/reabordagem-inteligente) avalia se vale mandar mais uma mensagem.

### Em ligações de campanha

O opt-out também é registrado quando o contato pede, durante uma ligação de campanha, para não ser mais contatado. O efeito é o mesmo: o número deixa de receber mensagens ativas em todos os canais, não só ligações.

### Bloqueio manual pela equipe

Para bloquear um contato, abra a conversa e clique em **Bloquear Contato**, no painel do contato, ao lado de **Assumir**. O contato bloqueado não recebe mensagens ativas, e a Mia deixa de responder quando ele escreve. O botão aparece para quem tem a permissão **Bloquear contato**.

<Frame>
  <img src="https://mintcdn.com/moradaai-f7bfc739/uTh8bSYnpBPT5o8O/images/leads/bloquear-contato-conversa.png?fit=max&auto=format&n=uTh8bSYnpBPT5o8O&q=85&s=d5bd0621ac435c324dad30a278d81720" alt="Botão Bloquear Contato no painel do contato, dentro da conversa" width="290" data-path="images/leads/bloquear-contato-conversa.png" />
</Frame>

<Note>
  Use o bloqueio manual para abuso ou spam. Para quem só pediu para não receber mensagens, o opt-out já resolve e mantém a Mia disponível se a pessoa voltar a escrever.
</Note>

## O que deixa de ser enviado

Um número com opt-out ou bloqueio não recebe nenhuma mensagem nova. A plataforma barra:

* campanhas de WhatsApp, de SMS e ligações de campanha;
* reabordagens da régua de abordagem;
* mensagens ativas enviadas pelo Talk;
* lembretes de agendamento;
* mensagens de fluxos de automação e de integrações com CRM;
* notificações enviadas pela API.

Quando alguém da equipe tenta enviar uma mensagem ativa pelo Talk para esse número, a plataforma recusa o envio e mostra o motivo:

* com opt-out: "Esta pessoa pediu para não ser mais contatada. A mensagem não foi enviada."
* bloqueado: "Este contato está bloqueado. Desbloqueie o contato para enviar a mensagem."

Em campanhas, o contato é pulado e aparece entre os que não receberam.

## Ver os contatos bloqueados

<Steps>
  <Step title="Abra a página Contatos">
    No menu **Leads**, clique em **Contatos**.
  </Step>

  <Step title="Filtre por status">
    Clique em **Filtrar** e, em **Status do contato**, escolha **Somente bloqueados**. A lista passa a mostrar quem tem opt-out e quem foi bloqueado.
  </Step>

  <Step title="Abra o detalhe">
    Clique no ícone ao lado do nome para ver o motivo, a origem, a data e a mensagem do contato que levou ao registro.
  </Step>
</Steps>

<img src="https://mintcdn.com/moradaai-f7bfc739/uTh8bSYnpBPT5o8O/images/leads/contatos-bloqueados-lista.png?fit=max&auto=format&n=uTh8bSYnpBPT5o8O&q=85&s=58c42bdfbc2fa05a71313688c5f10ede" alt="Página Contatos filtrada por Somente bloqueados, com contatos bloqueados marcados por cadeado e um contato com opt-out marcado pelo ícone de balão riscado" width="2560" height="1408" data-path="images/leads/contatos-bloqueados-lista.png" />

O detalhe mostra:

* **Motivo:** Solicitou não receber mais mensagens, Envio de spam, Mensagem de assédio, Conteúdo impróprio ou Bloqueio manual.
* **Origem:** Registrado pela IA na conversa, Registrado em ligação, Bloqueado automaticamente pela IA ou Bloqueado por (nome de quem bloqueou).
* **Data** do registro.
* **Mensagem:** o trecho da mensagem do contato que levou ao registro.
* **Abrir conversa**, para ver a conversa inteira.

<Frame>
  <img src="https://mintcdn.com/moradaai-f7bfc739/uTh8bSYnpBPT5o8O/images/leads/contato-opt-out-detalhe.png?fit=max&auto=format&n=uTh8bSYnpBPT5o8O&q=85&s=adfb748a68c772abe400d783302bee5e" alt="Detalhe de um contato com opt-out: motivo Solicitou não receber mais mensagens, registrado pela IA na conversa, data, a mensagem Parar promoções e os botões Abrir conversa e Desbloquear contato" width="420" data-path="images/leads/contato-opt-out-detalhe.png" />
</Frame>

## Desbloquear um contato

Desbloqueie quando o próprio contato pedir para voltar a receber mensagens, ou quando o registro foi feito por engano.

<Steps>
  <Step title="Encontre o contato">
    Em **Contatos**, filtre por **Somente bloqueados** ou busque pelo nome ou telefone.
  </Step>

  <Step title="Abra o detalhe">
    Clique no ícone ao lado do nome.
  </Step>

  <Step title="Desbloqueie">
    Clique em **Desbloquear contato** e confirme.
  </Step>
</Steps>

O contato volta a receber mensagens da IA e das campanhas. O desbloqueio remove tanto o bloqueio quanto o opt-out, e a plataforma registra quem desbloqueou e quando.

<Frame>
  <img src="https://mintcdn.com/moradaai-f7bfc739/uTh8bSYnpBPT5o8O/images/leads/desbloquear-contato-opt-out.png?fit=max&auto=format&n=uTh8bSYnpBPT5o8O&q=85&s=44b67eb0cfed631013649f1af15f46bf" alt="Confirmação de desbloqueio com o aviso de que o contato pediu para não receber mensagens (LGPD)" width="410" data-path="images/leads/desbloquear-contato-opt-out.png" />
</Frame>

<Warning>
  Quando o contato tem opt-out, a plataforma avisa antes de confirmar que ele pediu para não receber mensagens (LGPD). Desbloqueie só com um novo pedido do próprio contato para voltar a ser contatado.
</Warning>

<Info>
  Só quem tem a permissão **Bloquear contato** vê o botão de desbloquear. Por padrão, Administrador e Supervisor. Veja [Usuários e permissões](/guias/admin/usuarios-permissoes).
</Info>

## Opt-out de marketing no WhatsApp

O próprio WhatsApp permite que a pessoa pare de receber mensagens de marketing de uma empresa. Quando a Meta recusa um modelo de **Marketing** por esse motivo (código 131050), a plataforma registra a preferência e deixa de enviar modelos de marketing para esse contato. Modelos de **Utilidade** continuam sendo enviados.

* No Talk, o envio de um modelo de marketing é recusado com o aviso "Esta pessoa pediu ao WhatsApp para não receber mensagens de marketing desta empresa. Use um modelo de utilidade."
* Nas campanhas, o contato aparece com a falha **Opt-out de marketing (Meta: 131050)**.

Esse caso não aparece no filtro de bloqueados da página **Contatos**, porque a preferência fica no WhatsApp da pessoa e vale só para marketing.

## Para quem usa a API

Quando o destinatário tem opt-out ou bloqueio, o endpoint [Enviar Notificação](/api-reference/endpoint/enviar-notificacao) não envia a mensagem e responde `409`, com `error.code` igual a `ActiveMessageBlocked` e o motivo em `error.reason`: `opted_out`, `banned` ou `whatsapp_marketing_opted_out`.

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="O contato disse que não tem interesse. Ele foi bloqueado?">
    Não. Desinteresse não gera opt-out. A Mia registra o opt-out só quando o contato pede para não receber mais mensagens.
  </Accordion>

  <Accordion title="O contato voltou a escrever depois do opt-out. O que acontece?">
    Se foi o próprio contato que chamou, a Mia atende essa nova conversa. O opt-out continua valendo: nenhum disparo volta a sair para ele, seja campanha, reabordagem ou mensagem ativa, até alguém da equipe desbloquear. Se ele pedir para voltar a receber mensagens, desbloqueie pela página **Contatos**.
  </Accordion>

  <Accordion title="A Mia registrou opt-out por engano. Como desfazer?">
    Abra o detalhe do contato em **Contatos**, confira a mensagem que levou ao registro e clique em **Desbloquear contato**.
  </Accordion>

  <Accordion title="O bloqueio vale para todos os agentes?">
    Vale para o número em todo o workspace, em qualquer agente e canal. Se o contato tiver outro número, esse outro número não fica bloqueado.
  </Accordion>

  <Accordion title="Por que alguns contatos aparecem com Motivo não registrado?">
    São contatos bloqueados antes de a plataforma passar a guardar o motivo, a origem e a mensagem. O bloqueio continua valendo do mesmo jeito.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.