读取 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 回复。
API 返回详细信息的仅为每个对话中最近的消息;更早的消息会返回一条错误,提示其已被删除。
“请求”文件夹中的对话超过一定时间无活动后,将不再返回。
应用对每个 Instagram 专业账户每秒可进行的 Conversations API 调用次数上限。
instagram_business_basic 和 instagram_business_manage_messages 权限,需使用可管理该账户消息的人员所持有的访问令牌。
如何列出账户的对话?
使用 GET /me/conversations,或 /<IG_ID>/conversations,并加上 platform=instagram,同时使用可管理该账户消息的人员所持有的 Instagram 用户访问令牌。data 数组中的每一项即为一个对话,包含其 id 和 updated_time。
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 事件对应到其对话线程。
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),以及消息文本。
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 条的消息都会这样回复。
可从 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 监控
验证时间