nvie via WhatsApp quando o destinatário tiver dado o consentimento para receber mensagens por lá e possuir uma conta WhatsApp ativa; em todos os outros casos, envie por SMS ou faça o fallback para SMS. Na Cloud API do WhatsApp, uma mensagem para um número que não pode recebê-la falha com o erro 131026, e você só saberá disso pelo webhook de status, não pela resposta de envio. O padrão confiável é registar o consentimento de canal de cada cliente no momento do opt-in, verificar o que é permitido por lei antes do envio e permitir que um status de falha no WhatsApp acione um SMS. A BroadNet opera ambos os canais por trás de uma única Omnichannel API com regras explícitas de fallback.
Principais conclusões
- O erro 131026 significa que a Meta não conseguiu entregar a mensagem. A Meta lista três motivos possíveis: o número não é um número WhatsApp, o destinatário não aceitou os termos mais recentes ou o destinatário utiliza uma versão antiga do WhatsApp.
- Uma resposta API bem-sucedida significa apenas que a solicitação foi aceita. A entrega é reportada posteriormente pelo webhook de status: enviada, entregue, lida ou falhou, com um array de erros em caso de falha.
- Ter uma conta WhatsApp não é permissão para enviar mensagens a alguém: a política da Meta exige o número da pessoa e o consentimento dela para receber as suas mensagens.
- Fora da janela de 24 horas de atendimento ao cliente, o WhatsApp aceita apenas mensagens de template (caso contrário, erro 131047).
- O tipo de linha é o primeiro filtro: um SMS para um número de linha fixa ou gratuito geralmente falha e ainda assim gera a cobrança da mensagem.
- O fallback funciona melhor como uma regra na plataforma de envio: WhatsApp primeiro, onde o cliente o escolheu, e SMS em caso de status de falha ou falta de consentimento no WhatsApp.
O que significa o erro 131026 de WhatsApp?
Na referência de erros da Cloud API da Meta, 131026 significa "Não foi possível entregar a mensagem". A Meta apresenta três possíveis motivos: "O número de telefone do destinatário não é um número do WhatsApp", o destinatário "não aceitou os novos Termos de Serviço e Política de Privacidade" ou o destinatário está "usando uma versão antiga do WhatsApp". A correção sugerida pela Meta é perguntar à pessoa, "usando um método de comunicação que não seja o WhatsApp", para confirmar se ela pode enviar mensagens para o número da sua empresa, aceitar os termos mais recentes ou atualizar a aplicação.
Em outras palavras, 131026 é um sinal de encaminhamento, não um erro no seu código. Para uma palavra-passe de uso único, um aviso de entrega ou um lembrete de agendamento, o método fora do WhatsApp ao qual a Meta se refere é geralmente o SMS, e ele deve ser enviado automaticamente, em vez de após a abertura de um ticket de suporte.
Porque um ID de mensagem não significa que a mensagem foi entregue?
O envio é assíncrono. A API aceita a solicitação e devolve um ID de mensagem; o que acontece em seguida chega via o seu webhook. O webhook de status de mensagem da Meta reporta estes valores:
| Status | Descrição da Meta | O que fazer |
|---|---|---|
| enviado | A mensagem foi enviada com sucesso dos servidores da Meta | Aguarde a entrega ou falha |
| entregue | A mensagem foi entregue com sucesso ao dispositivo do utilizador WhatsApp | Nenhum fallback necessário |
| lida | A mensagem foi exibida numa conversa aberta no dispositivo do utilizador | Nenhum fallback necessário |
| falhou | Falha ao enviar ou entregar a mensagem ao dispositivo do utilizador | Leia errors[].code; utilize o fallback para SMS em mensagens urgentes |
Um status de falha traz um array de erros com um código numérico, um título, um campo de detalhes e um link para a referência do erro. Registe o código com a mensagem: ele indica se você deve tentar novamente, trocar de canal ou corrigir um template. A mesma lógica se aplica ao SMS, onde o relatório de entrega (DLR) da operadora desempenha o papel do webhook de status.
É possível enviar mensagens para alguém no WhatsApp apenas por essa pessoa ter uma conta?
Não. A Política de Mensagens do WhatsApp Business estabelece que você "só pode contactar pessoas no WhatsApp se: (a) elas tiverem fornecido o número de telemóvel ou nome de utilizador; e (b) você tiver recebido o consentimento do destinatário confirmando que ele deseja receber mensagens ou chamadas subsequentes de você." Você também deve respeitar qualquer solicitação, dentro ou fora do WhatsApp, para parar.
Portanto, a escolha do canal começa no opt-in, não no momento do envio. Pergunte aos clientes quais canais eles aceitam, armazene essa escolha com um registo de data/hora e envie mensagens apenas pelos canais que eles concordaram. A legislação local adiciona as suas próprias regras: veja o nosso guia sobre PDPL no UAE para marketing de SMS e WhatsApp para um exemplo.
E quanto à janela de 24 horas e ao erro 131047?
Uma mensagem WhatsApp de formato livre só é permitida dentro de 24 horas após a última mensagem do cliente para você. Fora desse prazo, a Cloud API devolve 131047, "Passaram-se mais de 24 horas desde que o destinatário respondeu pela última vez ao número do remetente", e a solução da Meta é "enviar uma mensagem de template para o destinatário em vez disso". Veja o que é a janela de 24 horas do WhatsApp.
Para o design de fallback, isso significa duas falhas diferentes: o 131047 é resolvido trocando para um template aprovado no WhatsApp, enquanto o 131026 é resolvido trocando de canal. Trate-os de forma diferente na sua lógica de reenvio.
Qual canal você deve usar primeiro?
Não existe uma resposta única por mercado; depende da mensagem e do que cada cliente concordou. Um conjunto de regras por destinatário cobre a maioria dos casos:
| Situação | Primeiro canal | Fallback |
|---|---|---|
| O cliente deu consentimento para WhatsApp e já enviou mensagens para você antes | WhatsApp (template fora do período de 24 horas) | SMS em caso de falha no status |
| O cliente deu consentimento para WhatsApp, mas ainda não há histórico | Template de WhatsApp | SMS em caso de falha no status ou sem status dentro do seu limite de tempo |
| Nenhum consentimento de WhatsApp registado | SMS | Voz para OTP onde for suportado |
| A mensagem WhatsApp anterior falhou com 131026 | SMS | Peça ao cliente para confirmar o WhatsApp no próximo contacto |
| O número é de linha fixa ou gratuito | Não é SMS: geralmente falha | Chamada de voz ou solicite um número de telemóvel |
| O cliente deu consentimento para RCS, Telegram ou Viber | O canal pelo qual você pode enviar | SMS |
Para a visualização por mercado (onde WhatsApp, RCS ou SMS lideram), leia nosso guia de canais SMS vs WhatsApp vs RCS.
O que você pode verificar antes de enviar?
A primeira verificação não tem nada a ver com aplicações: é o tipo de linha. Um SMS para um número fixo ou um número gratuito geralmente falha e, mesmo assim, gera a cobrança da mensagem. MobileValidate, uma marca da BroadNet em prévia privada, devolve o tipo de linha, a operadora atual e, para um número portado, a operadora original; o BroadNet HLR Lookup adiciona o status da rede em tempo real, informando se a linha está alcançável agora.
Para clientes que deram consentimento para outros canais, o MobileValidate também pode verificar em tempo real se o número deles está registado no Telegram, Viber ou Zalo, e em processamentos em lote no Signal, iMessage, RCS, LINE ou Botim; a verificação RCS informa a plataforma do dispositivo quando disponível. A sua política de uso aceitável limita essas verificações à prevenção de fraudes e à seleção de canais para contactos que deram consentimento. A lista completa de verificações está em mobilevalidate.com. O MobileValidate é um serviço independente, não afiliado, endossado ou patrocinado pelas plataformas que verifica; os seus nomes são usados apenas para descrever o que uma verificação abrange.
Para o próprio WhatsApp, os sinais confiáveis são os que o Meta fornece: o próprio opt-in do cliente, as suas respostas e o status de entregue ou falha da sua última mensagem. Armazene o último resultado do WhatsApp por cliente e use-o para orientar o próximo envio.
Como o BroadNet gere o fallback?
A BroadNet é uma Business Solution Provider oficial da Meta e opera WhatsApp Business API, SMS, RCS e voz numa única plataforma. O Omnichannel API recebe uma única solicitação com regras de fallback explícitas entre SMS, WhatsApp, RCS e voz, e devolve recibos unificados, de modo que um status de WhatsApp com falha se torne um SMS sem a necessidade de código extra na sua aplicação.
- Para palavras-passe de uso único, a API OTP envia com fallback automático entre SMS, WhatsApp, voz e Flash Call; o MyOTP.App cobre SMS, WhatsApp e Telegram a partir de uma única conta.
- Defina um limite de tempo para mensagens sensíveis ao tempo: se nem o status de entregue nem o de falha chegarem a tempo, envie o fallback.
- Mantenha modelos aprovados para cada tipo de mensagem que você possa precisar fora da janela de 24 horas.
- Suprima um canal para um cliente após um erro 131026 até que ele confirme novamente, para evitar o pagamento por falhas repetidas.
Para mais padrões, leia nossa estratégia de failover multicanal.
Como funciona um checklist de encaminhamento por destinatário?
- No momento do opt-in, registe quais canais o cliente aceita, com a data e o texto com o qual ele concordou.
- Verifique o tipo de linha de novos números e solicite um número de telemóvel quando for linha fixa ou número gratuito.
- Escolha o primeiro canal com base no consentimento e no histórico do cliente, não apenas por um padrão do país.
- Fora da janela de 24 horas, envie apenas modelos WhatsApp.
- Monitorize os webhooks de status e os relatórios de entrega; trate falhas e timeouts como gatilhos de fallback.
- Utilize o fallback para SMS em mensagens urgentes e registe o código de erro do WhatsApp junto com a mensagem.
- Revise as falhas semanalmente: um aumento de 131026 num segmento geralmente indica números desatualizados ou falta de consentimento.
Perguntas frequentes
O que significa o erro WhatsApp 131026?
"Não foi possível entregar a mensagem." O Meta lista três possíveis motivos: o número não é um número WhatsApp, o destinatário não aceitou os Termos de Serviço e a Política de Privacidade mais recentes, ou o destinatário utiliza uma versão antiga do WhatsApp.
Devo tentar reenviar uma mensagem que falhou com 131026?
Não tente no WhatsApp imediatamente. Envie conteúdos urgentes por SMS em vez disso e peça ao cliente, por outro canal, para confirmar o seu número WhatsApp.
Uma resposta 200 da API do WhatsApp significa que a mensagem foi entregue?
Não. Significa que a solicitação foi aceita. A entrega é reportada pelo webhook de status como enviada, entregue, lida ou falhou.
Posso enviar mensagens para um cliente no WhatsApp se eu souber que ele possui uma conta?
Não. A política do Meta exige que a pessoa tenha fornecido o número e dado o consentimento para receber mensagens da sua empresa no WhatsApp.
O que é o erro 131047?
Já se passaram mais de 24 horas desde a última resposta do cliente. Envie uma mensagem de modelo aprovada em vez de uma mensagem de texto livre.
Qual canal deve ser o fallback para WhatsApp?
SMS na maioria dos casos, pois alcança qualquer número de telemóvel. Para palavras-passe de uso único, a voz é um fallback adicional onde a plataforma oferece suporte.
Posso verificar um número antes do envio?
Sim, dentro da sua base legal. Verifique o tipo de linha primeiro; para clientes que deram consentimento, o MobileValidate pode verificar o registo em aplicações como Telegram, Viber e RCS, e o BroadNet HLR Lookup fornece o status da rede em tempo real.
Como o BroadNet envia o fallback de SMS?
A API Omnichannel aplica as suas regras de fallback numa única requisição, e a API de OTP alterna automaticamente entre SMS, WhatsApp, voz e Flash Call.
Lemos todas as fontes abaixo em 27 de setembro de 2026. Consulte nossos padrões editoriais.
Fontes
- Meta para Desenvolvedores — códigos de erro WhatsApp Cloud API (131026, 131047), acedido em 27 de setembro de 2026: developers.facebook.com.
- Meta para Desenvolvedores — referência de webhook de status de mensagem, acedida em 27 de setembro de 2026: developers.facebook.com.
- Política de Mensagens WhatsApp Business — requisitos de opt-in e descadastramento, acedida em 27 de setembro de 2026: whatsappbusiness.com/policy.
- MobileValidate — referência de serviços e consulta de operadora, última atualização em 25 de setembro de 2026: mobilevalidate.com/docs/services, mobilevalidate.com/services/carrier-lookup.
- MobileValidate — política de uso aceitável, acedida em 27 de setembro de 2026: mobilevalidate.com/legal/acceptable-use.