> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Qualidade do WhatsApp: o que significa e como recuperar

> Como a Meta classifica o seu número e modelos como Verde, Amarelo ou Vermelho, o que faz descer a classificação e como recuperar antes de limitar o envio.

Cada número de telefone empresarial do WhatsApp tem uma **classificação de qualidade**, e cada modelo de mensagem tem a sua própria **classificação de qualidade do modelo**. A Meta utiliza ambas para decidir se pode continuar a enviar livremente, se os modelos se mantêm ativos e se o seu [limite de mensagens](https://knowledge.flowella.io/pt/whatsapp/limits/messaging-limits.md) pode aumentar.

As classificações dos números de telefone funcionam como um semáforo:

* **Verde:** alta qualidade. O envio é normal e o seu limite pode aumentar quando os outros critérios são cumpridos.
* **Amarelo:** qualidade média. Trate-o como um aviso e restrinja públicos e frequência antes que a classificação desça mais.
* **Vermelho:** baixa qualidade. Conte com restrições. Um número que se mantém Vermelho pode ser fortemente limitado.

Esta página aborda o que a Meta documenta, o que vê no Flowella e no WhatsApp Manager e como a qualidade se relaciona com erros de entrega como o [131048](https://knowledge.flowella.io/pt/whatsapp/errors/error-131048.md).

> [!NOTE]
>
> **No Flowella.** Parcialmente suportado. O Flowella mostra a qualidade dos modelos com etiquetas na lista de modelos, mostra um banner vermelho e notifica todos quando um número desce para Amarelo ou Vermelho, e regista cada alteração que a Meta comunica. Não mostra a classificação atual de cada número: verifique-a no WhatsApp Manager. Consulte [O que o Flowella mostra](#what-flowella-shows).

## O que a qualidade afeta

| Área | Efeito de uma classificação baixa |
| - | - |
| [Limite de mensagens](https://knowledge.flowella.io/pt/whatsapp/limits/messaging-limits.md) | Uma qualidade baixa abranda ou impede a subida de nível do portfólio. Desde 7 de outubro de 2025, já não **reduz** um limite que já tem. |
| [Débito](https://knowledge.flowella.io/pt/whatsapp/limits/throughput.md) | Um número precisa de uma classificação Média (Amarelo) ou superior para passar para 1.000 mensagens por segundo. |
| Envio | Um número com problemas de qualidade persistentes pode ter os envios bloqueados com [131048](https://knowledge.flowella.io/pt/whatsapp/errors/error-131048.md). |
| Modelos | Um modelo classificado como Vermelho é pausado, e a terceira pausa desativa-o. Consulte [Ritmo e pausa de modelos](https://knowledge.flowella.io/pt/whatsapp/limits/template-pacing-and-pausing.md). |

O estado **Flagged** que os números recebiam após uma descida de qualidade já não existe. Antes de 7 de outubro de 2025, um número Flagged durante 7 dias descia um nível de limite de mensagens.

## Classificação de qualidade do número de telefone

A Meta atribui a cada número de telefone empresarial um `quality_rating`, devolvido pela Phone Numbers API. O WhatsApp Manager mostra a mesma classificação com outro nome, em **Account tools** → **Phone numbers**.

| Valor da API | WhatsApp Manager | Flowella |
| - | - | - |
| `GREEN` | High | Sem alerta |
| `YELLOW` | Medium | Notificação **WhatsApp quality rating** |
| `RED` | Low | Notificação e banner vermelho em todas as páginas |

A Meta comunica cada alteração com um webhook `phone_number_quality_update`.

A Meta não publica limiares exatos de taxa de bloqueio. Na prática, as classificações mudam quando os destinatários:

* **Bloqueiam** o seu número empresarial
* **Denunciam** as suas mensagens como spam
* Mostram um envolvimento fraco (poucas leituras ou respostas) em relação ao seu volume

O comportamento recente pesa mais do que o histórico antigo, e volumes de envio elevados são avaliados de forma mais rigorosa do que um número de baixo volume em aquecimento.

> [!TIP]
>
> Para a redação da própria Meta sobre a qualidade do número no WhatsApp Manager, consulte o artigo da Central de Ajuda da Meta [*About your WhatsApp Business phone number's quality rating*](https://www.facebook.com/business/help/896873687365001), para o qual a documentação da Meta sobre números de telefone remete.

## Classificação de qualidade do modelo

Separadamente, **cada modelo** tem uma classificação de qualidade baseada na utilização, no feedback dos clientes e no envolvimento. A Meta comunica-a através da Template API e mostra-a no painel **Manage templates** do WhatsApp Manager:

| Pontuação da API | Etiqueta no WhatsApp Manager | Significado |
| - | - | - |
| `GREEN` | Active - High quality | Pouco ou nenhum feedback negativo. O modelo pode ser enviado |
| `YELLOW` | Active - Medium quality | Feedback negativo ou baixas taxas de leitura. Ainda pode ser enviado, mas pode em breve ser pausado ou desativado |
| `RED` | Active - Low quality | Feedback negativo ou baixas taxas de leitura. Ainda pode ser enviado, mas corre o risco de ser pausado ou desativado em breve |
| `UNKNOWN` | Active - Quality pending | Um modelo novo ainda sem feedback suficiente. O modelo pode ser enviado |

Os modelos novos começam como `UNKNOWN`. A qualidade influencia o **ritmo de envio dos modelos** (pacing) e a **pausa de modelos**: um modelo sem classificação Verde pode ter o ritmo controlado, e um modelo Vermelho é pausado. Consulte [Ritmo e pausa de modelos](https://knowledge.flowella.io/pt/whatsapp/limits/template-pacing-and-pausing.md). Se o estado de um modelo passar de aprovado para qualquer outro, não o pode enviar até a Meta o aprovar novamente.

A Meta comunica as alterações de qualidade dos modelos com um webhook `message_template_quality_update`, e as pausas e desativações com `message_template_status_update`. O Flowella atualiza as etiquetas a partir de ambos.

Referência oficial: a página da Meta sobre [classificação de qualidade dos modelos](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality).

No Flowella, a lista de modelos assinala com etiquetas os modelos pausados, desativados e de baixa qualidade. Consulte [Etiquetas de saúde de entrega na lista de modelos](https://knowledge.flowella.io/pt/app/templates.md#delivery-health-pills-on-the-templates-list).

## Porque descem as classificações dos números

A maioria das descidas resulta de problemas de público e de frequência, e não de um único modelo "mau":

> [accordion] Enviar a pessoas que nunca deram consentimento para o WhatsApp
>
> Um número de telefone recolhido há anos para SMS ou checkout não constitui consentimento para o WhatsApp. Modelos de marketing inesperados levam a bloqueios. Dê preferência a contactos que deram consentimento recentemente para o WhatsApp.

> [accordion] Enviar com demasiada frequência às mesmas pessoas
>
> O WhatsApp é mais pessoal do que o email. Uma frequência elevada por destinatário aumenta as taxas de bloqueio e de denúncia. Limite os modelos enviados nos workflows do HubSpot (por exemplo, no máximo um modelo de marketing por destinatário por semana, a menos que tenha respondido).

> [accordion] Conteúdo que não corresponde ao consentimento que tem
>
> Conteúdo de marketing enviado a pessoas que só aceitaram atualizações de serviço (ou o inverso) gera reclamações. Faça corresponder a categoria e o texto do modelo ao consentimento que tem. Consulte [Modelo rejeitado](https://knowledge.flowella.io/pt/troubleshooting/template-rejected.md).

> [accordion] Um nome de exibição que os clientes não reconhecem
>
> Se o nome de exibição não corresponder à marca de que o cliente se lembra, este pode tratar a conversa como spam. Use um nome que os clientes reconheçam. Consulte [Nome de exibição e perfil](https://knowledge.flowella.io/pt/whatsapp/accounts/profile-setup.md).

## O que o Flowella mostra

O Flowella não apresenta a classificação de cada número de telefone. Verifique-a no WhatsApp Manager → **Account tools** → **Phone numbers**. O Flowella alerta-o quando a qualidade causa problemas.

### Banner vermelho

Quando qualquer número ligado está classificado como Vermelho, ou a Meta restringiu ou baniu a conta, todas as páginas do Flowella mostram "WhatsApp quality or account status needs attention. Open Meta Business Suite and resolve restrictions before sending is affected."

### Notificações

O Flowella notifica-o quando a Meta altera algo que afeta o envio. Estas notificações estão sempre ativas na aplicação e por email. Consulte [Preferências de notificação](https://knowledge.flowella.io/pt/settings/notification-preferences.md).

| Notificação | Quando é enviada | Nome da preferência |
| - | - | - |
| WhatsApp number quality changed | A classificação de um número desce para Amarelo ou Vermelho | **WhatsApp quality rating** |
| WhatsApp Business account update | A Meta restringe, suspende, bane ou desativa a conta, ou comunica uma violação de política | **WhatsApp account status** |
| Message template paused | O WhatsApp pausa um modelo | **Template paused** |
| Message template disabled | O WhatsApp desativa um modelo | **Template disabled** |
| Message template quality dropped | A classificação de um modelo desce para Vermelho | **Template quality drop** |

### Etiquetas dos modelos

A lista de modelos mostra **Quality: Yellow**, **Quality: Red**, **Paused by WhatsApp**, **Quality pause 1/3** (a contagem aumenta a cada pausa) e **Disabled by WhatsApp**. As pausas de ritmo de envio têm também um botão **Unpause**. Consulte [Etiquetas de saúde de entrega na lista de modelos](https://knowledge.flowella.io/pt/app/templates.md#delivery-health-pills-on-the-templates-list).

### Mensagens falhadas e Resultados

Quando a Meta bloqueia um envio devido à qualidade do seu número ([erro 131048](https://knowledge.flowella.io/pt/whatsapp/errors/error-131048.md)), a Caixa de entrada mostra o motivo por baixo da mensagem. Em [Resultados](https://knowledge.flowella.io/pt/app/analytics.md#delivery-read-and-failure-rates), as taxas de entrega e de falha ao longo do tempo ajudam a identificar a campanha que causou bloqueios.

## Como recuperar do Amarelo

A maioria das classificações Amarelas recupera em poucos dias **se** alterar o comportamento de imediato:

**1. Pause os envios agressivos**

Pare os envios de marketing para listas frias ou desinteressadas durante pelo menos 24 horas.

**2. Encontre a causa**

Verifique os [Resultados](https://knowledge.flowella.io/pt/app/analytics.md) no Flowella e no WhatsApp Manager para ver que campanha ou modelo coincide com a descida.

**3. Restrinja o público**

Nos próximos envios, segmente consentimentos recentes e contactos que responderam recentemente.

**4. Reduza o volume**

Envie para menos destinatários únicos por dia enquanto a qualidade recupera e mantenha os modelos com alta qualidade para que o aumento do [limite de mensagens](https://knowledge.flowella.io/pt/whatsapp/limits/messaging-limits.md) não fique bloqueado.

**5. Acompanhe diariamente**

Confirme no WhatsApp Manager que a classificação volta a aproximar-se do Verde antes de aumentar novamente o volume.

## Como recuperar do Vermelho

O Vermelho é mais grave. A Meta pode restringir o número enquanto estiver Vermelho, e um período prolongado em Vermelho pode impedir o envio.

* Pare os envios que causaram bloqueios, incluindo modelos de marketing que os clientes estão a denunciar.
* Retome lentamente, apenas com públicos envolvidos.
* Corrija nomes de exibição ou conteúdos de modelos que os clientes não reconhecem ou não esperavam.
* Se a Meta restringiu o número, aguarde que a Meta levante a restrição ou use outro número elegível. O Flowella não pode anular uma restrição da Meta.

## Qualidade e erros de entrega

| Sinal | O que normalmente significa | Guia |
| - | - | - |
| **131048** | A Meta restringiu os envios a partir do **seu** número por motivos de spam ou qualidade | [Erro 131048](https://knowledge.flowella.io/pt/whatsapp/errors/error-131048.md) |
| **131049** | Limite de marketing por utilizador do lado do destinatário, não o limite do seu portfólio | [Erro 131049](https://knowledge.flowella.io/pt/whatsapp/limits/per-user-marketing-limit.md) |
| Limite de mensagens do portfólio | Destinatários únicos fora da janela de 24 horas para o **portfólio empresarial** | [Limites de mensagens](https://knowledge.flowella.io/pt/whatsapp/limits/messaging-limits.md) |
| Modelo pausado ou Vermelho | As jornadas e as ações do HubSpot não podem depender desse modelo | [Modelo rejeitado](https://knowledge.flowella.io/pt/troubleshooting/template-rejected.md), [Mensagens não entregues](https://knowledge.flowella.io/pt/troubleshooting/messages-not-delivered.md) |

O Flowella mostra textos de falha diferentes para 131048 (a qualidade do seu número) e 131049 (o limite de marketing do destinatário). Trate-os como problemas diferentes.

## Prevenir descidas

* Torne o consentimento para o WhatsApp explícito quando recolher o número.
* Defina limites de frequência nos workflows do HubSpot.
* Segmente listas em vez de enviar um único modelo de marketing para todos os números de telefone do CRM.
* Esteja atento a picos precoces de falhas nos [Resultados](https://knowledge.flowella.io/pt/app/analytics.md) e pause antes que a Meta o passe para Vermelho.

## Guias relacionados

* [Ritmo e pausa de modelos](https://knowledge.flowella.io/pt/whatsapp/limits/template-pacing-and-pausing.md): modelos retidos, pausados e desativados
* [Débito](https://knowledge.flowella.io/pt/whatsapp/limits/throughput.md): o aumento para 1.000 mensagens por segundo exige qualidade Média
* [Limites de mensagens](https://knowledge.flowella.io/pt/whatsapp/limits/messaging-limits.md): limites do portfólio que a qualidade ajuda a desbloquear
* [Erro 131048](https://knowledge.flowella.io/pt/whatsapp/errors/error-131048.md): restrições de spam ou qualidade no seu número
* [Erro 131049](https://knowledge.flowella.io/pt/whatsapp/limits/per-user-marketing-limit.md): envolvimento saudável do ecossistema
* [Mensagens não entregues](https://knowledge.flowella.io/pt/troubleshooting/messages-not-delivered.md): resolução de problemas de entrega
* [Modelos](https://knowledge.flowella.io/pt/app/templates.md): etiquetas, pausas e envios retidos
* [Gerir cancelamentos de subscrição](https://knowledge.flowella.io/pt/app/opt-outs.md): mantenha o consentimento em ordem
* [Modelo rejeitado](https://knowledge.flowella.io/pt/troubleshooting/template-rejected.md): problemas de categoria e aprovação

Verificado com a documentação da Meta a 18 de novembro de 2026: [Template quality](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality), [Changes to messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/upcoming-messaging-limits-changes) e [Throughput](https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.