Se connecterCommencer l’essai gratuit
Meta Tech Provider

Erreur 131060 : message non pris en charge sur un numéro Coexistence

L'erreur 131060 arrive dans un webhook messages sous forme de message de type unsupported, intitulé « This message is currently unavailable. » Sur un numéro Coexistence, Meta la considère comme attendue : elle survient surtout quand quelqu'un écrit à l'entreprise pour la première fois, souvent juste après un clic sur une pub Click-to-WhatsApp, et disparaît en quelques secondes. Le message reste lisible dans l'application WhatsApp Business.

easyCoexistence tient les messages non pris en charge à l'écart de vos automatisations : votre IA ne répond jamais à un message qu'elle ne peut pas lire, et le payload original de Meta reste transmis à votre système lorsqu'une URL de transfert est définie.

131060

Code de Meta pour un message entrant actuellement indisponible, intitulé « This message is currently unavailable. »

Seconds

Meta indique que l'erreur se résout généralement en quelques secondes, après quoi WhatsApp livre les messages normalement.

First contact

Le scénario principal cité par Meta : un utilisateur WhatsApp écrit à l'entreprise pour la première fois, fréquent juste après un clic sur une pub Click-to-WhatsApp.

131051

Un autre code dans le même webhook : la Cloud API ne prend pas du tout en charge ce type de message.

Skipped

Les automatisations easyCoexistence ne s'exécutent pas sur un message non pris en charge ; le message lisible suivant de la conversation les déclenche.

Que contient le webhook 131060 ?

C'est un webhook messages ordinaire dont le message porte « "type": "unsupported" » et un tableau errors. L'erreur contient le code 131060 et le titre « This message is currently unavailable. », identique à son message. Un objet unsupported indique le type de contenu que Meta n'a pas pu transmettre ; la liste de Meta comprend image, interactive, reaction et poll_creation. Il n'y a ni corps de texte ni identifiant de média, donc rien dans le payload ne dit ce que le client a écrit. Le numéro de l'expéditeur, l'identifiant du message et l'horodatage sont présents comme d'habitude.

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

Pourquoi cela arrive-t-il sur un numéro Coexistence ?

Le guide Coexistence de Meta indique que les partenaires « peuvent recevoir un webhook de messages non pris en charge avec le code d'erreur 131060 » et que c'est attendu. Il cite deux scénarios.

Le premier : un utilisateur WhatsApp écrit à l'entreprise pour la première fois, ce que Meta juge particulièrement fréquent quand quelqu'un clique sur une pub Click-to-WhatsApp et envoie aussitôt un message. Le second : un utilisateur WhatsApp sur un appareil compagnon non pris en charge envoie un message à l'entreprise ou en reçoit un.

Meta n'explique pas le mécanisme. Ce qu'il précise compte davantage : l'erreur se résout généralement en quelques secondes, après quoi WhatsApp livre les messages normalement.

Que doit faire l'entreprise quand un message de ce type arrive ?

Le lire dans l'application. Meta demande aux plateformes d'inviter l'entreprise à consulter le message dans l'application WhatsApp Business, car l'application sur le téléphone le contient même si la copie de l'API était indisponible.

En pratique : ouvrez la conversation sur le téléphone, lisez ce que le client a écrit et répondez depuis là, ou attendez le message suivant du client, qui arrive normalement par l'API sans l'erreur. Répondre depuis le téléphone indique aussi aux automatisations qu'une personne suit la conversation. Pour une campagne publicitaire, attendez-vous à une petite rafale de ces messages au début de nouvelles conversations, et non à une panne.

Comment votre logiciel et votre IA doivent-ils le gérer ?

Traitez-le comme un événement connu, non comme une panne. Renvoyez un 200 dès réception, comme pour toute livraison, afin que Meta ne le renvoie pas. Enregistrez l'identifiant du message et l'expéditeur, ce qui permet de le relier à la conversation qui suit. Ne transmettez jamais le message vide à une IA comme s'il s'agissait d'un texte : sans contenu, toute réponse serait une supposition. Enfin, alertez sur le taux d'événements 131060, pas sur chaque occurrence isolée.

  • Renvoyez un 200 rapidement et dédoublonnez sur l'identifiant du message, comme pour tout webhook.
  • Ne lancez ni réponse IA ni détection de mots-clés pour le type unsupported.
  • Indiquez à votre équipe qu'un message attend dans l'application sur le téléphone.
  • Comptez les 131060 à part des vraies erreurs dans vos tableaux de bord.

Les automatisations s'exécutent-elles sur un message non pris en charge ?

Sur easyCoexistence, non. Les automatisations lisent les textes, les réponses de boutons et de listes, les légendes des médias et les espaces réservés comme « [voice message] » ; un message de type unsupported n'en a aucun, donc aucune automatisation ne répond et aucune exécution n'apparaît. Si une URL de transfert est définie, votre système reçoit tout de même le payload original de Meta, erreur comprise. En mode direct, Meta l'envoie directement à votre serveur.

Le message lisible suivant de cette personne déclenche les automatisations comme d'habitude. Comme rien n'a encore été stocké pour cette conversation, une automatisation « Premier message », comme une réponse de bienvenue, répond à ce message suivant.

En quoi 131060 diffère-t-il de 131051 ?

Les deux arrivent comme type unsupported dans le même webhook messages, ce qui prête à confusion dans les journaux. Ils signifient deux choses opposées pour la planification : l'un est un bref écart qui se corrige seul, l'autre une limite permanente de l'API pour ce contenu. Lisez errors[0].code, et non le type, pour les distinguer dans votre gestionnaire d'événements. Le tableau résume ce que disent les références de Meta sur chaque code.

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

Erreurs courantes

  • Alerter sur chaque événement 131060 isolé. Meta les juge attendus sur les numéros Coexistence ; surveillez plutôt le taux.
  • Laisser une IA répondre au message vide. Le payload ne contient aucun texte, la réponse serait inventée.
  • Répondre au webhook par un statut d'erreur. Meta renvoie les webhooks en échec, donc un seul message non pris en charge devient plusieurs livraisons.
  • Croire que le message est perdu. Il se trouve dans l'application WhatsApp Business ; seule la copie de l'API était indisponible.
Faire cela avec EasyCoexistence

Le numéro reste dans l'application sur le téléphone, où le message d'origine peut être lu. De US$ 9 à US$ 0,75 par numéro et par mois, dégressif à mesure que vous ajoutez des numéros, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Puis-je récupérer le contenu original par l'API ?

Les consignes de Meta pour 131060 consistent à consulter l'application WhatsApp Business. Sa référence des webhooks ne décrit aucun moyen de récupérer ultérieurement le contenu.

Le code 131060 signifie-t-il que le numéro est cassé ?

Non. Si les messages de contacts habituels continuent d'arriver en 131060 pendant des heures, demandez à votre IA d'exécuter get_number_health ou de vérifier la connexion ; les rafales lors des premiers contacts sont attendues.

Cela arrive-t-il sur les numéros qui n'utilisent que la Cloud API ?

Meta décrit ce schéma de premier contact dans son guide pour les numéros intégrés avec l'application WhatsApp Business, c'est-à-dire Coexistence. Le code figure dans la référence générale des webhooks de Meta ; traitez-le donc de la même façon sur tout numéro.

Cela est-il facturé ?

C'est un message entrant. Meta facture à l'entreprise les messages qu'elle envoie, par message, selon la catégorie et le pays, sur son propre compte WhatsApp Business.

Poursuivre la lecture

Prêt à commencer ?

Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.

Commencer l'essai gratuit

Vérifié le