API 経由の Instagram メンション: @メンションの取得と返信
Instagram の API は、公開メディアのコメントとキャプションにおけるプロアカウントへの @メンションを報告し、アカウントがその場で返信できるようにします。Instagram Login では、メンションは コメント Webhook で届き、返信は POST /<IG_ID>/mentions を通じて行います。メディア ID を指定し、コメントの場合はさらに コメント ID を指定すると、そのコメントに返信として投稿されます。
easyCoexistence は、Instagram アカウントのコメント、メンション、DM を、届くたびにエンドポイントへ転送します。
Instagram Login を使うアプリ向けに、メンションを含む Webhook 通知です。
別の Instagram ユーザーが自アカウントを @メンションしたコメントまたはキャプションに返信するエンドポイントです。
非公開アカウントのメディアでは、そのコメントや @メンションについて Webhook は発生しません。
Instagram Login でメンションに必要な権限は instagram_business_basic と instagram_business_manage_comments です。
メンションはどのように届きますか?
Webhook により、発生した時点で届きます。Instagram Login では、Meta は別のメンションフィールドではなく、コメント通知にメンションを含めて送信します。そのため、ハンドラーは新しいコメントと同じイベントからメンションを読み取ります。Meta は過去の通知の履歴を保持しないため、届いた時点で必要な情報を保存してください。
API が対象とするメンションはどれですか?
Meta のメンション API は、ビジネスアカウントまたはクリエイターアカウントが @メンションまたはタグ付けされた、キャプション、コメント、メディアを特定します:
- コメント内の @メンション。
- 投稿のキャプション内の @メンション。
- アカウントがタグ付けされているメディア。GET /<
IG_ID>/tags で一覧できますが、タグ付けされただけの写真へのコメントはサポートされていません。 - ストーリーズは対象外です。メンション API は対応しておらず、ストーリーズでのメンションは
story_mentionという添付タイプの DM としてアカウントに届きます。 - 非公開アカウントは対象外です。非公開アカウントのメディアは、メンションの Webhook を送信しません。
メンションにはどのように返信しますか?
POST /<IG_ID>/mentions を使います。コメント内のメンションには、メッセージと一緒に media_id と comment_id を送信すると、返信はそのコメントのスレッドに表示されます。キャプション内のメンションには、メッセージと media_id を送信すると、返信はそのメディアへのコメントとして投稿されます。両方の ID は Webhook 通知から取得します。
POST https://graph.instagram.com/<IG_ID>/mentions
?media_id=<MEDIA_ID>
&comment_id=<COMMENT_ID>
&message=<REPLY_TEXT>メンションに必要なものは何ですか?
Instagram Login では、コメントのモデレーションと同じ instagram_business_basic と instagram_business_manage_comments の権限が必要で、呼び出しは graph.instagram.com に送られます。開発者が所有または管理していないプロアカウントを扱うには、アプリに Advanced Access も必要です。
よくある間違い
- Instagram Login で別のメンションイベントを待つこと。Meta はメンションをコメント通知の中で配信します。
- 他のアカウントの投稿へのメンションに、自分の投稿へのコメントと同じように返信すること。Meta の経路は POST /<IG_ID>/mentions で、メディア ID と、コメントの場合はコメント ID を指定します。
- ストーリーズのメンションをメンション API から取得できると考えること。Meta は対応しておらず、ストーリーズのメンションは DM としてアカウントに届きます。
- Webhook が過去のメンションを再送してくれると考えること。Meta は通知の履歴を保持しないため、届いた時点で各メンションを保存してください。
set_social_webhook_destination で設定すると、そのアカウント専用のシークレットで署名されます。ツールでは、reply_to_comment で自分の投稿へのコメントに返信できます。他のユーザーの投稿でのメンションへの返信は、Meta のメンション用エンドポイントを使うため、対象外です。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
タグ付けされた写真にコメントできますか?
いいえ。GET /<IG_ID>/tags はアカウントがタグ付けされたメディアを一覧しますが、タグ付けされただけの写真へのコメントは Meta がサポートしていません。
他の人の投稿でのメンションに返信できますか?
はい。メディア ID を指定した POST /<IG_ID>/mentions に、メンションがコメント内にある場合はコメント ID を加えると、アカウントとしてそこに返信が投稿されます。
メンション API でストーリーズのメンションを取得できますか?
いいえ。ストーリーズのメンションは story_mention 添付タイプの DM としてアカウントに届き、その会話内で返信できます。
メンションが届かなかったのはなぜですか?
メディアが非公開アカウントのものである可能性があります。非公開アカウントはメンション通知を送信しません。または、メンションがメンション API の対象外であるストーリーズにある可能性があります。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日