Erros de SMS e mensageiros

Esta página lista os erros que um envio por SMS ou mensageiro pode mostrar na aba Erros de Estatísticas da mensagem e o que fazer em cada caso. Os erros que qualquer plataforma pode mostrar, como Phone Number Not Found ou Skip Push, estão em Como ler a aba Erros.

Como os erros de SMS e mensageiros aparecem na aba Erros

A aba Erros agrupa os envios com falha por plataforma. Cada linha mostra o nome do erro com o código entre parênteses, por exemplo Invalid To Phone Number (1001).

Procurar um erro

Procure um erro pelo nome e pelo código juntos. O mesmo número pode corresponder a erros diferentes, porque a Pushwoosh verifica uma mensagem em várias etapas. Por exemplo, Skip Push (1011) e Send Quota Exceeded (1011) são erros diferentes.

A maioria dos erros vem do seu provedor de SMS ou do mensageiro. A Pushwoosh os conta na categoria Erro do provedor, seja qual for a causa. Consulte Categorias de erros para saber o que cada categoria significa.

O que a aba Erros não mostra

A aba lista apenas os erros retornados no momento em que a Pushwoosh envia a mensagem. Estes casos não aparecem:

Falhas depois que o provedor ou o mensageiro aceitou a mensagem. Por exemplo, uma falha na operadora de telefonia móvel. O envio conta como aceito.
Algumas falhas temporárias. Incluem a maioria dos erros de rede. A Pushwoosh os repete automaticamente. No WhatsApp, um erro de rede não é repetido e aparece como Internal Service Error (10006).
Assinantes ignorados sem consentimento de marketing. A Pushwoosh os exclui do público antes do envio, então eles não são erros.

Erros de SMS

Esses erros vêm do seu provedor de SMS ou das configurações de SMS do seu projeto. Os erros que você vê dependem do provedor. Por exemplo, a Twilio informa um descadastramento, um número inválido e um remetente não permitido para o país como Bad Request (1006), e não como os erros mais específicos abaixo.

Problemas com o número de telefone

Esses erros são causados pelo número de telefone do destinatário, e não pela configuração do seu provedor.

Erro	Descrição	O que fazer
Invalid To Phone Number (1001)	O número de telefone não pode ser lido ou não tem código do país. A Pushwoosh cancela a inscrição do número no SMS.	Armazene os números de telefone no formato internacional com o código do país, por exemplo `+14155550100`, e registre o número novamente.
Unsubscribed Recipient (1002)	A pessoa cancelou o recebimento das suas mensagens junto à operadora de telefonia móvel, ou o número está na lista de bloqueio do seu provedor. Após um descadastramento pela operadora, a Pushwoosh cancela a inscrição do número no SMS e registra o descadastramento.	Não envie mensagens de marketing para este número. Consulte Descadastramentos que a Pushwoosh registra automaticamente. Se a pessoa não se descadastrou, verifique a lista de bloqueio no painel do seu provedor.

Conta e configuração do provedor

Esses erros significam que o seu provedor de SMS rejeitou a solicitação por causa da conta, das credenciais, do remetente ou da mensagem.

Erro	Descrição	O que fazer
Bad Request (1006)	O provedor rejeitou a solicitação. Na Twilio, isso também inclui uma pessoa que se descadastrou junto à operadora de telefonia móvel, um número inválido ou que não é de celular e um remetente que não é permitido para o país do destinatário.	Verifique o número do destinatário e o remetente para esse país no painel do seu provedor. Se a pessoa se descadastrou, pare de enviar mensagens para ela.
No Permission For Region (1003)	O país do destinatário não é permitido para este projeto ou provedor, ou as credenciais ou o remetente do provedor não estão definidos na configuração de SMS.	Verifique as credenciais do provedor e o número do remetente na configuração de SMS. Se estiverem corretos, entre em contato com o Suporte da Pushwoosh para verificar para quais países o projeto pode enviar SMS.
Invalid To From Combination (1012)	O seu ID de remetente não tem permissão para enviar para o país do destinatário, ou nenhum ID de remetente está definido na configuração de SMS.	Verifique no painel do seu provedor qual remetente usar para esse país.
Permission Denied (1015)	O provedor não aceitou as suas credenciais.	Compare as credenciais da configuração de SMS com as do painel do seu provedor.
Forbidden (1007)	O provedor recusou a solicitação ou a conexão, por exemplo por causa de credenciais incorretas, ou a conexão de SMS não está configurada.	Compare as credenciais da configuração de SMS com as do painel do seu provedor.
Account Is Inactive (1014)	A sua conta no provedor de SMS está suspensa.	Restabeleça a conta junto ao seu provedor.
Not Found (1008)	O provedor não encontrou a conta ou o remetente indicados na solicitação.	Verifique as configurações da conta e do remetente no painel do seu provedor.
Invalid MMS Attachment (1016)	O provedor rejeitou o arquivo anexado por causa do formato ou do tamanho.	Anexe um arquivo menor em um formato compatível com o seu provedor.
Internal Service Error (10006)	No SMS, também pode significar que o envio de SMS não está habilitado para a sua conta.	Entre em contato com o Suporte da Pushwoosh.

Limites de envio

Este erro significa que o envio atingiu um limite na quantidade de SMS, e não que há um problema com a mensagem.

Erro	Descrição	O que fazer
Send Quota Exceeded (1011)	O projeto atingiu o limite diário de SMS, ou o provedor limitou o envio. A Pushwoosh define o limite diário de SMS quando você configura o SMS para o projeto.	Entre em contato com o Suporte da Pushwoosh sobre o limite diário de SMS. Divida envios grandes em vários dias.

Falhas do provedor

Esses erros significam que o provedor não conseguiu processar a mensagem ou retornou uma resposta que a Pushwoosh não conseguiu ler.

Erro	Descrição	O que fazer
Unknown Error (1000), Converting Error (1004), Provider Unknown Error (1009), Provider Internal Error (1010)	O provedor retornou um erro que a Pushwoosh não reconhece, ou falhou do lado dele. Converting Error também pode significar que as configurações do provedor na configuração de SMS estão incompletas.	Compare a quantidade desses erros com envios anteriores de tamanho semelhante. Se aumentarem ou se repetirem a cada envio, entre em contato com o Suporte da Pushwoosh.

Erros do Viber

Além dos erros que qualquer plataforma pode mostrar, os envios do Viber podem mostrar estes dois. A Pushwoosh envia mensagens do Viber pela MStat, usando as credenciais da MStat da sua configuração de SMS.

Se um assinante não tiver nenhum contato do Viber no projeto, o envio falha com Push Token Not Found (1007), um dos erros que qualquer plataforma pode mostrar.

Erro	Descrição	O que fazer
No Device For Push Token (10002)	O contato do Viber do assinante está salvo sem número de telefone.	Registre novamente o número do assinante para o Viber. Consulte Registrar contatos do Viber.
Internal Service Error (10006)	As credenciais ou o ID da conta da MStat estão ausentes, o conteúdo da mensagem é inválido ou a MStat rejeitou a mensagem. A aba Erros não mostra qual desses casos ocorreu.	Verifique se a MStat está configurada com credenciais válidas na configuração de SMS e confira o conteúdo da mensagem. Se ambos estiverem corretos, entre em contato com o Suporte da Pushwoosh.

Erros do WhatsApp

A maioria dos erros do WhatsApp vem da Meta. Muitas vezes a Meta primeiro aceita uma mensagem e depois a rejeita, por exemplo quando o número não está no WhatsApp ou quando a Meta limita as mensagens de marketing para essa pessoa. Um envio assim conta como Aceitos pelo gateway no funil, não recebe confirmação de entrega e não aparece na aba Erros.

Mensagens fora da janela de 24 horas

Uma mensagem de formato livre, ou seja, enviada sem um modelo aprovado, só chega a uma pessoa dentro de 24 horas após a última mensagem dela para o seu número comercial. Fora dessa janela, o envio falha com um destes erros.

Erro	Descrição	O que fazer
Re Engagement Message (1030)	A pessoa não escreveu para o seu número comercial nas últimas 24 horas.	Envie um modelo aprovado em vez de texto livre.
Processing Error (1035)	A Pushwoosh ignorou uma mensagem de formato livre porque a janela de 24 horas já havia se fechado.	Envie um modelo aprovado em vez de texto livre.

Erros do destinatário

Esses erros são causados pelo destinatário ou pela frequência com que você envia mensagens para ele.

Erro	Descrição	O que fazer
Recipient Invalid Phone Number (1011)	O número do destinatário é o mesmo que o seu número comercial.	Remova o seu próprio número comercial do público.
Accounts Pair Rate Limit Hit (1059)	Você enviou mensagens demais para a mesma pessoa em pouco tempo.	Espace as mensagens para a mesma pessoa.

Erros de modelo e de conteúdo

Esses erros significam que a Meta rejeitou o modelo ou o conteúdo da mensagem.

Erro	Descrição	O que fazer
Template Does Not Exist (1037)	O modelo não existe no idioma selecionado ou ainda não foi aprovado.	Verifique o modelo e os idiomas dele no WhatsApp Manager e, em seguida, escolha um modelo aprovado na predefinição.
Template Param Count Mismatch (1036)	A quantidade de valores de variáveis não corresponde à quantidade de variáveis do modelo.	Preencha todas as variáveis do modelo na predefinição.
Template Parameter Format Mismatch (1040)	O valor de uma variável está no formato errado.	Compare os valores das variáveis com o modelo no WhatsApp Manager.
Template Hydrated Text Too Long (1038)	O texto fica longo demais depois que as variáveis são preenchidas.	Encurte os valores das variáveis ou o texto do modelo.
Template Format Character Policy Violated (1039)	O conteúdo do modelo viola uma política do WhatsApp.	Edite o modelo no WhatsApp Manager e envie-o novamente para aprovação.
Template Is Paused (1041)	A Meta pausou o modelo por causa da baixa qualidade. Não é o mesmo que Silent Hours (1041), consulte Como ler a aba Errors.	Use outro modelo aprovado ou melhore este no WhatsApp Manager.
Template Is Disabled (1042)	A Meta pausou o modelo vezes demais e o desativou permanentemente.	Crie um novo modelo e use-o na predefinição.
Request Invalid Parameter (1010), Request Missing Required Parameter (1009), Parameter Value Is Not Valid (1020), Generic User Error (1053)	Um valor da mensagem está ausente ou é inválido.	Verifique a predefinição: modelo, variáveis, botões e anexo.
Unsupported Message Type (1032)	O WhatsApp não oferece suporte a este tipo de mensagem.	Altere o tipo de conteúdo na predefinição.
Media Upload Error (1034)	A Meta não conseguiu carregar a mídia anexada.	Use um arquivo em uma URL pública `https` e em um formato compatível com o WhatsApp.

Erros de conta e de qualidade

Esses erros significam que a Meta restringiu a sua WhatsApp Business Account ou o seu número comercial. Resolva-os no WhatsApp Manager, conforme descrito em Como corrigir um remetente bloqueado ou limitado.

Erro	Descrição	O que fazer
Temporarily Blocked For Policies Violations (1005)	A Meta bloqueou a conta por violar as políticas dela.	Verifique o status da conta no WhatsApp Manager.
Account Has Been Locked (1017)	A Meta bloqueou a conta por uma violação de política, ou não conseguiu verificar os dados da solicitação.	Verifique o status da conta no WhatsApp Manager.
Account Is Restricted From Messaging In This Country (1016)	A conta não pode enviar mensagens para usuários deste país.	Verifique as restrições da conta no WhatsApp Manager.
Spam Rate Limit Hit (1008)	A Meta limita quantas mensagens este número pode enviar, porque muitas mensagens anteriores foram bloqueadas ou denunciadas como spam.	Revise o conteúdo e o público das mensagens recentes e, em seguida, reduza o volume.
Business Eligibility Payment Issue (1028)	Há um problema com a forma de pagamento da conta.	Verifique a forma de pagamento no WhatsApp Manager.
Provided Number Needs Display Name Approval (1027)	O nome de exibição do seu número comercial ainda não foi aprovado.	Aguarde a aprovação ou atualize o nome de exibição no WhatsApp Manager.
Business Phone Number Is Deleted (1024)	O seu número comercial foi excluído.	Conecte um número ativo na configuração do WhatsApp.
Account In Maintenance Mode (1035)	A conta está em modo de manutenção. Este é um erro diferente de Processing Error (1035) em Mensagens fora da janela de 24 horas.	Tente novamente mais tarde.

Erros de configuração e de permissão

Esses erros significam que a conexão entre a Pushwoosh e a sua WhatsApp Business Account não funciona. Reconecte a sua WhatsApp Business Account em Settings > Configure Platforms > WhatsApp, conforme descrito em Configuração do WhatsApp.

Erro	Descrição	O que fazer
Access Token Expired (1003)	O token de acesso da conexão expirou.	Reconecte a conta.
Authentication Failed (1002), Permission Denied (1013), API Permission (1014), API Method (1015), Access Denied (1023)	A Meta não aceitou a conexão ou falta uma permissão.	Reconecte a conta e conceda todas as permissões solicitadas.
Incorrect Certificate (1029)	O número comercial não está registrado corretamente.	Verifique o número comercial no WhatsApp Manager e, em seguida, reconecte a conta.
Internal Service Error (10006)	O número comercial ou o token de acesso está ausente da configuração do WhatsApp, ou a Pushwoosh não conseguiu se comunicar com a Meta ou ler a resposta dela.	Verifique a configuração do WhatsApp e reconecte a conta, se necessário. Se o erro se repetir, entre em contato com o Suporte da Pushwoosh.

Limites de taxa

Esses erros significam que você enviou mais rápido do que a Meta permite para o seu aplicativo ou conta.

Erro	Descrição	O que fazer
Rate Limit Hit (1058)	A taxa máxima de mensagens do seu número foi atingida.	Reduza a taxa de envio ou divida o envio em lotes menores.
API Too Many Calls (1056), Rate Limit Issues (1057)	O aplicativo ou a conta atingiu o limite de solicitações.	Reduza a taxa de envio ou divida o envio em lotes menores.

Erros temporários da Meta

Esses erros significam que a Meta falhou do lado dela ou retornou uma resposta que a Pushwoosh não reconhece.

Erro	Descrição	O que fazer
API Unknown (1018), API Service (1019), Something Went Wrong (1022), Service Unavailable (1025), Server Temporary Unavailable (1046)	Um erro temporário do lado da Meta.	Envie a mensagem novamente mais tarde. Se o erro se repetir, entre em contato com o Suporte da Pushwoosh informando a data da mensagem e o Código da mensagem.
Unknown Error (1000), Cannot Process Sending (1012)	A Meta retornou um erro que a Pushwoosh não reconhece, ou uma resposta que ela não conseguiu ler.	Se o erro se repetir, entre em contato com o Suporte da Pushwoosh informando a data da mensagem e o Código da mensagem.

Erros do Telegram

Os envios do Telegram mostram dois erros próprios.

Erro	Descrição	O que fazer
Chat Unavailable (410007)	A pessoa bloqueou ou removeu o bot, o chat não foi encontrado ou a conta do Telegram foi desativada. A Pushwoosh cancela a inscrição da pessoa no Telegram.	Não há nada a corrigir. A pessoa não pode receber mensagens do bot.
Invalid Authentication Info (401002)	O token do bot está ausente ou é inválido. Ele também aparece quando o ID de chat do Telegram de um assinante não é válido, e nesse caso a Pushwoosh cancela a inscrição desse assinante, ou quando a Pushwoosh não conseguiu se comunicar com o Telegram para verificar o token.	Verifique o token do bot na configuração do Telegram.

Erros do Facebook Messenger

Esses erros vêm da Meta quando a Pushwoosh envia uma mensagem a partir da sua página do Facebook.

Erro	Descrição	O que fazer
Outside Allowed Window (403004)	A pessoa não escreveu para a sua página nas últimas 24 horas, e a mensagem não tem tag de mensagem. A Pushwoosh não filtra essas pessoas do público, então cada envio desse tipo falha com este erro.	Fora da janela de 24 horas, envie com uma tag de mensagem. Consulte Usar uma tag de mensagem fora da janela de 24 horas.
Recipient Unavailable (410005)	A pessoa não pode receber mensagens da sua página. A Pushwoosh cancela a inscrição da pessoa no Facebook Messenger.	Não há nada a corrigir.
Invalid Authentication Info (401002)	O Page ID ou o Page Access Token está ausente, ou a Meta não aceitou o token.	Insira um Page ID e um Page Access Token válidos na configuração do Facebook Messenger.
No Permission (403003)	O seu Meta App não tem a permissão de que este envio precisa.	Verifique as permissões do Messenger do seu Meta App no painel do Meta App.
Invalid Request Parameter (400001)	A mensagem está vazia ou contém um valor inválido.	Verifique o conteúdo da mensagem.
Internal Server Error (5009999)	A Meta retornou um erro que a Pushwoosh não reconhece.	Se o erro se repetir, entre em contato com o Suporte da Pushwoosh informando a data da mensagem e o Código da mensagem.

Erros do Kakao

A maioria dos erros do Kakao vem do serviço de mensagens do KakaoTalk. A Pushwoosh mostra cada um com o próprio nome; abaixo eles estão agrupados pelo que é preciso verificar.

Erro	Descrição	O que fazer
Missing User Code (4001200), Missing Secret Key (4001201)	As credenciais do KakaoTalk não estão preenchidas.	Insira o USER CODE e a SECRET KEY na configuração do Kakao.
Invalid Authentication Info (401002), Invalid Token (401005), Token Expired (401006), Missing Authorization Header (401004), No Permission (403003), Unregistered Account (4001100)	O serviço não aceitou o token de acesso ou a sua conta.	Verifique o USER CODE e a SECRET KEY na configuração do Kakao. Se estiverem corretos, entre em contato com o Suporte da Pushwoosh.
Unauthorized IP Address (4031101)	O serviço não aceita solicitações do endereço a partir do qual a Pushwoosh envia.	Entre em contato com o Suporte da Pushwoosh.
Insufficient Balance (4001102)	A sua conta de mensagens do KakaoTalk está sem saldo.	Recarregue o saldo da sua conta de mensagens do KakaoTalk.
Unit Price Not Found (5001103)	O serviço não tem um preço unitário para esta mensagem na sua conta.	Entre em contato com o Suporte da Pushwoosh.
Unauthorized Sender Key (4001104), Missing Sender Key (4001301), Missing Sender Number (4001208), Invalid Sender Number Not Registered (400667), Invalid Sender Number Policy Violation (400668)	O perfil do remetente ou o número do remetente não está registrado ou não é permitido.	Verifique o perfil do remetente e o número do remetente na sua conta de mensagens do KakaoTalk.
Template Code Not Found (4001105), Missing Template Code (4001303)	O código do modelo na mensagem está ausente ou não corresponde a um modelo registrado.	Verifique se a mensagem usa um modelo do Kakao aprovado.
Recipient Opted Out (400090)	A pessoa cancelou o recebimento das suas mensagens do KakaoTalk.	Não envie mensagens de marketing para esta pessoa.
Missing Recipient Number (4001202), Invalid Recipient Number Format (4001204), Recipient Number Too Long (4001203), Missing Country Code (4001210), Invalid Country Code Format (4001212)	O número de telefone do destinatário está ausente ou tem o formato errado.	Armazene os números de telefone no formato internacional com o código do país e registre o número novamente.
Missing Message Body (4001206), Message Body Too Long (4001207), Title Too Long (4001205), Header Too Long (4001306), Invalid Request Parameter (400001) e outros erros com nomes … Too Long ou Invalid …	Uma parte da mensagem está ausente, é longa demais ou tem um valor inválido.	Corrija o campo que o erro indica na predefinição ou na mensagem do KakaoTalk.
Internal Server Error (5009999)	O serviço falhou do lado dele ou retornou um erro que a Pushwoosh não reconhece.	Se o erro se repetir, entre em contato com o Suporte da Pushwoosh informando a data da mensagem e o Código da mensagem.

Erros do LINE

A maioria dos erros do LINE segue o status HTTP retornado pela LINE Messaging API.

Erro	Descrição	O que fazer
Unable To Get Channel ID (1011), Unable To Get Channel Secret (1012)	O Channel ID ou o Channel secret não está preenchido.	Insira os dois na configuração do LINE.
Authentication Failed (1003)	O LINE não aceitou o token de acesso do canal, por exemplo porque o channel secret foi alterado.	Compare o Channel ID e o Channel secret com os do LINE Developers Console.
Duplicate Post (1006)	O LINE recusou a solicitação, seja por ser duplicada, seja porque o canal não tem permissão para usar esta parte da Messaging API.	Verifique o plano e as permissões da sua LINE Official Account. Se estiverem corretos, entre em contato com o Suporte da Pushwoosh.
Profile Not Found (1005), Access Not Available (1007)	O destinatário ou o recurso solicitado não está mais disponível no LINE.	Não há nada a corrigir para este destinatário.
Bad Request (1002)	O LINE rejeitou a solicitação.	Verifique o conteúdo da mensagem e a predefinição do LINE.
Payload Too Large (1008)	A mensagem é maior do que o LINE permite.	Reduza o tamanho da mensagem ou da mídia dela.
Unsupported Media Type (1009)	O LINE não oferece suporte ao tipo do arquivo anexado.	Anexe o arquivo em um formato compatível com o LINE.
Too Many Requests (1010)	O canal atingiu o limite de taxa de solicitações do LINE ou o limite mensal de mensagens.	Reduza a taxa de envio ou verifique o limite de mensagens do plano da sua LINE Official Account.
Internal Server Error (1001), Unknown Error (1000)	O LINE falhou do lado dele ou retornou um erro que a Pushwoosh não reconhece.	Envie a mensagem novamente mais tarde. Se o erro se repetir, entre em contato com o Suporte da Pushwoosh.