メンション

InstagramビジネスやInstagramクリエイターのエイリアスがタグ付けまたは@mentionされているキャプション、コメント、およびIGメディアを識別します。

制限

ストーリーのメンションはサポートされていません。
自分がタグ付けされた写真へのコメントはサポートされていません。
コメントや@mentionが表示されるメディアが非公開設定のアカウントによって作成された場合、Webhooksは送信されません。

エンドポイント

このAPIは次のエンドポイントで構成されています:

GET /{ig-user-id}/tags — ビジネスアカウントまたはクリエイターアカウントがタグ付けされているメディアオブジェクトを取得します
GET /{ig-user-id}?fields=mentioned_comment — ビジネスアカウントまたはクリエイターアカウントが@mentionされているコメントに関するデータを取得します
GET /{ig-user-id}?fields=mentioned_media — ビジネスアカウントまたはクリエイターアカウントがキャプション内で@mentionされているメディアオブジェクトに関するデータを取得します
POST /{ig-user-id}/mentions — ビジネスアカウントまたはクリエイターアカウントが別のInstagramユーザーによって@mentionされているコメントまたはメディアオブジェクトキャプションに返信します

使用手順については、各エンドポイントのリファレンスドキュメントを参照してください。

Webhooks

mentionsフィールドをサブスクリプション登録すると、InstagramユーザーがInstagramビジネスアカウントまたはInstagramクリエイターアカウントをメンションするたびに、Instagram Webhooks通知を受け取れます。FacebookはWebhooks通知データを保存していないので、メンションをリッスンするWebhookを設定した場合、後で使用するつもりであれば、受け取ったデータを保存する必要があります。

例

コメントの@Mentionをリッスンして返信する

コメントの@mentionをリッスンして、特定の基準を満たすものに返信できます:

mentionsフィールドをサブスクリプション登録するInstagram Webhookを設定します。
Webhooks通知を解析してコメントIDを特定できるスクリプトを設定します。
IDを使用してGET /{ig-user-id}/mentioned_commentエンドポイントをクエリし、各コメントに関する詳細情報を取得します。
返された結果を分析して、特定の基準を満たすコメントを特定します。
POST /{ig-user-id}/mentionsエンドポイントを使用して、それらのコメントに返信します。

返信は、ビジネスアカウントまたはクリエイターアカウントがメンションされたコメントへのサブスレッドコメントとして表示されます。

キャプションの@Mentionをリッスンして返信する

キャプションの@mentionをリッスンして、特定の基準を満たすものに返信できます:

mentionsフィールドをサブスクリプション登録するInstagram Webhookを設定します。
Webhooks通知を解析してメディアIDを特定できるスクリプトを設定します。
IDを使用してGET /{ig-user-id}/mentioned_mediaエンドポイントをクエリし、各メディアオブジェクトに関する詳細情報を取得します。
返された結果を分析して、特定の基準を満たすキャプションを含むメディアオブジェクトを特定します。
POST /{ig-user-id}/mentionsエンドポイントを使用して、それらのメディアオブジェクトにコメントします。