#Por que um bloco da minha automação está falhando?

Olhe debaixo dos números do bloco no canvas. Quando o bloco já teve falhas, aparece o alerta Principais motivos de falha com até 3 motivos, cada um com a quantidade de ocorrências e quando aconteceu pela última vez. Clique em um motivo para ver quem falhou com ele e, dali, reproduzir a execução passo a passo.

Papel: qualquer membro com acesso ao workspace.

#Antes de começar

• A automação precisa estar publicada e ter rodado. No rascunho o canvas não mostra os números dos blocos, então o alerta também não aparece.
• O alerta fica no mesmo lugar dos números do bloco. Blocos que não mostram números também não mostram o alerta.
• Só contam execuções reais. Disparos de teste não entram no alerta, assim como não entram nos outros números do bloco.

#Passo a passo

1. Abra a automação e encontre o bloco que tem falhas.
2. Debaixo dos números do bloco, leia o alerta Principais motivos de falha. Cada linha mostra:
   • o motivo, em linguagem simples, e o que fazer para resolver, quando houver uma ação recomendada;
   • quantas vezes aconteceu;
   • quando foi a última vez e, se aconteceu no último dia, quantas vezes foi nas últimas 24h.
3. Clique no motivo para abrir a janela com os contatos que falharam com ele neste bloco. Ao lado de cada contato aparecem a data da falha mais recente e, se ele falhou mais de uma vez, quantas vezes (por exemplo, 3×).
4. Clique em Depurar ao lado do contato. A janela fecha e o painel Execução passo a passo abre sobre o canvas com a falha mais recente dele, mostrando por onde passou e onde parou. Veja Como acompanhar uma execução passo a passo.
5. Para ver todos que falharam no bloco, sem separar por motivo, clique em Ver todos que falharam no fim do alerta. Nos blocos de envio de mensagem o link se chama Ver todos com falha de envio e lista só as mensagens recusadas; as falhas de execução desse bloco você abre pela linha do motivo.

Depois de corrigir a causa, use Retentar todas na mesma janela para as execuções daquele motivo voltarem a rodar a partir do bloco. O botão só aparece nas falhas de execução. Veja Como tentar de novo uma execução que falhou?.

Da mesma janela você pode salvar o grupo como uma lista para tratar depois. O passo a passo está em Como ver quais contatos falharam em cada erro da automação. Saindo do alerta do bloco, a lista recebe só quem falhou naquele bloco.

#Por que o motivo com menos ocorrências aparece primeiro

O alerta põe no topo o que está falhando agora. Motivos com ocorrência nas últimas 24h vêm antes, do mais frequente nesse período para o menos frequente. Depois vêm os motivos mais antigos, ordenados pelo total.

Assim, um erro que você já corrigiu na semana passada não esconde o erro novo, mesmo tendo mais ocorrências acumuladas. Motivos com um ponto vermelho e texto em vermelho aconteceram nas últimas 24h.

#Dois tipos de falha no mesmo bloco

Nos blocos de envio de mensagem, o alerta junta os dois tipos de falha e, quando os dois aparecem, marca cada linha com o tipo:

• envio: a mensagem foi disparada e o provedor recusou (número inválido, limite de envio, janela de 24h do WhatsApp fechada) ou avisou depois que não conseguiu entregar. Também entra aqui a mensagem que virou rascunho porque um atendente estava ativo na conversa: ela não saiu pelo WhatsApp e ficou no chat para o atendente revisar e enviar.
• execução: a automação parou neste bloco, às vezes sem chegar a enviar nada.

Nos demais blocos, só aparecem falhas de execução: as execuções que pararam com erro naquele bloco.

#Por que a janela mostra menos contatos que o número do alerta

O alerta conta ocorrências. A janela lista contatos. Quem falhou mais de uma vez com o mesmo motivo, por ter entrado de novo na automação ou por uma nova tentativa, aparece uma vez só, com o total de vezes ao lado. Em falhas de execução, entram só os contatos que a automação conseguiu identificar.

Para ver os erros da automação inteira, e não de um bloco só, use o cartão Principais erros da aba Execuções.