Instagram コメント Webhook:ペイロードをフィールドごとに解説
Instagram のコメント Webhook は、プロフェッショナルアカウントのメディア(リールを含む)にユーザーがコメントしたとき、またはコメントに返信したときにアプリへ通知するフィールドです。Meta は field が comments である change を送信します。その value には、コメントの id とテキスト、from に投稿者の Instagram スコープ ID とユーザー名、メディアの id と media_product_type、そしてコメントが返信の場合は parent_id が含まれます。
easyCoexistence は、接続された各 Instagram アカウントを comments に購読させ、Meta がそのアカウント向けに配信した comments イベントを、届き次第あなたの HTTPS エンドポイントへ転送します。
返信の場合にのみ存在し、返信先のコメントの ID を保持します。
アカウントが自分のメディアにコメントした場合、from に追加され、アカウント自身の ID と並んで入ります。
ライブ配信中のコメント用に別のフィールドがあり、配信が終了すると通知は止まります。
comments と live_comments の通知には Advanced Access が必要です。非公開アカウントのメディアでは通知が発生しません。
コメントの ID を指定して、投稿者に非公開の返信を 1 回送信できる残り時間です。
comments フィールドはいつ発火しますか?
アプリとアカウントの両方がフィールドに購読されている状態で、プロフェッショナルアカウントが所有するメディアにコメントされたとき、またはアカウントがメンションされたときに発火します。コメントごとに通知内の change が 1 件生成され、以下のケースはいずれも同じ形式を取ります:
- 投稿、リール、ストーリーズ、または広告へのコメントで、media.
media_product_typeがメディアの掲載先を示します。 - 既存のコメントへの返信で、返信先のコメントの ID を持つ
parent_idが付きます。 - アカウント自身がメディアに対して行ったコメント(その返信を含む)。from.id はアカウント自身の ID で、from に
self_ig_scoped_idが追加されます。 - アカウントへの @メンション。Instagram Login の場合、Meta はメンションを独自のフィールドではなくコメントの通知に含めます。
- ライブ配信中のコメントは
live_commentsという別フィールドで届き、値の形式は同じです。配信が終了すると止まります。
コメント通知はどのような形になりますか?
object に instagram を設定し、entry 配列を含む JSON の POST です。各 entry が 1 つのプロフェッショナルアカウントに対応し、その ID、Meta が通知を送信した時刻、そしてコメントごとに 1 つの change を持つ changes 配列を含みます。リールへの返信は次のようになります:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"parent_id": "<PARENT_COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<MEDIA_ID>",
"media_product_type": "REELS"
}
}
}
]
}
]
}各フィールドは何を意味しますか?
Meta の Webhook リファレンスがコメントについて挙げるフィールドを、外側から順に示します:
- entry[].id:プロフェッショナルアカウントの ID で、/me がそのアカウントに返す
user_idと同じです。コメントがどのアカウントに属するかを示します。 - entry[].time:Meta が通知を送信した時刻(Unix タイムスタンプ)。コメントが書かれた時刻ではありません。
- changes[].field:comments、またはライブ配信の場合は
live_comments。value を読む前に必ず確認してください。 - value.id:コメントの ID。公開で、またはプライベートで返信する、非表示にする、削除する際に使用する ID です。
- value.text:コメントのテキスト。コメントにテキストがある場合に含まれます。
- value.from.id と value.from.username:投稿者の Instagram スコープ ID とユーザー名。value.from.
self_ig_scoped_idは、アカウント自身がコメントを書いた場合に現れます。 - value.media.id と value.media.
media_product_type:コメント対象のメディアとその掲載先。Meta のメディアリファレンスでは AD、FEED、STORY、REELS が挙げられています。 - value.
parent_id:返信の場合、返信先のコメントの ID。トップレベルのコメントには存在しません。 - value.media.
ad_id、ad_title、original_media_id:広告へのコメントについてリファレンスに記載されています。
comments フィールドで報告されないものは何ですか?
ハンドラーが期待しそうなものの一部は、Meta のセットアップガイドとリファレンスによれば、イベントに含まれないか、そもそも送信されません:
- 非公開アカウントが所有するメディアへのコメント:Meta はこれらのコメントやメンションの通知を送信しません。
- アルバム ID:イベントには含まれず、Meta はコメント ID を使ってアルバムを検索するよう案内しています。
- ダイナミック広告で使われるメディアの広告 ID。
- コメントの作成時刻:GET /<
COMMENT_ID>?fields=timestamp で ISO 8601 形式で取得できます。 - ライブ配信終了後のライブコメント。ライブメディアの通知は止まります。
- ストーリーズのメンション。Meta のメンション API はこれをサポートしておらず、代わりに DM として届きます。
- 過去のイベント:Meta は照会可能な通知履歴を保持しないため、各イベントが届いた時点で必要なものを保存してください。
comments フィールドに必要なものは何ですか?
Instagram Login の場合、権限 instagram_business_basic と instagram_business_manage_comments、そして comments と live_comments の通知に Meta が必須とする Advanced Access が必要です。アプリは App Dashboard でライブ状態にし、コメントを購読している必要があります。各アカウントは POST /<IG_ID>/subscribed_apps で購読し、subscribed_fields に comments を含める必要があります。Meta はコメントについて、ポーリングよりもこの Webhook を強く推奨しています。レート制限の消費を抑えられるためです。
イベントのコメントにはどう返信しますか?
イベントに含まれる ID を使います。POST /<COMMENT_ID>/replies に message を指定すると、value.id を使ってコメントへの公開返信を投稿できます。POST /<IG_ID>/messages で recipient.comment_id に value.id を設定すると、投稿者に非公開の返信を 1 件送れます。コメントから 7 日以内、またはライブ配信中であれば配信が続く間に送信できます。from.id は Instagram スコープ ID ですが、投稿者がアカウントにメッセージを送るまで、その ID への直接の DM は失敗します。そのため、DM で相手に届かせる方法はプライベートリプライです。
easyCoexistence はコメントをどのように転送しますか?
アカウントに対して、set_social_webhook_destination(Claude または ChatGPT から)、または Partner API の PUT /channels/:id/webhook でエンドポイントを設定すると、受信したイベントを転送します。easyCoexistence は接続済みの各アカウントを、コメント、メンション、DM を運ぶフィールドに購読させ、配信ごとに Meta の署名を検証し、Meta にはすぐに応答します。そのアカウントの各 entry を、次のエンベロープに入れて HTTPS URL へ POST します:
- platform と
external_id:instagram と、アカウントの Instagram ID(entry.id と同じ)。 account_id:easyCoexistence における接続の ID。list_social_accountsが返すもので、MCP ツールが使用します。- entry:アカウントに対する Meta の entry をそのまま渡します。そのため、まとめて届いた配信は entry ごとに 1 回の POST になります。Meta の object フィールドと X-Hub-Signature-256 は転送されません。
- 配信:1 回だけ試行し、最大 8 秒待機します。リダイレクトは追跡せず、パブリック IP に解決される HTTPS アドレスへ送信します。コピーは保持されず、再送もされません。
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
}
}
]
}
}コメントから DM へのルールは同じイベントでどう動きますか?
ルールは転送と並行してこのイベントを読みます。ルールは、コメントに大文字小文字を区別せず一致するキーワードが含まれる場合に一致し、選んだ 1 件の投稿またはすべての投稿が対象です。一致すると、ルールの DM を投稿者へのプライベートリプライとして送り、ルールに公開返信があればそれも送ります。アカウント自身のコメントはスキップされ、コメントを起点とする自動化は、どのルールも返信しなかったコメントを処理します。ルールが返信したコメントも、エンドポイントには届きます。ルールの公開返信は、アカウント自身からの新しい comments イベントとして戻ってくることがあります。
よくある間違い
- comment_id を探すこと。Instagram Login の場合、コメントの ID は value.id にあります。comment_id は Meta の他のログイン設定のペイロードに属します。
- アカウント自身のコメントに返信すること。その返信は from.id が entry.id と等しい comments イベントとして戻ってくるため、それに返信する自動化は自分自身と会話し続けることになります。
- entry.time をコメントの時刻として読むこと。これは Meta が通知を送信した時刻を記録したもので、コメント自身の timestamp フィールドが書き込まれた時刻を示します。
- ライブコメントを comments フィールドで待つこと。ライブコメントは live_comments で届きます。これには独自の購読が必要で、配信が終了すると届かなくなります。
署名はそのアカウントのシークレットで行われ、コピーは保持されません。コメントから DM へのルールや自動化は、同じコメントに 24 時間体制で返信します。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
Instagram のコメント Webhook には、コメントへの返信も含まれますか?
はい。返信は独立した comments イベントとして届き、parent_id に返信先のコメントの ID が入ります。
リールへのコメントで Instagram のコメント Webhook は発火しますか?
はい。リールへのコメントは、投稿へのコメントと同じく comments フィールドで届きます。media.media_product_type でこの 2 つを区別できます。
Instagram のコメント Webhook が発火しないのはなぜですか?
多くの場合、アプリがライブ状態でないか Advanced Access がないこと、アカウントが /subscribed_apps で購読されていないこと、メディアが非公開アカウントのものであること、またはコメントがライブ配信上のもので live_comments を使うことが原因です。
コメントの Webhook にコメント投稿者のユーザー名は含まれますか?
はい。value.from に、Instagram スコープ ID と並んで投稿者のユーザー名が含まれるため、誰がコメントしたかを表示するのに追加の呼び出しは不要です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日