Facebook ページのアクセストークン: 有効期間と無効になる条件
長期間有効な Facebook ページのアクセストークンには有効期限がありません。アプリは、ユーザーがサインインした後、約 60 日間有効な長期ユーザートークンと引き換えに /me/accounts からこのトークンを取得します。取得するには、そのユーザーがページを完全に管理しているか、必要なタスクへのアクセス権を持っている必要があります。ただし Meta は、たとえばそのユーザーがページでの役割を失うなど、一定の条件下ではトークンを無効にします。
easyCoexistence は、接続する各ページについて長期ページトークンを取得し、暗号化して保管します。
長期間有効なページアクセストークンは、長期ユーザートークンから生成され、有効期限がありません。
長期ユーザーアクセストークンの一般的な有効期間。短期トークンは約 1〜2 時間有効です。
そのユーザーがページで適切な役割を持たなくなった場合のページトークンのエラーサブコード。
アプリが権限を一定期間使用しなかった場合、ユーザーはその権限を再度付与する必要があります。
Meta の API で割り当てられるページタスクの一つ。CREATE_CONTENT、MODERATE、MESSAGING、ANALYZE と並ぶものです。
Facebook ページのアクセストークンは期限切れになりますか?
それは、トークンの元になったユーザートークンによります。Meta のデフォルトのユーザートークンとページトークンは短期トークンで、数時間以内に期限切れになります。長期ユーザートークンの有効期間は一般に約 60 日です。長期ユーザートークンから生成されたページトークンには有効期限がありません。Meta によると、一定の条件下でのみ期限切れになるか無効になります。また Meta は、トークンの有効期間は予告なく変更される可能性があるため、それに依存しないよう注意しています。
長期ページアクセストークンはどのように取得しますか?
ユーザーが Facebook Login for Business でサインインした後、3 回の呼び出しで取得します。アプリは返されたコードを短期ユーザートークンと交換し、その後 GET /oauth/access_token に grant_type=fb_exchange_token とアプリシークレットを指定して、長期トークンと交換します。Meta は、この呼び出しはサーバーから行うよう求めています。長期ユーザートークンを使って GET /me/accounts を呼び出すと、ユーザーが許可した各ページについて、ページ ID、そのユーザーのタスク、ページトークンが返されます。
誰がページを接続し、トークンを取得できますか?
ページを所有している、またはページ上でタスクを実行できるユーザーです。Facebook のページ設定と Meta Business Suite では、完全な管理権限、またはコンテンツやメッセージなどの限定されたタスクへのアクセス権を指します。Meta の Pages API の概要では、管理者アクセス権を持つユーザーはすべてのタスクを実行できるとされています。ページトークンはページ、ユーザー、アプリごとに固有のため、同じページを 2 人が接続すると、それぞれ異なるトークンを保持します。Facebook の画面上の名称は、次のように API のタスクに対応します。
各操作にはどのタスクが必要ですか?
Meta は呼び出しごとに、トークンの背後にいるユーザーがその操作を許可するタスクを持っているかを確認します。そのため、作業に必要なアクセス権を持つアカウントから接続してください。
- テキスト、リンク、写真の投稿:
CREATE_CONTENT。 - 動画の投稿:Meta の Video API の概要によると、管理者相当のタスク。
- ページとして行うコメント ID と返信:MODERATE。
- Messenger の返信とプライベート返信:MESSAGING。
- インサイト:ANALYZE。
- フィードの Webhook:
CREATE_CONTENT、MANAGE、または MODERATE。messages フィールド:MESSAGING。
どのような場合にページアクセストークンは無効になりますか?
Meta は、受け付けなくなったトークンにはエラーコード 190 を返し、セッションの場合は 102 を返します。また、その理由を示す認証サブコードも返します。ユーザーは、Facebook の設定の「ビジネス インテグレーション」からアプリを削除することで、そのアプリのユーザートークンを無効にできます。また、アプリが 90 日間使用していない権限は、再度付与する必要があります。Meta が挙げているサブコードは次のとおりです:
- 458:そのユーザーがアプリにログインしていない。
- 459 または 464:アカウントの問題を解決するために、facebook.com でログインする必要がある。
- 460:そのユーザーのパスワードが変更された。
- 463 または 467:トークンが期限切れになったか、取り消されたか、その他の理由で無効です。
- 492:ページトークンの背後にいるユーザーが、ページで適切な役割を持たなくなった。
easyCoexistence はページの接続をどのように維持しますか?
サインイン時に、各ページのトークンを長期ユーザートークンから取得し、暗号化して保存します。そのため、定期的に更新する必要のある有効期限はありません。6 時間ごとに、軽量な Graph の呼び出しで接続済みの各ページを確認します。Meta がエラー 190 または 102 でトークンを拒否した場合(その確認時でも、どのツールの呼び出し中でも)、そのページは再接続が必要としてマークされ、所有者にメールが送られ、パートナープラットフォームが channel.disconnected を受け取ります。そのページを運営しているアカウントから再度サインインすると、接続が復元されます。
ページトークンを自分で使用できますか?
トークン自体は取得できません。get_social_credentials は、ページ ID と、graph.facebook.com の Graph API のベース URL を返します。ただしページトークンは返しません(Meta の規約による)。ページが接続されている限り、トークンは期限切れになりません。ただし Meta はいつでも無効化する可能性があります。MCP ツールは、トークンを公開せずに、ページとして呼び出しを行います。トークンと Webhook サブスクリプションは easyCoexistence が管理します。
よくある間違い
- 長期トークンをブラウザから要求すること。この交換にはアプリシークレットが含まれるため、Meta はこの呼び出しを必ずサーバーから行い、クライアント側では行わないよう求めています。
- 期限切れのトークンを延長しようとすること。Meta は期限切れのトークンを長期トークンに変換しません。ユーザーが再度ログインする必要があります。
- まもなく企業を離れる人を通じて接続すること。ページトークンはその人のアクセス権に基づいており、役割を失うと動作しなくなります。そのため、今後も在籍するアカウントから接続してください。
- トークンを固定長の列に保存すること。Meta は時間とともにトークンの長さを変更しており、上限を設けない可変長の型を使うよう勧めています。
6 時間ごとにページを確認し、Meta が受け付けなくなった場合はメールでお知らせします。お使いの AI は、トークンを自動で付加する MCP ツールを通じてこのトークンを扱え、get_social_credentials は自分のコードにページ ID と API のベースを渡します。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
アプリが使用しなくなった Facebook の権限は期限切れになりますか?
はい。アプリが 90 日間その権限を使用しないと、ユーザーは権限を再度付与する必要があります。
期限切れの Facebook トークンを長期トークンにできますか?
いいえ。Meta は期限切れのトークンを長期トークンに変換しません。そのため、新しい長期ページトークンを読み取る前に、ユーザーが再度ログインする必要があります。
Facebook ページのエラー 190 とは何を意味しますか?
Meta がそのトークンを受け付けなくなったことを意味します。サブコードがその理由を示します。たとえば、パスワード変更後は 460、ユーザーがページでの役割を失った場合は 492 です。
easyCoexistence は Facebook ページトークンを更新しますか?
いいえ。定期的に更新するものがないためです。保持している Page トークンには有効期限がありません。代わりに 6 時間ごとに各ページを確認し、再接続が必要な場合はメールでお知らせします。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日