WhatsApp

Por que uma Business Account ou número WhatsApp pode parar de enviar?

Um número WhatsApp pode parar de enviar porque a Meta limitou seu volume, restringiu seu acesso de qualidade ou política, ou baniu o número ou a Business Account.

Quando um envio via WhatsApp para, primeiro separe um limite de volume de uma restrição ou banimento. Eles têm causas diferentes e caminhos de recuperação diferentes.

Qual é a diferença entre um limite de taxa, uma restrição e um banimento?

EstadoO que controlaO que esperar
Limite de taxaQuantas mensagens o número ou portfólio de negócios pode enviar em um períodoUm envio pode ser limitado enquanto a conta continua utilizável.
RestriçãoSe a Meta permite algum envio ou atividade da contaA Meta pode limitar um número após sinais de qualidade ou política.
BanimentoSe o número ou a Business Account pode enviarO número ou conta permanece inutilizável até a Meta alterar a decisão.

A Meta também reporta uma classificação de qualidade para um número. Bloqueios, denúncias e outros feedbacks de destinatários podem reduzi-la. Uma classificação baixa limita a elegibilidade para maior capacidade de mensagens; não é a mesma coisa que um banimento.

O que significam Flagged e Restricted para um número?

flagged e restricted são estados operacionais que a Meta reporta para um número conectado. Eles pertencem ao estado WhatsApp do número, junto com quality_rating, messaging_limit e throughput_level, o campo de velocidade de envio permitida.

O estado indica que a Meta impôs uma condição ao número. Por si só, ele não diz se um envio específico será aceito. Leia a classificação de qualidade, o limite de mensagens e os campos de throughput juntos, e verifique o resultado da mensagem para a solicitação.

A orientação de qualidade da Meta associa baixa qualidade a capacidade de mensagens reduzida. Uma restrição pode, portanto, reduzir quem o número pode alcançar ou quanto pode enviar sem ser um banimento permanente. Não trate um rótulo Flagged ou Restricted como prova de que o número foi excluído ou desativado permanentemente.

Como é um banimento?

A Meta pode banir um número de telefone ou uma Business Account WhatsApp por violações da sua Business Messaging Policy ou Commerce Policy. A Meta diz que usa denúncias, informações da conta de negócios e dados de registro para detectar violações na sua orientação de detecção de violações.

Bird reporta um número banido com status: banned. Um número banido é terminal nas próximas ações de Bird: nenhuma operação Bird pode desfazer o estado. Uma Business Account carrega um objeto ban separado quando WhatsApp anuncia um banimento de conta. Seu estado é scheduled_for_disable ou disabled. Bird pode incluir um appeal_url para o Meta Business Support quando conhece o portfólio de negócios que possui a conta.

Esse banimento em nível de conta é diferente de uma falha de mensagem. Uma mensagem pode falhar porque a Meta recusou uma solicitação, ou pode ser rejeitada antes do envio por uma condição do lado Bird. A explicação de falha versus rejeição distingue esses eventos pelos detalhes do erro. Um erro rate_limited normalizado descreve limitação de requisições; não prova um banimento.

O que posso fazer quando o envio para?

Comece pelo estado que Bird e a Meta reportam:

  1. Leia o número em Bird e verifique status, quality_rating, messaging_limit e throughput_level na operação de número WhatsApp.
  2. Leia o evento de mensagem e o erro juntos. Guarde meta_error_code e sua descrição para um envio com falha.
  3. Abra o WhatsApp Manager e inspecione o número em Phone numbers.
  4. Se a Meta indicar um problema de conta ou política, abra o Business Support Home e use a opção de revisão que a Meta oferece.

Corrija o consentimento, conteúdo ou informação de conta subjacente quando o problema identificar um. Mantenha os requisitos de opt-in WhatsApp e de política enquanto faz isso. Tentar novamente com um número banido não remove o banimento. Alterar a solicitação Bird não pode substituir uma restrição da Meta.

Os controles de revisão disponíveis da Meta determinam se um problema de conta ou política pode ser contestado.

Quem pode alterar o estado?

Bird pode ler os estados que a Meta reporta, preservar o erro da mensagem e fornecer uma URL de recurso para um banimento conhecido de Business Account. Bird não pode aprovar uma revisão, remover um banimento, alterar uma classificação de qualidade ou elevar um limite de mensagens da Meta.

A Meta decide se reverte uma restrição ou banimento. Suas ferramentas de revisão mostram a ação disponível para o problema específico. O artigo de ajuda do app WhatsApp Business diz que a maioria das revisões de banimento de conta é concluída em 24 horas. Esse escopo não garante um prazo para a Business Platform. Use o status mostrado na ferramenta de suporte da Meta como a fonte da verdade.

Se a Meta restaurar o número ou a conta, leia-o novamente em Bird antes de retomar os envios. Uma solicitação API bem-sucedida ainda não substitui um resultado de entrega.

Em resumo

  1. Um limite de taxa controla o volume.

    Ele limita quanto o número pode enviar em um período; por si só, não significa uma violação de política.

  2. Uma restrição controla o acesso.

    Os estados Flagged e Restricted refletem uma condição de qualidade ou conta que pode limitar o envio.

  3. Um banimento é uma decisão da Meta.

    Um número ou conta banido não pode enviar até que a Meta reverta a decisão, caso ofereça revisão.

  4. Bird não pode remover um estado da Meta.

    Bird pode exibir o estado e o link de recurso da Meta, mas a revisão pertence às ferramentas de suporte da Meta.

Construa na mesma rede.

Uma chave de API de teste é sua imediatamente. A produção é desbloqueada quando adicionar um método de pagamento e verificar um remetente.

Comece com um canal.
Adicione os outros quando estiver pronto.

Uma chave API de teste é sua imediatamente. A produção é desbloqueada quando você adiciona um método de pagamento e verifica um remetente.

Usa Claude Code, Cursor ou Codex? Copie um prompt de configuração e o seu agente instala o Bird CLI e as skills por si. Escolha o seu:

Cursor