Facebook Page webhookフィールド:全一覧
Meta の Page Webhook リファレンスには、64 の購読フィールドが記載されています。投稿、コメント、リアクションを扱う feed、Page へのメンションを扱う mention、message、message_echoes、messaging_postbacks、message_reads などの Messenger フィールド、そして name、picture、hours、website などのプロフィールフィールドです。各フィールドには pages_manage_metadata が必要で、アプリは、アプリレベルと Page の両方で subscribed_apps を通じて購読された時点で、そのフィールドを受け取ります。
easyCoexistence は、接続した各 Page を feed、messages、mention に購読させ、イベントが発生するたびに X-EC-Signature で署名して HTTPS エンドポイントへ転送します。
購読フィールドは Meta の Page Webhook リファレンスに記載されており、feed や mention から Messenger、プロフィールフィールドまで含まれます。
Page Webhook がアプリに届く前に、MODERATE 権限を持つ Page 管理者が付与する必要がある権限です。
Page が送信したメッセージ用の個別の Messenger フィールドで、Messenger の会話でのみ利用できます。
leadgen を購読するために必要な Page タスクで、leads_retrieval、ads_management、pages_read_engagement、pages_manage_metadata を含みます。
Webhook が発生するのは、Page とアプリの両方のレベルで購読されたフィールドのみです。
Page Webhook フィールドはどのように分類されていますか?
Meta は Page オブジェクトのリファレンスページに、すべてのフィールドをまとめて記載しています。フィールドは、Page 上およびその周辺での活動、Messenger の会話、Page 自体の詳細の編集という 3 つのグループに分かれます。feed、mention、プロフィール変更は entry.changes に、各フィールド名を付けて届きます。アプリが Include Values をオフにしている場合は changed_fields として届きます。Messenger のイベントは entry.messaging に届き、スレッドを所有していないアプリの場合は entry.standby に届きます。
Page の活動を報告するフィールドはどれですか?
会話ではなく、コンテンツと活動を扱うフィールドは 12 あります。たとえば新しいコメントは、item が comment、verb が add に設定された変更として feed に届きます。リアクション、シェア、Page 自身の投稿も同様です。各フィールドが何を配信するかは、Meta のリファレンスに記載されています:
Messenger のイベントを届けるフィールドはどれですか?
Messenger のフィールドは最も数が多く、Meta の Messenger Webhook ガイドに、各フィールドが何を送信するかが記載されています。Page の会話を扱うフィールドは 13 あります。スレッドを所有していないアプリにメッセージを届ける standby は、Page リファレンスではなく、そのガイドに記載されています:
ほかの Messenger フィールドにはどのようなものがありますか?
特定の製品向けに、さらに 10 のフィールドがあります。通話からコマース、インテグリティ報告までを扱います:
send_cart:カート情報または注文情報を含むメッセージ。message_context:Meta のモデルがメッセージに対して行った判定で、イベント名とスコアを含みます。- calls、
call_settings_update、call_permission_reply:Messenger の音声通話、Page の通話設定の変更、通話の許可リクエストに対するユーザーの回答。 messaging_customer_information:顧客情報画面にユーザーが入力した内容。messaging_in_thread_lead_form_submit:会話内で送信されたリードフォーム。message_template_status_update:ユーティリティメッセージテンプレートの審査ステータスが変更されたこと。business_integrityとmessaging_integrity:インテグリティの更新。business_integrityには違反、制限、対処のイベントが含まれます。
Page のプロフィール変更を報告するフィールドはどれですか?
Page 自身の詳細の編集を報告するフィールドは 29 あります。詳細ごとに 1 フィールドで、それぞれがその項目名を含む変更として届きます:
- Identity:name、picture、category(最大 3 つまで)、description(Story Description)。
- 企業の詳細:
company_overview、mission、founded、products、general_info、general_manager、members、awards、affiliation。 - 連絡先と所在地:email、phone、website、location、hours、
current_location、hometown、parking、public_transit。 - 店舗情報:
price_range、payment_options、attire、culinary_team。 - 個人情報:birthday、
personal_info、personal_interests。
各フィールドにはどの権限が必要ですか?
いずれのフィールドにも pages_manage_metadata が必要で、MODERATE 権限を持つ Page 管理者が付与します。一部のフィールドではさらに権限が必要になります。Page は subscribed_apps を通じて購読されます。トークンと権限は、フィールドの種類ごとに Meta のガイドで定められています。アプリ自身のロール以外の人に関するイベントを受け取るには、権限に加えて Advanced Access も必要です:
| Permissions | Task of the person behind the token | |
|---|---|---|
| Any field | pages_manage_metadata and pages_show_list | CREATE_CONTENT, MANAGE or MODERATE |
| messages and other Messenger fields | pages_messaging as well | MESSAGING |
| leadgen | leads_retrieval, pages_read_engagement and ads_management as well | ADVERTISE |
easyCoexistence はどのフィールドを購読しますか?
3 つです:feed、messages、mention。Page を接続すると、easyCoexistence はこれらのフィールドと Page のトークンを添えて POST /{page-id}/subscribed_apps を送信します。その後、その Page の各 entry を、設定したエンドポイントへ転送します。転送時には X-EC-Signature で署名されます。コメントルールと自動化は feed の新規コメントとメッセージに対して動作し、メンションはそのまま転送されます。それ以外のフィールドは購読されないため、echo、postback、受信確認、ハンドオーバー、standby、プロフィール変更は転送されません。
よくある間違い
- アプリが購読していないフィールドを Page に購読させること。Meta が配信するのは、Page とアプリの両方のレベルで購読されたフィールドのみです。
- Messenger のイベントを changes として解析すること。これらは entry.changes ではなく entry.messaging に届き、1 つの entry には 1 つの messaging オブジェクトが含まれます。
- Page 自身の返信を messages で受け取ると想定すること。Page が送信したメッセージは message_echoes に届き、これは別のフィールドです。
- 大規模な Page の「いいね」を feed で得られると想定すること。Meta が「いいね」の通知を送るのは、いいね数が 10,000 未満の Page のみです。
コメントルールと自動化は、新規コメントとメッセージに対して動作します。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
広告投稿へのコメントは feed に含まれますか?
はい。広告投稿そのものについては Meta は何も送信しませんが、広告へのコメントは feed に届きます。
Include Values の設定は何を変えますか?
オンの場合、変更には新しい値が changes に含まれます。オフの場合、Meta は変更されたフィールド名のみを changed_fields で送信します。
Page が購読しているフィールドはどう確認しますか?
Page のトークンを使って GET /{page-id}/subscribed_apps を実行すると、Page にインストールされたアプリの一覧と、各アプリの subscribed_fields が返されます。
easyCoexistence は Page のプロフィール変更を転送しますか?
いいえ。easyCoexistence に接続された Page は feed、messages、mention のみに購読されるため、name、picture、その他のプロフィールフィールドは転送されません。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日