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

WhatsApp API のメッセージが届かない:原因を順番に確認

WhatsApp API で受け付けられたメッセージは、届いたメッセージとは限りません。Meta は結果を後から、ステータス Webhook で報告します。報告は sent(送信済み)、delivered(配信済み)、read(既読)、failed(失敗)のいずれかで、失敗の場合はエラーコードが付きます。次の順に確認してください:失敗ステータスとそのコード、24 時間ウィンドウ(131047)、支払い方法(131042)、テンプレート(132001、132015)、受信者(131026、131049、131050)、最後に番号の上限と接続です。

easyCoexistence は、接続されたすべての番号を 24 時間体制で監視し、Meta が配信を停止したり、接続が切れたり、品質が下がったりすると、メールでお知らせします。

4 statuses

sent(チェック 1 つ)、delivered(チェック 2 つ)、read(青いチェック 2 つ)、failed(赤いエラーの三角形)。これらはステータス Webhook が報告する値です。

131047

受信者が最後に返信してから 24 時間以上経っています。Meta は代わりにテンプレートを送るよう求めています。

131026

配信できない場合:その番号が WhatsApp を利用していない、受信者が新しい利用規約に同意していない、または古い WhatsApp のバージョンを使っている。

30 days

配信されなかったユーティリティテンプレートやマーケティングテンプレートを、WhatsApp が破棄するまで再試行する既定の時間です。認証テンプレートの既定値は 10 分です。

20 mps

WhatsApp Business アプリと Cloud API の両方で使われている番号の、固定のスループットです。

受け付けられたメッセージが、なぜ届かないことがあるのですか?

API の応答と配信は、別々の出来事だからです。送信すると、Meta はリクエストを受け付けた時点で message id を返します。メッセージがお客様の端末に届くかどうかは後から分かり、messages フィールドのステータス Webhook で通知されます。sent は Meta のサーバーを出たこと(チェック 1 つ)、delivered は端末に届いたこと(チェック 2 つ)、read は開封されたこと(青いチェック 2 つ)を意味します。failed は送信または配信できなかったことで、errors 配列で示されます。配列には code、title、error_data.details が含まれます。まず推測せず、その message id の failed ステータスを探し、コードを読んでください。Webhook の送信先を設定していなければ、この情報は記録されません。

原因は、どの順に確認すればよいですか?

新しく接続した番号で多いものから、まれなものへ並べています。各項目に Meta のコードを記載しているので、failed ステータスからどの原因か判別できます:

  • ウィンドウ終了:131047。お客様が最後にメッセージを送ってから 24 時間以上経過しています。フリーテキストのメッセージには開いたウィンドウが必要です。テンプレートを送ってください。
  • 支払い:131042。または、テンプレートが黙って破棄されています。2026 年 10 月 1 日以降は、支払い方法を登録せずに月 1,000 件を超えると、サービスメッセージも停止します。
  • テンプレート:132001 承認されていない、または言語が誤っている。132000 変数の数が誤っている。132012 形式が誤っている。132015 一時停止中。132016 無効。
  • 受信者:131026 WhatsApp を利用していない、古いバージョン、または利用規約に同意していない。131050 マーケティングメッセージの受け取りを停止している。131049 健全なエンゲージメントを保つため保留されている。米国の番号へのマーケティングテンプレートは配信されません。
  • 上限:131048 スパムの兆候を受けて制限中。131056 同じ相手への送信が多すぎる。130429 スループット超過。Coexistence の番号では秒間 20 件まで。
  • アカウント:131031 または 368。ポリシー違反で WhatsApp Business Account が制限または無効化されています。
  • 接続:番号がリンクされなくなっている。例えば、14 日間 WhatsApp Business アプリを開かなかった場合。

受信者側のコードは、どう扱えばよいですか?

原因によって対応が異なります。再試行すべきものと、決して再試行してはいけないものがあるからです。131050 は、相手がこちらからのマーケティングメッセージの受け取りを停止したことを意味します。Meta は再試行しないよう求めており、user_preferences Webhook で停止と再開が通知されます。131049 は、エンゲージメントを健全に保つために Meta がマーケティングメッセージを保留していることを意味します。多くは、マーケティングテンプレートのユーザーごとの上限です。Meta は、再送する前に少なくとも 24 時間待つよう勧めています。それより早く再送しても、同じエラーが返るだけです。131026 は、番号が WhatsApp を利用していないこと、お客様が現在の利用規約に同意していないこと、非常に古いアプリのバージョンを使っていることを示します。まず番号の形式と国番号を確認し、そのうえで別のチャネルでお客様に連絡してください。

WhatsApp は、いつまで配信を試み続けますか?

メッセージの生存時間(TTL)までです。端末の電源が切れていたり圏外だったりすると、WhatsApp は即座に失敗とせず、配信を再試行します。既定では、ユーティリティテンプレートとマーケティングテンプレートは 30 日間、認証テンプレートは 10 分間です。事業者は message_send_ttl_seconds でテンプレートごとに短くできます。ユーティリティは 30 秒から 12 時間まで、認証は 30 秒から 15 分までです。TTL 内に配信できなかったメッセージは破棄されます。したがって、sent のまま delivered にならないメッセージは、数時間経っても通常は失われておらず、お客様の端末で待機中です。コードや時間に敏感なアラートには短い TTL を設定し、遅れた配信で混乱が生じないようにしてください。

AI の返信や自動化には、どう影響しますか?

まず実行履歴を、次にステータスを確認してください。Runs タブで「Skipped」と表示された実行は何も送信されておらず、理由が示されます。例えば「お客様からの最後のメッセージから 24 時間以上経過しています」「このチャットには最近あなたが携帯電話から返信しました」「このチャットの AI 返信の上限に、この 1 時間で達しました」です。「Done」の実行は、Meta がすべての返信を受け付けたことを示しますが、配信されたことの証明ではありません。easyCoexistence はメッセージのステータスを保存しません。自動化を有効にしている場合、転送先 URL を設定していればそこに届きます。ダイレクトモードでは、ステータスは直接お客様自身のエンドポイントに送られます。ChatGPT または Claude から、AI に get_number_health を実行するよう依頼してください。ライブのステータス、品質評価、直近 15 件の監視イベントが返され、その中には Meta のコードを含む sending ブロックも含まれます。

設定方法

  1. Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
  2. Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
  3. Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
  4. Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
  5. Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.

よくある間違い

  • 131050 で再試行すること。相手はこちらからのマーケティングメッセージを停止しています。試行を増やしても届くことはなく、ネガティブなシグナルを増やすだけです。
  • message id を配信済みと読むこと。Meta はまず受け付け、失敗は後から報告します。そのため、id の時点で止まるワークフローは、拒否されたすべてのメッセージを見逃します。
  • 1 日後にフリーテキストで返信すること。お客様からのメッセージがない状態で 24 時間が経過すると、テンプレートしか受け付けられません。
  • Webhook の送信先なしで運用すること。失敗ステータスは Webhook でしか届かないため、設定がなければ、メッセージが届かなかった理由は失われます。
EasyCoexistence で実現する

また、Meta のステータス Webhook を変更せずにお客様のシステムへ転送します。ChatGPT または Claude からは get_number_health で番号を確認できます。接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。

よくある質問

メッセージのチェックが 1 つのまま何時間も表示されるのはなぜですか?

チェック 1 つは sent のステータスです。Meta は送信しましたが、端末がまだ受信していません。通常は電源が切れているか、オフラインだからです。WhatsApp は、テンプレートの生存時間が切れるまで再試行を続けます。既定では、ユーティリティとマーケティングは 30 日間です。

返信は届くのに、テンプレートが届かないのはなぜですか?

通常は、WhatsApp Business Account の支払い方法の問題です。Meta は、支払い方法がなくても番号の月間無料枠内のサービスメッセージは配信しますが、テンプレートは配信しません。「Billing & payments」でカードを追加してください。

WhatsApp Business アプリで、失敗したメッセージを確認できますか?

確実にはできません。Coexistence の番号では、API で送信したメッセージはアプリのチャットに表示されますが、メッセージが失敗した理由は、ステータス Webhook のエラーコードでしか分かりません。

配信されなかったメッセージも、Meta に料金を請求されますか?

いいえ。Meta は配信されたメッセージにのみ料金を請求します。一時停止中のテンプレートによる送信も、課金されません。

続きを読む

WhatsApp メッセージが届かなかった理由:failed ステータスとエラーの読み方failed ステータスは、Meta が WhatsApp メッセージを送信も配信もできなかったことを示します。主なエラーコードと対処法を解説します。WhatsApp Webhook のステータス:sent、delivered、read、failed送信したメッセージの結果を WhatsApp がどう報告するか:statuses 配列、各ステータス値、全フィールド、wamid による照合。WhatsApp Business アカウントに支払い方法を追加してください。追加しないと、サービスメッセージが停止します支払い方法がないと Meta はメッセージテンプレートを配信せず、月 1,000 件の無料枠を超えたサービスメッセージも停止します。追加と確認の方法。WhatsApp テンプレートが一時停止または無効化されたときの対処法品質の低い WhatsApp テンプレートは 3 時間、次に 6 時間一時停止され、その後は無効になります。対処法を解説します。WhatsApp Business 番号が制限または停止されたとき: 審査をリクエストする方法Meta が WhatsApp の制限・停止を表示したら、審査のリクエスト手順と申請前の修正点、所要時間を解説します。WhatsApp Cloud API のエラーコードWhatsApp Cloud API の全エラーコードを一覧化。意味と再試行の可否を確認できます。

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

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

無料トライアルを始める

確認日