EntrarComeçar teste grátis
Meta Tech Provider

Tratar mensagens de STOP e descadastro automaticamente

Para tratar mensagens de STOP no WhatsApp automaticamente, crie uma automação por palavra-chave que reconhece STOP e suas variações quando elas são a mensagem inteira. Ela responde com uma confirmação e chama um webhook que marca o contato como fora da lista no seu próprio cadastro. A política da Meta exige respeitar pedidos de descadastro, e as automações por palavra-chave rodam antes das respostas genéricas, então uma resposta de IA não responde no lugar delas.

O easyCoexistence conecta o número do WhatsApp Business que você mantém no app à Cloud API da Meta pela Coexistência e roda a automação por palavra-chave que responde ao STOP em segundos, com uma etapa Call my webhook assinada que entrega a saída ao seu próprio sistema e um e-mail se essa etapa falhar.

30 keywords

O máximo de palavras-chave que uma automação reconhece; basta uma delas, e maiúsculas não importam.

Is exactly

O modo de palavra-chave que só roda quando a mensagem inteira é igual a uma palavra-chave, depois de remover os espaços em volta dela.

On or off WhatsApp

A política da Meta exige que as empresas respeitem pedidos para sair da lista ou parar de receber mensagens, em qualquer canal por onde cheguem.

Quick reply

A Meta cita um botão que permite ao cliente deixar de receber marketing como um uso comum dos botões de resposta rápida.

131050

Status Failed para um template de marketing enviado a quem desativou o seu marketing em Offers and announcements.

Utility

A Meta lista a confirmação da preferência de saída do cliente como exemplo de mensagem de utilidade.

Como funciona uma automação de STOP?

É uma automação por palavra-chave com duas etapas, e ela fica no mesmo número das suas outras automações. As automações por palavra-chave são verificadas primeiro e só uma automação responde a cada mensagem, então um STOP nunca vai para a sua IA de resposta genérica nem para a sua mensagem de boas-vindas. O cliente recebe a confirmação em segundos, e o seu próprio sistema guarda a saída da lista onde as suas campanhas consultam.

1Customer writes STOPOr taps a Stop promotions button
2Has keywordIs exactly, with STOP and its variants
3Reply with textConfirms what stops and how to come back
4Call my webhookYour system marks the contact opted out
5Your listCampaigns skip the contact from now on

Quais palavras a automação deve reconhecer?

Palavras curtas com Is exactly, para que frases comuns nunca a acionem: Contains "stop" também dispararia em "nonstop" e em "don't stop the updates". Is exactly ignora maiúsculas e espaços em volta do texto, mas não a pontuação, então "STOP." precisa de uma entrada própria. Cabem até 30 palavras-chave, o suficiente para três idiomas:

  • Inglês: stop, stop., unsubscribe, opt out, stop promotions, no more messages.
  • Português: parar, pare, sair, descadastrar, não quero mais, cancelar inscrição.
  • Espanhol: baja, darme de baja, no más mensajes, detener, cancelar suscripción.
  • Rótulos de botões exatamente como estão escritos nos seus templates, como "Stop promotions".
  • Deixe de fora "cancel" e "cancelar" sozinhos: os clientes também os usam para cancelar um pedido.

Como é a automação?

Esta é a automação que uma IA cria com create_automation, ou a que você monta no editor a partir do exemplo Keyword reply. A confirmação vem primeiro, para que o cliente receba resposta mesmo que o seu sistema esteja lento, e o webhook registra a saída depois dela. Você pode adicionar uma etapa Tag, como opted_out, para que o contato também carregue a saída dentro da easyCoexistence, onde Conversas e qualquer condição conseguem vê-la. O seu endpoint responde HTTP 200 sem campo reply, o que não envia mais nada; se ele falhar, a execução é marcada como Failed e você recebe um e-mail para registrar essa saída manualmente.

create_automation arguments for STOP
{
  "connection_id": "<from list_numbers>",
  "name": "Opt-out: STOP",
  "enabled": false,
  "trigger": {
    "type": "message_received",
    "match": "keyword",
    "keyword_mode": "exact",
    "keywords": ["stop", "stop.", "unsubscribe", "stop promotions",
                 "parar", "sair", "descadastrar", "baja", "darme de baja"]
  },
  "steps": [
    { "type": "reply_text",
      "text": "Done, {{first_name}}. Bloom Store will not send you offers on WhatsApp anymore. Order updates still arrive. Reply START to subscribe again." },
    { "type": "call_webhook",
      "url": "https://example.com/hooks/whatsapp-opt-out" }
  ]
}

O que o seu sistema recebe e armazena?

Um POST em JSON assinado em X-EC-Signature com o Signing secret da automação, exibido na etapa Call my webhook. Os campos que importam são contact.wa_id, o número do cliente em formato internacional, só com dígitos, message.text, a palavra que ele enviou, message.at e automation.name. Verifique a assinatura e depois marque esse número como fora da lista, com o horário e a palavra, no CRM, banco de dados ou planilha que as suas campanhas consultam. Não grave nada quando dry_run for true, o que indica um teste feito em Try it. Os contatos do easyCoexistence guardam campos e tags, mas nunca alimentam as suas campanhas, então o registro que a sua ferramenta de envio consulta é o que vale.

Como o cliente sai da lista sem escrever STOP?

De três outras formas, e duas nunca chegam ao chat. Um toque em um botão de resposta rápida "Stop promotions" chega como uma mensagem com esse texto, então a mesma automação responde quando o rótulo está entre as suas palavras-chave. Desativar as suas ofertas na configuração Offers and announcements do WhatsApp não envia nada para você; o próximo template de marketing falha com o erro 131050 e, com mensagens roteadas pela easyCoexistence e uma Forward URL, esse status de falha chega ao seu sistema, que deve gravar a mesma marcação. Bloquear o número interrompe a entrega por completo. A política da Meta também cobre pedidos de saída por e-mail, telefone ou presencialmente, então todos os canais devem gravar na mesma lista.

Como alguém volta a se inscrever?

Com uma segunda automação por palavra-chave que espelha a primeira: Has keyword, Is exactly, com START, "subscribe", "voltar" e "alta"; uma etapa Reply with text que confirma o que o cliente voltará a receber e identifica a sua empresa; e uma etapa Call my webhook que remove a marcação. Quem escreve START está dando permissão com as próprias palavras, então grave o horário e a mensagem como o novo registro de consentimento. Mencione START na confirmação do STOP para que os clientes saibam como voltar.

Como configurar

  1. Build the opt-out endpointExpose an HTTPS endpoint, or an n8n Webhook node, that verifies X-EC-Signature, sets the opted-out flag for contact.wa_id and returns HTTP 200 with no reply.
  2. Create the STOP automationStart from Keyword reply, set Has keyword to Is exactly, add the words and button labels, write the confirmation, then add Call my webhook with your URL. Set the switch to Off.
  3. Copy the Signing secretSave the automation, select its Call my webhook step and copy the Signing secret into your endpoint's configuration.
  4. Test the wordsClick Test and send "STOP", "stop." and "please don't stop" in Try it: the first two should run, the third should not. Then switch it On and save.
  5. Add START and the status checkCreate the START automation, and have your system treat failed statuses with error 131050 as an opt-out from marketing.

Erros comuns

  • Usar Contains com "stop" ou "sair". Contains encontra a palavra dentro de frases mais longas, então "hoje não consigo sair do trabalho" tira da lista um cliente que nunca pediu isso.
  • Devolver {"reply": "..."} do endpoint de saída depois de uma etapa Reply with text. A automação envia as duas, e o cliente recebe duas confirmações.
  • Registrar a saída só nos chats do WhatsApp. Se as campanhas saem de outra ferramenta que nunca lê a lista, o próximo envio chega a quem pediu para parar.
  • Repetir o envio de templates de marketing que falharam com 131050. A pessoa desativou as suas ofertas no WhatsApp; repetir só acumula erros e arrisca bloqueios.
Fazendo isso com o EasyCoexistence

Automações não têm custo extra. De US$ 9 até US$ 0,75 por número por mês, caindo conforme você adiciona números, com os primeiros 3 dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Mandar STOP bloqueia a minha empresa no WhatsApp?

Não. STOP é uma mensagem comum, e o próprio WhatsApp não faz nada com ela, então parar de enviar depende de você. Por isso a automação registra o pedido. O cliente também pode bloquear o número ou desativar as suas ofertas no WhatsApp, o que interrompe a entrega do lado da Meta.

As atualizações de pedido devem parar quando o cliente manda STOP?

Defina o que o STOP abrange e diga isso na confirmação. As orientações da Meta sobre consentimento sugerem instruções claras para sair de categorias específicas, então uma escolha comum é o STOP encerrar as ofertas enquanto as atualizações de pedido continuam, com outra palavra-chave para parar tudo.

Minha IA consegue tratar pedidos de descadastro escritos em frase?

Ela consegue responder a eles, mas não registrá-los: uma etapa Reply with AI só escreve texto. Um agente de IA pode adicionar uma tag que você permitir, como opted_out, ou iniciar a sua automação STOP quando o pedido for claro, e você também pode criar uma segunda automação por palavra-chave em modo Contains para frases mais longas, como "me descadastre", com as mesmas duas etapas.

E se o cliente mandar STOP fora do horário comercial?

A automação de STOP responde do mesmo jeito. As automações por palavra-chave são verificadas antes das automações After hours, First message e Every message, então uma mensagem de ausência nunca responde a um pedido de saída no lugar dela.

Continue lendo

Pronto para começar?

Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.

Começar teste grátis

Verificado em