WhatsApp API のメッセージが届かない:原因を順番に確認
WhatsApp API で受け付けられたメッセージは、届いたメッセージとは限りません。Meta は結果を後から、ステータス Webhook で報告します。報告は sent(送信済み)、delivered(配信済み)、read(既読)、failed(失敗)のいずれかで、失敗の場合はエラーコードが付きます。次の順に確認してください:失敗ステータスとそのコード、24 時間ウィンドウ(131047)、支払い方法(131042)、テンプレート(132001、132015)、受信者(131026、131049、131050)、最後に番号の上限と接続です。
easyCoexistence は、接続されたすべての番号を 24 時間体制で監視し、Meta が配信を停止したり、接続が切れたり、品質が下がったりすると、メールでお知らせします。
sent(チェック 1 つ)、delivered(チェック 2 つ)、read(青いチェック 2 つ)、failed(赤いエラーの三角形)。これらはステータス Webhook が報告する値です。
受信者が最後に返信してから 24 時間以上経っています。Meta は代わりにテンプレートを送るよう求めています。
配信できない場合:その番号が WhatsApp を利用していない、受信者が新しい利用規約に同意していない、または古い WhatsApp のバージョンを使っている。
配信されなかったユーティリティテンプレートやマーケティングテンプレートを、WhatsApp が破棄するまで再試行する既定の時間です。認証テンプレートの既定値は 10 分です。
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 ブロックも含まれます。
設定方法
- 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.
- Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
- Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
- Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
- 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 でしか届かないため、設定がなければ、メッセージが届かなかった理由は失われます。
また、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 Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日