Instagram message_reactions Webhook:react と unreact のペイロード
Instagram の message_reactions Webhook フィールドは、プロフェッショナルアカウントとの会話でユーザーがメッセージにリアクションしたとき、またはそのリアクションを削除したときにアプリへ通知します。イベントは messaging 配列内の reaction オブジェクトとして届きます。reaction オブジェクトには、リアクションされたメッセージの ID である mid、action(react または unreact)、そして react の場合のみ reaction(love など)と emoji(絵文字そのもの)が含まれます。
easyCoexistence は、接続された各 Instagram アカウントのコメント、メッセージ、メンションを購読し、それらのイベントが届くたびにアカウントごとのシークレットで署名して、各メッセージの mid とともに HTTPS エンドポイントへ転送します。
reaction.action の値は 2 つです:リアクションが追加された場合(react)と、削除された場合(unreact)。
Meta が angry、sad、wow、love、like、laugh などを含むリアクションをこの Webhook でサポートし始めた Graph API バージョン。
アカウント自身がユーザーのメッセージにリアクションしたり、リアクションを取り消したりしても、Meta は通知を送信しません。
message_reactions は、アプリのダッシュボードで作成した新しい Instagram プロダクトが初期状態で購読するフィールドの 1 つです。
テキスト、リンク、リアクション、ステッカーを送る Send API の呼び出しは、アカウントごとに 1 秒あたりの回数で制限されます。
message_reactions はいつ発生しますか?
アプリとアカウントが当該フィールドを購読した後、ユーザーがプロフェッショナルアカウントとの会話でメッセージにリアクションしたときと、そのリアクションを削除したときに発生します。Meta の Instagram Messaging ガイドでは、逆方向について明記されています。アカウント自身がリアクションしたり取り消したりしても通知は送信されず、messages でもそのエコーは届きません。
リアクションの通知はどのような形ですか?
object が instagram に設定された POST で、entry に messaging 配列が含まれます。DM と異なり、このイベントには message オブジェクトがありません。リアクションは sender、recipient、timestamp と並んで、独自の reaction オブジェクトに入ります。以下は Meta が Instagram Login 向けに示した例です:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "react",
"reaction": "love",
"emoji": "\u{2764}\u{FE0F}"
}
}
]
}
]
}各フィールドの意味は何ですか?
Meta がリアクションイベントについて文書化しているフィールドを、外側から順に示します:
- entry[].id と recipient.id:プロフェッショナルアカウント。sender.id:リアクションしたユーザーの Instagram スコープ ID。
- timestamp:イベントが発生した時刻で、Meta のサンプルではミリ秒単位です。entry[].time は Meta が通知を送信した時刻です。
- reaction.mid:リアクションされたメッセージの ID。messages イベントで同じメッセージが持っていた mid と同一です。
- reaction.action:リアクションが追加されたとき react、削除されたとき unreact。
- reaction.reaction:リアクションの名前(love など)。Meta は angry、sad、wow、love、like、laugh、その他を挙げています。
- reaction.emoji:Unicode 文字列としての絵文字(love の場合は \u{2764}\u{FE0F})。
- unreact の場合、reaction と emoji は省略されます。
unreact はどのような形ですか?
同じイベントで action が unreact に設定され、reaction も emoji もありません。名前を付けるものが残っていないためです。reaction.mid と sender.id で、削除されたリアクションと照合し、そのユーザーのリアクションを記録から削除してください。
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "unreact"
}mid はどのメッセージを指しますか?
ユーザーがリアクションしたメッセージは、messages イベントで持っていたのと同じ mid で届き、アカウント自身のメッセージのエコーも含まれます。mid を保存するハンドラーは、リアクションを会話の正しい行に紐付けられます。Meta は注意点を 1 つ挙げています。カルーセル投稿の 1 枚の画像へのリアクションは、カルーセルの最初の画像として報告されるため、選ばれた画像と異なる場合があります。
アカウントはメッセージにどのようにリアクションしますか?
POST /<IG_ID>/messages で行います。recipient.id にユーザーの Instagram スコープ ID を設定し、sender_action を react に設定して、message_id と reaction(絵文字または UTF-8 形式の絵文字)を含むペイロードを送ります。別の絵文字で同じ呼び出しを繰り返すとリアクションが変わります。sender_action を unreact に設定し、message_id のみを送ると削除されます。どちらの呼び出しも Webhook は発生させません。
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
"recipient": { "id": "<IGSID>" },
"sender_action": "react",
"payload": {
"message_id": "<MESSAGE_ID>",
"reaction": "<EMOJI>"
}
}message_reactions には何が必要ですか?
Instagram Login では instagram_business_basic と instagram_business_manage_messages が必要です。開発者が所有または管理していないアカウントには Advanced Access が必要です。アプリのダッシュボードで作成した新しい Instagram プロダクトは message_reactions を初期状態で購読し、各アカウントは POST /<IG_ID>/subscribed_apps で購読させます。Meta の Send Messages ガイドはこのフィールドを messaging_reactions と記載していますが、そのフィールド表、ダッシュボードの初期値、Webhook リファレンスでは message_reactions です。
easyCoexistence はリアクションを転送しますか?
いいえ。easyCoexistence のアプリと接続された各アカウントは、コメント、メッセージ、メンションのみを購読するため、message_reactions のイベントはエンドポイントに転送されません。リアクションが mid で指す DM とエコーは、アカウントのシークレットで署名されて、エンドポイントに届きます。
よくある間違い
- リアクションを message の中で探すこと。リアクションイベントには message オブジェクトがありません。sender と recipient と並ぶ reaction オブジェクトを読んでください。
- action を確認せずに reaction や emoji を読むこと。unreact では両方とも省略されるため、リアクションが削除されたときに壊れるコードになります。
- アカウントがリアクションした後に Webhook を待つこと。Meta はアカウント自身のリアクションについて、エコーも含めて何も送信しません。そのため、アプリが送信したときに記録してください。
- Meta の Send Messages ガイドから messaging_reactions という名前をコピーすること。フィールド表、ダッシュボードの初期値、Webhook リファレンスにあるフィールドは message_reactions です。
お使いのエージェントは 24 時間ウィンドウ内であれば、send_social_dm を使ってユーザーに返信できます。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 までです。最初の 3 日間は無料トライアルです。
よくある質問
カルーセル投稿へのリアクションが最初の画像を指すのはなぜですか?
Meta は、ユーザーがカルーセルの画像の 1 つにリアクションすると、カルーセルの最初の画像を報告します。そのため、ユーザーが選んだ画像と異なる場合があります。
企業がメッセージにリアクションすると、Instagram は Webhook を送信しますか?
いいえ。アカウントがメッセージにリアクションしたり、リアクションを取り消したりしても、Meta は message_reactions の通知もエコーも送信しません。
Instagram の Webhook はどのリアクションを報告できますか?
Meta の Instagram Messaging ガイドは、Graph API v12.0 から angry、sad、wow、love、like、laugh、その他を挙げています。絵文字そのものは reaction.emoji に入ります。
Webhook のフィールド名は message_reactions ですか、messaging_reactions ですか?
message_reactions です。Meta の Send Messages ガイドでは messaging_reactions と記載されていますが、フィールド表、アプリのダッシュボードの初期値、Webhook リファレンスではすべて message_reactions を使用しています。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日