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

Instagram Webhook フィールドの全一覧

Instagram Login のプロフェッショナルアカウントでは、Meta の Webhook フィールド表に、comments、live_comments、messages、message_echoes、message_reactions、messaging_postbacks、messaging_referral、messaging_seen、messaging_optins、messaging_handover、standby が並んでいます。mentions は comments の中で配信されます。例には message_edit も含まれます。各フィールドには instagram_business_basic に加えて、コメント系では instagram_business_manage_comments、ほとんどのメッセージ系フィールドでは instagram_business_manage_messages が必要です。story_insights は Instagram Login では提供されません。

easyCoexistence は、接続された各 Instagram アカウントを comments、messages、mentions に購読させ、届いた順に、そのアカウント固有のシークレットで署名したうえで、あなたの HTTPS エンドポイントへ転送します。

8

アプリダッシュボードで新しい Instagram 製品を追加すると、最初から購読されるフィールドには comments、messages、message_reactions などが含まれます。

Per app

フィールドはアカウントごとではなく、アプリ単位で選択されます。アカウントはアプリが選択したフィールドを受け取ります。

Advanced Access

Instagram Login の Webhook について Meta のセットアップガイドが挙げるアクセスレベルで、comments と live_comments の通知には必須です。

story_insights

Meta のフィールド表で Instagram Login では利用不可とされ、Facebook Login と Unified Login で提供されているフィールドです。

10 Sep 2025

message_edit の Webhook が、Business Login for Instagram と Facebook Login for Business 向けに Meta から導入された時期。

Instagram Login ではどの Webhook フィールドが提供されますか?

Meta のフィールド表に基づき、各フィールドの発火条件は例と Webhook リファレンスから引いています。各フィールドには、表に示された権限に加えて instagram_business_basic も必要です。また Meta は、comments と live_comments の通知に Advanced Access を必須としています。

commentsA comment or reply on the account's posts, Reels, Stories or ads, @mentions included. instagram_business_manage_comments.
live_commentsA comment on the account's Live while it is broadcast. instagram_business_manage_comments.
mentionsNo field of its own with Instagram Login: Meta includes mentions in the comments notification.
messagesA DM: text, attachments, shares, Story replies and mentions, quick replies, deletions, and echoes of the account's own messages. instagram_business_manage_messages.
message_echoesListed with instagram_business_manage_comments; the account's own messages arrive on messages with is_echo set to true.
message_reactionsA person reacts to a message or removes the reaction. instagram_business_manage_messages.
message_editA person edits a message, with mid, text and num_edit. In Meta's examples and changelog, not in its fields table.
messaging_postbacksA tap on an ice breaker, a template's postback button or a persistent menu item. instagram_business_manage_messages.
messaging_referralAn ig.me link with a ref parameter, opened in an existing conversation. instagram_business_manage_messages.
messaging_seenA person reads a message, reported as read.mid. instagram_business_manage_messages.
messaging_optinsListed with instagram_business_manage_messages; Meta's Instagram examples show no payload for it.
messaging_handoverThread control passed, taken or requested between apps under the handover protocol. instagram_business_manage_messages.
standbyA message that arrives while another app controls the conversation. instagram_business_manage_messages.

Instagram Login では利用できないフィールドはどれですか?

Meta のフィールド表で Instagram Login の権限が割り当てられていない行が 3 つあり、そのため Instagram Login のアプリはこれらを受け取りません。さらに 1 つのフィールドは Instagram Login の外側にだけ存在します。

  • story_insights: ストーリーズの期限切れ時点の指標。Facebook Login または Unified Login と instagram_manage_insights が必要です。Meta のメディアインサイトのリファレンスでは、insights の Webhook は Instagram Login で非対応とされています。
  • messaging_policy_enforcement と response_feedback: Meta の Instagram Messaging API の列にのみ記載されています。
  • mentions を単独のフィールドとして扱うのは Facebook Login と Unified Login で、必要な権限は instagram_manage_comments です。Instagram Login では mentions が comments に含まれます。

フィールドはどのように購読しますか?

2 か所で設定します。アプリダッシュボードで Instagram 製品の Webhook 設定を開き、コールバック URL と検証トークンを保存します。これで Meta の検証リクエストが送られるので、その後フィールドを選択します。新しい Instagram 製品は、そのうち 8 つのフィールドを最初から購読しています。次に、graph.instagram.com で POST /<IG_ID>/subscribed_apps を使い、各アカウントを購読させます。その際 subscribed_fields には、ダッシュボードで選んだフィールドをカンマ区切りで指定します。

Subscribing one account to three fields
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
  ?subscribed_fields=comments,messages,message_reactions
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{ "success": true }

アカウントごとに異なるフィールドを受け取れますか?

いいえ。Meta のセットアップガイドによると、アプリのユーザーのアカウントごとにフィールドを選択することはできません。アカウントは、アプリで選択されたフィールドを受け取ります。アカウントの購読にある subscribed_fields は、ダッシュボードのフィールドを列挙するためのものです。ハンドラーは、アプリが選んだどのフィールドも届く可能性があるものとして設計し、アカウントが何を要求したかではなく、各イベントが何を含むかで判断してください。

通知の中でフィールドはどう見分けますか?

エントリの形で見分けます。コメント系のフィールドは changes 配列で届き、各 change がフィールド名を示します。メッセージ系のフィールドは messaging 配列で届き、フィールド名はありません。sender、recipient、timestamp と並ぶキーで区別します:

  • changes[].field が comments または live_comments の場合、コメントは value に入っています。
  • message: messages。アカウント自身が送ったメッセージのエコーを含み、それには is_echo が true で設定されています。
  • reaction: message_reactions。postback: messaging_postbacks。read: messaging_seen。message_edit: message_edit。
  • sender と並ぶ referral: messaging_referral。message の内側の referral は messages に属し、新しいスレッドや Click-to-Direct 広告に由来します。
  • pass_thread_control、take_thread_control、request_thread_control: messaging_handover。Meta の Webhook リファレンスの記載どおりです。

easyCoexistence はどのフィールドを購読しますか?

comments、messages、mentions です。これは接続時に各 Instagram アカウントが購読するリストです。Instagram Login では mentions は comments に含まれるため、購読は comments と DM をカバーし、DM にはエコー、ストーリーズへの返信、ストーリーズでのメンション、添付ファイルが含まれます。表のその他のフィールドは、それを購読したアプリに対して Meta が配信するもので、接続の購読には含まれません。set_social_webhook_destination または Partner API でエンドポイントを設定すると、easyCoexistence は Meta の署名を検証し、Meta にすぐ応答して、そのアカウントの各エントリを次のように POST します:

  • platform と external_id: instagram。アカウントの Instagram ID で、entry.id と等しい値です。
  • account_id: easyCoexistence での接続の ID で、MCP ツールが受け取るものです。
  • entry: アカウントについての Meta の entry をそのまま渡します。Meta の object フィールドと X-Hub-Signature-256 ヘッダーは転送されません。
  • X-EC-Signature: t=<unix>,v1=<hex>。タイムスタンプ、ドット、生のボディの HMAC-SHA256 で、キーはアカウント固有のシークレットです。
  • 配信: 最大 8 秒で 1 回の試行です。リダイレクトは追従せず、コピーは保持せず、リトライもしません。

よくある間違い

  • Instagram Login で mentions フィールドを待つこと。Meta は mentions を comments の通知に含めるため、フィールド mentions をキーにしたハンドラーは実行されません。
  • アカウントは自身の購読で指定されたフィールドだけを受け取ると考えること。Meta はアプリに選択されたフィールドを配信するため、各イベントが何を含むかで分岐してください。
  • message.referral と最上位の referral を同じイベントだと扱うこと。前者は messages で届き、後者は messaging_referral で、既存の会話内で開かれた ig.me リンクからのものです。
  • Instagram Login で story_insights を待つこと。Meta は利用不可と示しているため、ストーリーズが公開されている間に、そのインサイトエンドポイントから指標を読み取ってください。
EasyCoexistence で実現する

イベントは既定では保存されません。オートメーションを有効にしているアカウントは、DM とコメントを 7 日間保持します。エンドポイントは Claude または ChatGPT から set_social_webhook_destination で、もしくは Partner API で設定できます。接続あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料トライアルです。

よくある質問

Instagram Login に mentions の Webhook フィールドはありますか?

独立したものはありません。Meta は Instagram Login の場合、mentions を comments の通知に含めます。mentions が独立したフィールドになるのは、Facebook Login と Unified Login の場合です。

story_insights は Instagram Login で利用できますか?

いいえ。Meta のフィールド表では Instagram Login で利用不可とされており、メディアインサイトのリファレンスでも insights の Webhook は非対応とされています。

Instagram のメッセージ用 Webhook に必要な権限はどれですか?

instagram_business_basic と instagram_business_manage_messages で、これに加えて Advanced Access が必要です。Meta のセットアップガイドは、これを Instagram Login の Webhook 向けに挙げています。

Meta はいつ Instagram 向けの message_edit Webhook を追加しましたか?

2025 年 9 月 10 日です。Business Login for Instagram と Facebook Login for Business 向けでした。編集は messaging 配列の中に message_edit キーで届きます。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日