Fila de Envio WhatsApp

Ver Mais

O acompanhamento em segundo plano de tudo o que o sistema envia e recebe pelo WhatsApp.

Conceito

A Fila de Envio WhatsApp mostra as mensagens que o sistema colocou na fila para envio automático (avisos, alertas, comunicados e envios em lote) e os retornos que chegam do WhatsApp (confirmações de entrega e mensagens recebidas). O processamento é automático, em ordem, e a tela mostra somente os dados da própria empresa.

OBJETIVO

Dar visibilidade ao que aguarda envio, ao que já saiu e ao que falhou, com ações para reprocessar falhas e, em emergência, interromper os envios pendentes; e acompanhar o processamento dos retornos do WhatsApp.

Onde fica: Tela Fila de Envio WhatsApp (Fila WhatsApp). Na versão 5.5.0, a tela não consta no menu Integrações da base de demonstração.

ATENÇÃO

Este recurso depende da contratação do +Vidas WhatsApp. Para contratar, consulte a Hope Solution (suporte@hopesolution.com.br).

Os recursos da tela

A tela tem dois recursos: Envios (mensagens que saem do sistema) e Recebimentos (retornos que chegam do WhatsApp e são processados em segundo plano).

Recurso Envios: indicadores

Indicador	O que mostra
Pendentes	Mensagens aguardando a vez de envio.
Processando	Mensagens sendo enviadas no momento.
Enviados (24h)	O que saiu nas últimas 24 horas.
Erros (24h)	Envios que falharam nas últimas 24 horas, com o motivo registrado.
Sem confirmação (24h)	Mensagens aceitas pelo provedor, ainda sem confirmação de entrega. Volume alto pode indicar número bloqueado ou aparelho desligado.

Recurso Envios: colunas

Coluna	O que mostra
Status	A situação da mensagem na fila: Pendente, Processando, Enviado, Erro ou Cancelado.
Criado em e Concluído	Quando a mensagem entrou na fila e quando o envio terminou.
Entrega	A confirmação devolvida pelo WhatsApp após o envio (por exemplo, Entregue ou Lida).
Disp.	O dispositivo responsável pelo envio.
Destinatário e Telefone	Para quem a mensagem foi enviada.
Tipo	O tipo da mensagem (aviso, comunicado, envio em lote e outros).
Anexo	Se a mensagem tem arquivo anexo.
Tent.	Quantas tentativas de envio já foram feitas.
Usuário	Quem originou o envio, quando partiu de uma ação em tela.
Erro	A descrição da falha, quando o envio não foi concluído.

Recurso Envios: ações

Ação	O que faz
Atualizar	Recarrega os indicadores e a lista.
Reprocessar	Devolve para a fila os itens com falha de envio, para novo envio.
Cancelar Pendentes	Interrupção de emergência: cancela todos os itens da empresa que aguardam envio. Eles não serão enviados, e a ação não pode ser desfeita.

Os filtros permitem recortar a fila por situação, período, dispositivo e lote, para acompanhar um envio em massa específico ou investigar as falhas de um dia.

Recurso Recebimentos

Mostra os retornos que chegam do WhatsApp e são processados em segundo plano: confirmações de entrega e mensagens recebidas. Os indicadores são Pendentes, Processando, Concluídos, Erros e Espera (min), que é a idade do item mais antigo aguardando; acima de alguns minutos, indica atraso no processamento.

Coluna	O que mostra
Status	Pendente, Processando, Concluído ou Erro.
Recebido em e Processado	Quando o retorno chegou e quando foi processado.
Evento	O tipo do retorno (confirmação de entrega, mensagem recebida e outros).
ID da mensagem e Instância	Identificadores para rastrear a mensagem no aparelho de origem.
Tent. e Erro	As tentativas de processamento e a descrição da falha, quando houver.

As ações são Atualizar e Reprocessar (devolve à fila os retornos com falha; o reprocessamento não duplica o que já foi gravado). Cada item permite ver o conteúdo bruto recebido, para diagnóstico.

Regras de envio: horário, ritmo e limites

Valores em vigor no servidor em 01/10/2026. Os limites valem por aparelho (cada número conectado em Integrações, WhatsApp), e não por empresa.

Regra	Fila (telas, lotes, alertas, Pega Plantão)	Chat de WhatsApp (envio direto)
Horário	Envios em massa das 6h às 23h; Pega Plantão e envio individual pela tela a qualquer hora.	Qualquer hora.
Por minuto	Sem número fixo; o ritmo das rodadas controla (cerca de 9 a 10 por aparelho).	12 por aparelho.
Por dia	500 por aparelho; a contagem zera à meia-noite.	500 nas últimas 24 horas por aparelho; a contagem é móvel.
Ao atingir o limite	A mensagem não se perde: aguarda a virada do dia na fila, dentro da validade de 24 horas.	A mensagem é recusada, e o usuário precisa tentar de novo.
Validade	Mensagem aguardando há mais de 24 horas é cancelada; até 5 tentativas por mensagem.	Não se aplica.

A fila trabalha em rodadas: cada aparelho envia de 6 a 10 mensagens por rodada, com espera de 1 a 3 segundos entre mensagens, 30 segundos entre rodadas e pausas ocasionais de 2 a 5 minutos. O ritmo é irregular de propósito, porque o WhatsApp tende a bloquear números que enviam em cadência automática. Um lote de 500 mensagens leva cerca de 1h20 a 1h30 para sair (estimativa pela configuração). Um envio em massa criado de madrugada fica Pendente e sai a partir das 6h; isso não é falha.

Proteções automáticas: número sem WhatsApp vira Erro sem tentativa; aparelho desconectado devolve as mensagens à fila sem gastar tentativa; 15 envios seguidos sem confirmação de entrega pausam o aparelho por 30 minutos (sinal de número bloqueado). Número recém-desbloqueado deve ficar entre 50 e 100 mensagens por dia durante 1 a 2 semanas.

Ver também: +Vidas WhatsApp: Perguntas e Respostas, seção Regras de envio.

Como se comunica com os outros processos

Processo	Ligação
Telas de envio	Os envios feitos nas telas (faturas, avisos, comunicados, lotes) entram nesta fila para sair em ritmo seguro.
Configuração do WhatsApp	Os dispositivos cadastrados são os responsáveis pelos envios exibidos na coluna Disp.
Confirmações de entrega	Os retornos processados no recurso Recebimentos atualizam a coluna Entrega do recurso Envios.

PRÓXIMO PASSO

Para as perguntas mais frequentes, veja +Vidas WhatsApp: Perguntas e Respostas.

whatsapp envio

Fila de Envio WhatsApp

Contact Us

Artigos Relacionados