提及 Instagram 用戶

透過此關係連線，您可以就 Instagram 留言或附有說明文字的 Instagram 媒體物件（某個 Instagram 用戶在其中以 @ 提及了另一位 Instagram 用戶）建立 Instagram 留言。

建立

回覆附有說明文字的 Instagram 媒體物件

POST /{ig-user-id}/mentions?media_id={media_id}&message={message}

就特定 Instagram 媒體物件建立 Instagram 留言，而此類物件在說明文字中以 @ 提及了某個 Instagram 用戶。

限制

不支援限時動態上的提及。
不支援在您獲標註的相片上留言。
如果收到留言或獲 @ 提及的媒體是由設定為不公開的帳戶所建立，則系統不會傳送 Webhooks。

查詢字串參數

除非另有要求，否則查詢字串參數為可選項目。

{media_id}（必填） — 包含在 Webhook 通知承載中的媒體編號
{message}（必填） — 要包含在留言中的文字

權限

含有下列權限的 Facebook 用戶存取憑證：

instagram_basic
instagram_manage_comments
pages_read_engagement
pages_show_list

如果憑證是來自在企業管理平台獲授予專頁角色的用戶，則同時必須持有以下其中一項權限：

ads_management
pages_read_engagement
business_management

cURL 要求範例

curl -i -X POST \
 -d "media_id=17920112008063024" \
 -d "message=Thanks%20for%20the%20dinosaur!" \
 -d "access_token=a-valid-access-token-goes-here" \
 "https://graph.facebook.com/17841405309211844/mentions"

回應範例

{
  "id": "17846319838228163"
}

回覆留言

POST /{ig-user-id}/mentions?media_id={media_id}&comment_id={comment_id}&message={message}

就特定 Instagram 留言物件建立 Instagram 留言，而此類留言中有以 @ 提及了某個 Instagram 用戶。

限制

不支援限時動態上的提及。
不支援在您獲標註的相片上留言。
如果收到留言或獲 @ 提及的媒體是由設定為不公開的帳戶所建立，則系統不會傳送 Webhooks。

查詢字串參數

除非另有要求，否則查詢字串參數為可選項目。

{comment_id}（必填） — 包含在 Webhook 通知承載中的留言編號
{media_id}（必填） — 包含在 Webhook 通知承載中的媒體編號
{message}（必填） — 要包含在留言中的文字

權限

含有下列權限的 Facebook 用戶存取憑證：

instagram_basic
instagram_manage_comments
pages_read_engagement
pages_show_list

如果憑證是來自在企業管理平台獲授予專頁角色的用戶，則同時必須持有以下其中一項權限：

ads_management
pages_read_engagement
business_management

參數

comment_id（必填）
media_id（必填）
message

cURL 要求範例

curl -i -X POST \
 -d "media_id=17920112008063024" \
 -d "comment_id=17918718562020960" \
 -d "message=Hope%20you%20enjoy%20your%20new%20T-Rex!" \
 -d "access_token=a-valid-access-token-goes-here" \
 "https://graph.facebook.com/17841405309211844/mentions"

回應範例

{
  "id": "17846319838254687"
}

讀取

我們並不支援這項操作。

更新

我們並不支援這項操作。

刪除

我們並不支援這項操作。