01 — CONTEXTO
Por que existe
O WhatsApp oficial pune números que insistem com quem não quer receber: o índice de qualidade cai e o número pode ser suspenso. A Z-API já respeitava quem pedia para sair — o canal Meta, não: disparava campanha, NPS, CSAT e cobrança sem checar nada.
Esta funcionalidade traz esse respeito para o Meta. O cliente passa a dizer se quer continuar recebendo, por número, e o Zapisp obedece antes de cada envio. Menos denúncias, número mais saudável, os dois canais no mesmo padrão.
02 — VISÃO GERAL
Como funciona
São quatro momentos. A resposta do cliente é sempre por botão ou tela — ele nunca precisa digitar.
PASSO O QUE ACONTECE
1 · Convite A empresa envia o convite de opt-out, perguntando se o cliente quer continuar -------------- recebendo
2 · Resposta O cliente responde na telinha. O Zapisp guarda a escolha dele.
3 · Respeito Antes de cada envio, o Zapisp confere a escolha e não envia para quem pediu para -------------- sair.
4 · Voltar Para voltar, o cliente precisa receber um novo convite — ou o provedor libera pelo -------------- “Forçar desbloqueio” no cadastro.
Os três status possíveis do cliente:
• continuar recebendo → recebe
• não quero receber → bloqueado
• não sou cliente → bloqueado
• nunca respondeu → recebe
A escolha vale por número: sair de um número não afeta os outros. Vale sempre a última resposta.
03 — PEDIR PERMISSÃO
A oferta de opt-out
É o convite que pergunta ao cliente se ele quer continuar recebendo. Há três formas de enviar — a empresa escolhe. Todas abrem a mesma telinha de resposta, e o Zapisp registra a escolha sozinho.
1 · Em um template existente (campanha)
• o custo se mantém
• não usa o template padrão
O botão de opt-out entra em um template que a empresa já usa — o convite pega carona no disparo que já ia acontecer, e o custo continua o mesmo da campanha.
[1.] No Gerenciador do WhatsApp (Meta), edite o seu template de campanha e adicione o botão de Flow apontando para o Flow de opt-out do Zapisp. A edição passa por nova aprovação da Meta.
[2.] Dispare a campanha normalmente pelo Zapisp usando esse template.
[3.] O botão aparece na mensagem, e a resposta do cliente é registrada automaticamente.
2 · Ao fim da pesquisa (NPS / pós-atendimento)
• gratuita
• não usa template nenhum
[1.] Ligue “Enviar oferta de opt-out ao fim da pesquisa” nas configurações de NPS e/ou de pós-atendimento (telas na seção 05).
[2.] Pronto — quando o cliente responde a pesquisa, o convite sai sozinho, depois da mensagem de agradecimento.
Sai como mensagem de sessão, aproveitando a conversa que o cliente acabou de abrir ao responder a pesquisa — por isso não há cobrança.
3 · Convite avulso (pela integração)
• pago (mensagem cobrada)
• usa o template padrão
[1.] Se quiser, escolha qual template de convite usar no campo “Opt-out” do modal Templates padrão (seção 04). Sem escolha, vale o padrão Zapisp.
[2.] Envie pela integração (API do gateway) uma mensagem com a coringa @optout@ no texto.
[3.] O Zapisp dispara o template de convite para o cliente — mensagem cobrada, e só sai se o template estiver aprovado na Meta.

Convite avulso na prática — chamada da integração com a coringa @optout@ na mensagem
O que o cliente recebe
Nas três formas, o convite abre a mesma telinha de resposta:

O aviso no convite deixa claro que a escolha vale para aquele número. O convite sai em espanhol para empresas do Paraguai e em português para o resto.
04 — CONFIGURAÇÃO
Templates padrão
Aqui a empresa escolhe qual modelo de mensagem o Zapisp usa para cada tipo de envio automático — inclusive o convite de opt-out. Sem uma escolha, o Zapisp usa o modelo padrão dele.
Quando ele é usado: o template padrão de opt-out serve apenas ao convite avulso (forma 3). A campanha usa o próprio template da empresa, e a oferta ao fim da pesquisa não consome template nenhum.

Modal Templates padrão — o campo Opt-out define o template do convite avulso
05 — AUTOMAÇÃO
Oferta ao fim das pesquisas
Nas configurações de NPS e de pós-atendimento há a opção “Enviar oferta de opt-out ao fim da pesquisa”. Com ela ligada, logo depois que o cliente responde a pesquisa o Zapisp já manda o convite — sem custo, aproveitando a conversa aberta.

Pesquisa NPS · Configuração — enviar oferta de opt-out ao fim da pesquisa

Pós-atendimento (CSAT) — a mesma opção na configuração da pesquisa
06 — EXCEÇÃO
Ignorar opt-out em um template
Algumas mensagens são essenciais (cobrança, aviso de corte) e precisam sair mesmo para quem pediu para parar. Isso é definido por template:
- No editor do template há o botão “Ignorar opt-out do destinatário”.
- Os templates com ele ligado ganham o selo Ignora opt-out na listagem.
- Vale para qualquer template aprovado — mesmo os sem variáveis.

Editor do template — botão Ignorar opt-out do destinatário

Listagem de templates — selo Ignora opt-out
Atenção
Ligar “ignorar opt-out” faz a mensagem chegar em quem pediu para não receber. É para mensagem essencial — usar em promoção anula a escolha do cliente e expõe a empresa.
07 — ACOMPANHAMENTO
Status no cadastro
Dá para ver a escolha de cada cliente em dois lugares: a aba “Status do Opt-out” no cadastro do cliente, e a coluna “Opt-out Meta” nas listas de leads e de clientes.

Base de clientes — coluna Opt-out Meta

Cadastro do cliente — aba Status do Opt-out, histórico por número e Forçar desbloqueio
08 — A LÓGICA
Como o envio decide
Antes de cada envio por Meta, o Zapisp segue esta ordem:

Tudo isso vale por empresa: enquanto a funcionalidade não é ativada para uma empresa, o canal Meta se comporta exatamente como antes.
09 — DÚVIDAS
Perguntas frequentes
O opt-out bloqueia até a cobrança?
Sim — quem recusa deixa de receber tudo, inclusive a cobrança. O “ignorar opt-out” por template existe justamente para a mensagem essencial pontual.
Enquanto a funcionalidade não está ativa, muda alguma coisa?
Nada. O canal Meta dispara como sempre disparou, e nenhuma opção nova aparece. Ela é ativada empresa por empresa.
Se o cliente nunca respondeu o convite, ele é bloqueado?
Não. Sem resposta, o envio é permitido. Só bloqueia quem respondeu “não quero receber” ou “não sou cliente”.
Um cliente que saiu consegue voltar?
Não por conta própria: a telinha já respondida não aceita uma nova resposta — para mudar a escolha, ele precisaria receber um novo convite, e envios para quem saiu ficam bloqueados. Na prática, quem libera é o provedor, pelo botão “Forçar desbloqueio” na aba Status do Opt-out do cadastro; a partir daí o cliente volta a receber normalmente.
A escolha vale para todos os números da empresa?
Não. Vale por número: sair de um não afeta os outros.
Quem saiu na Z-API também está bloqueado no Meta?
Não. Os dois canais são independentes: quem saiu na Z-API pode voltar a receber pelo Meta (e vice-versa).
Enviar o convite para quem já saiu funciona?
Não — o convite passa pelo mesmo bloqueio dos demais envios: quem pediu para sair não recebe nem um novo convite. Para reabrir essa conversa, o provedor libera antes pelo “Forçar desbloqueio”.