Guia Skala · API Oficial WhatsApp

Manual de uso da API Oficial com foco em templates que a Meta aprova.

Exemplos prontos de Marketing, Utilidade e Autenticação, critérios usados pela Meta, e o que evitar para não levar reprovação ou rebaixamento da linha.

3
categorias oficiais
9+
exemplos prontos
1
guia direto
Primeiros dias

Aquecimento do número (dias 1–15)

O início é o período mais sensível. A Meta avalia o comportamento do número nas primeiras semanas para liberar volume e melhorar o Quality Rating.

Faça

  • • Comece com baixo volume (10–50 mensagens/dia)
  • • Envie só para contatos com opt-in recente
  • • Use mensagens 1:1 personalizadas, sem template
  • • Misture com horários humanos (não madrugada)

Evite

  • • Disparar em massa no primeiro dia
  • • Copy promocional pesada antes do aquecimento
  • • Repetir o mesmo script para contatos diferentes
  • • Importar listas frias e disparar de uma vez

Como funciona o aquecimento na prática: o número precisa atingir 250 conversas/24h para subir ao Tier 1.000. É necessário atingir 1.000 conversas iniciadas por empresa em uma janela de 7 dias com qualidade Média ou Alta. O mesmo modelo se repete para os próximos tiers (10.000 → 100.000 → ilimitado), sempre dobrando o volume com qualidade estável.

Escala

Limites e Tiers de mensageria

Cada tier libera mais conversas iniciadas por 24h. Subir depende de volume sustentado e Quality Rating mantido.

TierLimite / 24hRequisito para subir
Inicial250Qualidade Média/Alta por 7 dias + atingir o volume
Tier 11.000Atingir 2x o limite anterior em 7 dias
Tier 210.000Manter qualidade + dobrar o volume
Tier 3100.000Histórico consolidado
Tier 4IlimitadoOperação madura e estável

O limite é avaliado a cada 24h móveis, no momento em que a conversa que atingiu o teto foi iniciada — não à meia-noite.

Reputação

Quality Rating

A classificação é baseada no feedback dos destinatários: bloqueios, denúncias, respostas negativas e taxa de leitura/resposta.

Alta

Comunicação saudável, sem ação necessária.

Média

Volume de perto, reduza o ritmo de envios.

Baixa

Status mudou para 'Sinalizado' — sem aumento de tier. Acima de 7 dias mantendo, vai para 'Conectado'. Se continuar baixa, vira 'Em revisão'.

Status possíveis

  • ConectadoOperação normal.
  • SinalizadoQualidade baixa, sem aumento de tier.
  • Em revisãoLimite de mensagens atingido, aguarde queda do envio.
Sinal

Engajamento

O que mais derruba a qualidade do número é a falta de interação. A Meta lê silêncio como spam.

  • Baixa taxa de resposta e leitura
  • Muitos usuários bloqueando ou denunciando como spam
  • Mensagens fora do contexto esperado pelo cliente
  • Conteúdo promocional excessivo em template de Utilidade

Sempre que possível, set-in-set-out: peça para o canal (forms, site, e-mail) antes de iniciar conversas via WhatsApp. Deixe claro o tipo e frequência de mensagens que o contato receberá, e ofereça opção fácil de saída.

Cadência

Frequência de envios

Disparos repetidos para a mesma base derrubam taxa de leitura e elevam denúncias.

Contato repetido na mesma base

Evite reabordar a mesma base de contatos em um intervalo menor que 24h, especialmente com o mesmo template ou oferta. Isso aumenta drasticamente a taxa de bloqueio e pode derrubar a qualidade do número.

Linguagem

Palavras e tom

A escolha de palavras pesa na avaliação automática da Meta antes mesmo da resposta humana.

  • Evite termos como "incrível", "última chance", "grátis", "promoção" em excesso — soa como spam
  • Evite ALL CAPS e excesso de pontos ou exclamações !!!
  • Evite tom comercial agressivo, como mensagem de uma pessoa real
  • Em mensagens de Utilidade / autenticação, foco estritamente transacional
Categorias

As 3 categorias de template do WhatsApp

Escolher a categoria correta é o primeiro filtro de aprovação. A Meta reclassifica automaticamente quando identifica desvio de intenção.

Marketing

Promoções, ofertas, novidades, lançamentos, reengajamento e recomendações.

  • Exige opt-in claro
  • Precisa de opção de sair
  • Sujeito a reclassificação

Utilidade

Atualizações de pedido, lembretes, faturas, agendamentos, status de serviço.

  • Deve ser transacional
  • Sem tom promocional
  • Disparo livre dentro do contexto

Autenticação

Códigos de verificação OTP, confirmação de login e validação em dois passos.

  • Somente código + instrução
  • Sem CTA promocional
  • Botão de copiar código
Biblioteca

Exemplos de templates prontos

Templates genéricos que podem ser adaptados. Mantenha variáveis com contexto, identifique a marca e respeite a categoria.

Marketing

MarketingPromocional

🔥 Black Week começou, {{1}}!

Separamos as ofertas que mais combinam com você. Até 40% OFF em itens selecionados, só até domingo. Quer dar uma olhada?

Você recebe porque optou em nossa lista. Cancelar: responda SAIR.

Ver ofertas
Falar com atendente

12:30 ✓✓

Variáveis

{{1}} nome
MarketingReengajamento

Faz tempo que a gente não se fala 👋

Oi {{1}}! Voltamos com novidades pensadas pra quem já é cliente: 15% OFF na próxima compra com o cupom VOLTEI15. Válido por 7 dias.

Para parar de receber, responda SAIR.

Resgatar cupom

12:30 ✓✓

Variáveis

{{1}} nome
MarketingLançamento

Novidade que combina com você

{{1}}, lançamos a coleção {{2}} — peças pensadas pra quem comprou conosco antes. Quer ser uma das primeiras a ver?

Cancelar: responda SAIR.

Ver coleção

12:30 ✓✓

Variáveis

{{1}} nome{{2}} coleção

Utilidade

UtilidadePós-venda

Pedido #{{1}} confirmado ✅

Oi {{2}}, recebemos seu pedido e já estamos preparando. Previsão de envio: {{3}}. Você pode acompanhar o status pelo link abaixo.

Acompanhar pedido

12:30 ✓✓

Variáveis

{{1}} pedido{{2}} nome{{3}} data
UtilidadeLembrete

Sua consulta está chegando

{{1}}, lembramos que sua consulta com Dr(a). {{2}} está marcada para {{3}} às {{4}}. Precisa remarcar?

Confirmar presença
Remarcar

12:30 ✓✓

Variáveis

{{1}} nome{{2}} profissional{{3}} data{{4}} hora
UtilidadeCobrança

Fatura disponível

Olá {{1}}, sua fatura de {{2}} no valor de R$ {{3}} está disponível e vence em {{4}}.

Ver fatura
Pagar agora

12:30 ✓✓

Variáveis

{{1}} nome{{2}} mês{{3}} valor{{4}} vencimento
UtilidadeLogística

Pedido enviado 🚚

{{1}}, seu pedido #{{2}} foi despachado. Código de rastreio: {{3}}. Prazo estimado: {{4}}.

Rastrear

12:30 ✓✓

Variáveis

{{1}} nome{{2}} pedido{{3}} código{{4}} prazo

Autenticação

AutenticaçãoOTP

Seu código de verificação

{{1}} é seu código de verificação. Por segurança, não compartilhe com ninguém.

Este código expira em 10 minutos.

Copiar código

12:30 ✓✓

Variáveis

{{1}} código OTP
AutenticaçãoLogin

Confirme seu acesso

Use o código {{1}} para entrar na sua conta. Não solicitou? Ignore esta mensagem.

Copiar código

12:30 ✓✓

Variáveis

{{1}} código OTP
Aprovação

O que a Meta avalia para aprovar

Critérios objetivos aplicados a todo template submetido. Reprovação geralmente cai em um destes pontos.

01

Categoria correta

Marketing, Utilidade ou Autenticação — a Meta reclassifica se identificar tom promocional em Utilidade.

02

Contexto e clareza

Deve ficar claro quem está falando, por que e qual ação se espera do destinatário.

03

Variáveis com sentido

Sem variáveis soltas no início/fim, sem duas variáveis seguidas sem texto entre elas.

04

Sem conteúdo proibido

Nada de jogos de azar não autorizados, conteúdo adulto, armas, criptoativos sem permissão.

05

Opt-in comprovável

O contato precisa ter autorizado receber mensagens — e ter como sair facilmente.

06

Footer e CTA coerentes

Botões devem fazer o que prometem; links devem apontar para domínios da marca.

Boas práticas

O que fazer e o que evitar

Faça

Mensagem objetiva, com contexto claro do remetente
CTA único e coerente com a categoria escolhida
Identificação da marca logo no início
Opt-out visível em templates de Marketing
Variáveis usadas para personalizar, não para enrolar

Evite

Promessas vagas tipo "clique aqui e veja a surpresa"
Caixa alta excessiva, emojis em rajada e gírias agressivas
Pedir dados sensíveis (CPF, senha, cartão) por template
Disparar a base inteira sem segmentação ou opt-in
Misturar Marketing dentro de um template de Utilidade
Antes & Depois

Mesmo objetivo, redação diferente

Reprovado

"🔥🔥🔥 IMPERDÍVEL!!! CLICA AGORA e GANHA SURPRESA 😱😱 Não perde essa CHANCE ÚNICA, é só HOJE!!!"

Aprovado

"Oi {{1}}, a campanha de aniversário Skala começou: 25% OFF em planos anuais até sexta. Quer ver as opções?"

Antes de enviar

Checklist final do template

  • Categoria correta (Marketing / Utilidade / Autenticação)
  • Identificação da marca no início da mensagem
  • Variáveis com exemplo preenchido e contexto claro
  • Opt-out visível em templates de Marketing
  • Sem caixa alta excessiva e sem emojis em excesso
  • CTA coerente com o conteúdo da mensagem
  • Sem solicitar dados sensíveis (CPF, senha, cartão)
  • Links apontando para domínios oficiais da marca
  • Texto revisado sem erros de português
  • Diferente o suficiente de templates já enviados

Quer ajuda para validar seus templates?

Time Skala revisa, sugere ajustes e acompanha aprovação na Meta.

Falar com a Skala
Resumo rápido

Diretrizes essenciais

  • Aquecimento gradual, nunca disparo em massa no dia 1
  • Qualidade > Volume — sempre
  • Opt-in explícito antes de qualquer disparo
  • Não repita disparos na mesma base em menos de 24h
  • Templates só após validade dada (HSM/24h)
  • Use o tom certo para a categoria aprovada
  • Variáveis com propósito real
  • Cuidado com link: nada de linguagem agressiva ou promocional em excesso
  • Inspecione rapidamente engajamento e cobrança da qualidade

Nota importante: as regras da Meta evoluem constantemente. Mantenha contato com o time Skala para revisões periódicas e qualquer atualização de critérios.