Facebook Page を Webhook に登録する: subscribed_apps エッジ
Facebook Page は、POST /{page-id}/subscribed_apps によってアプリの Webhook に登録されます。このリクエストでは、feed,messages などの subscribed_fields と、CREATE_CONTENT、MANAGE、MODERATE のいずれかのタスクを持つ人物の Page アクセストークンを渡します。pages_manage_metadata と pages_show_list の権限も付与されている必要があります。Meta は、アプリもそのフィールドに登録している場合にのみ、そのフィールドのイベントを送信します。GET で登録状況を確認でき、DELETE で登録を解除できます。
easyCoexistence は、接続する各 Page を subscribed_apps 経由で feed、messages、mention に登録し、削除時には登録を解除します。
Page とアプリの両方で登録されたフィールドのみが Webhook を生成します。Page の一覧にはアプリより多くのフィールドを含められます。
Page のタスク。トークンの持ち主は、そのうち 1 つを持つことで、サブスクリプションを読み取りまたは作成できます。
アプリが DELETE で Page の Webhook サブスクリプションを削除した場合、success と並んで返されます。
アプリレベルのサブスクリプションを読み取り、作成、削除するには、/{app-id}/subscriptions で何が必要か。
Meta がアプリを Page から登録解除するまでの、Messenger 配信の失敗が続く時間。再登録するまで解除されたままです。
subscribed_apps エッジは何をしますか?
このエッジは、アプリを Page にインストールし、アプリが受け取る Page の Webhook フィールドを設定します。Meta は、Page にアプリがインストールされ、設定でアプリプラットフォームが無効になっていない場合にのみ通知を送信します。さらに、通知は Page 側(このエッジで設定)とアプリ側(App Dashboard または /{app-id}/subscriptions で設定)の両方で登録されたフィールドに限られます。Page はアプリより多くのフィールドに登録できます。
Page を登録するにはどうすればよいですか?
エッジに対して、カンマで区切った subscribed_fields と Page のアクセストークンを付けて POST を送信します。成功すると success true が返されます。messages を含む呼び出しでは、トークンに pages_messaging も必要です。
POST https://graph.facebook.com/{page-id}/subscribed_apps
?subscribed_fields=feed,messages,mention
&access_token=<PAGE_ACCESS_TOKEN>
{ "success": true }必要なトークン、タスク、権限は何ですか?
1 つの Page に呼び出しを紐づける Page アクセストークンで、その Page を操作できる人物から取得したものです。Meta のリファレンスとガイドでは、次の要件が定められています。
- 任意のフィールド:
CREATE_CONTENT、MANAGE、MODERATE のいずれかのタスクを持つ人物、かつpages_manage_metadataとpages_show_list。 - messages とその他の Messenger フィールド:
pages_messagingも必要で、MESSAGING タスクを実行できる人物のトークンであること。 - leadgen: ADVERTISE タスク、
leads_retrieval、pages_read_engagement、ads_managementが必要です。 - GET でサブスクリプションを読み取る場合も、作成時と同じタスクと権限が必要です。
フィールドにはどのアクセスレベルが必要ですか?
Page や、アプリ自身の役割の外にいる人物を対象とする場合は Advanced Access が必要です。Standard Access では、Messenger の通知は、アプリの管理者、開発者、テスターなど、アプリに役割を持つ人物からのものに限られます。Advanced Access は権限ごとに App Review を通じて付与され、Business Verification が必要です。これにより、アプリの顧客にも通知が届くようになります。Meta の Messenger ガイドでは、アプリの公開も前提条件として挙げられています。
アプリレベルのサブスクリプションとは何ですか?
もう一方の側面であり、アプリ自身が受信するフィールドを、コールバック URL とともに設定するものです。App Dashboard で設定するか、アプリアクセストークンを使って POST /{app-id}/subscriptions を送信して設定します。その際、object=page、callback_url、fields、include_values、verify_token を渡します。これにより Meta の検証リクエストが送信されます。同じエッジに対して GET を送信すると、各オブジェクトの callback_url、fields、サブスクリプションが有効かどうかが表示されます。新たに POST を送信すると、他のフィールドを上書きせずにフィールドを変更できます。DELETE では、すべてのフィールドまたは指定したフィールドを削除します。
Page がどのアプリに登録されているか確認するには?
同じエッジに対して、Page のトークンを使って GET を送信します。data 配列には、Page にインストールされている各アプリの名前、ID、subscribed_fields が一覧表示されます。Page にアプリがインストールされていない場合は、空の配列が返されます。
GET https://graph.facebook.com/{page-id}/subscribed_apps
?access_token=<PAGE_ACCESS_TOKEN>
{
"data": [
{
"category": "Business",
"link": "https://example.com/app",
"name": "<APP_NAME>",
"id": "<APP_ID>",
"subscribed_fields": ["feed", "messages", "mention"]
}
]
}サブスクリプションを解除するには?
DELETE /{page-id}/subscribed_apps を送信すると、アプリと Page の関連付けが解除されます。アプリは、アプリアクセストークンを使って自身のサブスクリプションを削除することもできます。レスポンスには success と messaging_success が含まれます。Meta も自動的に解除することがあります。Messenger の配信が 1 時間失敗し続けると、アプリは Page から登録解除されます。エンドポイントが再び機能するようになったら、アプリは再度登録する必要があります。
easyCoexistence は接続時に何をしますか?
ユーザーが選択した Page ごとに、その Page のトークンを保存した直後に登録を行います。具体的には、subscribed_fields を feed,messages,mention に設定して POST /{page-id}/subscribed_apps を送信します。Meta が拒否した場合でも Page は接続されたままになり、list_social_accounts の last_error に理由が表示されます。Page を削除すると、トークンが破棄される前に DELETE /{page-id}/subscribed_apps が送信されます。また、subscribed_apps やトークンのパスに届くツールはないため、サブスクリプションは easyCoexistence だけが管理します。
よくある間違い
- ユーザーアクセストークンでエッジを呼び出すこと。登録する Page の Page アクセストークンが必要です。
- Page は登録したがアプリは登録していないこと。フィールドは、アプリ自身のサブスクリプションにも含まれている場合にのみ、コールバックに届きます。
- messages を登録する際に pages_messaging を省略すること。Meta はこれを必須としており、MESSAGING タスクを実行できる人物のトークンが必要です。
- 障害後に再登録し忘れること。1 時間分の Messenger 配信が失敗すると、アプリは登録解除され、POST を再送するまでイベントは届かなくなります。
また、その Page 用のシークレットで署名された HTTPS エンドポイントへ、Page のイベントを転送します。転送は MCP コネクタ 1 つ、または Partner API から行えます。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 までです。最初の 3 日間は無料トライアルです。
よくある質問
Page ごとに個別に登録する必要がありますか?
はい。subscribed_apps は Page ごとに、その Page 自身のトークンを使って動作します。一方、page オブジェクトのアプリレベルのサブスクリプションは、アプリをインストールした Page に適用されます。
subscribed_apps がエラー 200 を返すのはなぜですか?
Meta は、このエッジに対する 200 を権限エラーとして扱います。トークンに pages_manage_metadata と pages_show_list が含まれ、CREATE_CONTENT、MANAGE、MODERATE のいずれかのタスクを持つ人物から取得されたものかを確認してください。
Graph API Explorer から Page を登録できますか?
はい。Meta のガイドでは、アプリを選択し、pages_manage_metadata 付きのユーザートークンを取得して、それを Page のトークンに交換し、{page-id}/subscribed_apps に POST を送信する手順が示されています。
easyCoexistence に接続した Page に Webhook フィールドを追加できますか?
ツール経由では追加できません。subscribed_apps のパスに届くツールはなく、Page は feed、messages、mention に登録されたままです。これらは easyCoexistence が転送するフィールドです。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日