Erro 131060: mensagem não suportada num número Coexistence
O erro 131060 chega num webhook de mensagens como uma mensagem do tipo «unsupported», com o título «This message is currently unavailable.». Num número Coexistence, a Meta considera-o esperado: acontece sobretudo quando alguém escreve à empresa pela primeira vez, muitas vezes logo após tocar num anúncio Click-to-WhatsApp, e costuma desaparecer em poucos segundos. A mensagem em si pode ser lida na app WhatsApp Business.
O easyCoexistence mantém as mensagens não suportadas fora das automatizações, para que a sua IA nunca responda a uma mensagem que não consegue ler, e continua a reencaminhar o payload original da Meta para o seu sistema quando há um Forward URL definido.
Código da Meta para uma mensagem recebida atualmente indisponível, com o título «This message is currently unavailable.»
A Meta indica que o erro se resolve normalmente em poucos segundos, após o que o WhatsApp entrega as mensagens com normalidade.
O cenário principal que a Meta refere: um utilizador do WhatsApp que escreve à empresa pela primeira vez, frequente logo após tocar num anúncio Click-to-WhatsApp.
Outro código no mesmo webhook: a Cloud API não suporta esse tipo de mensagem.
As automatizações do easyCoexistence não correm numa mensagem não suportada; a mensagem legível seguinte desse chat é que as inicia.
O que contém o webhook 131060?
É um webhook de mensagens comum cuja mensagem tem "type": "unsupported" e um array errors. O erro traz o código 131060 e o título «This message is currently unavailable.», com a mesma frase como mensagem. Um objeto unsupported indica o tipo de conteúdo que a Meta não conseguiu transmitir; a lista de valores da Meta inclui image, interactive, reaction e poll_creation. Não há corpo de texto nem id de media, por isso nada no payload indica o que o cliente escreveu. O número do remetente, o id da mensagem e a data e hora estão presentes, como de costume.
{
"object": "whatsapp_business_account",
"entry": [{
"id": "<WABA_ID>",
"changes": [{
"field": "messages",
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "<BUSINESS_NUMBER>",
"phone_number_id": "<PHONE_NUMBER_ID>"
},
"contacts": [{ "profile": { "name": "Ana" }, "wa_id": "5511999998888" }],
"messages": [{
"from": "5511999998888",
"id": "wamid.HBgN...",
"timestamp": "1762876800",
"type": "unsupported",
"errors": [{
"code": 131060,
"title": "This message is currently unavailable.",
"message": "This message is currently unavailable."
}],
"unsupported": { "type": "<UNSUPPORTED_TYPE>" }
}]
}
}]
}]
}Porque acontece num número Coexistence?
O guia Coexistence da Meta indica que os parceiros podem receber um webhook de mensagens unsupported com o código de erro 131060 e que isso é esperado. Refere dois cenários.
O primeiro é um utilizador do WhatsApp que escreve pela primeira vez à empresa, situação que a Meta diz ser especialmente comum quando alguém toca num anúncio Click-to-WhatsApp e envia logo uma mensagem. O segundo é um utilizador do WhatsApp num dispositivo secundário não suportado que envia uma mensagem à empresa ou recebe uma dela.
A Meta não explica o mecanismo. O que diz importa mais: o erro resolve-se normalmente em poucos segundos e, a partir daí, o WhatsApp entrega as mensagens com normalidade.
O que deve fazer a empresa quando chega uma?
Leia-a na app. A instrução da Meta às plataformas é que digam à empresa para verificar a mensagem na app WhatsApp Business, porque a app no telemóvel a tem mesmo quando a cópia da API não esteve disponível.
Na prática: abra o chat no telemóvel, leia o que o cliente escreveu e responda a partir daí, ou aguarde a mensagem seguinte do cliente, que normalmente chega pela API sem o erro. Responder a partir do telemóvel indica também às automatizações que uma pessoa tem o chat. Numa campanha de anúncios, espere um pequeno surto destes no início de novas conversas, e não uma avaria.
Como devem reagir o software e a IA?
Trate-o como um evento conhecido, e não como uma falha. Responda com código 200, como faria com qualquer entrega, para que a Meta não o reenvie. Registe o id da mensagem e o remetente, o que permite associá-la à conversa que se segue. Nunca entregue à IA a mensagem vazia como se fosse texto: sem conteúdo, qualquer resposta é uma suposição. E alerte pela taxa de eventos 131060, e não por eventos isolados.
- Responda depressa com código 200 e elimine duplicados pelo id da mensagem, como em qualquer webhook.
- Ignore as respostas de IA e a correspondência por palavras-chave quando o type for unsupported.
- Mostre à sua equipa que há uma mensagem à espera na app no telemóvel.
- Conte o 131060 separadamente dos erros reais nos seus painéis.
As automatizações correm numa mensagem unsupported?
No easyCoexistence, não. As automatizações leem respostas de texto, de botões e de listas, legendas de media e marcadores como "[voice message]"; uma mensagem do tipo unsupported não tem nada disso, por isso nenhuma automatização a responde e nenhuma execução aparece. Se houver um Forward URL definido, o seu sistema continua a receber o payload original da Meta, com o erro incluído. No modo direto, a Meta envia-o diretamente para o seu servidor.
A mensagem legível seguinte dessa pessoa inicia as automatizações como de costume. Como ainda não havia nada guardado para esse chat, uma automatização "First message", como uma resposta de boas-vindas, responde a essa mensagem seguinte.
Em que se distingue o 131060 do 131051?
Ambos chegam como type unsupported no mesmo webhook de mensagens, e por isso são confundidos nos registos (logs). Significam coisas opostas para o planeamento: um é uma falha curta que se resolve sozinha, o outro é um limite permanente da API para esse conteúdo. Leia errors[0].code, e não o type, para os distinguir no seu código. A tabela resume o que as referências da Meta dizem sobre cada código.
| 131060 | 131051 | |
|---|---|---|
| Title | This message is currently unavailable. | Message type unknown |
| Meaning | The message cannot be passed on right now | The Cloud API does not support that type |
| Typical cause | First contact on a Coexistence number, often after an ad tap | Content the API never delivers |
| How long | Usually clears within seconds | Permanent for that content |
| What to do | Read it in the WhatsApp Business app | Ask the customer for text, or read it in the app |
Erros comuns
- Disparar alertas por eventos 131060 isolados. A Meta considera-os esperados em números Coexistence; acompanhe a taxa em vez disso.
- Deixar uma IA responder à mensagem vazia. O payload não tem texto, por isso a resposta seria inventada.
- Responder ao webhook com um código de erro. A Meta volta a enviar os webhooks que falham, por isso uma só mensagem não suportada transforma-se em várias entregas.
- Assumir que a mensagem se perdeu. Está na app WhatsApp Business; só a cópia da API é que não esteve disponível.
O número fica na app no telemóvel, onde se pode ler a mensagem original. De US$ 9 até US$ 0.75 por número por mês, descendo à medida que se acrescentam números, com os primeiros 3 dias grátis.
Perguntas frequentes
Posso obter o conteúdo original pela API?
A orientação da Meta para o 131060 é verificar a app WhatsApp Business. A referência de webhooks não descreve forma de obter o conteúdo mais tarde.
O 131060 significa que o número está avariado?
Não. Se as mensagens de contactos habituais continuarem a chegar como 131060 durante horas, peça à sua IA que execute get_number_health ou verifique a ligação, mas os surtos no primeiro contacto são esperados.
Acontece em números que só usam a Cloud API?
A Meta descreve o padrão do primeiro contacto no guia para números integrados com a app WhatsApp Business, que é o caso do Coexistence. O código em si consta da referência geral de webhooks da Meta, por isso trate-o da mesma forma em qualquer número.
Há alguma cobrança por isso?
É uma mensagem recebida. A Meta cobra à empresa as mensagens que esta envia, por mensagem, por categoria e por país, na sua própria conta WhatsApp Business.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em