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 エンドポイントへ転送します。
アプリダッシュボードで新しい Instagram 製品を追加すると、最初から購読されるフィールドには comments、messages、message_reactions などが含まれます。
フィールドはアカウントごとではなく、アプリ単位で選択されます。アカウントはアプリが選択したフィールドを受け取ります。
Instagram Login の Webhook について Meta のセットアップガイドが挙げるアクセスレベルで、comments と live_comments の通知には必須です。
Meta のフィールド表で Instagram Login では利用不可とされ、Facebook Login と Unified Login で提供されているフィールドです。
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 を必須としています。
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 には、ダッシュボードで選んだフィールドをカンマ区切りで指定します。
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 は利用不可と示しているため、ストーリーズが公開されている間に、そのインサイトエンドポイントから指標を読み取ってください。
イベントは既定では保存されません。オートメーションを有効にしているアカウントは、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 監視
確認日