EntrarComeçar teste grátis
Meta Tech Provider

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.

131060

Código da Meta para uma mensagem recebida que está indisponível no momento, com o título "This message is currently unavailable."

Seconds

A Meta diz que o erro normalmente se resolve em poucos segundos e que, depois disso, o WhatsApp entrega as mensagens normalmente.

First contact

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.

131051

Um código diferente, no mesmo webhook, indica que a Cloud API não suporta aquele tipo de mensagem de forma alguma.

Skipped

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.

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>" }
        }]
      }
    }]
  }]
}

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.

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 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.
Fazendo isso com o EasyCoexistence

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átis

Verificado em