ログイン無料トライアルを開始
easyCoexistence 公式 API

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 エンドポイントへ転送します。

10K likes

Page のいいねの通知は、いいね数が 10,000 未満の Page に限り送られます。

Ad posts

feed フィールドは広告投稿そのものについては何も送りませんが、そこへのコメントは送られます。

pages_manage_metadata

Page の Webhook をアプリに届けるには、MODERATE 権限を持つ Page 管理者による許可が必要です。

1,000

Meta は多くの更新を 1 回の Webhook 配信にまとめますが、まとめることは保証されていません。

36 hours

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 に投稿した場合のものです:

A feed change, as Meta sends it
{
  "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 が、オブジェクトを作成した時刻です。
EasyCoexistence で実現する

コメントから 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 監視

確認日