Facebook ページ API の接続が止まる理由と、接続を維持する方法
Meta がトークンを受け付けなくなる、またはイベントを送らなくなると、Facebook ページの接続は止まります。原因は、短期間のサインインで得たトークン、パスワード変更(エラー 190、サブコード 460)、ページでの役割の喪失(492)、Business Integrations でのアプリ削除(458)、90 日間使われなかった権限、非アクティブなアプリ、または Meta によるページの制限です。
easyCoexistence は、各ページのトークンを長期のサインインから取得し、6 時間ごとにページを確認し、Meta がトークンを拒否したらメールでお知らせします。
Meta の既定のユーザートークンとページトークンの有効期間。長期のユーザートークンから得たページトークンには有効期限がありません。
この期間ログイン、API 呼び出し、Webhook がないと、Meta はアプリを非アクティブとみなし、そのすべてのトークンを無効にします。
pages_manage_posts や read_insights などのページ権限は、90 日間のデータアクセス期間では失効しません。
Page Integrity による制限。Messenger Platform API からページがメッセージを送ることをブロックします。
easyCoexistence が接続済みの各ページを軽量な Graph 呼び出しで確認する頻度。Meta がトークンを拒否した場合は、オーナーにメールを送ります。
ページ接続が止まる原因は何ですか?
原因は 4 つのレベルにあります。サインインする人、アプリの権限と状態、ページ自体、そして Webhook の購読です。それぞれ現れ方は異なりますが、多くはエラー 190 として返され、そのサブコードが原因を示します:
ページトークンが数時間で失効するのはなぜですか?
/me/accounts から短期間のユーザートークンで読み取ったため、そのトークンも短期間です。Meta の既定のユーザートークンとページトークンは数時間で失効し、短期トークンでは約 1 〜 2 時間です。サーバーで fb_exchange_token により交換すると、ユーザートークンは約 60 日間有効になり、それで読み取ったページトークンには有効期限がありません。Meta は失効済みのトークンを延長しません。エラーは Session has expired(サブコード 463)と返り、本人が再度サインインする必要があります。
パスワード変更やセキュリティチェックの後はどうなりますか?
Meta は本人のトークンを無効にします。ログアウトやパスワード変更は、エラー 190、サブコード 460(The session is invalid because the user logged out)を返します。また、セキュリティイベントによって、想定された有効期限より前にトークンが無効になる場合があると、Meta は警告しています。サブコード 459 と 464 は、アカウント自体に対応が必要であることを示します。その場合は、本人が facebook.com にログインして問題を解決し、その後アプリに再度サインインする必要があります。それ以外の場合の対処は新たなサインインで、本人、またはページの役割を持つ別の人が行えます。
本人がページの役割を失うとどうなりますか?
そのページトークンは、エラー 190、サブコード 492 で機能しなくなります。Meta はこれを、ページアクセストークンに関連付けられたユーザーがページで適切な役割を持たなくなったことと説明しています。トークンはページ、本人、アプリごとに発行されるため、役割を持つ他の人のトークンは引き続き機能します。対処は、まだ完全な管理権限またはタスクアクセス権を持つアカウントから、ページを再接続することです。できれば、その事業を離れる予定のない人が行うことをおすすめします。
Business integrations でアプリが削除されるとどうなりますか?
Meta は、アプリがその人について保持していたユーザーアクセストークンを無効にします。それを使って読み取ったページトークンも機能しなくなり、エラー 190、サブコード 458(the user has not authorized the application)が返ります。人は Facebook の設定の Business integrations からアプリを削除し、Meta はアプリの deauthorize コールバックを呼び出します。システムユーザーのトークンも、Business Manager の Business Settings、Integrations、Connected apps から同じように終了されます。アプリは DELETE /{user-id}/permissions によって、自身のアクセスを終了できます。
ページ権限は 90 日で失効しますか?
90 日の規則は 2 種類あり、そのうち 1 つだけがページ権限に関係します。データアクセスの有効期限は、本人が最後に活動してから 90 日後にアプリを遮断するもので、pages_show_list、pages_manage_posts、pages_messaging、read_insights など、Meta が失効しないと明示しているページ権限には適用されません。一方、権限の有効期限は別物です。アプリが 90 日間使わなかった権限は、App Review で承認されたものであっても失効することがあり、本人が再度許可しなければなりません。それを必要とする呼び出しは、新しいサインインで権限が付与されるまで、コード 10 または 200 番台のいずれかで失敗します。
アプリ全体がアクセスを失うことはありますか?
はい。文書化された 3 つの場合があり、Meta は App Dashboard のアラート受信トレイに緊急通知を送って警告します。90 日間ログイン、Graph API または Marketing API の呼び出し、Webhook 通知がないアプリは非アクティブとみなされ、Meta はそのすべてのトークンを無効にします。App Dashboard から復元すると最新バージョンにアップグレードされますが、古いトークンは無効のままで、不使用によって失効した権限は App Review を通し直す必要があります。年次の Data Use Checkup を完了する必要があり、Meta の規約やポリシーに違反すると、API アクセスが制限されたり権限が取り消されたりすることがあります。
Meta がページを制限するとどうなりますか?
制限された操作は失敗します。エラー 368(ポリシー違反のため一時的にブロック)、またはメッセージの場合はエラーコード 10、サブコード 1893063 が返ります。どの制限かは、Meta の Page Integrity API が示します。pages_manage_metadata 権限を使って GET /{page-id}/page_status を呼ぶと、status(ok、warning、restricted、suspended のいずれか)、有効な各制限(page_publish、page_read_only、page_messaging、page_messaging_api など)とその expiration_time、そして FILE_APPEAL などの推奨アクションが返ります。business_integrity Webhook フィールドは、変更が発生するたびにそれを報告します。
API 呼び出しは動くのに、イベントが止まるのはなぜですか?
Webhook は独自の条件で失敗するためです。配信に 1 時間失敗すると、Meta は Webhooks Disabled アラートを送り、再度購読するまでアプリをそのページから購読解除します。また、App Settings で App platform をオフにしているページには、何も送りません。トークンはどちらの場合も有効なままになることがあります。そのため、障害の後は GET /{page-id}/subscribed_apps を確認し、エンドポイントが再び応答したら、そのエンドポイントにページのトークンで POST します。
投稿が失敗する前に、切れた接続をどう検知しますか?
定期的に確認することで検知します。Meta はトークンが無効になってもアプリに通知しないためです。ページのトークンを使い GET /{page-id}?fields=id,name のような軽い呼び出しは、投稿と同じように失敗します。アプリの ID とシークレットをアクセストークンとして渡して呼び出す debug_token は、is_valid、expires_at、付与されたスコープを返します。機能しなくなったトークンについては、エラーコードとサブコードも返します。page_status は制限を報告し、deauthorize コールバックは削除されたアプリを知らせます。
curl -G "https://graph.facebook.com/v26.0/debug_token" \
--data-urlencode "input_token=$PAGE_TOKEN" \
--data-urlencode "access_token=$APP_ID|$APP_SECRET"
# data.is_valid, data.expires_at, data.scopes, data.granular_scopes,
# and data.error.code with data.error.subcode once the token stops workingページを再接続するにはどうしますか?
接続したときと同じフローで、まだページの役割を持つ人が行います。原因がある場合は、先にそれを解消してください。チェックポイントがかかったアカウントは facebook.com にログインし、制限には推奨アクションを実行し、失敗していたエンドポイントは再び 200 を返すようにします。新しいサインインでは新しいトークン文字列が返るため、保存されている古いトークンは両方保持せず、置き換えてください:
ページ接続が切れたとき、easyCoexistence は何をしますか?
見える範囲の切断を監視し、それをお知らせします。6 時間ごとに、接続されたすべてのページを GET /{page-id}?fields=id,name で確認します。Meta がエラー 190 または 102 でトークンを拒否すると(その確認時でも、ツール呼び出し中でも)、そのページは「Reconnect needed」とマークされ、オーナーに 1 通のメールが届き、パートナープラットフォームは channel.disconnected を受け取ります。権限の欠落やポリシーによるブロックといった他の拒否は、Meta のコードとメッセージとともに、ツールの結果として返されます。
本人が Business integrations でアプリを削除すると、Meta の deauthorize コールバックが easyCoexistence に届きます。すると、その人が接続したページが削除され、トークンとイベントの送信先が消去され、課金から外され、channel.removed が送られます。ダッシュボードから再度サインインすると、同じ接続としてコメントルールと自動化とともにページが戻り、feed、messages、mention が再び購読されます。「Reconnect needed」の状態になった後も、イベントの送信先は残ります。削除後は、set_social_webhook_destination で新しいシークレットを付けて再設定します。
よくある間違い
- エラー 190 を再試行すること。拒否されたトークンは、呼び出しのたびに同じように失敗します。有効なトークンを得られるのは、ページの役割を持つ人による新しいサインインだけです。
- 制限を解除するために再接続すること。新しいトークンではページのステータスは変わりません。page_status の推奨アクション(異議申し立てなど)こそが状態を変えます。
- 製品があまり使わない権限を要求すること。90 日間使われないと失効することがあり、それを必要とする呼び出しは失敗します。機能をリリースするときに要求してください。
- 再接続後も古いトークンを保持すること。新しいサインインでは別のトークン文字列が返され、古いトークンを持ったままのジョブは 190 で失敗し続けます。
1 回の Facebook サインインで、コメントルールと自動化を保ったまま、同じ接続としてページが戻ります。接続ごとに月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
60 日のユーザートークンが期限切れになると、ページトークンも止まりますか?
/me/accounts からその長期のユーザートークンで読み取ったものであれば止まりません。そのページトークンには有効期限がありませんが、このページで挙げた原因によっては依然として止まることがあります。
ページトークンが機能しなくなったら、Meta が知らせてくれますか?
無効になったトークンについては知らせてくれません。次の呼び出しがエラーを返します。本人がアプリを削除したときには Meta が deauthorize コールバックを呼び出し、アプリ全体のリスクについては App Dashboard のアラート受信トレイで警告します。
別の人のトークンで、ページの接続を維持できますか?
はい。ページトークンはページ、本人、アプリごとに発行されるため、ページの役割を持つ別の人のトークンは、ある人のアクセスが終わっても機能し続けます。
Facebook ページの easyCoexistence の料金はいくらですか?
接続ごとに月額 US$ 9 から、接続数によって決まり、接続を増やすほど下がって US$ 0.75 まで。各ページは 1 接続として数え、最初の 3 日間は無料です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日