Iniciar sessãoIniciar teste gratuito
Meta Tech Provider

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.

131060

Código da Meta para uma mensagem recebida atualmente indisponível, com o título «This message is currently unavailable.»

Seconds

A Meta indica que o erro se resolve normalmente em poucos segundos, após o que o WhatsApp entrega as mensagens com normalidade.

First contact

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.

131051

Outro código no mesmo webhook: a Cloud API não suporta esse tipo de mensagem.

Skipped

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.

messages webhook with error 131060 (shape from Meta's reference, values illustrative)
{
  "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.

131060131051
TitleThis message is currently unavailable.Message type unknown
MeaningThe message cannot be passed on right nowThe Cloud API does not support that type
Typical causeFirst contact on a Coexistence number, often after an ad tapContent the API never delivers
How longUsually clears within secondsPermanent for that content
What to doRead it in the WhatsApp Business appAsk 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.
Fazer isto com a EasyCoexistence

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 gratuito

Verificado em