Como ler a aba Errors

Quando alguns destinatários não receberam sua mensagem, a aba Errors mostra o motivo. Ela lista os envios com falha da mensagem, para que você possa consultar o que cada erro significa e corrigi-lo, ou exportar os envios com falha.

Para abrir a aba, vá para a página de estatísticas de mensagens da mensagem e clique em Errors, ao lado de Overview e Timeline.

O que a aba Errors mostra

A aba mostra os envios com falha de um canal. Se uma mensagem foi enviada por vários canais, a aba mostra o canal selecionado acima dela.

Os envios com falha são agrupados por plataforma, por exemplo iOS, Android ou Email. Clique em uma plataforma para recolher ou expandir seus erros. Cada grupo tem estas partes:

• Linha da plataforma: quantas mensagens foram enviadas nesta plataforma, quantas falharam e que proporção do público elegível do canal elas representam.
• Linhas de erro: uma linha por erro, exibida com seu nome e código, por exemplo Invalid To Phone Number (1001), com uma breve descrição abaixo. Cada linha tem sua própria contagem e sua proporção do mesmo público.

O selo vermelho na aba Errors é o número de envios com falha no canal selecionado, incluindo Erros de processamento. Sem envios com falha, não há selo.

Quando a aba está vazia

A aba mostra Nenhum erro de entrega para esta mensagem em dois casos:

• Nada falhou. Não há erros a listar.
• A mensagem falhou antes de ser enviada (status Com falha). Nada foi enviado, então não há nada a listar. Isso não significa que a mensagem foi entregue. O motivo aparece na aba Overview. Veja Por que uma mensagem falhou.

O que a aba não mostra

A aba lista apenas os envios que falharam antes ou durante a entrega da mensagem pela Pushwoosh à plataforma de entrega. Ela não lista:

• Exclusões de público. Assinantes deixados de fora de propósito, por exemplo pelo limite de frequência, pelo grupo de controle global ou por um cancelamento de inscrição anterior. A aba Overview os mostra nas linhas Excluídos.
• Rejeições depois que a plataforma de entrega aceitou a mensagem. Por exemplo, um SMS que a operadora não consegue entregar mais tarde. Esse envio conta como Aceitos pelo gateway na aba Overview e, até que a entrega seja confirmada, como Entrega não confirmada.
• Falhas temporárias que a Pushwoosh tenta novamente. Elas não são registradas como erros.

Consultar um erro

Para descobrir o que um erro significa e como corrigi-lo:

1. Leia o nome e o código na linha do erro. Erros diferentes podem compartilhar um código, por exemplo, Silent Hours (1041) e o erro do WhatsApp Template Is Paused (1041), então procure também pelo nome.
2. Procure-os em Erros em todas as plataformas.
3. Se não estiverem lá, abra a página da plataforma da linha em Erros de envio.
4. Se a linha tiver um nome de categoria em vez de um código, por exemplo Erro não classificado, encontre-o em Categorias de erro.

A Pushwoosh classifica cada erro em uma dessas categorias. A aba mostra o nome da categoria apenas para erros que não têm código.

Erros em todas as plataformas

Estes erros podem aparecer em qualquer plataforma, de push a SMS e mensageiros. A Pushwoosh os informa antes ou durante a entrega da mensagem à plataforma de entrega.

Erro	O que significa	O que fazer
Push Token Not Found (1007), Phone Number Not Found (1007) no SMS	O assinante não tem push token, número de telefone ou ID de chat para esta plataforma no projeto, então a Pushwoosh não enviou a mensagem.	Colete o contato e registre-o no projeto.
Platform Is Disabled (10005)	A plataforma está desativada no projeto.	Ative a plataforma em Settings > Configure Platforms. Se você não quiser enviar nesta plataforma, remova-a da mensagem.
Skip Push (1011)	Um placeholder não tinha valor para este assinante nem valor padrão. No SMS, e para textos montados a partir de um feed de produtos, ele também aparece quando o texto ficou vazio depois que os placeholders foram preenchidos.	Verifique os placeholders e seus valores padrão na mensagem ou na predefinição.
Unable To Compile Liquid Template (1014)	A mensagem contém um erro de sintaxe Liquid.	Corrija o template Liquid na mensagem ou na predefinição.
Silent Hours (1041)	O destinatário estava dentro das horas de silêncio do canal, e o Message behavior do canal é Do not send. Não é uma falha de entrega.	Não há nada a corrigir. Para alcançar esses destinatários, envie a mensagem sem horas de silêncio ou escolha Send after the silence period ends para o canal.
Internal Service Error (10006)	O envio falhou antes ou durante a entrega pela Pushwoosh à plataforma de entrega. Em algumas plataformas, ele também abrange erros de configuração; veja a página da plataforma em Erros de envio.	Se ele se repetir, entre em contato com o Suporte da Pushwoosh.

Categorias de erro

Cada categoria abaixo diz o que deu errado e o que fazer.

Categoria	O que significa	O que fazer
Token inválido ou expirado	O token ou endereço de e-mail não pode mais receber mensagens, por exemplo porque o aplicativo foi excluído ou o endereço é inválido.	Comum em grandes públicos. Compare com envios anteriores de tamanho semelhante. Aprofunde a investigação apenas se a proporção aumentar muito.
Sem token push	O assinante não tem push token, endereço de e-mail, número de telefone ou ID de chat nesta plataforma.	Para push, peça à sua equipe de desenvolvimento para verificar se o aplicativo registra os dispositivos. Para outros canais, colete e registre o contato.
Dispositivo não encontrado	O dispositivo não está no seu público da Pushwoosh.	Geralmente ocorre após filtros de segmento ou limpeza de público. Verifique quem foi o alvo.
Plataforma desativada	Esta plataforma está desativada no projeto, ou a API da plataforma de entrega está desativada, por exemplo a do Firebase Cloud Messaging.	Ative a plataforma na configuração do aplicativo ou remova-a do envio.
Cota do provedor excedida	Apple, Google ou outra plataforma de entrega limitou o envio, ou sua cota de envio de e-mails se esgotou.	Diminua a velocidade ou divida o envio. Verifique com o Suporte se isso continuar acontecendo.
Conteúdo da mensagem inválido	O conteúdo da mensagem foi rejeitado (vazio ou inválido).	Abra a predefinição ou o texto da mensagem e corrija o conteúdo vazio ou quebrado.
Configuração da plataforma inválida	As credenciais do aplicativo para esta plataforma estão erradas ou desatualizadas (certificados, chaves e similares).	Verifique a configuração da plataforma no Control Panel ou peça ao Suporte / seus desenvolvedores para renovar as credenciais.
Erro do provedor	A plataforma de entrega relatou um problema ou o código não foi reconhecido.	Alguns casos geralmente não são um problema. Muitos casos: entre em contato com o Suporte da Pushwoosh com a data da mensagem e o Código da mensagem.
Erro de processamento	Algo falhou no próprio processamento da Pushwoosh durante o envio.	Entre em contato com o Suporte da Pushwoosh.
Erro não classificado	O erro não se encaixou em um grupo conhecido.	Deve ser raro. Se você vir muitos, entre em contato com o Suporte com a data da mensagem e o Código da mensagem.

Para SMS, Viber, WhatsApp, Telegram, Facebook Messenger, Kakao e LINE, todo erro retornado pelo provedor é listado em Erro do provedor, qualquer que seja a causa, incluindo limites de envio, credenciais inválidas e problemas de template. Cota do provedor excedida e Configuração da plataforma inválida se aplicam apenas a push e e-mail. Para descobrir o que esse erro significa, procure seu nome e código em Erros de SMS e mensageiros.

Erros de processamento

Erros de processamento são falhas no próprio processamento da Pushwoosh: ao montar a mensagem, ao entregá-la ou ao ler a resposta da plataforma de entrega. Você os vê em dois lugares:

• A aba Errors os lista junto com os outros erros.
• Na aba Overview, o funil os mostra em uma linha própria, não entre os envios rejeitados.

Nota

Uma linha chamada Processing Error com um código entre colchetes é outra coisa: uma falha antes do envio que não tem nome próprio. Seu código pode pertencer a qualquer categoria. Por exemplo, uma mensagem do WhatsApp fora da janela de 24 horas aparece dessa forma.

Exportar erros

Você pode exportar um erro ou todos os erros da aba:

• Para exportar os destinatários de um erro, clique no ícone de download ao lado desse erro.
• Para exportar todos os erros em um único arquivo, clique em Exportar erros.

Exportar erros exige estas duas condições:

• A permissão Personal data na sua função.
• Acesso aos logs de mensagens na sua conta.

Se o ícone de download e Exportar erros não aparecerem, peça ao administrador da sua conta ou ao Suporte para verificar as duas condições. Linhas sem código não têm ícone de download. Use Exportar erros para incluí-las.