Como funcionam o opt-out, o consentimento e os relatórios de custo na WACRM

A WACRM te dá três formas independentes de ficar seguro e no controle do custo no WhatsApp: uma baixa automática que bloqueia os futuros envios de modelo e transmissão para um contato sem precisar de configuração, um registro de consentimento que condiciona cada transmissão, e um relatório de custo que você pode obter pela API. Este guia percorre as três coisas como funcionam hoje — incluindo a única peça, uma tela de relatório de custo no Workspace, que ainda não existe.

O que você precisa antes de começar

• Uma conta WACRM Workspace com pelo menos um projeto e uma conversa com algum contato, para as seções de opt-out e consentimento.
• Acesso de owner ao workspace e uma forma de chamar uma API HTTP (curl ou similar), para a seção do relatório de custo — a tela que gera a API key é só para o owner.

Pare o envio para um contato — palavras-chave de opt-out

A WACRM verifica toda mensagem de texto recebida — no WhatsApp, SMS, Messenger e Instagram — em busca de uma palavra-chave de opt-out exata, sem diferenciar maiúsculas de minúsculas, depois de remover pontuação e espaços extras — uma frase que só contém a palavra não conta. Assim que um contato envia uma, a WACRM registra a baixa para o canal por onde ela chegou. No WhatsApp, toda tentativa posterior de enviar um modelo ou uma transmissão para ele é então bloqueada com um erro consent_required, automaticamente, sem nada para você configurar — uma resposta de texto livre para esse contato dentro de uma janela de 24 horas aberta continua passando:

A WACRM não responde nada quando isso acontece — sem confirmação automática — e essa mesma mensagem também fica de fora da resposta automática de IA da WACRM. As baixas são registradas por canal, então STOP em um canal não tira o contato de outro:

SMS, Messenger e Instagram nunca exigem um opt-in antes — só uma baixa explícita bloqueia um envio. Os envios de modelo e transmissão pelo WhatsApp são o oposto: precisam de um opt-in registrado (próxima seção). Voltar a assinar também não é automático (veja as perguntas frequentes) — trate uma baixa como algo que você precisa reverter deliberadamente, do mesmo jeito que a registrou.

Exija consentimento antes de transmitir — o cartão de consentimento do Inbox

O opt-in de marketing por WhatsApp registrado de um contato é o único sinal que o sistema de transmissões da WACRM verifica antes de enviar um modelo para ele. Para registrar um:

1. Abra Conversations → Inbox e selecione a conversa do contato.
2. Encontre o cartão Consentimento de marketing por WhatsApp no painel lateral. Ele mostra o status atual do contato e, se existir, quando foi registrado pela última vez.
3. Clique em Registrar aceite (ou Registrar recusa), adicionando opcionalmente uma nota curta em Origem / comprovação sobre de onde veio o consentimento.

Esse cartão não é uma certificação legal — registrar o aceite só diz à WACRM que o comércio afirma que esse cliente concordou em receber mensagens de marketing por WhatsApp. Mas é o registro que as transmissões realmente usam: inicie uma campanha em Messaging → Broadcasts e cada destinatário sem opt-in registrado é pulado — nada é enviado para ele, e o contador Skipped da campanha sobe, com o texto No opt-in consent — enquanto a campanha continua para todos os outros. Veja o guia do primeiro modelo para o passo a passo completo de uma transmissão.

Obtenha um relatório de custo e uma previsão pela API

Ainda não existe uma tela de relatório de custo no Workspace — isso funciona só pela API, e só o owner do workspace consegue chegar à tela que gera a key.

1. Como owner, abra Developer / API & MCP na barra lateral do Workspace (/settings).

2. Crie uma nova key — uma Secret key (sk_live_…) para um servidor ou script — e marque Restrict what this key can do (advanced).

3. Dentro de WhatsApp CRM scopes, marque cost_reports:read e crie a key. Ela aparece uma única vez — copie imediatamente.

   Criar keys e restringir seus scopes depende do seu plano — o Workspace mostra um aviso de upgrade se o seu não incluir isso.

4. Chame o endpoint do relatório de custo com essa key:

   Code Copy

   curl -s "https://api.wacrm.ai/v1/crm-projects/{project}/cost-report?date_from=2026-10-01&date_to=2026-10-31" \
     -H "Authorization: Bearer sk_live_your_scoped_key"

{project} é o UUID do seu projeto; precisa ser o mesmo projeto ao qual sua key pertence — outro projeto, mesmo que também seja seu, retorna 404. As datas usam YYYY-MM-DD, o intervalo não pode passar de 366 dias, e um intervalo inválido ou invertido retorna um erro 400 em vez de uma resposta chutada.

A resposta divide o gasto por categoria de mensagem — marketing, utility, authentication e service — e inclui uma previsão: para cada categoria, a WACRM soma o gasto estimado dos 30 dias anteriores a hoje, divide por 30 (dias sem dados contam como zero) e multiplica por 30 para estimar os próximos 30 dias, marcado como estimate: true; uma categoria sem dados nessa janela retorna null, não 0. O relatório cobre só mensagens de WhatsApp: envios por SMS, Messenger e Instagram e mensagens com falha não são contados, e mensagens enviadas antes de o acompanhamento de custos começar não entram. Cada número aqui é construído com as tarifas de estimativa próprias da WACRM (placeholder), que podem diferir bastante do que a Meta realmente cobra — nunca os leia como uma fatura confirmada da Meta nem como um preço. Para as tarifas reais da Meta por mensagem e por país, veja o guia de preços de mensagens.

O que funciona hoje / o que precisa da WACRM

Pronto para colocar isso em prática com o seu próprio número? Peça acesso antecipado para ter um Workspace, ou deixe a equipe da WACRM configurar a captura de consentimento e o monitoramento de custo para você com o Quick Setup.