Na API oficial do WhatsApp, o erro 131026 indica falha de entrega, sem revelar sozinho a causa. Use este roteiro numa integração já configurada, com o registro da tentativa e o destino usado.
1. Leia o código no registro
No registro que você já possui, identifique o código e o rótulo do erro. No trecho da documentação da AWS, esses campos aparecem como code e title:
O rótulo Message undeliverable significa que não foi possível entregar a mensagem.
A figura é um trecho de evento AWS/EventBridge. Use-a para reconhecer os campos, respeitando o formato da sua integração.
2. Confira o número usado como destino
Use o valor associado à tentativa que falhou, não apenas o cadastro atual: ele pode ter sido corrigido depois. Coloque lado a lado o destino registrado e o número confirmado agora, registrando eventuais diferenças.
Se você usa a Nextags, a referência de telefone pede DDI, DDD e número, somente com dígitos. Compare o valor que a integração recebeu com o telefone confirmado pelo contato. Se o DDD estiver ausente, confirme essa informação com o contato.
Considere um telefone brasileiro confirmado como (31) 97042-6813. No formato da Nextags, ele corresponde a 5531970426813, mas o registro do envio apresenta 5513970426813. Os dois destinos têm só dígitos e o mesmo tamanho; o DDD mudou de 31 para 13.
Se houver essa divergência, confirme o telefone e corrija o dado de destino antes de decidir sobre outro envio.
Se os valores coincidirem, registre a conferência e siga para as outras verificações. Isso não comprova WhatsApp ativo, causa ou entrega.
3. Peça uma conferência
A documentação da Nextags relaciona o código a possibilidades como número sem WhatsApp, aplicativo antigo e termos novos não aceitos.
Por outro meio já disponível, peça à pessoa que confira o telefone e o aplicativo e envie uma mensagem à empresa.
Registre o retorno: uma conversa iniciada agora não comprova a entrega da mensagem anterior.
4. Encaminhe as pendências
Se a dúvida persistir, envie ao responsável pela integração o código, telefone, horário da tentativa e resultado das verificações.
Fontes e referências
Regras e recursos dos canais podem mudar. Confira as condições atuais nas fontes oficiais antes de colocar sua operação no ar.
Conteúdo de Angelo Sebastião Silva Goncalves. Preparado com apoio de IA. Consulte as fontes e os critérios editoriais. Conheça nossos critérios editoriais e como solicitar uma correção.
