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

读取 Instagram 私信记录:Conversations API

Instagram 的 Conversations API 通过 graph.instagram.com 读取专业账户的私信记录。GET /me/conversations?platform=instagram 会列出各个对话及其 updated_time;GET /<CONVERSATION_ID>?fields=messages 按 ID 和时间列出某个对话的消息;GET /<MESSAGE_ID>?fields=id,created_time,from,to,message 则返回单条消息。每个对话中只有最近 20 条消息的详细信息可供读取。

easyCoexistence 会在新的 Instagram 私信到达时将其转发至您的端点,并在 24 小时窗口内使用 send_social_dm 回复。

20

API 返回详细信息的仅为每个对话中最近的消息;更早的消息会返回一条错误,提示其已被删除。

30 days

“请求”文件夹中的对话超过一定时间无活动后,将不再返回。

2/sec

应用对每个 Instagram 专业账户每秒可进行的 Conversations API 调用次数上限。

2 permissions

instagram_business_basic 和 instagram_business_manage_messages 权限,需使用可管理该账户消息的人员所持有的访问令牌。

如何列出账户的对话?

使用 GET /me/conversations,或 /<IG_ID>/conversations,并加上 platform=instagram,同时使用可管理该账户消息的人员所持有的 Instagram 用户访问令牌。data 数组中的每一项即为一个对话,包含其 id 和 updated_time。

Listing conversations
GET https://graph.instagram.com/me/conversations
  ?platform=instagram
  &access_token=<ACCESS_TOKEN>

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
  ]
}

如何找到与某人的对话?

添加 user_id 参数,其值为对方的 Instagram 范围 ID,即对方给该账户发消息时以 sender.id 形式传来的 IGSID。响应会返回该对话的 id。这样无需翻阅整个列表,即可将 Webhook 事件对应到其对话线程。

One person's conversation
GET https://graph.instagram.com/me/conversations
  ?user_id=<IGSID>
  &access_token=<ACCESS_TOKEN>

如何读取消息?

分两步进行。GET /<CONVERSATION_ID>?fields=messages 按 id 和 created_time 列出对话中的消息,这是默认字段。随后使用 fields=id,created_time,from,to,message 调用 GET /<MESSAGE_ID>,即可返回单条消息:包括由谁发送、发给谁(各附用户名和 ID),以及消息文本。

A conversation's messages, then one message
GET https://graph.instagram.com/<CONVERSATION_ID>
  ?fields=messages
  &access_token=<ACCESS_TOKEN>

GET https://graph.instagram.com/<MESSAGE_ID>
  ?fields=id,created_time,from,to,message
  &access_token=<ACCESS_TOKEN>

能往回读取多远?

Meta 的指南和概览对返回内容设定了四项限制:

  • 消息详情:每个对话中最近的 20 条消息;请求更早的消息会返回错误,提示该消息已被删除。
  • 请求:“请求”文件夹中无活动满 30 天的对话将不再返回。
  • 分享内容:分享的帖子或 Reel 仅返回其图片或视频 URL。
  • 频率:每个 Instagram 专业账户每秒 2 次调用。

需要满足什么条件?

使用 Instagram 登录时,需要 instagram_business_basic 和 instagram_business_manage_messages 权限,以及可管理该账户消息的人员所持有的访问令牌。对于您拥有或管理并已添加到应用中的账户,Standard Access 即可满足;若要为其他账户提供服务,则需要 Advanced Access。此外,该账户还须在其 Instagram 应用设置中开启“允许访问消息”。

为什么要保存 Webhook 的记录?

由于 API 只返回每个对话最近 20 条消息的详细信息,完整的记录必须在消息产生时即时保存。messages Webhook 会在私信到达时推送,其中对方的 IGSID 为 sender.id;该账户发出的消息同样会推送,只是 ID 的角色互换。因此,对话双方的内容都可以被记录下来。

如何通过 easyCoexistence 读取私信记录?

它转发私信,而不是读取历史记录。通过 set_social_webhook_destination 设置端点后,新私信到达时即会转发至该端点,且不保留副本;send_social_dm 可在 24 小时窗口内回复,可从 Claude、ChatGPT 或您自己的代码中发起。没有任何工具调用 me/conversations,因此更早的消息请在 Instagram 应用中读取,或由您自己的系统在消息到达时保存。

常见错误

  • 期望从 API 获取完整的对话线程。详情仅限最近 20 条消息,因此应在私信到达时通过 messages Webhook 即时存储。
  • 轮询对话以查找新私信。API 限制每个账户每秒 2 次调用,而 messages Webhook 会在每条私信到达时即时推送。
  • 试图找回旧的消息请求。“请求”文件夹中无活动满 30 天的对话将不再返回。
  • 把错误信息中的“deleted”误解为对方删除了消息。Meta 对任何早于最近 20 条的消息都会这样回复。
使用 EasyCoexistence 完成这些操作

可从 Claude、ChatGPT 或您自己的代码中使用,基于 Meta 官方 API;它没有用于 Conversations API 历史记录的工具。每个连接每月 US$ 9 起,连接越多单价越低,最低降至 US$ 0.75,并提供前 3 天免费试用。

常见问题

能否完整导出 Instagram 账户的私信记录?

不能通过 API 完整导出:API 会列出对话,但每个对话只返回最近 20 条消息的详情。完整的记录需要在 Webhook 推送私信时即时保存。

通过 API 读取消息会将其标记为已读吗?

不会。Meta 表示,通过 API 投递的消息在发送回复之前,不会在 Instagram 应用中被标记为已读。

Conversations API 支持 Instagram 登录吗?

支持。Meta 为其编写的指南面向 Instagram 登录,调用 graph.instagram.com 并使用 instagram_business_* 权限。

如何从对话中获取某人的用户名?

对消息请求 from 字段,即可返回发送者的用户名和 ID。对方向账户发过消息后,可通过 User Profile API 凭其 IGSID 获取更多信息,例如姓名。

继续阅读

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

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

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

验证时间