Saltar para o conteúdo principal
Quando um contacto diz que não recebeu a sua mensagem WhatsApp, encontre primeiro a mensagem no Flowella. O seu estado, e o motivo indicado pelo Flowella, dizem-lhe o que correu mal e o que deve corrigir.

Verificar o estado da mensagem

Abra a conversa na Inbox. Cada mensagem que envia mostra um ícone de estado junto à hora. O motivo de uma falha aparece por baixo da mensagem, por isso não precisa de passar o cursor por cima. Se o WhatsApp não indicou nenhum motivo, aparece apenas o ícone.

Encontrar a causa

Esta árvore de decisão mostra onde procurar, a partir do que vê na Inbox.

Mensagens que falharam

Quando uma mensagem mostra Failed, leia o motivo por baixo dela. Estes são os motivos mais comuns: A janela de 24 horas é a janela de atendimento ao cliente da Meta: as 24 horas após a última mensagem que o contacto lhe enviou. Para todos os outros códigos, consulte Códigos de erro do WhatsApp.

Mensagens que não estão na Inbox

Se não encontrar a mensagem na conversa, é porque nunca foi enviada: o Flowella ou o WhatsApp recusou-a, ou o Flowella está a retê-la. Verifique de onde foi enviada:
  • Um workflow do HubSpot. Abra o histórico de inscrições do workflow no HubSpot para esse contacto. O passo Send WhatsApp Template, Send WhatsApp Message ou Send WhatsApp Reply falhado mostra a mensagem de erro do Flowella, e o resultado Error code da ação contém um código curto. Consulte Códigos de falha das ações de envio.
  • Um envio em massa ou um envio de teste. Abra o modelo, selecione o separador Statistics e leia a coluna Details do Send log. Consulte Send log.
  • A Inbox ou a API. O Flowella mostra o motivo na Inbox, ou devolve-o na resposta da API, e não envia a mensagem.
Estes são os motivos habituais:
O Flowella bloqueia todas as mensagens para um número de telefone que fez opt-out no número WhatsApp a partir do qual envia. Isto abrange a Inbox, os envios em massa, Test Template, os workflows do HubSpot e a API.
  • No HubSpot, o passo falha com CONTACT_OPTED_OUT.
  • No Send log, Details indica “Recipient opted out of messages on this channel.”
  • Na Inbox, o Flowella indica “This contact opted out on this WhatsApp number.”
Para verificar, selecione o número WhatsApp a partir do qual enviou, selecione Opt-outs na barra lateral e procure o número de telefone. Cada número WhatsApp tem a sua própria lista. Respeite o opt-out. Utilize Re-opt in apenas quando o contacto tiver pedido para voltar a receber notícias suas. Consulte Opt-outs.
Quando o WhatsApp pausa ou desativa um modelo, o Flowella retém os envios em massa e os envios Send WhatsApp Template do HubSpot que o utilizam. Envia-os quando o WhatsApp restaurar o modelo, e a notificação Message template approved indica quantas tarefas de envio retidas foram retomadas. Entretanto, o passo do HubSpot aguarda o resultado do Flowella.Um modelo desativado permanece retido até o editar e voltar a submeter e a Meta o aprovar novamente. Não é possível enviar um modelo pausado ou desativado a partir da Inbox. Verifique a etiqueta do modelo na página Templates. Consulte Etiquetas de saúde de entrega e Modelos pausados ou desativados.
O Flowella para os envios quando o período de avaliação gratuito terminou, está no plano Free, a sua subscrição terminou ou um pagamento está em atraso há mais de 7 dias. Quando um pagamento falha, o envio continua a funcionar durante 7 dias. No período de avaliação gratuito, os envios a partir da Inbox, os envios em massa e a API também param quando atinge o limite de mensagens do período de avaliação.Na aplicação, vê Subscription required, Payment required ou Message limit reached. No HubSpot, o passo Send WhatsApp Template falha com uma mensagem a indicar que a sua subscrição não está ativa ou que o seu pagamento está em atraso. Consulte Ações bloqueadas pela faturação.
Os números de telefone têm de estar em formato internacional: um +, o indicativo do país e o número, como +447700900123. Um 0 inicial ou a falta do indicativo do país faz o envio falhar.
  • No HubSpot, o passo falha com CONTACT_PHONE_MISSING ou CONTACT_PHONE_INVALID.
  • No Send log, Details indica “Invalid phone number.”
Consulte Formato do número de telefone.
Se o mesmo modelo, no mesmo idioma, for enviado para o mesmo número de telefone a partir do mesmo número WhatsApp no espaço de 15 segundos, o Flowella envia-o uma vez. A repetição aparece como Suppressed no Send log, e o passo do HubSpot falha com DUPLICATE_TEMPLATE_SEND_SUPPRESSED. O número de telefone recebeu o modelo uma vez. Consulte Envio de modelo suprimido como duplicado.
Quando uma variável não tem valor para o contacto e o modelo não tem um valor alternativo confirmado, o Flowella não envia. O erro indica a variável, por exemplo “Variable {{1}} is empty and has no fallback value.” No HubSpot, o código de erro é VARIABLE_EMPTY_NO_FALLBACK. Consulte Valores alternativos.

Mensagens presas em Sent, Pending ou Held

Sent, mas nunca Delivered. O telemóvel do contacto pode estar desligado ou offline. O WhatsApp continua a tentar entregar durante algum tempo e depois descarta a mensagem. Consulte Time-to-live. Se o contacto bloqueou o seu número empresarial, as suas mensagens também ficam em Sent. Não há nada a corrigir no Flowella: contacte a pessoa por outro meio. Held. O WhatsApp pode controlar o ritmo de um modelo que é novo, que foi retomado recentemente ou que ainda não tem a classificação Green. Envia as primeiras mensagens e retém as restantes enquanto aguarda as reações das pessoas que as receberam. Se as reações forem boas, o WhatsApp envia as mensagens retidas. Se forem negativas, o WhatsApp descarta-as, estas falham com o código 132015 e o modelo é pausado. A Meta indica que o seu objetivo é entregar as mensagens de campanha com ritmo controlado no espaço de uma hora. Consulte a página de ritmo de modelos da Meta. Pending. O Flowella ainda não recebeu um estado do WhatsApp. Recarregue a conversa após alguns minutos. Se muitas mensagens permanecerem em Pending, consulte o estado da WhatsApp Business API da Meta para ver se há algum incidente.

Detetar problemas de entrega cedo

  • Dashboard. A faixa de atenção mostra Delivery failures quando mais de 5% das mensagens enviadas a partir do número selecionado nos últimos 7 dias falharam. Selecione Open analytics para ver o detalhe. Consulte Dashboard.
  • Results. O cartão Failure rate fica vermelho acima de 5%. Template performance mostra que modelos falham. Consulte Results.
  • Faixa de qualidade. Uma faixa vermelha no topo da aplicação indica “WhatsApp quality or account status needs attention” quando um dos seus números tem uma classificação de qualidade Red ou está restringido. Consulte Classificação de qualidade.
  • Notificações. O Flowella notifica todas as pessoas da sua organização, na aplicação e por e-mail, sobre estes eventos. Não é possível desativá-las.
    • WhatsApp quality rating: a qualidade de um número desce para Yellow ou Red.
    • Template paused: o WhatsApp pausa um modelo.
    • Template quality drop: a qualidade de um modelo desce para Red.
    Consulte Preferências de notificação.

Continua com problemas?

Contacte o suporte do Flowella com:
  • O número de telefone do contacto e o número WhatsApp a partir do qual enviou
  • A data e a hora do envio
  • O texto por baixo da mensagem, ou o código de erro do HubSpot ou do Send log
  • O nome do modelo, se enviou um modelo

Relacionado

Códigos de erro do WhatsApp

O que significa cada código e como o corrigir.

Falhas de sincronização HubSpot

Ações de workflow que falham e os respetivos códigos de erro.

Opt-outs

Verifique e gira os opt-outs de cada número WhatsApp.

Classificação de qualidade

Como a Meta classifica o seu número e os seus modelos.
Última modificação em 24 de outubro de 2026