ログイン無料トライアルを開始
Meta Tech Provider

Coexistence 番号の未対応メッセージ(エラー 131060)

エラー 131060 は、messages の Webhook に type が unsupported のメッセージとして届き、タイトルは「This message is currently unavailable.」です。Coexistence 番号では Meta が想定内の挙動と説明しており、多くは相手が初めて事業者にメッセージを送ったときに発生します。特に Click-to-WhatsApp 広告をタップした直後に多く、通常は数秒で解消します。メッセージ本文は WhatsApp Business アプリで読めます。

easyCoexistence は未対応メッセージを自動化から除外するため、読めないメッセージに AI が応答することはありません。

131060

受信メッセージが現在利用できないことを示す Meta のコードで、タイトルは「This message is currently unavailable.」です。

Seconds

Meta によると、このエラーは通常数秒以内に解消し、その後 WhatsApp は通常どおりメッセージを配信します。

First contact

Meta が挙げる主なケースは、WhatsApp ユーザーが事業者に初めてメッセージを送る場合で、Click-to-WhatsApp 広告をタップした直後によく見られます。

131051

同じ Webhook 内の別のコードは、Cloud API がそのメッセージタイプをまったくサポートしないことを示します。

Skipped

easyCoexistence の自動化は、対応していないメッセージでは実行されず、そのチャットで次に読めるメッセージが自動化を開始します。

131060 の Webhook にはどんな内容が含まれますか?

通常の messages の Webhook で、メッセージの type は unsupported、errors 配列があります。エラーには code 131060 と、タイトル「This message is currently unavailable.」が入り、error の message も同じ文です。unsupported オブジェクトは、Meta が転送できなかったコンテンツの種類を示します。Meta の値の一覧には image、interactive、reaction、poll_creation などがあります。本文もメディア ID もないため、ペイロードだけでは顧客が何を書いたかは分かりません。送信者の番号、メッセージ ID、タイムスタンプは通常どおり含まれます。

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

Coexistence 番号で発生するのはなぜですか?

Meta の Coexistence ガイドでは、パートナーは「unsupported messages webhook with error code 131060」を受け取ることがあり、これは想定内であると述べられています。想定されるシナリオは 2 つあります。

1 つめは、WhatsApp ユーザーが事業者に初めてメッセージを送る場合です。Meta は、Click-to-WhatsApp 広告をタップしてすぐにメッセージを送るケースで特に多いと説明しています。2 つめは、未対応のコンパニオンデバイスを使う WhatsApp ユーザーが、事業者へメッセージを送る、または事業者からメッセージを受け取る場合です。

Meta は仕組みまでは説明していません。ただし重要なのは、このエラーは通常数秒で解消し、その後 WhatsApp はメッセージを通常どおり配信する、という点です。

メッセージが届いたら事業者は何をすべきですか?

アプリで読んでください。Meta がプラットフォームに求める対応は、WhatsApp Business アプリでメッセージを確認するよう事業者に伝えることです。API 側のコピーは利用できなくても、スマートフォンのアプリには同じメッセージがあるためです。

実際には、スマートフォンでチャットを開き、顧客の内容を読んでそこから返信するか、顧客の次のメッセージを待ちます。次のメッセージは通常、このエラーなしで API を通じて届きます。スマートフォンから返信すると、自動化にも人が対応中であることが伝わります。広告キャンペーンでは、新しい会話の開始時に少数のこのエラーが集中して出ることがありますが、それは不具合ではありません。

ソフトウェアと AI はどう扱うべきですか?

既知のイベントとして扱い、失敗とはみなさないでください。通常の配信と同様に 200 で応答すると、Meta は再送しません。メッセージ ID と送信者を記録すると、その後に続く会話と結びつけられます。内容が空のメッセージを、テキストとして AI に渡さないでください。内容がなければ、どんな返信も推測になります。さらに、1 件ごとではなく 131060 の発生件数に対してアラートを設定してください。

  • 200 をすばやく返し、通常の Webhook と同じくメッセージ ID で重複排除してください。
  • type が unsupported のメッセージには、AI による返信やキーワード照合を行わないでください。
  • チームに、スマートフォンのアプリにメッセージが待っていることを伝えてください。
  • ダッシュボードでは、131060 を実際の失敗とは別に集計してください。

unsupported のメッセージで自動化は実行されますか?

easyCoexistence では実行されません。自動化はテキスト、ボタンとリストの返信、メディアのキャプション、および「[voice message]」のようなプレースホルダーを読み取ります。type が unsupported のメッセージにはこれらがないため、どの自動化も応答せず、実行履歴にも表示されません。「Forward URL」を設定している場合、エラーを含む Meta の元のペイロードはシステムに届きます。ダイレクトモードでは、Meta から直接サーバーに送られます。

その人から次に読めるメッセージが届くと、通常どおり自動化が開始します。そのチャットにはまだ何も保存されていないため、「First message」の自動化、たとえば歓迎の返信は、その次のメッセージに応答します。

131060 と 131051 はどう違いますか?

どちらも同じ messages の Webhook に type が unsupported として届くため、ログで混同されやすくなります。ただし計画の上では意味が正反対です。一方は自然に解消する短い空白で、もう一方は API がそのコンテンツに対して示す恒久的な制限です。ハンドラーで見分けるには、type ではなく errors[0].code を読んでください。各コードの説明は Meta のリファレンスに基づいています。

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

よくある間違い

  • Coexistence 番号の 131060 を都度アラートにすること。Meta は想定内と説明しているため、件数の推移を監視してください。
  • 空のメッセージに AI で返信させること。ペイロードにテキストがないため、回答は作り話になります。
  • Webhook にエラーステータスで応答すること。Meta は失敗した Webhook を再送するため、1 件の未対応メッセージが複数回の配信になります。
  • メッセージが失われたと考えること。メッセージは WhatsApp Business アプリにあり、利用できなかったのは API 側のコピーだけです。
EasyCoexistence で実現する

Forward URL を設定している場合は、Meta の元のペイロードをシステムに転送します。番号はスマートフォンのアプリに残り、元のメッセージを読むことができます。料金は接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。

よくある質問

API で元の内容を取得できますか?

131060 について Meta が案内しているのは、WhatsApp Business アプリで確認することです。Meta の Webhook リファレンスには、あとから内容を取得する方法は記載されていません。

131060 は番号が壊れているという意味ですか?

いいえ。通常の連絡先からのメッセージが何時間も 131060 として届き続ける場合は、AI に get_number_health の実行を依頼するか、接続を確認してください。ただし、初回連絡時に集中して発生するのは想定内です。

Cloud API だけを使う番号でも発生しますか?

Meta は、WhatsApp Business アプリで登録された番号向けのガイドで、初回連絡のパターンを説明しています。これは Coexistence のことです。このコードは Meta の一般的な Webhook リファレンスにあるため、どの番号でも同じように扱ってください。

このエラーで課金されますか?

これは受信メッセージです。Meta は事業者が送信したメッセージに対して、メッセージごとに、カテゴリーと国別に課金します。課金先は事業者自身の WhatsApp Business アカウントです。

続きを読む

始める準備はできましたか?

WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。

無料トライアルを始める

確認日