Se você utiliza o WhatsApp pela API Oficial (WABA), é essencial entender que existem regras definidas pela Meta que controlam como e quando as mensagens podem ser enviadas.

Essas regras não são da Poli — elas se aplicam a todas as empresas que utilizam o WhatsApp oficial.

Neste guia, você vai entender:

• O que são as restrições da Meta
• Como funciona a janela de 24h
• O que são templates e como usar corretamente
• Tipos de templates (Utility, Marketing, etc.)
• Como a Poli cobra pelos envios
• Principais erros e como resolver

O que são as restrições da Meta?

A Meta controla o envio de mensagens no WhatsApp para:

• evitar spam
• proteger a experiência do usuário
• garantir conversas relevantes
  

👉 Por isso, nem toda mensagem pode ser enviada a qualquer momento.

Janela de 24 horas: como funciona

A regra mais importante do WhatsApp é a janela de atendimento de 24 horas.

👉 Ela começa quando o cliente envia uma mensagem para sua empresa.

Após 24 horas

Se o cliente não responder dentro desse período:

👉 você NÃO pode mais enviar mensagens comuns

👉 Para iniciar uma nova conversa, é obrigatório usar um template aprovado pela Meta.

💰 Como isso é cobrado dentro da Poli?

• Cada template enviado consome 1 crédito do seu plano
• Esse envio reabre a conversa com o cliente

O que são templates (mensagens aprovadas)?

Templates são mensagens previamente aprovadas pela Meta para iniciar conversas fora da janela de 24h.

👉 Eles são obrigatórios para reativar um cliente.

Utility (Utilidade)

Usado para comunicações essenciais e esperadas.

Exemplos:

• confirmação de pedido
• atualização de status
• lembretes

Características:

• informativo
• esperado pelo usuário
• baixa chance de bloqueio

Marketing

Usado para campanhas e ofertas.

Exemplos:

• promoções
• novidades
• campanhas

Características:

• promocional
• maior risco de bloqueio
• exige cuidado no conteúdo

Authentication (Autenticação)

Usado para envio de códigos.

Exemplos:

• código de verificação
• login

Como criar um bom template

Aqui é onde a maioria dos erros acontece.

Boas práticas

• Seja claro e direto
• Use linguagem natural
• Contextualize o motivo da mensagem
• Personalize (nome, produto, etc.)
• Evite excesso de emojis

Evite:

• mensagens genéricas
• disparos em massa sem contexto
• linguagem agressiva de venda
• links suspeitos

Principais erros de envio (e como resolver)

Por que sua mensagem foi bloqueada?

Isso pode acontecer quando:

• há envio em massa
• o conteúdo parece spam
• o usuário não interagiu recentemente
• o template foi mal estruturado

Como evitar bloqueios e melhorar entregabilidade

• Use templates apenas quando necessário
• Priorize mensagens úteis (Utility)
• Evite disparos massivos
• Respeite o contexto do cliente
• Mantenha qualidade nas conversas

Não sabe qual é o problema?

Se você não identificou o erro:

• verifique o histórico da conversa
• revise o conteúdo da mensagem
• confirme se está dentro da janela de 24h

Lista de Erros e Soluções

Erro 131030: Destinatário inválido

• O que significa: O número de telefone para o qual você tentou enviar a mensagem não é uma conta de WhatsApp válida ou não existe.
• Ação Recomendada:
• 1. Verifique se o número está no formato correto (DDI + DDD + Número).
  2. Confirme com o cliente se ele possui o aplicativo WhatsApp ativo.
  3. Importante: Remova este número da sua lista de envios. Tentar enviar repetidamente para números inexistentes prejudica a reputação da sua conta.

Erro 131047: Janela de 24h fechada

• O que significa: Passaram-se mais de 24 horas desde a última mensagem enviada pelo cliente. Por regra da Meta, não é permitido enviar mensagens de texto livre (sessão) após esse período.
• Ação Recomendada:
• • Não tente reenviar a mesma mensagem.
  • Você deve enviar um Modelo de Mensagem (Template) aprovado para reabrir a conversa. Assim que o cliente responder a esse template, a janela de 24h se renovará.

Erro 131026: Mensagem não entregue (Violação)

• O que significa: A mensagem não pôde ser entregue. Geralmente ocorre porque o usuário bloqueou a empresa, restrições de entrega ou violação de políticas.
• Ação Recomendada:
• 1. Caso não consiga contato, tente outro canal (ligação, Instagram, Messenger)
  2. Peça para o cliente enviar uma mensagem para a empresa, dessa forma deve abrir a janela de conversação
  3. Se o erro for pontual em um cliente, é provável que ele tenha bloqueado seu número. Pare de enviar mensagens para este contato.

Erro 130429: Limite de Taxa Atingido (Rate Limit)

• O que significa: A empresa atingiu o limite de mensagens permitidas por segundo. Para cada número de telefone comercial registrado, a API de Nuvem é compatível com até 80 mensagens por segundo (mps), por padrão. Esse limite pode aumentar para até 1.000 mps de acordo com a qualidade da conta

• Ação Recomendada:
• 1. Verifique em qual Tier sua conta está (ex: 80 ou 1000 mensagens/segundo).
  2. Reduza a velocidade dos disparos.
  3. Aguarde alguns minutos antes de realizar novos envios.

Erro 131042: Falha de Pagamento

• O que significa: Existe uma pendência financeira na conta de anúncios associada ao WhatsApp Business (cartão recusado, saldo insuficiente ou falta de método de pagamento).
• Ação Recomendada:
• • Acesse imediatamente o Gerenciador de Negócios > Cobranças e regularize o método de pagamento. O serviço de mensagens permanecerá pausado até a quitação.

Erro 131049: Bloqueio de Qualidade (Spam)

• O que significa: A Meta bloqueou o envio para proteger a integridade do sistema, geralmente devido a um alto volume de denúncias, bloqueios recentes por parte dos usuários ou baixa qualidade dos templates enviados.
• Ação Recomendada:
• • Pare os disparos imediatamente.
  • Não insista. Enviar mais mensagens agora pode banir seu número permanentemente.
  • Revise sua estratégia e aguarde 24 a 48 horas enviando apenas mensagens essenciais (templates de utilidade).
  • Revise o conteúdo dos templates usados nos disparos

Erro 131051: Tipo de Mídia Não Suportado

• O que significa: O arquivo enviado (PDF, Imagem, Vídeo) é muito pesado, está corrompido ou está em um formato que o WhatsApp não aceita.
• Ação Recomendada:
  Imagens: 5MB
  Vídeos: 16MB
  Documentos (PDF): 100MB
  Áudio: 16MB
• 1. Converta o arquivo para formatos padrão (JPG, PNG, PDF, MP4).

Erro 132000: Erro de Parâmetros (Variáveis)

• O que significa: O número de variáveis enviadas na API não corresponde ao número de variáveis existentes no Modelo criado.
• Ação Recomendada:
• • Compare o seu envio com o modelo no Gerenciador. Se o modelo espera 3 variáveis ({{1}}, {{2}}, {{3}}), o seu código de envio (JSON) precisa conter exatamente 3 parâmetros preenchidos.

Erro 132001: Template Inexistente

• O que significa: O sistema não encontrou um template com o nome especificado.
• Ação Recomendada:
• 1. Verifique a ortografia exata do nome do modelo (ele deve ser todo em minúsculas e com underlines, ex: confirma_pedido).
  2. Verifique se o código de idioma está correto (ex: pt_BR).
  3. Confirme no Gerenciador se o status do template é APPROVED.

Erro 131031: Conta Bloqueada

• O que significa: A conta do WhatsApp Business (WABA) foi restrita devido a violações graves de política.
• Ação Recomendada:
• • Acesse a Qualidade da Conta (Account Quality) no Gerenciador de Negócios para ver o motivo e solicitar uma análise (apelação).

Erro 131048: Bloqueio por Taxa de Spam

• O que significa: Diferente do bloqueio de qualidade geral, este erro indica que você atingiu um limite específico de mensagens marcadas como spam em um curto período.
• Ação Recomendada: Pare o envio imediatamente. Revise o conteúdo da última campanha enviada. Provavelmente a mensagem está confundindo os usuários ou não tem um botão de opt-out claro.

Erro 131056: Limite de Mensagens por Usuário (Pair Rate Limit)

• O que significa: Você enviou muitas mensagens para o mesmo destinatário em um curto espaço de tempo, e o sistema bloqueou temporariamente o envio para esse número específico para evitar importunação.
• Ação Recomendada: Aguarde alguns minutos antes de enviar nova mensagem para este cliente específico. Evite "bombardear" o usuário com várias mensagens seguidas (ex: dividir um texto longo em 10 balões pequenos).

Erro 368: Bloqueio Temporário por Política

• O que significa: A conta do WhatsApp Business foi temporariamente impedida de enviar mensagens devido a violações detectadas pelos sistemas automatizados de integridade.
• Ação Recomendada: Verifique o painel de "Qualidade da Conta" no Gerenciador de Negócios. Pode durar mais que 24h dependendo da gravidade ou até que você resolva a pendência indicada.

Erros Técnicos e de Configuração:

Erro 133010: Número não Registrado (Sender)

• O que significa: O erro não está no cliente, mas no seu número. O número de telefone da sua empresa não está registrado corretamente na API, perdeu a conexão ou não está corretamente vinculado ao WABA
• Ação Recomendada: Refaça o processo de registro do número juntamente com um especialista da Poli

Erro 131000: Erro Genérico (Something went wrong)

• O que significa: Uma falha técnica temporária nos servidores da Meta. Não é culpa da sua requisição.
• Ação Recomendada: Aguarde alguns minutos e tente o envio novamente. Se persistir por horas, abra um chamado no suporte da Meta.

Erro 131053: Falha no Upload de Mídia

• O que significa: O arquivo de mídia que você tentou enviar (imagem, vídeo, PDF) não pôde ser processado. Motivos comuns: formato não suportado, arquivo corrompido ou muito pesado.
• Ação Recomendada: Teste abrir o arquivo no seu computador. Verifique se ele está dentro dos limites (16MB para imagens/vídeos, 100MB para documentos) e converta para formatos padrão (JPG, MP4, PDF).

Erro 131008 / 131009: Parâmetro Obrigatório Faltando

• O que significa: A sua chamada de API está incompleta. O erro 131008 indica que falta um campo obrigatório, e o 131009 indica que o valor preenchido é inválido.
• Ação Recomendada: Revise o JSON de envio. Verifique se campos como type, to ou template estão preenchidos corretamente e sem erros de digitação.

Ainda precisa de ajuda?

Se mesmo após essas verificações o problema continuar:

👉 Fale com nosso suporte e vamos te ajudar a identificar o que está acontecendo