Instagram live_comments Webhook: ライブ配信中のコメント
Instagram の live_comments Webhook フィールドは、プロアカウントのライブ配信中に、そのライブへのコメントをアプリに通知します。各コメントは、field が live_comments に設定された change として届きます。値の形式は comments フィールドと同じで、コメントの id とテキスト、from 内の Instagram スコープ ID とユーザー名、メディアの id を含みます。配信が終了すると通知は止まります。
easyCoexistence は、接続された各 Instagram アカウントに対して comments、messages、mentions を購読し、投稿とリールへのコメントを届き次第、そのアカウントのシークレットで署名して HTTPS エンドポイントに転送します。
comments と同じく、live_comments の通知にも権限が必要です。非公開アカウントが所有するメディアは通知を送りません。
アプリが Instagram ライブのコメントへ、アカウントごとに送信できるプライベートリプライの毎秒数。
ライブ配信のメディアに対するコメント通知が止まるタイミング。
ライブコメントへのプライベートリプライを送信できる期間。配信が終了すると送信できなくなります。
Meta が live_comments を導入した時期。配信中のライブ動画へのコメントが対象です。
live_comments はいつ発火しますか?
プロアカウントのライブ動画が配信されている間に、誰かがそのライブにコメントすると、アプリとアカウントがそのフィールドを購読していれば発火します。comments とは別物です。投稿、リール、ストーリー、広告へのコメントは comments に届き、ライブ配信中のコメントは live_comments に届きます。ライブメディアの通知は配信が終わると止まり、非公開アカウントのメディアでは発火しません。
live_comments の通知はどのような形ですか?
コメントと同じ外側の構造です。object は instagram、entry はアカウントごとに 1 件、changes 配列の field は live_comments になります。Meta の Instagram Login の例では comments と live_comments の値の形式が同じなので、フィールド名だけで両者を区別します:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "live_comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<LIVE_MEDIA_ID>",
"media_product_type": "<MEDIA_PRODUCT_TYPE>"
}
}
}
]
}
]
}各フィールドはそれぞれ何を意味しますか?
Meta の Webhook リファレンスに記載された live_comments のフィールドを、外側から順に示します。
- entry[].id: プロアカウントです。entry[].time: コメントが書かれた時刻ではなく、Meta が通知を送った時刻です。
- changes[].field:
live_commentsです。形式は comments と同じなので、value を読む前に必ず確認してください。 - value.id: コメントの ID です。プライベートリプライの宛先はこの ID で指定します。
- value.text: コメントのテキストです。
- value.from.id と value.from.username: コメントした人の Instagram スコープ ID とユーザー名です。アカウントが自分でコメントした場合は from.
self_ig_scoped_idが含まれます。 - value.media.id と value.media.
media_product_type: ライブ動画本体と、その掲載先の種別です。 - value.
parent_id: 別のコメントへの返信である場合に、リファレンスに記載されています。
live_comments は comments と何が違いますか?
ペイロードは同じですが、ルールは異なります。Meta のコメントに関するリファレンスは、ライブ動画へのコメントを独自のケースとして扱い、レート制限やプライベートリプライのルールも別の数値を定めています。左に comments フィールド、右に live_comments を並べて比較します。
| comments | live_comments | |
|---|---|---|
| Fires for | Comments on posts, Reels, Stories and ads | Comments on a Live while it broadcasts |
| Notifications | As each comment is made | Stop when the broadcast ends |
| Public reply | POST /<COMMENT_ID>/replies | Not supported on live video |
| Hide or delete | Supported | Not supported on live video |
| Private reply | Within 7 days of the comment | Only during the broadcast |
| Private reply rate | 750 per hour per account | 100 per second per account |
ライブコメントにはどう返信しますか?
配信中にプライベートリプライで返信します。POST /<IG_ID>/messages に recipient.comment_id としてコメントの ID を指定すると、コメントした人に DM が 1 通送られます。相手がアカウントをフォローしていれば受信トレイに、フォローしていなければメッセージリクエストに届きます。Meta のリファレンスでは、ライブ動画への公開の操作は対象外です。そこでのコメントへの返信、コメントの作成、非表示、削除はサポートされていません。配信が終わると、そのライブのコメントへのプライベートリプライは送れなくなります。
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
"recipient": { "comment_id": "<COMMENT_ID>" },
"message": { "text": "<REPLY_TEXT>" }
}Webhook を使わずにライブのコメントを読み取れますか?
ライブが続いている間だけ可能です。Meta のコメントに関するリファレンスでは、ライブ動画のコメントは、そのメディアが配信されている間だけ読み取れるとされています。メディアのリファレンスも、ライブ動画そのものについて同じことを述べています。アカウントの現在のライブを一覧する live_media エッジは、graph.facebook.com 上の Facebook Login 向けに文書化されています。Meta は問い合わせ可能な通知履歴を保持していないため、各イベントが届いたときに必要な情報を保存してください。
live_comments には何が必要ですか?
Instagram Login の場合、comments と同じ instagram_business_basic と instagram_business_manage_comments の組み合わせに加え、Meta が comments と live_comments の通知に必須とする Advanced Access が必要です。App Dashboard で Instagram のプロダクトを新たに追加すると、最初から live_comments を購読した状態になります。各アカウントは POST /<IG_ID>/subscribed_apps で購読します。ライブを配信するアカウントは公開アカウントである必要があります。
easyCoexistence は Live のコメントを転送しますか?
いいえ。easyCoexistence のアプリと接続された各アカウントは、live_comments ではなく comments、messages、mentions を購読するため、ライブ配信中に書かれたコメントは転送されません。投稿やリールへのコメントは転送され、reply_to_comment、hide_comment、コメントから DM へのルール、オートメーションでそれらに対応できます。
よくある間違い
- ライブのコメントを comments フィールドで待つこと。ライブのコメントは live_comments に届き、field は live_comments になります。アプリでそのフィールドを選択しておく必要があります。
- 公開で返信すること。Meta はライブ動画のコメントへの返信、非表示、削除をサポートしていません。配信中のプライベートリプライが唯一の経路です。
- プライベートリプライを配信後にまとめて送ること。配信が終わると送信できなくなるため、配信中に返信してください。
- live_comments を履歴として扱うこと。通知は配信が終わると止まり、Meta には問い合わせ可能な履歴が残らないため、届いた時点で必要な情報を保存してください。
reply_to_comment は公開またはプライベートリプライで返信し、コメントから DM へのルールは 24 時間稼働します。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
Instagram の comments Webhook にはライブのコメントが含まれますか?
いいえ。ライブ配信中のコメントは、値の形式は同じですが、別のフィールド live_comments に届きます。
Meta はいつ live_comments Webhook を追加しましたか?
2021 年 11 月 9 日です。配信中のライブ動画へのコメントが対象です。
live_comments Webhook が届かなくなったのはなぜですか?
おそらく配信が終了したためです。ライブメディアのコメント通知は配信終了で止まります。最初から届いていない場合は、Advanced Access、アカウントの購読、アカウントが公開されているかを確認してください。
アプリは Instagram ライブのコメントにどのくらいの速さでプライベートリプライを送れますか?
アカウントあたり毎秒最大 100 件です。これはライブのコメントに対する Meta のプライベートリプライのレートで、投稿とリールへのコメントは 1 時間あたり 750 件です。各返信は配信が終わる前に送信しなければなりません。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日