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

通过 API 收发 Instagram 私信与 24 小时窗口

通过 Instagram 的 API,专业账户可以回复任何给它发过私信的人,大多数对话的标准消息窗口为 24 小时。对方必须先发消息,并且账户需要在 Instagram 应用中开启“允许访问消息”,应用才能读取或发送其私信。

easyCoexistence 可通过 Claude、ChatGPT 或您自己的代码,使用 send_social_dm 在 24 小时窗口内回复 Instagram 私信,并在新私信到达时转发至您的端点。

24 hours

用户消息之后的标准回复窗口,适用于大多数用户操作。

7 days

Meta 单独的 Human Agent 窗口,适用于人员撰写并标记 human_agent 的回复。

1,000 bytes

一条私信通过 API 可承载的最大文本量,以 UTF-8 编码计算。

2534022

代码 10 下的错误子代码,表示消息在允许窗口之外发送。

30 days

消息请求文件夹中的对话在闲置多久后不再由 API 返回。

谁可以通过 API 向账户发送消息?

只能是曾经给账户发过消息的人。对话只能由对方主动发起,无论是从动态、帖子、限时动态提及,还是其他途径。此后应用就可以回复对方。对帖子发表评论的人也能收到一条私密回复,详见下文。

API 无法发送首条消息,也不支持群组对话:每个对话仅限账户与一位用户之间。

消息窗口有多长?

大多数对话为 24 小时。Meta 称之为标准消息窗口,开启窗口的操作决定其长度:对方发来的一条消息会开启 24 小时窗口,对方的下一条消息会再次开启。如果首条消息来自点击了 Click-to-Direct 广告的用户,窗口最长可持续 7 天。

Meta 另有一个为期 7 天的 Human Agent 窗口,适用于人员撰写并由具备该功能的应用标记 human_agent 的回复,用于标准窗口无法覆盖的问题。在任何已开启窗口之外的发送都会失败,返回代码 10、子代码 2534022。

什么是“允许访问消息”?

这是 Instagram 应用中的一项设置,允许已连接的工具读取和发送账户的私信。Meta 指南将其放在:设置、消息和限时动态回复、消息控制、已连接的工具下。在应用管理私信之前,账户必须先开启此项。关闭时,发送会失败,返回代码 200、子代码 2534041:账户所有者已禁用对 Instagram 私信的访问。

评论的私密回复如何运作?

专业账户可以向在其帖子、Reels 或限时动态下发表评论的人发送一条消息,时限为评论发出后 7 天;若是直播,则仅限直播期间。若对方关注了该账户,消息会进入其收件箱;若未关注,则进入消息请求,并附带该帖子的链接。后续消息必须等对方回复后才能发送,并且需在对方回复后 24 小时内发出。

API 对话在应用中显示在哪里?

在账户正常的 Instagram 收件箱中,但有几点差异值得留意:

  • 关注账户的人发来的新对话进入“主要”,未关注账户的人发来的则进入消息请求。
  • 通过应用回复的对话会移入“一般”文件夹,不论收件箱设置如何。
  • 交付给应用的消息在发送回复之前,在 Instagram 应用中不会标记为已读。
  • 30 天无活动的消息请求不再由 API 返回。

账户的发送速率是多少?

Meta 为每个 Instagram 专业账户设置消息速率,与应用的其他 API 调用分开计算:

  • 文本、链接、表情回应和贴纸:每秒 100 次调用。
  • 音频或视频:每秒 10 次调用。
  • 对帖子和 Reels 评论的私密回复:每小时 750 次调用。
  • Conversations API:每秒 2 次调用。

一条消息可以包含什么?

文本、链接、图片、音频、视频、PDF 文件、贴纸、表情回应、消息模板,以及账户拥有的帖子。文本必须为 UTF-8 编码,且不超过 1,000 字节,若包含重音字符和表情符号,可容纳的字符数会更少。图片可为 PNG 或 JPEG 格式,最大 8 MB;音频、视频和 PDF 文件最大 25 MB。

常见错误

  • 未开启“允许访问消息”。在账户于应用中开启之前,发送都会失败,返回代码 200、子代码 2534041。
  • 按字符而非字节计算长度。重音字母在 UTF-8 中占两个字节,多数表情符号占四个字节,因此通过 1,000 字符检查的文本仍可能被拒绝。
  • 对同一条评论发送第二条私密回复。Meta 只允许一条,之后的消息需等对方回复才能发送。
  • 从对话的首条消息开始计算窗口时间。窗口应从对方最新的一条消息起算,因此对方每回复一次,账户就多获得一段时间。
使用 EasyCoexistence 完成这些操作

自动化规则可用固定文本或 AI 自行回复,评论转私信规则则全天候发送私密回复。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,并提供 3 天免费试用。

常见问题

企业能否先通过 Instagram 发送私信?

不能通过 API。对方必须先向账户发消息,或评论其某条帖子,之后可在 7 天内发送一条私密回复。

24 小时过后会怎样?

API 会拒绝发送,直到对方再次发消息,从而开启新窗口。人员撰写的回复可使用 Meta 单独的 7 天 Human Agent 窗口,并标记 human_agent。

通过 API 发送的 Instagram 私信最长多少?

每条消息最多 1,000 字节的 UTF-8 文本。重音字母和表情符号各占一个以上字节,因此包含它们的消息所能容纳的字符数少于 1,000 个。

通过 API 读取的消息会在应用中显示为已读吗?

不会。交付给应用的消息在 Instagram 收件箱中保持未读,直到发送回复为止。

继续阅读

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

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

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

验证时间