Coexistence 番号の未対応メッセージ(エラー 131060)
エラー 131060 は、messages の Webhook に type が unsupported のメッセージとして届き、タイトルは「This message is currently unavailable.」です。Coexistence 番号では Meta が想定内の挙動と説明しており、多くは相手が初めて事業者にメッセージを送ったときに発生します。特に Click-to-WhatsApp 広告をタップした直後に多く、通常は数秒で解消します。メッセージ本文は WhatsApp Business アプリで読めます。
easyCoexistence は未対応メッセージを自動化から除外するため、読めないメッセージに AI が応答することはありません。
受信メッセージが現在利用できないことを示す Meta のコードで、タイトルは「This message is currently unavailable.」です。
Meta によると、このエラーは通常数秒以内に解消し、その後 WhatsApp は通常どおりメッセージを配信します。
Meta が挙げる主なケースは、WhatsApp ユーザーが事業者に初めてメッセージを送る場合で、Click-to-WhatsApp 広告をタップした直後によく見られます。
同じ Webhook 内の別のコードは、Cloud API がそのメッセージタイプをまったくサポートしないことを示します。
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、タイムスタンプは通常どおり含まれます。
{
"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 のリファレンスに基づいています。
| 131060 | 131051 | |
|---|---|---|
| Title | This message is currently unavailable. | Message type unknown |
| Meaning | The message cannot be passed on right now | The Cloud API does not support that type |
| Typical cause | First contact on a Coexistence number, often after an ad tap | Content the API never delivers |
| How long | Usually clears within seconds | Permanent for that content |
| What to do | Read it in the WhatsApp Business app | Ask the customer for text, or read it in the app |
よくある間違い
- Coexistence 番号の 131060 を都度アラートにすること。Meta は想定内と説明しているため、件数の推移を監視してください。
- 空のメッセージに AI で返信させること。ペイロードにテキストがないため、回答は作り話になります。
- Webhook にエラーステータスで応答すること。Meta は失敗した Webhook を再送するため、1 件の未対応メッセージが複数回の配信になります。
- メッセージが失われたと考えること。メッセージは WhatsApp Business アプリにあり、利用できなかったのは API 側のコピーだけです。
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 の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日