Facebook Page のフィード Webhook:コメント・投稿・リアクションのイベント
Facebook の Page Webhook にある feed フィールドは、Page のフィードに対するほぼすべての変更を発生時に通知します。各変更には、投稿、コメント、リアクションなどの item と、add、edit、remove などの verb が含まれ、関係する ID や、送信者の from、テキストの message も付きます。Meta は X-Hub-Signature-256 で署名した JSON として送信します。
easyCoexistence は、接続する各 Page のフィードフィールドを購読し、その変更を発生と同時に、Page ごとのシークレットで署名して HTTPS エンドポイントへ転送します。
Page のいいねの通知は、いいね数が 10,000 未満の Page に限り送られます。
feed フィールドは広告投稿そのものについては何も送りませんが、そこへのコメントは送られます。
Page の Webhook をアプリに届けるには、MODERATE 権限を持つ Page 管理者による許可が必要です。
Meta は多くの更新を 1 回の Webhook 配信にまとめますが、まとめることは保証されていません。
Meta がアプリのエンドポイントへ失敗した配信を再試行する期間です(頻度は次第に下がります)。
feed フィールドは何を通知しますか?
Meta の表現によれば、Page のフィードに対するほぼすべての変更を通知します。投稿、コメント、リアクション、シェアなどが対象で、含まれる内容は変更の種類によって異なります。広告投稿そのものは送られませんが、そこへのコメントは届きます。Page のいいねの通知は、いいね数が 10,000 未満の Page に限り送られます。
item と verb は何を意味しますか?
各変更の value にある 2 つのフィールドが、何が起きたかを示します:
- item:何が変わったかです。Meta の一覧から選ばれ、post、status、photo、video、link、share、comment、reaction、album などがあります。
- verb:それに何が起きたかです。add、edit、edited、delete、remove、hide、unhide、block、unblock、follow、mute、update のいずれかです。
- 新しいコメントは、item が comment、verb が add で届きます。コメントから DM へのルールは、この組み合わせを探します。
- リアクションは item が reaction で、それが何かを示す
reaction_typeを伴います。
フィードの変更はどのような形で届きますか?
JSON の object が page に設定された POST で、Page ごとの entry を含みます。entry には Page の ID、時刻、変更の配列があります。以下は Meta 自身の例で、ユーザーが Page に投稿した場合のものです:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1520544816,
"changes": [
{
"field": "feed",
"value": {
"from": { "id": "<USER_ID>", "name": "<NAME>" },
"item": "post",
"post_id": "<PAGE_POST_ID>",
"verb": "add",
"created_time": 1520544814,
"is_hidden": false,
"message": "<POST_TEXT>"
}
}
]
}
]
}変更にはどのフィールドが含まれますか?
Meta のリファレンスでは、フィードの変更の value に含まれうるフィールドとして次が挙げられています。変更の種類に応じて存在します:
post_id、comment_id、parent_id:投稿、コメント、そしてそのコメントが属するものです。- from:変更を行った人の ID と名前です。
- message:テキストです。添付コンテンツには link、photo、photos、video があります。
created_time。編集の場合はedited_timeです。- リアクションには
reaction_type、投稿が非表示かどうかにはis_hiddenがあります。 - post:
status_type、is_published、updated_time、permalink_urlなどの詳細です。
Page はどのように購読されますか?
CREATE_CONTENT、MANAGE、MODERATE のいずれかのタスクを実行できる人が、pages_manage_metadata と pages_show_list の権限を付与した状態で、Page のトークンを使い、subscribed_fields=feed を付けて POST /{page-id}/subscribed_apps を送ります。Meta は、Page にアプリがインストールされていて、設定でアプリプラットフォームがオフになっていない間だけ通知を送ります。easyCoexistence は接続時に、各 Page を feed、messages、mention に購読させます。
フィードのイベントはエンドポイントにどう届きますか?
Meta は easyCoexistence のアプリにイベントを配信します。アプリは X-Hub-Signature-256 を検証し、Meta にすぐ応答して、接続済みの Page の各 entry を、その Page に設定された HTTPS エンドポイントへ転送します。転送には X-EC-Signature ヘッダーが付きます。これは、タイムスタンプと生のボディの HMAC-SHA256 で、その Page のシークレットを鍵としています。転送は 1 回だけ行われ、コピーは保持されず、再試行もありません。エンドポイントは set_social_webhook_destination、または Partner API の PUT /channels/:id/webhook で設定します。
どのフィードの変更がコメントルールや自動化を開始しますか?
新しいコメントだけです。つまり、Page の投稿のいずれかに対する、item が comment で verb が add の変更です。コメントから DM へのルールは、そのメッセージをキーワードと照合し、Page 自身のコメントはスキップします。自動化は、どのルールにも返信されなかったコメントを対象とします。編集、非表示、リアクション、投稿は、エンドポイントを設定している場合、そのまま送られます。
よくある間違い
- フィードの変更をすべて新しいコメントとして扱うことです。item と verb を確認してください。リアクション、編集、非表示、削除も同じフィールドで届きます。
- Page 自身のコメントに返信することです。Page の返信もフィードの変更として届くため、from.id が Page の ID のものはスキップしてください。
- 1 回の配信に変更が 1 件だけだと想定することです。Meta は最大 1,000 件の更新をまとめられるため、各 entry とその中の各 change をループ処理してください。
- entry.time を変更が発生した時刻と読むことです。Meta はこれを通知を送信した時刻に設定します。値の中の created_time が、オブジェクトを作成した時刻です。
コメントから DM へのルールと自動化は、新しいコメントに対して動作します。接続ごとに月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料トライアルです。
よくある質問
フィードの Webhook にはコメントも含まれますか?
はい。新しいコメントは、item が comment、verb が add のフィードの変更として届き、comment_id、post_id、from、message を含みます。
Page のいいねについて Webhook は届きますか?
Meta の Page Webhook リファレンスによると、いいね数が 10,000 未満の Page に限られます。
広告投稿はフィードの Webhook に含まれますか?
広告投稿そのものは含まれませんが、それに対するコメントは送られます。
Page のフィードイベントを受け取るには、自分の Meta アプリが必要ですか?
いいえ。Meta は easyCoexistence のアプリに配信し、そのアプリが、その Page 用に設定したエンドポイントへ各イベントを転送します。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日