Manual de Boas Práticas — WhatsApp API + GHL

📱

Manual Operacional — Versão 1.0

Boas Práticas em
Disparos WhatsApp
via API Oficial

Guia completo para o time operar campanhas com segurança, qualidade e resultados no GoHighLevel + Meta Cloud API.

📲 WhatsApp Business API ⚡ GoHighLevel 📊 Meta Cloud API ✅ Boas Práticas 2026

ℹ️

Para quem é este manual? Este documento é obrigatório para toda pessoa do time que for operar, criar, revisar ou aprovar qualquer disparo de WhatsApp via GoHighLevel. Leia, salve e consulte antes de cada campanha.

1

Como a Meta PensaO princípio fundamental + sinais

2

Qualidade do NúmeroVerde / Amarelo / Vermelho

3

Sistema de TiersLimites diários e como subir

4

Higienização da BaseObrigatório antes de disparar

5

TemplatesCriar, aprovar e o que evitar

6

Estratégia de DisparoVolume, horário e cadência

7

Configuração no GHLPasso a passo do Bulk Action

8

MonitoramentoMétricas e alertas durante o envio

9

Recuperação de QualidadeO que fazer se cair

10

Checklist Pré-DisparoNão dispare sem marcar tudo

11

Erros Mais Comuns11 erros e como evitar

12

GlossárioTodos os termos técnicos

⚡ Regra dos 40%

Nunca dispare mais de 40% do tier para leads frios

🕐 Horário Seguro

Sempre entre 08h e 17h em dias úteis

📨 2 Tentativas Max

Quem não respondeu vai para DND — nunca 3ª mensagem

1

Como a Meta Pensa

O que você precisa entender antes de qualquer disparo

O Princípio Fundamental

A Meta não é uma ferramenta de marketing em massa. Ela é uma plataforma de comunicação que tolera marketing desde que respeite a experiência do usuário.

O algoritmo da Meta funciona como um sistema de reputação contínuo. Toda mensagem enviada alimenta um score invisível. Esse score define se suas próximas mensagens chegam ou não.

✗ Sinais Negativos (qualidade cai)

Contato bloqueia após receber mensagem
Contato denuncia como spam
Mensagem enviada mas nunca lida
Alta taxa de erros de entrega
Muitas mensagens sem nenhuma resposta

✓ Sinais Positivos (qualidade sobe)

Contato responde a mensagem
Contato salva o número
Conversa ativa (vai e volta)
Baixa taxa de bloqueio
Alta taxa de leitura

O Conceito de Comportamento Humano

A Meta compara seu padrão de envio com o comportamento humano natural. Se algo é humanamente impossível, ela entende como automação abusiva.

🚫 Bloqueio imediato

10.000 mensagens em 10 minutos — impossível para humano

⚠️ Suspeito

1 mensagem exatamente a cada 3 segundos durante 8h — padrão de robô

✅ Aprovado

100 mensagens/hora com variação em horário comercial — parece humano

💡

Regra de ouro Quanto mais seu disparo parecer um vendedor humano enviando mensagens individualmente, melhor será sua performance e qualidade.

⚠️

Atenção: Coexistência Se seu número está em modo Coexistência (app + API ao mesmo tempo), a Meta avalia o comportamento dos dois juntos. Disparos pelo app pessoal fora do horário comercial prejudicam a qualidade medida pela API.

2

Qualidade do Número

O ativo mais valioso da operação — cuide como um patrimônio

Os Três Estados de Qualidade

Status	Cor	Significado	O que fazer
Alta	🟢 Verde	Mensagens chegam bem, reputação boa	Manter boas práticas
Média	🟡 Amarelo	Alguns reclamaram, risco crescente	Reduzir volume, revisar templates
Baixa	🔴 Vermelho	Muitos bloqueios/denúncias	Pausar IMEDIATAMENTE

Onde Verificar a Qualidade

🖥️ No GoHighLevel

Configurações → WhatsApp → Números → Ver classificação de qualidade

📊 No Meta Business Manager

business.facebook.com → Contas do WhatsApp → Número → Insights

⚠️

GHL vs Meta — Podem divergir! O GHL mede apenas conversas iniciadas pela API. O Meta mede TODAS as conversas (app + API). Se o GHL mostra Vermelho mas o Meta mostra Alto, significa que problemas foram criados especificamente pelos disparos em massa via API.

Impacto da Qualidade na Operação

📉 Capacidade de Envio

Qualidade baixa pode reduzir seu tier e limitar o número de disparos diários

💬 Taxa de Entrega

Mensagens podem ser marcadas como "entregues" mas nunca aparecer para o destinatário

📋 Templates

Templates com baixa performance são pausados automaticamente pela Meta

🔒 Conta

Qualidade persistentemente baixa pode resultar em restrição permanente da conta

🦁

Metáfora para o time Pense no número de WhatsApp como uma pontuação de crédito. Leva tempo para construir, é fácil de destruir e a recuperação é lenta. Cuide como um ativo valioso — porque é.

3

Sistema de Tiers

Seus limites diários de envio e como subir de nível

O que são Tiers

A Meta controla quantas novas conversas você pode iniciar por dia. Isso é chamado de Tier (nível). Cada tier tem um limite diferente.

250

Tier 0

Novo

1K

Tier 1

Verificado

2K

Tier 2

Crescendo

10K

Tier 3

Escalando

100K

Tier 4

Avançado

∞

Tier 5

Enterprise

🚨

Regra importante — Desde outubro/2025 Os limites são por portfólio (WABA), não por número. Se você tem 2 números no mesmo WABA com limite de 2.000/dia, eles compartilham esse total — não são 2.000 cada.

Como Subir de Tier (Automático)

A Meta avalia a cada 6 horas se você pode subir. Para subir, todos os critérios abaixo devem ser atendidos:

Qualidade está em Verde ou Amarelo (NUNCA Vermelho)
Usou pelo menos 50% do limite atual nos últimos 7 dias consecutivos
Não houve violações de política recentes

Regra dos 500

⏱️

Pausa automática de 24h A Meta exige aguardar 24 horas após iniciar conversas com 500 contatos em um único dia. Isso é automático — o sistema pausará os envios. Não é bug — é política. Planeje o disparo considerando essa pausa.

4

Higienização da Base

Obrigatório antes de qualquer disparo — sem exceção

🚫

Por que é obrigatório? Cada número inválido, fixo ou bloqueado que você dispara é um erro que a Meta contabiliza contra você. Com 30% de erros numa campanha, sua qualidade cai imediatamente. Uma base não higienizada já foi a causa de qualidade Vermelha em contas reais.

Classificação dos Números

Tipo	Formato	WhatsApp?	Ação
✅ Celular válido	+55 + DDD + 9 + 8 dígitos = 13 dígitos	Sim	Disparar
⚠️ Celular antigo	+55 + DDD + 8 dígitos = 12 dígitos	Talvez	Corrigir (add 9)
❌ Telefone fixo	1º dígito após DDD = 2, 3, 4 ou 5	Nunca	Remover
⚠️ Internacional	Não começa com +55	Verificar	Segmentar separado
❌ Sem número	Campo vazio	Não	Remover do disparo

Como Identificar Telefone Fixo

Formato: +55 [DDD] [PRIMEIRO DÍGITO]...

Se o primeiro dígito após o DDD for:
  2, 3, 4 ou 5  →  FIXO  →  não tem WhatsApp  →  NÃO disparar ❌
  6, 7, 8 ou 9  →  CELULAR  →  pode ter WhatsApp  →  ok ✅

Exemplos:
  +5511 3333-4444  →  fixo (começa com 3)  ❌
  +5511 99999-9999  →  celular (começa com 9)  ✅
  +5521 98765-4321  →  celular  ✅
  +5521 2222-3333  →  fixo  ❌

Validação de WhatsApp Ativo

Higienizar o formato não garante que o número tem WhatsApp ativo. Para bases grandes (acima de 5.000), use serviços de validação:

🇧🇷 Z-API

Recomendado para BR. Checa se o número tem WhatsApp sem enviar mensagem.

🌐 Twilio Lookup

Verifica se o número é válido e ativo internacionalmente.

🏢 Infobip

Solução enterprise com verificação em massa.

💰

Custo estimado: R$ 0,01 a R$ 0,05 por número. Para 10.000 números = R$ 100 a R$ 500. Vale o investimento — evita milhares em conversas cobradas com erro e protege a qualidade do número.

5

Templates

Como criar, o que evitar e como garantir aprovação

🔑

Sem template aprovado = impossível disparar em massa. Template é uma mensagem pré-aprovada pela Meta para iniciar conversas com contatos que não te enviaram mensagem nas últimas 24h.

Categorias de Template

Categoria	Uso	Custo	Aprovação
Marketing	Promoções, lançamentos, reativação	Mais caro	Mais rigorosa
Utilidade	Confirmações, lembretes, atualizações	Médio	Moderada
Autenticação	Códigos de verificação (OTP)	Mais barato	Mais fácil

Estrutura de um Bom Template

Saudação

"Oi, {{1}}!" — personalizada com o nome

Contexto

"Aqui é a equipe da [Empresa]." — quem você é

Valor / Motivo

Máx. 3-4 linhas — seja direto e claro

Call to Action

Preferencialmente uma pergunta: "Posso te contar mais?"

Opt-out ⚠️

"Para sair, responda SAIR." — obrigatório em Marketing

✅ PODE usar

Variáveis {{1}} {{2}} {{3}}
URL de domínio próprio verificado
Emojis com moderação
Botões de resposta rápida (até 3)
Botão de opt-out
Texto em português correto

❌ NÃO PODE usar

Variáveis (NOME) [NOME] {NOME}
URLs encurtadas (bit.ly, etc.)
"oferta imperdível", "última chance", "grátis"
Dados sensíveis (CPF, cartão)
Ausência de opt-out em Marketing

Por que Terminar com Pergunta?

Template sem pergunta	Template com pergunta
Só clique no link	Resposta + clique no link
0 sinal de engajamento	1 sinal positivo para a Meta
Qualidade estável ou cai	Qualidade mantida ou sobe
Sem janela de 24h aberta	Abre janela de 24h livre de templates

⏱️ Prazo médio

24 horas (máx. 48h). Black Friday/datas comemorativas: até 72h

📅 Planejamento

Submeta o template com pelo menos 3 dias de antecedência do disparo

🖥️ Onde criar

GHL → Configurações → WhatsApp → Modelos → + Criar. Nunca pelo Meta direto!

6

Estratégia de Disparo

Volume, horário, cadência e distribuição segura

A Regra dos 40%

📏

Nunca dispare mais de 40% do seu limite diário de tier para leads frios.
Tier 2.000/dia → máximo recomendado = 800 disparos/dia para leads frios.
Por quê? Leads frios têm baixa taxa de resposta. Disparar no máximo + baixa resposta = qualidade cai = você perde o tier.

Volume por Temperatura do Lead

Temperatura	Descrição	Volume seguro/dia
🔥 Quente	Comprou, respondeu, clicou nos últimos 30 dias	Até 80% do tier
🌡️ Morno	Interagiu há 31–90 dias	Até 60% do tier
🧊 Frio	Nunca interagiu ou +90 dias sem interação	Até 40% do tier

Distribuição por Horário — Simule Comportamento Humano

08h–09h (abertura)

10%

09h–11h (pico matinal)

25%

11h–12h (pré-almoço)

15%

12h–13h30 (almoço)

5%

13h30–15h (retomada)

15%

15h–17h (pico tarde)

25%

17h–18h (encerramento)

5%

🚫

Nunca dispare: Antes das 08h ou após as 20h | Fins de semana para B2B | Feriados nacionais

Sequência para Leads Frios — Máximo 2 Tentativas

📨

Dia 1 — Mensagem 1

Template de abertura com pergunta. Se respondeu → atendimento humano imediato.

⏳

Aguardar 48–72h

Se não respondeu, aguardar antes de nova tentativa.

📨

Dia 3 — Mensagem 2

Template de follow-up diferente. Se respondeu → atendimento. Se não respondeu → DND.

🔕

Sem engajamento → DND

TAG "sem-engajamento" + ativar DND WhatsApp. Nunca 3ª mensagem.

7

Configuração no GHL

Passo a passo do Bulk Action — WhatsApp em Massa

Passo a Passo do Disparo em Massa

1

Selecionar contatos

Contatos → Filtrar por tag ou Smart List → Selecionar todos

2

Abrir Bulk Action

Ação em Massa → WhatsApp em Massa

3

Selecionar template

Escolher apenas templates com status Ativo/Aprovado

4

Modo: DRIP (Gradual)

⚠️ NUNCA use "Carregar tudo de uma vez" para listas grandes

5

Configurar lote e intervalo

Lote: 5 mensagens | Repetir após: 3 Minutos

6

Janela de tempo

Início: 08h00 | Fim: 17h00 | Dias: Seg–Sex apenas

Configurações de Lote Recomendadas por Temperatura

Temperatura	Lote (msgs)	Intervalo	Total/hora
🔥 Leads quentes	10	3 minutos	~200/hora
🌡️ Leads mornos	5	3 minutos	~100/hora
🧊 Leads frios	5	3 minutos	~100/hora

Smart Lists — Organize Antes de Disparar

📋 disparo-D1

Lote do primeiro dia. Remover após envio.

📋 disparo-D2

Lote do segundo dia. Configurar após D1.

💬 responderam

Quem respondeu. Excluir de novos disparos.

🔕 sem-engajamento

Não respondeu após 2x. Ativar DND.

⚙️

Configure o Workflow ANTES de disparar
Trigger: mensagem recebida → Remover tag "disparo-pendente" → Adicionar tag "respondeu-wpp" → Notificar time comercial → Se sem resposta do time em 4h → Bot responde automaticamente.

8

Monitoramento Durante o Disparo

Métricas, frequência e sinais de alerta

Métricas Obrigatórias

Métrica	✅ Saudável	⚠️ Atenção	🚨 Pausar
Taxa de entrega	> 90%	80–90%	< 80%
Taxa de leitura	> 20%	10–20%	< 10%
Taxa de resposta	> 15%	5–15%	< 5%
Taxa de erro	< 5%	5–15%	> 15%
Taxa de bloqueio*	< 1%	1–3%	> 3%

*Bloqueio: Meta Business Manager → Contas do WhatsApp → Número → Insights

🚨

Pause a campanha IMEDIATAMENTE se: Erros > 15% | Qualidade mudou para Amarelo durante o disparo | Mais de 10 denúncias em sequência | Taxa de leitura < 8% após 200 mensagens

9

Recuperação de Qualidade

O que fazer quando a qualidade cai

🟡 Qualidade Amarela — 7 passos

Pausar todos os disparos em massa
Manter atendimentos em andamento
Analisar template com maior bloqueio
Revisar e melhorar o template
Aguardar 24–48 horas
Retomar com 20% do tier máximo
Priorizar leads quentes

🔴 Qualidade Vermelha — Emergência

Pausar tudo — sem exceção
Não tente recuperar com mais disparos
Abrir chamado no suporte GHL
Responder só conversas por iniciativa do lead
Aguardar 7 dias sem disparos
Retomar com base quente, 100/dia

Tempo Médio de Recuperação

Situação	Tempo estimado
🟡 Amarelo → 🟢 Verde	3–7 dias com boas práticas
🔴 Vermelho → 🟡 Amarelo	7–14 dias sem disparos
🔴 Vermelho → 🟢 Verde	14–30 dias

10

Checklist Pré-Disparo

Use obrigatoriamente antes de cada campanha — imprima esta página

🔒

Não dispare sem marcar todos os itens abaixo. Este checklist é obrigatório. Se algum item não puder ser marcado, o disparo deve ser adiado.

📋 Base de Contatos

Lista higienizada — sem fixos, sem inválidos
DND verificado — contatos removidos
Duplicatas removidas
Segmentação feita (quente/morno/frio)
Volume calculado — max 40% do tier para frios

📝 Template

Template criado pelo GHL (não pelo Meta)
Variável no formato {{1}}
Status: Ativo / Aprovado
Opt-out incluído
URL sem encurtador
Testado em número pessoal

⚙️ Configuração GHL

Tipo: DRIP — não Imediato
Lote: 5 msgs / 3 minutos
Horário: 08h00 – 17h00
Dias: Seg–Sex apenas
Smart List correta selecionada
Workflow de resposta ativo

🗓️ Monitoramento

Responsável designado para acompanhar durante todo o disparo
Critérios de pausa definidos e conhecidos (ver Seção 8)
Time de atendimento avisado — respostas irão chegar
Relatório de encerramento programado para o fim do dia

✅ Todos marcados?

Então você está pronto para disparar com segurança.

11

Erros Mais Comuns

11 erros que já destruíram campanhas — e como evitar

Erro 1 — Disparar toda a base de uma vez

🔴 10.000 msgs de uma vez = pico anormal = Meta detecta automação abusiva

✅ Dividir em lotes diários de no máximo 40% do tier

Erro 2 — Usar template com data fixa

🔴 Template expira após a data, precisa criar outro do zero

✅ Usar variável {{2}} para datas — reutilizável

Erro 3 — Variável no formato errado

🔴 (NOME DA PESSOA) não é substituído — contato recebe assim literalmente

✅ Sempre usar {{1}} para o primeiro campo variável

Erro 4 — Disparar lista não higienizada

🔴 20–30% de erros instantaneamente — qualidade despenca

✅ Higienização obrigatória antes de qualquer campanha

Erro 5 — Criar template no Meta diretamente

🔴 Template não aparece no GHL — impossível usar no disparo

✅ Criar sempre pelo GHL → Configurações → WhatsApp → Modelos

Erro 6 — Sem workflow de resposta

🔴 Leads respondem e ficam sem retorno — perda de oportunidade

✅ Workflow automático de resposta configurado ANTES de disparar

Erro 7 — 3ª tentativa para quem não respondeu

🔴 Alta taxa de bloqueio e denúncia — qualidade em colapso

✅ Máximo 2 tentativas. Sem resposta = DND

Erro 8 — Ignorar métricas durante o disparo

🔴 Problemas se acumulam sem intervenção — destrói a qualidade

✅ Monitorar a cada 1–2h, especialmente nas primeiras 500 msgs

Erro 9 — Usar URL encurtada (bit.ly, etc.)

🔴 Meta bloqueia o template — não consegue verificar o destino

✅ Usar sempre o domínio completo da empresa

Erro 10 — Não respeitar horário comercial

🔴 Mensagens às 23h = silenciamento e bloqueio em massa

✅ Disparar apenas entre 08h e 20h; B2B: 09h–18h dias úteis

Erro 11 — Múltiplos workflows de disparo simultâneos

🔴 Vários disparos ao mesmo tempo para base fria = sobrecarga = bloqueios em cascata

✅ Máximo 1 campanha de disparo ativa por vez. Finalizar antes de iniciar outra.

12

Glossário

Todos os termos técnicos que o time precisa conhecer

WABA

WhatsApp Business Account — a conta empresarial vinculada ao Meta

Tier

Nível de capacidade de envio (250 / 1K / 2K / 10K / 100K / ilimitado)

Template

Mensagem pré-aprovada pela Meta para iniciar conversas

Bulk Action

Funcionalidade do GHL para disparos em massa

Drip

Modo de envio gradual (ex: 100/hora), oposto ao Imediato

DND

Do Not Disturb — contato marcado para não receber mensagens

Opt-in

Consentimento do contato para receber mensagens

Opt-out

Mecanismo para o contato solicitar saída da lista

Qualidade

Score do número (Verde/Amarelo/Vermelho) baseado no comportamento dos destinatários

Portfólio (WABA)

Agrupamento de números que compartilham limites e configurações

Taxa de entrega

% de mensagens que chegaram ao aparelho do destinatário

Taxa de leitura

% de mensagens abertas pelo destinatário

Taxa de bloqueio

% de contatos que bloquearam o número após receber mensagem

Smart List

Lista dinâmica no GHL baseada em filtros automáticos

Janela de 24h

Período após resposta do contato em que você pode enviar msgs livres sem template

Lead frio

Contato sem interação há mais de 90 dias ou que nunca interagiu

Lead quente

Contato que interagiu (respondeu, clicou) nos últimos 30 dias

Coexistência

Modo que permite usar o mesmo número no app e na API simultaneamente

⚡

Os 10 Mandamentos do Disparo

Cole na parede. Leia antes de cada campanha. Sem exceções.

1
NUNCA dispare para lista não higienizada — fixos e inválidos destroem sua qualidade
2
NUNCA use mais de 40% do tier para leads frios — a margem de segurança é obrigatória
3
SEMPRE use DRIP — nunca "Imediato" em listas grandes
4
SEMPRE inclua opt-out em templates de Marketing — é exigência da Meta
5
SEMPRE use variáveis no formato {{1}} — nunca (NOME) ou [NOME]
6
SEMPRE crie templates pelo GHL — nunca diretamente pelo Meta Business Manager
7
NUNCA dispare fora do horário comercial — 08h às 17h em dias úteis
8
NUNCA envie mais de 2 mensagens para quem não respondeu — sem resposta = DND
9
SEMPRE monitore as métricas a cada hora durante o disparo — especialmente nas primeiras 500
10
Se a qualidade cair para Vermelho: PARE TUDO imediatamente — nunca tente "recuperar com mais disparos"

Manual elaborado com base nas políticas do Meta WhatsApp Business Platform

e nas boas práticas do GoHighLevel. Revisar a cada 3 meses ou após mudanças de política.

v1.0

Maio 2026