AnmeldenKostenlose Testphase starten
Meta Tech Provider

Fehler 131060: nicht unterstützte Nachricht auf einer Coexistence-Nummer

Fehler 131060 kommt in einem Nachrichten-Webhook als Nachricht vom Typ unsupported an, mit dem Titel „Diese Nachricht ist derzeit nicht verfügbar.“ Bei einer Coexistence-Nummer hält Meta das für erwartet: Es tritt meist auf, wenn jemand dem Unternehmen zum ersten Mal schreibt, oft direkt nach dem Tippen auf eine Click-to-WhatsApp-Anzeige, und verschwindet in der Regel innerhalb von Sekunden. Die Nachricht selbst ist in der WhatsApp-Business-App lesbar.

easyCoexistence hält nicht unterstützte Nachrichten aus Ihren Automatisierungen heraus, sodass Ihre KI nie eine Nachricht beantwortet, die sie nicht lesen kann, und Metas Payload trotzdem an Ihr System weitergeleitet wird, wenn eine Forward URL gesetzt ist.

131060

Metas Code für eine eingehende Nachricht, die derzeit nicht verfügbar ist, mit dem Titel „Diese Nachricht ist derzeit nicht verfügbar.“

Seconds

Meta sagt, der Fehler löst sich in der Regel innerhalb weniger Sekunden, danach liefert WhatsApp Nachrichten wieder normal aus.

First contact

Das wichtigste Szenario laut Meta: Ein WhatsApp-Nutzer schreibt dem Unternehmen zum ersten Mal, häufig direkt nach dem Tippen auf eine Click-to-WhatsApp-Anzeige.

131051

Ein anderer Fehlercode im selben Webhook: Die Cloud API unterstützt diesen Nachrichtentyp überhaupt nicht.

Skipped

easyCoexistence-Automatisierungen laufen bei einer nicht unterstützten Nachricht nicht; die nächste lesbare Nachricht aus diesem Chat startet sie.

Was enthält der 131060-Webhook?

Es ist ein gewöhnlicher Nachrichten-Webhook, dessen Nachricht "type": "unsupported" hat und ein errors-Array. Der Fehler trägt den Code 131060 und den Titel „Diese Nachricht ist derzeit nicht verfügbar.“, mit demselben Satz als Text. Ein unsupported-Objekt benennt die Art des Inhalts, den Meta nicht weitergeben konnte; Metas Liste der Werte umfasst image, interactive, reaction und poll_creation. Es gibt keinen Textinhalt und keine Media-ID, daher verrät nichts im Payload, was der Kunde geschrieben hat. Absender-Nummer, Nachrichten-ID und Zeitstempel sind wie üblich vorhanden.

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

Warum tritt er bei einer Coexistence-Nummer auf?

Metas Coexistence-Leitfaden sagt, dass Partner einen Nachrichten-Webhook vom Typ unsupported mit dem Fehlercode 131060 erhalten können und dies erwartet ist. Er nennt zwei Szenarien.

Das erste: Ein WhatsApp-Nutzer schreibt dem Unternehmen zum ersten Mal, was laut Meta besonders häufig vorkommt, wenn jemand auf eine Click-to-WhatsApp-Anzeige tippt und sofort eine Nachricht sendet. Das zweite: Ein WhatsApp-Nutzer auf einem nicht unterstützten Companion-Gerät sendet dem Unternehmen eine Nachricht oder empfängt eine von ihm.

Meta erklärt den Mechanismus nicht. Wichtiger ist, was es sagt: Der Fehler löst sich in der Regel innerhalb weniger Sekunden, und danach liefert WhatsApp Nachrichten wieder normal aus.

Was soll das Unternehmen tun, wenn eine ankommt?

In der App nachsehen. Metas Hinweis an Plattformen lautet, dem Unternehmen zu sagen, es solle die Nachricht in der WhatsApp-Business-App prüfen, weil sie dort auch dann vorliegt, wenn die API-Kopie nicht verfügbar war.

In der Praxis: Den Chat auf dem Telefon öffnen, lesen, was der Kunde geschrieben hat, und von dort antworten, oder auf die nächste Nachricht des Kunden warten, die normalerweise ohne Fehler über die API kommt. Antwortet man vom Telefon aus, erfahren Automatisierungen außerdem, dass eine Person den Chat übernommen hat. Bei einer Anzeigenkampagne ist zu Beginn neuer Gespräche mit einer kleinen Welle solcher Fälle zu rechnen, kein Defekt.

Wie sollten Software und KI damit umgehen?

Als bekanntes Ereignis behandeln, nicht als Fehler. Den Webhook wie bei jeder Zustellung mit 200 bestätigen, damit Meta ihn nicht erneut sendet. Nachrichten-ID und Absender speichern, damit sich der folgende Chat zuordnen lässt. Den leeren Payload niemals einer KI als Text übergeben: Ohne Inhalt wäre jede Antwort geraten. Und auf die Häufigkeit von 131060-Ereignissen alarmieren, nicht auf einzelne.

  • Schnell mit 200 antworten und nach Nachrichten-ID deduplizieren, wie bei jedem Webhook.
  • KI-Antworten und Schlüsselwortabgleich für type unsupported überspringen.
  • Dem Team zeigen, dass eine Nachricht in der App auf dem Telefon wartet.
  • 131060 in Dashboards getrennt von echten Fehlern zählen.

Laufen Automatisierungen bei einer nicht unterstützten Nachricht?

Bei easyCoexistence nicht. Automatisierungen lesen Text, Button- und Listenantworten, Medienbeschriftungen und Platzhalter wie "[Sprachnachricht]". Eine Nachricht vom Typ unsupported hat keines davon, daher beantwortet keine Automatisierung sie, und es entsteht kein Lauf. Ist eine Forward URL gesetzt, erhält Ihr System weiterhin Metas Original-Payload samt Fehler. Im Direktmodus schickt Meta ihn direkt an Ihren Server.

Die nächste lesbare Nachricht dieser Person startet Automatisierungen wie üblich. Da für diesen Chat noch nichts gespeichert wurde, beantwortet eine Automatisierung „Erste Nachricht“, etwa eine Willkommensantwort, genau diese nächste Nachricht.

Worin unterscheidet sich 131060 von 131051?

Beide kommen als Typ unsupported im selben Nachrichten-Webhook an, weshalb sie in Logs leicht verwechselt werden. Für die Planung bedeuten sie das Gegenteil: Das eine ist eine kurze Lücke, die sich von selbst schließt, das andere eine dauerhafte Grenze der API für diesen Inhalt. Im Handler errors[0].code auslesen, nicht den Typ, um sie zu unterscheiden. Metas Referenzen erklären beide Codes getrennt.

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

Häufige Fehler

  • Einzelne 131060-Ereignisse melden. Meta nennt sie bei Coexistence-Nummern erwartet; stattdessen die Häufigkeit beobachten.
  • Eine KI auf die leere Nachricht antworten lassen. Der Payload hat keinen Text, die Antwort wäre erfunden.
  • Mit einem Fehlerstatus auf den Webhook antworten. Meta sendet fehlgeschlagene Webhooks erneut, sodass eine nicht unterstützte Nachricht zu mehreren Zustellungen wird.
  • Annehmen, die Nachricht sei verloren. Sie liegt in der WhatsApp-Business-App; nur die API-Kopie war nicht verfügbar.
Mit EasyCoexistence

Die Nummer bleibt in der App auf dem Telefon, wo die Originalnachricht lesbar ist. US$ 9 bis hinunter zu US$ 0.75 pro Nummer und Monat, sinkend mit jeder weiteren Nummer; die ersten 3 Tage sind kostenlos.

Häufig gestellte Fragen

Kann ich den Originalinhalt über die API abrufen?

Metas Hinweis zu 131060 lautet, in der WhatsApp-Business-App nachzusehen. Die Referenz des Webhooks beschreibt keinen Weg, den Inhalt später abzurufen.

Heißt 131060, dass die Nummer defekt ist?

Nein. Wenn Nachrichten von gewöhnlichen Kontakten über Stunden weiter als 131060 ankommen, lassen Sie Ihre KI get_number_health ausführen oder prüfen Sie die Verbindung. Wellen beim ersten Kontakt sind dagegen erwartet.

Betrifft es Nummern, die nur die Cloud API nutzen?

Meta beschreibt das Muster beim ersten Kontakt in seinem Leitfaden für Nummern, die mit der WhatsApp-Business-App angebunden wurden, und genau das ist Coexistence. Der Code selbst steht in Metas allgemeiner Webhook-Referenz, daher sollte man ihn auf jeder Nummer gleich behandeln.

Wird dafür etwas berechnet?

Es ist eine eingehende Nachricht. Meta berechnet dem Unternehmen die von ihm gesendeten Nachrichten pro Nachricht, nach Kategorie und Land, auf seinem eigenen WhatsApp-Business-Konto.

Weiterlesen

Bereit für den Start?

Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.

Kostenlose Testphase starten

Verifiziert am