Iniciar sesiónEmpezar prueba gratis
Meta Tech Provider

Error 131060: mensaje no compatible en un número de Coexistencia

El error 131060 llega en un webhook de mensajes como un mensaje de tipo unsupported con el título "This message is currently unavailable." En un número de Coexistencia, Meta lo considera esperado: ocurre sobre todo cuando alguien escribe al negocio por primera vez, a menudo justo después de tocar un anuncio Click-to-WhatsApp, y suele resolverse en segundos. El mensaje en sí se puede leer en la app de WhatsApp Business.

easyCoexistence deja los mensajes no compatibles fuera de tus automatizaciones, así que tu IA nunca responde a un mensaje que no puede leer, y aun así reenvía el payload de Meta a tu sistema cuando hay una Forward URL configurada.

131060

Código de Meta para un mensaje entrante que no está disponible en este momento, con el título "This message is currently unavailable."

Seconds

Meta indica que el error normalmente se resuelve en pocos segundos y que, después, WhatsApp entrega los mensajes con normalidad.

First contact

El escenario principal que menciona Meta: un usuario de WhatsApp que escribe al negocio por primera vez, algo frecuente justo después de tocar un anuncio Click-to-WhatsApp.

131051

Un código distinto en el mismo webhook: la Cloud API no admite ese tipo de mensaje en absoluto.

Skipped

Las automatizaciones de easyCoexistence no se ejecutan con un mensaje no compatible; el siguiente mensaje legible de ese chat las pone en marcha.

¿Qué contiene el webhook del error 131060?

Es un webhook de mensajes normal cuyo mensaje tiene "type": "unsupported" y un array errors. El error lleva el código 131060 y el título "This message is currently unavailable.", con la misma frase como mensaje. Un objeto unsupported indica el tipo de contenido que Meta no pudo transmitir; la lista de valores de Meta incluye image, interactive, reaction y poll_creation. No hay cuerpo de texto ni id de multimedia, así que nada en el payload indica lo que escribió el cliente. El número del remitente, el id del mensaje y la marca de tiempo llegan como siempre.

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 qué ocurre en un número de Coexistencia?

La guía de Coexistencia de Meta dice que los socios "pueden recibir un webhook de mensajes no compatibles con el código de error 131060" y que es algo esperado. Menciona dos escenarios.

El primero es un usuario de WhatsApp que escribe al negocio por primera vez, algo que, según Meta, es especialmente común cuando alguien toca un anuncio Click-to-WhatsApp y envía un mensaje de inmediato. El segundo es un usuario de WhatsApp en un dispositivo complementario no compatible que envía un mensaje al negocio o recibe uno de este.

Meta no explica el mecanismo. Lo que sí dice importa más: el error normalmente se resuelve en pocos segundos y, después, WhatsApp entrega los mensajes con normalidad.

¿Qué debe hacer el negocio cuando llega uno?

Leerlo en la app. La instrucción de Meta a las plataformas es pedir al negocio que busque el mensaje en la app de WhatsApp Business, porque la app del teléfono lo tiene aunque la copia de la API no estuviera disponible.

En la práctica: abre el chat en el teléfono, lee lo que escribió el cliente y responde desde allí, o espera el siguiente mensaje del cliente, que normalmente llega por la API sin el error. Responder desde el teléfono también indica a las automatizaciones que una persona está atendiendo el chat. En una campaña de anuncios, es normal ver una pequeña ráfaga de estos casos al inicio de las conversaciones nuevas; no es un fallo.

¿Cómo deben manejarlo tu software y tu IA?

Trátalo como un evento conocido, no como un fallo. Responde al webhook con un 200, como con cualquier entrega, para que Meta no lo reenvíe. Registra el id del mensaje y el remitente, lo que te permite vincularlo con la conversación que sigue. Nunca le pases el mensaje vacío a una IA como si fuera texto: sin contenido, cualquier respuesta es una suposición. Y configura las alertas sobre la tasa de eventos 131060, no sobre casos aislados.

  • Responde con 200 rápido y deduplica por id de mensaje, como con cualquier webhook.
  • Omite las respuestas de IA y la detección de palabras clave para type unsupported.
  • Avisa a tu equipo de que hay un mensaje esperando en la app del teléfono.
  • Cuenta los 131060 por separado de los fallos reales en tus paneles.

¿Se ejecutan las automatizaciones con un mensaje no compatible?

En easyCoexistence, no. Las automatizaciones leen texto, respuestas de botones y listas, leyendas de archivos multimedia y marcadores como "[voice message]"; un mensaje de tipo unsupported no tiene nada de esto, así que ninguna automatización lo responde y no aparece ninguna ejecución. Si hay una Forward URL configurada, tu sistema sigue recibiendo el payload original de Meta, con el error incluido. En modo directo, Meta lo envía directamente a tu servidor.

El siguiente mensaje legible de esa persona activa las automatizaciones como de costumbre. Como todavía no se había guardado nada de ese chat, una automatización de "Primer mensaje", como una respuesta de bienvenida, responde a ese siguiente mensaje.

¿En qué se diferencia el error 131060 del 131051?

Ambos llegan como type unsupported en el mismo webhook de mensajes, y por eso se confunden en los registros. Para la planificación significan cosas opuestas: uno es un hueco breve que se resuelve solo; el otro, un límite permanente de la API para ese contenido. Lee errors[0].code, no el type, para distinguirlos en tu handler. La tabla resume lo que dicen las referencias de Meta 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

Errores comunes

  • Generar una alerta por cada 131060 aislado. Meta los considera esperados en números de Coexistencia; vigila la tasa.
  • Dejar que una IA responda al mensaje vacío. El payload no tiene texto, así que la respuesta sería inventada.
  • Responder al webhook con un código de estado de error. Meta reenvía los webhooks que fallan, así que un solo mensaje no compatible se convierte en varias entregas.
  • Dar el mensaje por perdido. Está en la app de WhatsApp Business; solo la copia de la API no estaba disponible.
Hacerlo con EasyCoexistence

El número sigue en la app del teléfono, donde se puede leer el mensaje original. De US$ 9 a US$ 0.75 por número al mes, con un precio que baja a medida que añades números, y los primeros 3 días gratis.

Preguntas frecuentes

¿Puedo recuperar el contenido original a través de la API?

Para el error 131060, Meta indica revisar la app de WhatsApp Business. Su referencia de webhooks no describe ninguna forma de recuperar el contenido más tarde.

¿El error 131060 significa que el número está fallando?

No. Si los mensajes de contactos habituales siguen llegando como 131060 durante horas, pide a tu IA que ejecute get_number_health o revisa la conexión, pero las ráfagas en el primer contacto son esperables.

¿Ocurre también en números que solo usan la Cloud API?

Meta describe el patrón del primer contacto en su guía para números incorporados con la app de WhatsApp Business, que es justamente lo que es Coexistencia. El código en sí figura en la referencia general de webhooks de Meta, así que trátalo igual en cualquier número.

¿Se cobra algo por esto?

Es un mensaje entrante. Meta cobra al negocio por los mensajes que este envía, por mensaje, según la categoría y el país, en su propia cuenta de WhatsApp Business.

Sigue leyendo

¿Listo para empezar?

Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.

Empezar prueba gratis

Verificado el