# Status do número e da conta no WhatsApp API: como ler e o que fazer

> Status do número WhatsApp API é a leitura de que aquele número está apto a enviar: ele precisa estar conectado, com nome de exibição aprovado, pagamento em dia e templates aprovados. A Meta resume isso na Health Status API, que devolve Available, Limited ou Blocked. Consulte antes de cada campanha. Quem dispara pela estrutura da AD PRO não precisa vigiar esse painel.

Página original: https://www.adprotecnologia.com.br/disparo-em-massa/status-do-numero-whatsapp-api
Autor: AD PRO Tecnologia. Publicado em 2026-10-31.

## O que significa o status do número na API do WhatsApp?

Quando se fala em status de número na API, existem três perguntas diferentes, e misturar as três é o que gera confusão:

- **O número está conectado e pode enviar?** É o estado operacional: registrado, verificado, com nome de exibição e pagamento ok. Para usar a API, o número precisa estar conectado (connected).
- **Existe algum impedimento ou limitação agora?** É a leitura da Health Status API: Available, Limited ou Blocked, calculada considerando todos os itens envolvidos no envio.
- **As pessoas estão gostando das mensagens?** É a qualidade (verde, amarela, vermelha). Esse assunto tem página própria: [qualidade do número do WhatsApp API](https://www.adprotecnologia.com.br/crm/blog/qualidade-do-numero-whatsapp-api). Aqui o foco é o painel de status e o que fazer quando ele mostra problema.

**Onde olhar cada tipo de status**

| Onde | O que mostra | Quando consultar |
| --- | --- | --- |
| WhatsApp Manager | Número, nome de exibição, templates, limites e faixa de qualidade. Veja [gerenciador do WhatsApp](https://www.adprotecnologia.com.br/disparo-em-massa/gerenciador-do-whatsapp) | Rotina semanal e véspera de campanha |
| Health Status API | Se o envio vai funcionar (Available, Limited ou Blocked) e por quê | Antes de disparar e quando um envio falha |
| Webhooks da Meta | Avisos em tempo real sobre limite, nome de exibição, template e violações | Sempre ligados, com alerta para o time |
| Código de erro do envio | O motivo exato de uma mensagem que falhou. Veja [códigos de erro do WhatsApp API](https://www.adprotecnologia.com.br/disparo-em-massa/codigos-de-erro-whatsapp-api) | Quando o relatório mostra falhas |

## Como consultar o status pela Health Status API?

A Meta oferece o campo health_status em três tipos de item: a conta do WhatsApp Business, o número comercial e o template. A resposta informa se uma mensagem vai conseguir sair, levando em conta **todos os itens envolvidos**: o número, o template, a conta do WhatsApp, o portfólio empresarial e o app. O campo can_send_message traz um de três valores:

**Valores do can_send_message (documentação da Meta)**

| Valor | Significado | O que fazer |
| --- | --- | --- |
| AVAILABLE | O item cumpre todos os requisitos de envio | Nada. Pode disparar |
| LIMITED | O item funciona, mas com limitações. A causa vem no campo additional_info (por exemplo, um nome de exibição não aprovado pode limitar o volume) | Ler o additional_info e corrigir a causa. O volume pode voltar quando ela some |
| BLOCKED | O item não cumpre um ou mais requisitos e não pode ser usado como está | Ler o array errors (error_code, error_description, possible_solution), aplicar a solução e consultar de novo |

O status geral é o **pior** entre os itens: basta um bloqueado para o geral aparecer como BLOCKED, e basta um limitado para aparecer como LIMITED. Por isso um número saudável pode aparecer travado por causa de um template não aprovado, de um problema no portfólio ou no app. A consulta é uma chamada de leitura simples:

**Consulta de saúde do número (modelo para o time técnico)**

```text
GET /<ID_DO_NUMERO>?fields=health_status

O que conferir na resposta:
- can_send_message do número: AVAILABLE, LIMITED ou BLOCKED
- entidades listadas: PHONE_NUMBER, WABA, BUSINESS, APP (e MESSAGE_TEMPLATE, se consultar um template)
- se LIMITED: ler additional_info
- se BLOCKED: ler errors (error_code, error_description, possible_solution)
- depois de corrigir: consultar de novo e registrar a data e a resposta
```

## O que impede um número de ficar conectado e enviar?

Quando o envio falha, o código de erro costuma apontar o item que está fora do status. Os mais comuns, segundo a documentação da Meta:

**Erros que indicam problema de status, causa e saída**

| Código | O que a Meta informa | Saída |
| --- | --- | --- |
| 133010 | Número não registrado na WhatsApp Business Platform | Registrar o número e tentar de novo. Veja [número para API oficial](https://www.adprotecnologia.com.br/disparo-em-massa/numero-para-api-oficial-do-whatsapp) |
| 131037 | O número comercial usado no envio não tem nome de exibição aprovado (a Meta cita esse caso para os números 555) | Ajustar o nome de exibição. Veja [nome de exibição](https://www.adprotecnologia.com.br/disparo-em-massa/nome-de-exibicao-whatsapp-api) |
| 131042 | Erro no método de pagamento (nenhuma conta de pagamento vinculada, linha de crédito acima do limite ou inativa, conta excluída ou suspensa) | Revisar o cadastro de cobrança. Veja [forma de pagamento](https://www.adprotecnologia.com.br/disparo-em-massa/forma-de-pagamento-whatsapp-api) |
| 131031 | Conta do WhatsApp Business restrita ou desativada por violar uma política | Seguir o guia de [conta restrita](https://www.adprotecnologia.com.br/disparo-em-massa/conta-restrita-whatsapp-business-api) |
| 131048 | Há restrições na quantidade de mensagens que o número pode enviar | Verificar a qualidade do número e a dos templates no WhatsApp Manager |

Número banido no WhatsApp é outro caso: precisa de recurso antes de ser registrado na API. E a qualidade baixa deixou de reduzir o limite de envio em 7 de outubro de 2025, mas continua pesando em outros pontos: templates ruins são pausados (3 horas na primeira vez, 6 horas na segunda e desativação na terceira) e a subida de limite exige qualidade alta.

## Que avisos (webhooks) a Meta envia sobre número e conta?

Quem só abre o painel de vez em quando descobre o problema depois do prejuízo. Os webhooks avisam na hora. Os campos mais úteis para a rotina de disparo:

**Campos de webhook que reportam mudanças de status**

| Campo | O que avisa |
| --- | --- |
| account_alerts | Mudanças no limite de envio do número, no perfil comercial e na situação de conta comercial oficial |
| account_update | Violações de política ou termos, desativação do vínculo, reconexão e exclusão da conta. Quando se aplica, traz o tipo e a duração da restrição |
| phone_number_name_update | Resultado da verificação do nome de exibição do número |
| phone_number_quality_update | Mudanças no nível de velocidade (throughput) do número |
| message_template_status_update | Mudança no status de um template existente (aprovado, pausado, desativado) |
| message_template_quality_update | Mudança na qualidade de um template |

Um detalhe prático: as notificações de violação também chegam por e-mail aos administradores do portfólio. Se o endereço cadastrado é de alguém que saiu da empresa, o aviso se perde. Mais sobre o webhook em geral em [webhook do WhatsApp API](https://www.adprotecnologia.com.br/disparo-em-massa/webhook-do-whatsapp-api).

## Que rotina de checagem evita surpresa no dia do disparo?

1. **Três dias antes.** Confira o nome de exibição, a forma de pagamento e o status dos templates da campanha. A análise de um template pode levar até 24 horas, e template reprovado precisa de ajuste. Veja [template reprovado](https://www.adprotecnologia.com.br/crm/blog/template-reprovado-whatsapp).
2. **Um dia antes.** Consulte a Health Status API do número e do template. Se aparecer LIMITED, corrija ainda hoje.
3. **No dia, antes do primeiro lote.** Repita a consulta e confira o limite de envio disponível frente ao tamanho da base. Veja [limite de envio](https://www.adprotecnologia.com.br/disparo-em-massa/limite-de-envio-whatsapp-api).
4. **Entre os lotes.** Olhe falhas e respostas. Se o erro de limite por pessoa (131049) aparecer, não insista no mesmo contato: a orientação da Meta é esperar pelo menos 24 horas.
5. **Depois do disparo.** Registre o resultado e o que mudou no painel. Compare com o relatório. Veja [métricas de campanha de WhatsApp](https://www.adprotecnologia.com.br/crm/blog/metricas-de-campanha-de-whatsapp).

**Checklist de status para a véspera do disparo**

```text
[ ] Número conectado (connected) e sem aviso no WhatsApp Manager
[ ] Nome de exibição aprovado
[ ] Forma de pagamento ativa, sem pendência
[ ] Health Status do número: AVAILABLE (se LIMITED, ler additional_info)
[ ] Templates da campanha aprovados e fora de pausa
[ ] Limite de envio maior que o tamanho do lote do dia
[ ] Webhooks ligados e alerta chegando para quem responde
[ ] E-mails dos administradores do portfólio atualizados
[ ] Base com opt-in e sem quem pediu para sair
[ ] Quem atende as respostas escalado para o horário do envio
```

## O que fazer quando o status aparece como Limited ou Blocked?

1. **Não reenvie em loop.** Insistir com quem já está no limite de marketing por pessoa pode bloquear novas tentativas para aquele contato por até 24 horas (erro 131049).
2. **Leia a causa.** Em LIMITED, o campo additional_info; em BLOCKED, o array errors com código, descrição e solução sugerida.
3. **Aplique a solução sugerida** e consulte de novo para confirmar a mudança de status.
4. **Se a causa é política ou spam**, siga o roteiro de recurso em [conta restrita](https://www.adprotecnologia.com.br/disparo-em-massa/conta-restrita-whatsapp-business-api).
5. **Se a causa é template**, ajuste o texto, a categoria e as variáveis e submeta de novo.
6. **Se a causa é opt-in ou reclamação**, revise a base antes da próxima campanha. Veja [opt-in no WhatsApp](https://www.adprotecnologia.com.br/crm/blog/opt-in-whatsapp).

## Quem dispara pela AD PRO precisa vigiar o status do número?

> **Como a AD PRO faz:** A campanha sai pela API oficial, na estrutura da AD PRO, então Health Status, webhooks e WhatsApp Manager dos números de envio não entram na sua rotina. O que você acompanha é a demanda, no portal de disparos: em análise, teste, aprovado, disparado e relatório. Na etapa de teste, a mensagem chega a números reais para você conferir, e o envio em lotes só começa depois do seu ok. Se preferir ter a API na sua própria conta, a estruturação tem valor base de R$ 2.000 (sem custos da Meta, de provedores e de ferramentas), e este painel passa a ser seu.

Para entender como a AD PRO trabalha por completo, veja [empresa de disparo em massa](https://www.adprotecnologia.com.br/disparo-em-massa/empresa-de-disparo-em-massa), o [hub de disparo em massa](https://www.adprotecnologia.com.br/disparo-em-massa) e a página sobre [disparo em massa agendado](https://www.adprotecnologia.com.br/disparo-em-massa/disparo-em-massa-agendado).

## Perguntas frequentes

### Como ver o status do número no WhatsApp API?

Consulte o WhatsApp Manager para o estado do número, do nome de exibição e dos templates, e a Health Status API para saber se o envio vai funcionar. A resposta traz Available, Limited ou Blocked e, nos dois últimos casos, a causa.

### O que significa Limited no status do WhatsApp API?

Limited quer dizer que o item cumpre os requisitos de envio, mas com limitações. A causa aparece no campo additional_info. Um nome de exibição não aprovado, por exemplo, pode limitar o volume. Corrigida a causa, o volume pode voltar.

### O que fazer quando o status é Blocked?

Blocked quer dizer que um requisito não foi cumprido e o item não pode ser usado como está. Leia o array errors, que traz código, descrição e solução sugerida, aplique a solução e consulte de novo para confirmar.

### Status do número é a mesma coisa que qualidade do número?

Não. O status diz se o número consegue enviar agora (conectado, aprovado, sem bloqueio). A qualidade (verde, amarela, vermelha) reflete como as pessoas recebem as mensagens. Desde 7 de outubro de 2025, qualidade baixa não reduz mais o limite de envio.

### Preciso vigiar o status do número se disparar pela AD PRO?

Não. A estrutura de envio é da AD PRO. Você manda a base e a copy, aprova o teste em números reais e acompanha o status da demanda no portal. Se contratar a estruturação da API na sua conta, o painel passa a ser seu e esta página serve de roteiro.

## Fontes

- [Meta for Developers, Messaging and Calling Health Status](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/health-status/), conferido em 2026-10-31
- [Meta for Developers, códigos de erro da WhatsApp Business Platform](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes), conferido em 2026-10-31
- [Meta for Developers, webhooks do WhatsApp](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview/), conferido em 2026-10-31
- [Meta for Developers, números de telefone comerciais](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers), conferido em 2026-10-31
- [Meta for Developers, pausa de templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-pausing), conferido em 2026-10-31
- [Meta for Developers, limite de marketing por pessoa](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits/), conferido em 2026-10-31
- [Meta for Developers, limites de envio](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits), conferido em 2026-10-31

---

AD PRO Tecnologia LTDA, CNPJ 68.425.611/0001-15, São Paulo/SP. Atendimento on-line para todo o Brasil. Diagnóstico comercial gratuito de 30 minutos: https://www.adprotecnologia.com.br/#agendar. WhatsApp +55 11 98604-5939. Fatos e preços publicados: https://www.adprotecnologia.com.br/fatos