Meta Tech Provider

番号が使えなくなった場合の原因の調べ方

接続済みの番号が使えなくなったとき、原因がコードであることはほとんどありません。発生頻度の高い順に、期限切れのトークン、再接続で失われた Webhook オーバーライド、14 日間の非アクティブによる切断、品質低下、アカウント制限を確認してください。

ほぼすべての無反応な障害を占める原因です。

期限切れのトークンが返すエラーで、番号が見つからないように見えます。

切断を正式に通知するイベントです。

電話ではなぜ何も問題がないように見えるのですか？

WhatsApp Business アプリと API は、同じ番号上にある別々の画面だからです。ほとんどの障害は、その一方だけに影響します。

トークンの有効期限が切れても、アプリには影響しません。Webhook オーバーライドが削除されても、アプリには影響しません。品質が低下しても、アプリには影響しません。どの場合も、企業は顧客への対応を続け、通常どおり動作していると考えるため、報告する理由がありません。

これが、誰かがダッシュボードを確認する運用ではなく、監視が必要な理由です。障害は実際に起きていますが、静かに進行し、番号に最も近い人ほど気づきにくいのです。

まずトークンを確認してください。最も多い原因で、最も安く修正できるためです。期限切れまたは無効化された認証情報は、すべてのリクエストで同じように失敗し、番号が削除された場合とまったく同じに見えます。同じアカウントに対して 2 つ目の認証情報を保持すると、両者を見分けられます。

次に Webhook オーバーライドを確認してください。再接続が起きると、送信先はアプリと一緒に削除されます。そのため、送信と監視は動作していても、サーバーへの配信だけが静かに停止します。

次に切断を確認してください。アカウントの account_update イベントに PARTNER_REMOVED と理由が含まれます。PRIMARY_INACTIVITY は、アプリが約 14 日間開かれなかったことを意味し、再接続で解決します。

その次が品質です。品質はプッシュ通知ではなくポーリングで確認します。最後が制限です。これはアカウントレベルの措置であり、どのプロバイダーも解除できません。

昨日まで動作していて、何もデプロイしていないなら、コードです。

Cloud API は安定しており、リクエストの形式が知らないうちに変わることもありません。数か月動いていた連携が停止した場合、可能性が高いのは認証情報、ルーティングの変更、またはアカウントレベルのイベントです。いずれも、誰もリポジトリに触れずに起こります。

例外として挙げるべきなのは、テンプレートが編集された場合です。テンプレート内の変数の数を変更すると、すべての送信者に対する仕様が静かに変わります。WhatsApp Manager で別の人が行った内容の変更ですが、コードの障害のように見えます。

EasyCoexistence で実現する

EasyCoexistence は 5 つすべてを継続的に確認し、接続のタイムラインに記録します。そのため、推測ではなく日時付きのイベントからトラブルシューティングを始められます。

電話では番号が使えるのに、何も送信できません。どこから確認すればよいですか？

アクセストークンです。最も多い原因で、削除された番号に最も似た状態になります。

再接続したのに、メッセージがサーバーに届きません。

Webhook オーバーライドがアプリと一緒に削除されています。再適用が必要ですが、EasyCoexistence が自動で行います。

14 日間のルールが原因だったかどうかは、どうすれば分かりますか？

account_update イベントに、理由 PRIMARY_INACTIVITY とともに切断が届きます。

テンプレートの編集で送信が壊れることはありますか？

はい。コードの障害に似て見える唯一の原因です。変数の数を変更すると、すべての送信者に対する仕様が変わります。

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

確認日 2026-09-22