登录开始免费试用
easyCoexistence 官方 API

通过 API 处理 Instagram 提及:查找并回复 @提及

Instagram 的 API 会在公开媒体的评论和说明文字中,报告对专业账户的 @提及,并允许该账户就地回复。使用 Instagram 登录时,提及会通过评论 Webhook 送达;回复则通过 POST /<IG_ID>/mentions 发送,附上媒体 ID。若是评论中的提及,还需附上评论 ID,回复会以评论的形式发布在该处。

easyCoexistence 会在您使用 set_social_webhook_destination 设置后,将 Instagram 账户的评论、提及和私信实时转发到您的端点,并以该账户专属的密钥签名。

comments

面向使用 Instagram 登录的应用,包含提及的 Webhook 通知。

POST /mentions

用于回复评论或说明文字的端点,该内容中有其他 Instagram 用户 @提及了该账户。

Private

私人账户所拥有的媒体,其上的评论或 @提及不会触发 Webhook。

2

使用 Instagram 登录时,获取提及所需的权限:instagram_business_basic 和 instagram_business_manage_comments。

提及如何送达?

通过 Webhook 实时送达。使用 Instagram 登录时,Meta 会将提及包含在评论通知中,而不是单独发送 mentions 字段,因此处理程序从与新评论相同的事件中读取提及。Meta 不保留过往通知的历史记录,因此请在每条通知到达时保存所需内容。

API 涵盖哪些提及?

Meta 的提及 API 可识别商业或创作者账户被 @提及或标记的说明文字、评论和媒体:

  • 评论中的 @提及。
  • 帖子说明文字中的 @提及。
  • 账户被标记的媒体,可通过 GET /<IG_ID>/tags 列出;不支持对账户仅被标记的照片进行评论。
  • 不包括快拍:提及 API 不支持快拍,快拍提及会以私信送达账户,附件类型为 story_mention。
  • 不包括私人账户:其拥有的媒体不会发送提及 Webhook。

如何回复提及?

使用 POST /<IG_ID>/mentions。对于评论中的提及,随消息发送 media_id 和 comment_id,回复会出现在该评论的回复串中;对于说明文字中的提及,发送 media_id 和消息,回复会以评论的形式发布在该媒体上。两个 ID 都来自 Webhook 通知。

Replying to a mention in a comment
POST https://graph.instagram.com/<IG_ID>/mentions
  ?media_id=<MEDIA_ID>
  &comment_id=<COMMENT_ID>
  &message=<REPLY_TEXT>

提及需要什么?

使用 Instagram 登录时,需要权限 instagram_business_basic 和 instagram_business_manage_comments,即评论管理所使用的同一组权限,调用会发往 graph.instagram.com。若要为开发者不拥有或管理的专业账户提供服务,应用还需要高级访问权限。

常见错误

  • 在 Instagram 登录下等待单独的提及事件。Meta 会将提及包含在评论通知中送达。
  • 像回复自己帖子的评论一样,回复其他账户帖子上的提及。Meta 对此的路由是 POST /<IG_ID>/mentions,附上媒体 ID;若是评论中的提及,还需附上评论 ID。
  • 期望通过提及 API 获取快拍提及。Meta 在该 API 中不支持快拍;快拍提及会以私信送达。
  • 指望 Webhook 重新推送旧的提及。Meta 不保留通知历史,因此请在每条到达时保存。
使用 EasyCoexistence 完成这些操作

其工具可通过 reply_to_comment 回复您自己帖子下的评论;回复他人帖子中的提及(这会用到 Meta 的提及端点)则不在其中。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费。

常见问题

我可以评论账户被标记的照片吗?

不可以。GET /<IG_ID>/tags 会列出账户被标记的媒体,但 Meta 不支持对账户仅被标记的照片进行评论。

我可以回复别人帖子上的提及吗?

可以。使用 POST /<IG_ID>/mentions,附上媒体 ID;若提及位于评论中,还需附上评论 ID,回复会以该账户的身份发布在那里。

提及 API 能获取快拍提及吗?

不能。快拍提及会以私信送达账户,附件类型为 story_mention,并可在该对话中获得回复。

为什么某条提及始终没有送达?

媒体可能属于私人账户,而私人账户不会发送提及通知;或者提及位于快拍中,而提及 API 不涵盖快拍。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间