Erros no envio de mensagens ocorrem quando as mensagens, por algum motivo, não chegam aos destinatários. Esses casos são indicados como Falha no envio ou Não entregues nos relatórios de disparo.
Para entender os motivos desses erros, acesse um disparo específico em Análises > Envio de mensagens > Performance dos envios e:
Baixe um arquivo clicando em Solicitar relatório do disparo. Neste arquivo, há uma coluna dedicada aos possíveis motivos;
Utilize o filtro Falhas no envio da mensagem ou Não entregues, disponíveis na lista Progresso do disparo por contato e identifique o motivo.
Informações sobre erros no envio e cobranças
Os disparos de mensagens podem ter dois status principais quando ocorre um erro: Falhas no envio e Não entregue. A cobrança depende do status da mensagem:
Disparos com status Falhas no envio da mensagem: Não há cobrança, pois o disparo não chegou a ser enviado devido a um problema interno na Zenvia.
Disparos com status Não Entregue: Há cobrança. A mensagem foi enviada para a operadora (por exemplo, Vivo ou Claro), mas não chegou ao destinatário. As operadoras são responsáveis por entregar a mensagem ao destinatário final.
Fluxo de envio e cobrança
A Zenvia envia uma mensagem para a operadora;
Se o envio for bem-sucedido, o status muda para Enviado e uma cobrança é gerada;
A operadora tenta entregar a mensagem ao destinatário;
Se ocorrer um erro durante essa etapa, o status muda para Não Entregue e os motivos podem incluir:
Dispositivo do destinatário indisponível (desligado, sem bateria, fora da área de cobertura, ou com problemas técnicos).
Caixa de mensagens do destinatário cheia.
Conteúdo bloqueado pelo provedor (spam ou malicioso).
A seguir, confira os motivos dos erros por canal e como solucioná-los:
Entenda os erros no envio de SMS
Para disparos de SMS, as mensagens de erros que podem ser exibidas são:
Erro | Solução |
140 - Mobile number not covered O número de telefone está fora da cobertura da operadora | O número de telefone está fora da cobertura da operadora. Verifique se há sinal no dispositivo ou se há algum problema com a operadora. Por favor, tente novamente mais tarde. |
161- Message rejected by operator A mensagem SMS foi rejeitada pela operadora do destinatário | A mensagem SMS foi rejeitada pela operadora do destinatário. Isso pode ter ocorrido devido ao conteúdo da mensagem ou porque o destinatário bloqueou o remetente. Por favor, revise o conteúdo da sua mensagem e verifique sua lista de contatos. Tente novamente mais tarde. |
190 - Unknown error Ocorreu um erro desconhecido durante o envio | Ocorreu um erro desconhecido durante o envio. Isso pode ser devido a um problema técnico ou uma situação imprevista. Por favor, tente novamente mais tarde ou entre em contato com o suporte técnico. |
999 - Unknown Error Ocorreu um erro desconhecido durante o envio | Ocorreu um erro desconhecido durante o envio. Isso pode ser devido a um problema técnico ou uma situação imprevista. Por favor, tente novamente mais tarde ou entre em contato com o suporte técnico. |
990 - Você atingiu o limite da sua conta. Entre em contato com o Suporte | Você atingiu o limite de uso deste canal. Para continuar enviando e recebendo mensagens, por favor, entre em contato com nosso time de vendas para atualizar seu plano. |
| EMPTY - status de erros que não possuem reason code | Ocorreu um erro desconhecido durante o envio. Isso pode ser devido a um problema técnico ou uma situação imprevista. Por favor, tente novamente mais tarde ou entre em contato com o suporte técnico. |
| MESSAGE_LIMIT_REACHED - Você atingiu o limite da sua conta. Entre em contato com o Suporte. | Você atingiu o limite de uso deste canal. Para continuar enviando e recebendo mensagens, por favor, entre em contato com nosso time de vendas para atualizar seu plano. |
Mensagem bloqueada por infração de conteúdo | Rever o conteúdo da mensagem para garantir que esteja em conformidade com as políticas do provedor de SMS. Evite enviar mensagens com conteúdo considerado impróprio ou violador de diretrizes. |
O limite de conteúdo da mensagem foi ultrapassado | A mensagem SMS excedeu o limite de 160 caracteres. Você pode reduzir o conteúdo da mensagem ou fazer o envio de SMS concatenados, que permite o envio de mensagens mais longas divididas automaticamente em várias mensagens SMS de 160 caracteres e são reagrupadas no dispositivo do destinatário. |
Número do destinatário incorreto ou incompleto; Contato inválido | Verifique e corrija o número do destinatário. Certifique-se de incluir os códigos DDI+DDD para enviar a mensagem com sucesso. |
Valor de campo variável inválido | As variáveis devem ser preenchidas no formato: {{nomedavariavel}}. Corrija qualquer valor de campo variável inválido antes de enviar a mensagem. |
O serviço ainda não está pronto. Tente novamente mais tarde; Serviço temporariamente indisponível | Tentar enviar a mensagem novamente em um momento posterior, quando o serviço estiver disponível. |
Entenda os erros no envio de WhatsApp
Para o canal WhatsApp, listamos os códigos dos erros específicos mais comuns e como solucioná-los.
Para verificar todos os erros de mensagens do WhatsApp, acesse a tabela Códigos de erro do cliente da WhatsApp Business API.
Erro | Solução |
| 100 - Param template ['components'][...]['image']['link'] is not a valid URI (Nota: a palavra 'image' pode variar para 'document' ou 'video') | Revise as configurações da sua campanha/disparo e certifique-se de preencher o campo da variável de mídia com um link de internet direto, válido e público. |
Remetente e destinatário já possuem uma interação em aberto | Encerre o atendimento atual para prosseguir com o novo disparo. |
33 - Unsupported post request | A WhatsApp Business API não existe ou não possui as permissões necessárias. Consulte a documentação da Graph API. |
666 - Contact [555555555555] have received too many messages in a short period | O destinatário recebeu muitas mensagens em um curto período. Aguarde antes de enviar mais mensagens. |
1346003 - Sua mensagem não pode ser enviada pois ela tem conteúdo que outras pessoas no Facebook denunciaram como abusivo | Verifique o conteúdo da mensagem para garantir conformidade com as políticas do Facebook. |
2593006 - The account is not registered | A conta não está registrada. Registre a conta conforme documentação da Meta. |
3252001 - Parece que você estava usando este recurso de forma indevida avançando muito rapidamente. Sua capacidade de usar o recurso foi bloqueada temporariamente | A conta do WhatsApp Business foi temporariamente bloqueada por violação de políticas. |
DENY_LISTED - Recipient is in the deny list for this senderId | O destinatário está na lista de bloqueio para este remetente. Por favor, verifique sua lista de contatos e remova o destinatário da lista de bloqueio antes de tentar novamente. |
error - Error handling content [0] from message [7a9cbf06-57a6-41f5-bcbc-db8fedc667f7]: Cannot read properties of undefined (reading 'length') | Erro relacionado ao formato inválido de campos do template. Por exemplo: URL inválida, ou estarem em branco. |
error - Error handling content [0] from message [7a12c9b4-cadb-4a95-989a-75fdad286109]: Invalid URL | Erro relacionado ao formato inválido de campos do template. Por exemplo: URL inválida, ou estarem em branco. |
INVALID_CONTACT - Contact 9176800 is not an valid Whatsapp number | O contato não é um número válido do WhatsApp. Verifique se o número de telefone está correto e registrado no WhatsApp. |
130472 - Failed to send message because this user's phone number is part of an experiment | Falha ao enviar mensagem devido a experimento da Meta. Aguarde a conclusão para reenviar a mensagem. |
131000 - Something went wrong | Erro desconhecido ao enviar mensagem. Tente novamente após algum tempo. |
131000 - Template is temporarily unavailable to use because it was paused due to low quality | O template da mensagem foi pausado devido ao feedback negativo recorrente dos clientes ou ao baixo índice de leitura. Por favor, revise e edite o conteúdo da mensagem e solicite a aprovação do template novamente. |
131031 - Business account has been locked | A conta de negócios foi bloqueada. A conta do WhatsApp Business associada foi restringida ou desabilitada por violação de política; ou não foi possível verificar os dados incluídos na solicitação em relação ao conjunto de dados na conta do WhatsApp Business. |
131042 - Message failed to send because there were one or more errors related to your payment method | Falha ao enviar a mensagem devido a um ou mais erros relacionados ao seu método de pagamento do WhatsApp. Por favor, entre em contato com o time de suporte. |
131047 - Message failed to send because more than 24 hours have passed since the customer last replied to this number | Mais de 24 horas sem resposta. Inicie uma nova conversa para continuar o envio de mensagens. |
131048 - Message failed to send because there are restrictions on how many messages can be sent from this phone number.This may be because too many previous messages were blocked or flagged as spam | Restrições de envios de mensagens aplicadas devido a muitas mensagens bloqueadas ou sinalizadas como spam. Verifique o limite de mensagens. |
131053
| Erros específicos ao tentar carregar mídia via URL. Verifique a compatibilidade e o formato correto da mídia. |
Entenda os erros no envio de e-mail
Ao analisar os erros de e-mail, você encontrará códigos que indicam a decisão do provedor em relação à sua mensagem. Cada código é composto por 3 dígitos (XXX), sendo o primeiro dígito o status da sua mensagem.
4XX – Erro temporário (Soft bounce)
Esse código indica um erro temporário durante o envio da sua mensagem, como a caixa de entrada do destinatário cheia ou instabilidade temporária no serviço de e-mail do destinatário. Você pode tentar enviar novamente, pois pode ser aceito em outro momento. Analise os demais dígitos (4.X.X) para entender melhor a descrição do erro.
Veja algumas possíveis soluções:
Bloqueio anti-spam: O serviço de e-mail do contato possui um bloqueio interno que pode incluir o domínio, IP ou algum conteúdo específico do e-mail. Mantenha a base de contatos atualizada, evitando contatos inexistentes e conteúdo que possa ser considerado spam.
Caixa de entrada cheia: Ignore ou remova o contato da base, ou envie para um e-mail alternativo.
Conta indisponível, servidor indisponível, falha na entrega: ignore ou remova o contato da lista temporariamente.
Variáveis inválidas: Alguma variável no conteúdo do e-mail não está preenchida corretamente, portanto, atualize as informações cadastrais do contato.
5XX – Erro permanente (Hard bounce)
Indica que a conta inválida ou domínio inválido, ou seja, o endereço de e-mail é inexistente ou o endereço não aceita mensagens do remetente. Analise os demais dígitos (5.X.X) para entender melhor o tipo de erro permanente relatado.
Erro | Solução |
400 Received: (qmail 60130/11702 invoked for bounce) | Ocorreu um erro ao enviar a mensagem. As possíveis causas incluem detecção de SPAM ou o domínio do remetente estar na lista de bloqueio do destinatário. Por favor, revise o conteúdo e tente novamente. |
400 attachments.0.type: The attachment type cannot contain ';', or CRLF characters | O tipo de anexo contém caracteres inválidos. Certifique-se de que o tipo MIME do anexo não contenha esses caracteres. |
400 personalizations.0.custom_args: The combined size of both global and personalization custom arguments may not exceed 10000 bytes per personalization | O tamanho combinado dos argumentos personalizados não deve exceder 10.000 bytes. Reduza o tamanho dos dados personalizados. |
400 personalizations.0.to.0.email: Does not contain a valid address | O e-mail remetente fornecido não é válido. Verifique e corrija o endereço de e-mail. |
400 reply_to.email: The reply_to email does not contain a valid address | O endereço de e-mail no campo reply_to não é válido. Verifique e corrija o endereço de e-mail. |
401 DomainKeys Identified Mail (DKIM) | Ocorreu um erro durante a verificação de assinatura DKIM. Verifique se a chave pública está correta no registro DNS. Por favor, entre em contato com o time de suporte. |
401 Return-Path | Falha de autenticação ao definir o caminho de retorno. Verifique as configurações de autenticação. Por favor, entre em contato com o time de suporte. |
401 Authenticated user is not authorized to send mail | O usuário autenticado não tem permissão para enviar e-mails. Verifique as permissões da API Key no painel do SendGrid. Por favor, entre em contato com nosso time de suporte. |
502 Bad Gateway | Nosso servidor de e-mail recebeu uma resposta inválida de outro servidor. Verifique a comunicação entre servidores. Por favor, entre em contato com nosso time de suporte. |
503 #5.5.1 RCPT first | Este erro acontece quando você usa o protocolo SMTP diretamente, como com TELNET ou uma ferramenta de teste SMTP, e não com a API do Sendgrid. O RCPT TO deve ser enviado antes de outros comandos, como DATA. |
503 Bad sequence of commands. Could not process RCPT command when in this state. | Este erro acontece quando você usa o protocolo SMTP diretamente, como com TELNET ou uma ferramenta de teste SMTP, e não com a API do Sendgrid. O RCPT TO deve ser enviado antes de outros comandos, como DATA. |
503 NEDD RCPT BEFORE DATA | Este erro acontece quando você usa o protocolo SMTP diretamente, como com TELNET ou uma ferramenta de teste SMTP, e não com a API do Sendgrid. O RCPT TO deve ser enviado antes de outros comandos, como DATA. |
503 This mail server requires authentication | Erro de autenticação ao tentar enviar para um endereço não local. Verifique as configurações de autenticação e registros DNS. Por favor, entre em contato com o nosso time de suporte. |
complained - User reported the e-mail | A mensagem não pode ser enviada. O destinatário solicitou que a mensagem fosse marcada como SPAM em sua caixa de entrada. |
DENY_LISTED - Recipient is in the deny list for this senderId | O destinatário pediu para não receber mais e-mails do remetente. |
error - Template id not approved yet | A mensagem não pode ser enviada. O template de e-mail não foi aprovado. Por favor, aguarde a aprovação do template. |
error - Failed to access URL | Falha ao acessar a URL especificada. Por favor, verifique a disponibilidade da URL e tente novamente. |
EXCEPTION - read ECONNRESET | A mensagem não pode ser enviada, a conexão foi terminada inesperadamente. Verifique a conexão de sua rede de internet e tente novamente. |
EXCEPTION - socket hang up | A mensagem não pode ser enviada, a conexão foi terminada inesperadamente. Verifique a conexão de sua rede de internet e tente novamente. |
timeout of 30000ms exceeded | Operação de envio de mensagens ultrapassou o tempo limite definido. Verifique a conectividade com o servidor. |
required - The field to (recipient) must be provided | Mensagem disparada sem destinatário definido. Defina um destinatário para a mensagem. |
INVALID_SENDER - Please contact support team | A mensagem não foi enviada. Esse erro ocorre quando o "from" da mensagem não corresponde ao "credentials.senderId". Por favor, entre em contato com o time de suporte. |
Entenda os erros no envio de RCS
Para o canal RCS, listamos os erros específicos mais comuns e como solucioná-los.
Caso tenha mais dúvidas, confira os Termos de Serviço do RCS Business Messaging e Política de Uso aceitável.
Erro | Solução |
0 - Unexpected error preparing message | Condição de erro não prevista ou não especificada ocorreu durante o processamento de uma solicitação no sistema RCS. |
11 - Message body invalid | O corpo da mensagem é inválido. |
| 12 - Message content overflow | O conteúdo da mensagem excede o tamanho permitido. Reduza o tamanho do conteúdo da mensagem para estar dentro do limite permitido. Confira os formatos e tamanhos permitidos. |
| 13 - Incorrect or incomplete 'to' mobile number | O número de telefone do destinatário está incorreto ou incompleto. Verifique e corrija o número de telefone do destinatário, garantindo que esteja no formato correto (DDI+DDD+9 dígitos). |
| 105 - Message blocked by duplicated external key | Mensagem bloqueada por chave externa duplicada. Cada mensagem de RCS tem um ID que o Google RCS espera que seja único. Ou seja, disparar com uma mensagem com IDs iguais gerará um erro na segunda. |
| 130 - Message blocked | A mensagem foi bloqueada pela Google. Pode ocorrer por diversas razões; algumas dentre elas: Conteúdo SPAM ou malicioso, Recipiente optou por não receber mais as mensagens do remetente. |
| 134 - Message blocked by forbidden content | A mensagem foi bloqueada por conter conteúdo proibido. Pode ocorrer por diversas razões, entre elas: Links maliciosos, Arquivos cuja extensão não é permitida, Linguajar ofensivo ou proibido. |
| 135 - Aggregate is Invalid or Inactive | O agregado é inválido ou inativo. No contexto de RCS, refere-se a um Aggregate (grupo de mensagens) cujo ID está inativo ou é inválido. |
| 136 - Message expired | A mensagem RCS não foi entregue dentro de um período específico de tempo e expirou. Verifique a conexão do Google ou se o dispositivo do destinatário está desligado. |
| 141 - International sending not allowed | Mensagem RCS enviada para um número internacional e o envio internacional não é permitido pelas configurações ou políticas do serviço de mensagens. |
| 190 - Unknown error | Erro genérico. Ocorreu um problema, mas a causa exata não pode ser determinada. |
| 400 - com.google.apps.framework.request.CanonicalCodeException: The supplied file URL https://negocie.ceapay.com.br/images/logo_mob.png is invalid Code: INVALID_ARGUMENT | A URL fornecida para o arquivo é inválida. Verifique se a URL está correta e acessível. |
| 400 - com.google.apps.framework.request.CanonicalCodeException: Unsupported content-type ,image/png. The RBM platform determines the MIME type of the file from the content-type field in the HTTP headers. The content-type field of the URL provided is unsupported. This content-type must be one of: [image/jpeg, image/jpg, image/gif, image/png, video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm, application/pdf]. Code: INVALID_ARGUMENT | O tipo de conteúdo (MIME type) do arquivo fornecido na URL não é suportado pela plataforma RBM. Verifique os tipos de arquivo suportados pela plataforma. |
| 400 - Unsupported file type: gcs_url: "https://rbm-us.storage.googleapis.com/691582025489/lr8gl6osBmiuVnQUqMsghllc" mime_type: "image/webp" size: 9948 file_name: "b7d3244a7a6ddce9682aea28fd12a05c407 a42e747354a663575257b33c335df.bin" width: 424 height: 186 | O tipo de arquivo fornecido não é suportado pela plataforma RBM. Verifique os tipos de arquivo suportados pela plataforma. |
| 400 - User phone number is not of a valid format. | O número de telefone fornecido não está em um formato válido. |
| 400 - Within contentMessage, text must not be empty | O texto da mensagem não pode estar vazio. Certifique-se de que o campo de texto da mensagem não está vazio antes de enviá-la |
| erros com status 400 | Solicitação feita ao servidor é inválida ou contém argumentos incorretos. Verifique os códigos da API para identificar e corrigir o problema. |
| 403 - There was an error looking up the RBM agent (ID: rbm-agent) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with. | O sistema não conseguiu encontrar o agente RBM correspondente ao projeto GCP com o qual você está autenticando. |
| 403 - This operation is blocked because it violates the RBM Terms of Service (Terms of Service for RCS Business Messaging | RCS Business Messaging Developer Docs | Google for Developers ) and/or Policies (Acceptable Use Policy | Business Communications | Google for Developers ). | Esta operação foi bloqueada devido a violações dos Termos de Serviço e/ou Políticas do RBM, como o envio de conteúdo proibido ou uso indevido da API. |
| 403 - This operation is blocked because the RBM agent has not launched on the user's carrier nor have they been invited to become a tester (Test devices | RCS Business Messaging Developer Docs | Google for Developers ). | Esta operação foi bloqueada porque o agente RBM ainda não foi lançado na operadora do usuário ou o usuário não foi convidado a se tornar um testador. |
| erros com status 403 | Autenticação falhou. Verifique as configurações e o status do agente RBM que realizou a solicitação. |
| 404 - Requested entity was not found | O recurso ou a entidade solicitada não pôde ser localizada pelo servidor. Isso pode incluir URLs incorretas, o número do destinatário não é reconhecido pelo RCS ou a tentativa de acessar um recurso que foi removido ou nunca existiu. |
| 429 - You have reached the maximum number of times that this request can be made in a given time period. Some requests are limited according to their parameters: for instance, a request can only be made once every four hours from a given agent for a given user | Você atingiu o número máximo de vezes que essa solicitação pode ser feita em um determinado período de tempo. Algumas solicitações são limitadas de acordo com seus parâmetros: por exemplo, uma solicitação só pode ser feita uma vez a cada quatro horas de um determinado agente para um determinado usuário. |
| 500 - Internal error encountered. | O servidor RCS encontrou um problema interno que o impede de processar a solicitação. |
| 503 - The service is currently unavailable | O servidor RCS está temporariamente indisponível ou sobrecarregado e não pode atender à solicitação. Isso pode ser devido a manutenção programada, sobrecarga do servidor, falhas temporárias na infraestrutura, ou outros motivos que tornem o serviço indisponível. |
| 990 - Account Limit Reached - Please contact support | O limite da conta foi atingido. |
| 999 - Unknown Error | Ocorreu um erro desconhecido durante o envio. Isso pode ser devido a um problema técnico ou uma situação imprevista. Por favor, tente novamente mais tarde ou entre em contato com o suporte técnico. |
| CONTENT_RESTRICTION - Agent has rich content restriction | O agente RCS está configurado com restrições de conteúdo Rich Card que proíbem o envio de certos tipos de mídia ou conteúdo formatado de maneira específica. |
| error - Unexpected Error | Ocorreu um erro desconhecido durante o envio. Isso pode ser devido a um problema técnico ou uma situação imprevista. Por favor, tente novamente mais tarde ou entre em contato com o suporte técnico. |
| INVALID_CONTACT - Contato inválido | Contato inválido. |
| NOT_CAPABLE_RCS - Phone {telefone} is not capable to receive RCS | O telefone não é capaz de receber RCS. |
