Saúde de envios: como ler o painel de saúde do WhatsApp

Resposta rápida

A tela Saúde de Envios mostra, num único lugar, como estão saindo as mensagens da clínica: taxa de sucesso dos envios, status de cada canal/conexão do WhatsApp e eventuais restrições da Meta (API Oficial). É a primeira coisa a abrir quando o suporte reporta “muitas mensagens com erro” ou “canal caiu”.

Onde fica

Conversas → Saúde de Envios (rota /app/saude-envios).

O que cada widget mostra

A tela reúne três grupos de informação:

1. Status dos canais. Cada conexão do WhatsApp da clínica aparece com o status ao vivo (mesmo da tela de Conexões). Verde = conectado, vermelho = desconectado, amarelo = em reconexão, vermelho escuro = erro. É o consolidado de todos os números da clínica num lugar só.

2. Taxa de sucesso dos envios. Percentual de mensagens que efetivamente saíram sobre o total que o sistema tentou processar. Olha o número do dia e a tendência dos últimos dias. Queda sustentada é sinal de problema (conexão, número inválido, template reprovado).

3. Restrições da Meta. Quando a Meta aplica uma restrição de cobrança (código #131042 é o mais comum) ou uma limitação de envio, a tela sinaliza. É um alerta que exige ação — explicações abaixo.

Como interpretar os números

• Taxa de sucesso alta (acima de 95%) — operação saudável, sem ação.
• Taxa de sucesso caindo ou abaixo do esperado — investigue o motivo na Fila de Mensagens, olhando os erros do dia. Padrões comuns: número sem WhatsApp, template reprovado, contato que bloqueou.
• Canal vermelho — conexão perdida; clique no card e reconecte pelo QR Code (veja Conexões do WhatsApp).
• Restrição Meta — pode limitar o envio de mensagens de template ou a qualidade do número. Veja a próxima seção.

O que fazer quando aparece alerta

Canal desconectado. Abra o card da conexão e clique em QR Code para reconectar com o celular da clínica. As mensagens que estavam na fila saem automaticamente quando a conexão volta. Detalhes em Conexões do WhatsApp.

Taxa de sucesso baixa. Abra a Fila de Mensagens e filtre pelo status Erro no dia atual. O motivo de cada erro aparece na linha. Os mais comuns: número sem WhatsApp, template reprovado pela Meta, contato que bloqueou, janela de 24h fechada.

Restrição Meta (cobrança). A Meta aplica a restrição quando identifica que o número pode ter sido usado de forma não autorizada. A tela mostra o código e o motivo. Ações típicas: revisar templates suspeitos, comprovar uso comercial, abrir chamado com a Meta. Não ignore — se persistir, o número pode ser banido.

Como evitar cair em restrição

• Não envie mensagens em massa para contatos que não têm relação com a clínica.
• Respeite a janela de horário de envio (veja Janela de horário para envio de mensagens).
• Mantenha os templates da API Oficial revisados e aprovados pela Meta (veja Templates da API Oficial).
• Use o disparo em massa com moderação e audiência bem definida (veja Disparos em massa).

Mais dicas em Como evitar desconexões do WhatsApp.

Perguntas frequentes

O que é a tela Saúde de Envios? É o painel consolidado de como as mensagens da clínica estão saindo — taxa de sucesso, status dos canais e restrições da Meta, num lugar só.

A taxa de sucesso caiu. O que faço? Abra a Fila de Mensagens, filtre por Erro no dia e olhe os motivos. A maioria é configuração (número errado) ou canal — corrigível em minutos.

Apareceu “restrição Meta”. É grave? Pode ser. Indica que a Meta sinalizou o número. Ações variam (revisar templates, abrir chamado). Se persistir, o número pode ser limitado. Não ignore.

Como melhorar a taxa de sucesso? Mantenha os cadastros atualizados (telefones válidos), use a audiência certa nos disparos e respeite a janela de horário. A taxa de sucesso alta é construída no dia a dia.

Termos relacionados

saúde de envios · taxa de sucesso · status do canal · restrição Meta · template reprovado · Fila de Mensagens