Fila de Mensagens: como ler e o que fazer quando a mensagem não sai

Resposta rápida

A Fila de Mensagens é a tela que mostra tudo o que o sistema tentou enviar pelo WhatsApp da clínica: o que ainda vai sair, o que já saiu, o que falhou e por quê. Use a aba Fila ativa para ver o que está em jogo agora e a aba Histórico para o que já foi processado. Quando uma mensagem não chega, a Fila é o primeiro lugar a olhar — quase sempre ela mostra o motivo e o que fazer.

Diagnóstico rápido (na maioria dos casos)

Na grande maioria das vezes, “a mensagem não foi” é configuração, não erro do sistema. Verifique, nesta ordem: (1) o WhatsApp está conectado? (2) o envio está dentro da janela de horário? (3) a confirmação automática está ativada? (4) o paciente está na regra de público? Se passar pelos quatro e ainda assim não enviar, abra a Fila de Mensagens e procure a mensagem — o motivo e a solução aparecem na linha.

Conexões do WhatsApp — canal Conectado (verde)?
Janela de horário — o envio caiu dentro da janela permitida?
Confirmação automática — está ativada e com texto/horário salvos?
Quem recebe — o paciente está na regra de público?

A tela Fila de Mensagens

Conversas → Fila de Mensagens (rota /app/fila-de-mensagens).

Aba “Fila ativa” — o que ainda vai sair: mensagens pendentes, executando e pausadas.
Aba “Histórico” — o que já foi finalizado: enviado, erro e cancelado. O contador vermelho na aba mostra quantos erros o dia teve.
A tela navega por dia (setas e calendário) e pode filtrar por status, canal, tipo de mensagem e texto. Dá para exportar CSV.

Clique numa linha para expandir a linha do tempo da mensagem: agendada → enviada → entregue → lida → respondida (ou o ponto em que parou). Mensagens enviadas ainda mostram o estágio de entrega do WhatsApp: Enviado (1 check), Entregue (2 checks), Lido.

O que cada status significa

Status	Significado	O que você pode fazer
Pendente / Agendado	Aguardando o horário ou a vez na fila	Enviar agora, pausar, cancelar, trocar canal
Executando	Saindo neste momento	Aguardar
Pausado	Alguém pausou manualmente	Retomar (volta a valer a partir de agora) ou cancelar
Enviado	Saiu com sucesso	Acompanhar entrega/leitura na linha
Erro	Falhou — o motivo aparece na faixa vermelha	Corrigir a causa e usar Reenviar
Cancelado	Cancelada manualmente ou pelo sistema	Reenviar, se fizer sentido

Mensagem com ERRO: os motivos mais comuns

A faixa vermelha da linha diz o motivo e o que fazer. Os frequentes:

Canal desconectado / sessão expirada — o WhatsApp da clínica caiu. Use o botão “Abrir conexões” e reconecte pelo QR Code (veja Conexões do WhatsApp).
Número sem WhatsApp / número inválido — o telefone do cadastro está errado ou não tem WhatsApp. Corrija o telefone na ficha do lead/cliente e reenvie.
Lead sem telefone — o cadastro não tem número. Complete o cadastro.
Janela de 24h fechada (canais API Oficial) — fora da janela de 24h desde a última mensagem do cliente, só é possível enviar templates aprovados (veja Templates da API Oficial).
Contato precisa responder primeiro — o WhatsApp exige que esse contato inicie a conversa; peça para o cliente mandar um “oi”.

Mensagem PENDENTE que não sai: o que verificar

Pendente não é erro — é “ainda não chegou a vez”. Ela pode estar esperando por:

O horário programado — mensagens agendadas para mais tarde ficam pendentes até lá. A coluna de horário mostra quando.
A reconexão do canal — se o WhatsApp da clínica está desconectado, o sistema segura a mensagem e envia sozinho quando a conexão voltar. Reconecte e aguarde alguns minutos.
A vez na fila do canal — para proteger o número contra bloqueio, o sistema espaça os envios: cada canal envia uma remessa por ciclo (1 a 5 minutos, conforme a prioridade). Com muitas mensagens no mesmo número, elas saem aos poucos — é proposital.
Mensagem presa de um dia anterior — a fila processa as mensagens do dia. Se uma mensagem de ontem ficou pendente (por exemplo, o canal passou o dia desconectado), navegue até o dia dela e use “Enviar agora”, que a despacha na hora.

”A confirmação de agendamento não foi” — causas específicas

Direto da agenda você também consegue conferir: abra o agendamento e veja o status de confirmação, que lista o histórico de envio daquele agendamento (com botão “Ir para a fila”).

Se não há registro nenhum de envio, verifique nesta ordem:

A mensagem da categoria está ativa? Sem uma mensagem de “Confirmação de Agendamento” configurada e ativa, nada dispara.
O serviço do agendamento está vinculado à mensagem? Se a mensagem tem serviços selecionados, agendamentos de outros serviços não disparam. Mensagem sem serviços vinculados vale para todos.
O agendamento está muito distante? Se a configuração define uma janela de dias, agendamentos além dela não disparam a mensagem no ato do agendamento.
Já houve envio igual no mesmo dia? O sistema não envia a mesma mensagem duas vezes para o mesmo agendamento no mesmo dia (proteção contra duplicata). Reagendar para outra data gera um novo envio normalmente.
O agendamento foi editado/reagendado? O sistema recalcula o envio para a nova data; se o agendamento foi cancelado ou já passou, a mensagem programada é cancelada (aparece no histórico como cancelada, com o motivo).

Aniversário: além da mensagem ativa, a categoria Aniversário tem um horário de envio próprio — confira se está configurado.

”Mudei o status na agenda e a mensagem não saiu”

As mensagens ligadas ao status do agendamento (Confirmado, Chegou, Atendimento Finalizado, Faltou, Cancelamento) têm um prazo para o status ser mudado. É o que impede a agenda de disparar mensagens antigas quando alguém corrige um dia passado — mas também significa que mudar o status muito depois não envia nada, sem erro na fila (o disparo nem chega a ser gerado).

Mensagem	Prazo para mudar o status
Confirmação de Agendamento, Cliente Chegou	até 2 horas depois do início do agendamento
Atendimento Finalizado, Faltou, Cancelamento	até o fim do dia do agendamento

Na prática:

Finalizar a agenda no fim do expediente funciona normalmente — mesmo horas depois do procedimento, e mesmo em procedimentos longos (uma criolipólise das 11h às 13h30 finalizada às 17h envia).
Finalizar, cancelar ou marcar falta no dia seguinte não envia. Se a recepção esqueceu de fechar a agenda e só ajustou depois, a mensagem daquele atendimento não sai — nesse caso, envie manualmente pela conversa do cliente.
Marcar “Chegou” muito depois do horário não dispara o aviso de chegada, porque esse aviso só faz sentido no momento da chegada.

O prazo de cada categoria também aparece na própria tela de configuração da mensagem, no bloco “Quando esta mensagem é enviada”.

Atendimento Finalizado é por dia, não por procedimento. A mensagem só sai quando todos os atendimentos do cliente naquele dia estiverem finalizados. Enquanto houver procedimento pendente com outro profissional, o sistema envia a mensagem de Disponível para Próximo Atendimento; a de Atendimento Finalizado sai ao concluir o último. E, se a mensagem tem serviços vinculados, ela só vale para agendamentos desses serviços.

Janela de horário de envio

Mensagens de automação podem ter uma janela de horário (“A partir de / Até”) configurada em cada ação: se o horário calculado cai antes da janela, o envio é adiado para o início dela; se cai depois, vai para o início da janela do dia seguinte. Sem janela configurada, a mensagem sai no horário calculado — inclusive de madrugada. Detalhes em Janela de horário de envio.

Histórico por mensagem

Dentro da configuração de cada mensagem há uma aba de histórico com os números do dia (total, enviado, entregue, lido, respondido, erro) e busca por nome/telefone — útil para responder “essa campanha chegou em quem?” sem sair da tela. Para conferir se um disparo em massa específico saiu, veja Como conferir se a mensagem foi enviada.

Checklist-resumo

Abra a Fila de Mensagens no dia certo e ache a mensagem.
Erro? Leia o motivo na faixa vermelha, corrija e Reenviar.
Pendente? Confira horário programado, conexão do canal e espaçamento; de outro dia, use Enviar agora.
Nem aparece na fila? O disparo não foi gerado — confira mensagem ativa, vínculo de serviço, o prazo do status (seção acima) e as causas da seção de confirmação.
Persistiu? Chame o suporte informando clínica, telefone do cliente e horário — com isso a equipe localiza a mensagem nos registros internos rapidamente.

Falar com suporte

Perguntas frequentes

As mensagens não estão sendo enviadas / parou de enviar. Comece pela conexão do WhatsApp (status verde). Depois cheque janela de horário, confirmação ativada e regra de público. Se ainda assim não sair, abra a Fila de Mensagens e procure a linha com erro.

A mensagem automática não chegou para um cliente específico. Abra a Fila de Mensagens no dia do envio, ache a mensagem pelo nome/telefone e veja o status. Se está “Enviado”, a entrega/leitura aparece na linha do tempo. Se está “Erro”, a causa está na faixa vermelha.

Não consigo enviar pelo telefone comercial / parou só em uma unidade. Provavelmente a conexão daquele número/unidade caiu. Verifique e reconecte aquela conexão específica. Aparece também na tela Saúde de Envios (status dos canais).

Parou de enviar depois de uma atualização do sistema. Reconfira se a confirmação continua ativada e se o texto/horário foram mantidos. Se estava tudo certo e parou mesmo assim, registre um exemplo e chame o suporte.

O áudio não está sendo enviado. Verifique a conexão do WhatsApp; falha só em áudio, com a conexão verde, deve ser reportada ao suporte.

Termos relacionados

Fila de Mensagens · fila ativa · histórico · status de envio · enviado · entregue · lido · erro · cancelado · conexão caiu · janela de horário · fora do funil