Erro 131060: mensagem não suportada em número com Coexistência
O erro 131060 chega em um webhook messages como uma mensagem do tipo unsupported, com o título "This message is currently unavailable." (esta mensagem está indisponível no momento). Em um número com Coexistência, a Meta considera isso esperado. Acontece principalmente quando alguém escreve para a empresa pela primeira vez, muitas vezes logo depois de tocar em um anúncio Click-to-WhatsApp, e costuma se resolver em segundos. A mensagem em si pode ser lida no app do WhatsApp Business.
O easyCoexistence mantém mensagens não suportadas fora das suas automações, então sua IA nunca responde a uma mensagem que não consegue ler, e ainda encaminha o payload da Meta ao seu sistema quando há uma Forward URL configurada.
Código da Meta para uma mensagem recebida que está indisponível no momento, com o título "This message is currently unavailable."
A Meta diz que o erro normalmente se resolve em poucos segundos e que, depois disso, o WhatsApp entrega as mensagens normalmente.
O principal cenário citado pela Meta: um usuário do WhatsApp escreve para a empresa pela primeira vez, algo comum logo depois de tocar em um anúncio Click-to-WhatsApp.
Um código diferente, no mesmo webhook, indica que a Cloud API não suporta aquele tipo de mensagem de forma alguma.
As automações do easyCoexistence não rodam em uma mensagem não suportada; é a próxima mensagem legível desse chat que as dispara.
O que vem no webhook do erro 131060?
É um webhook messages 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 no campo message. Um objeto unsupported indica o tipo de conteúdo que a Meta não conseguiu repassar; a lista de valores da Meta inclui image, interactive, reaction e poll_creation. Não há corpo de texto nem media id, então nada no payload diz o que o cliente escreveu. O número do remetente, o id da mensagem e o timestamp vêm normalmente.
{
"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>" }
}]
}
}]
}]
}Por que isso acontece em um número com Coexistência?
O guia de Coexistência da Meta diz que os parceiros "podem receber um webhook de mensagens não suportadas com o código de erro 131060" e que isso é esperado. Ele cita dois cenários.
O primeiro é um usuário do WhatsApp escrevendo para a empresa pela primeira vez, o que, segundo a Meta, é especialmente comum quando alguém toca em um anúncio Click-to-WhatsApp e já manda uma mensagem. O segundo é um usuário do WhatsApp em um dispositivo vinculado (companion) não suportado enviando uma mensagem para a empresa ou recebendo uma dela.
A Meta não explica o mecanismo. O que ela afirma importa mais: o erro normalmente se resolve em poucos segundos e, depois disso, o WhatsApp entrega as mensagens normalmente.
O que a empresa deve fazer quando uma dessas chega?
Lê-la no app. A orientação da Meta às plataformas é pedir que a empresa veja a mensagem no app do WhatsApp Business, porque ela está no app do celular mesmo quando a cópia da API ficou indisponível.
Na prática: abra o chat no celular, leia o que o cliente escreveu e responda por ali, ou aguarde a próxima mensagem do cliente, que normalmente chega pela API sem o erro. Responder pelo celular também sinaliza às automações que uma pessoa assumiu o chat. Em uma campanha de anúncios, é normal ver uma pequena leva desses eventos no início de novas conversas, e isso não indica falha.
Como seu software e sua IA devem tratar isso?
Trate como um evento conhecido, não como falha. Responda ao webhook com 200, como em qualquer entrega, para que a Meta não o reenvie. Registre o id da mensagem e o remetente, o que permite vinculá-la à conversa que vem em seguida. Nunca passe a mensagem vazia para uma IA como se fosse texto: sem conteúdo, qualquer resposta é chute. E configure alertas pela taxa de eventos 131060, não por eventos isolados.
- Responda 200 rapidamente e elimine duplicatas pelo id da mensagem, como em qualquer webhook.
- Não acione respostas de IA nem correspondência por palavra-chave em mensagens do type unsupported.
- Avise sua equipe de que há uma mensagem esperando no app do celular.
- Conte os eventos 131060 separadamente das falhas reais nos seus painéis.
As automações rodam em uma mensagem não suportada?
No easyCoexistence, não. As automações leem texto, respostas de botões e listas, legendas de mídia e marcadores como "[voice message]"; uma mensagem do tipo unsupported não tem nada disso, então nenhuma automação responde a ela e nenhuma execução aparece. Se houver uma Forward URL configurada, seu sistema continua recebendo o payload original da Meta, incluindo o erro. No modo direto, a Meta o envia direto ao seu servidor.
A próxima mensagem legível dessa pessoa dispara as automações normalmente. Como ainda não havia nada armazenado para esse chat, uma automação de "First message", como uma resposta de boas-vindas, responde a essa próxima mensagem.
Qual a diferença entre o erro 131060 e o 131051?
Os dois chegam como type unsupported no mesmo webhook messages, por isso costumam ser confundidos nos logs. Para o planejamento, significam coisas opostas: um é uma indisponibilidade breve que se resolve sozinha, o outro é um limite permanente da API para aquele conteúdo. Leia errors[0].code, e não o type, para diferenciá-los no seu handler. 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 para eventos 131060 isolados. A Meta os considera esperados em números com Coexistência; acompanhe a taxa de ocorrências.
- Deixar uma IA responder à mensagem vazia. O payload não tem texto, então a resposta seria inventada.
- Responder ao webhook com um status de erro. A Meta reenvia webhooks que falham, e uma única mensagem não suportada vira várias entregas.
- Achar que a mensagem se perdeu. Ela está no app do WhatsApp Business; só a cópia da API ficou indisponível.
O número continua no app do celular, onde a mensagem original pode ser lida. De R$ 29,90 a R$ 3,90 por número por mês, caindo conforme você adiciona números, com os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Dá para recuperar o conteúdo original pela API?
A orientação da Meta para o 131060 é verificar o app do WhatsApp Business. A referência de webhooks da Meta não descreve nenhuma forma de recuperar o conteúdo depois.
O erro 131060 significa que o número está com problema?
Não. Se mensagens de contatos habituais continuarem chegando como 131060 por horas, peça à sua IA para executar get_number_health ou verifique a conexão, mas rajadas no primeiro contato são esperadas.
Acontece em números que usam só a Cloud API?
A Meta descreve o padrão do primeiro contato no guia para números conectados com o app do WhatsApp Business, que é o caso da Coexistência. O código em si está na referência geral de webhooks da Meta, então trate-o da mesma forma em qualquer número.
A Meta cobra por essas mensagens?
É uma mensagem recebida. A Meta cobra da empresa pelas mensagens que ela envia, por mensagem, por categoria e por país, na própria WhatsApp Business Account da empresa.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em