通过 API 收发 Instagram 私信与 24 小时窗口
通过 Instagram 的 API,专业账户可以回复任何给它发过私信的人,大多数对话的标准消息窗口为 24 小时。对方必须先发消息,并且账户需要在 Instagram 应用中开启“允许访问消息”,应用才能读取或发送其私信。
easyCoexistence 可通过 Claude、ChatGPT 或您自己的代码,使用 send_social_dm 在 24 小时窗口内回复 Instagram 私信,并在新私信到达时转发至您的端点。
用户消息之后的标准回复窗口,适用于大多数用户操作。
Meta 单独的 Human Agent 窗口,适用于人员撰写并标记 human_agent 的回复。
一条私信通过 API 可承载的最大文本量,以 UTF-8 编码计算。
代码 10 下的错误子代码,表示消息在允许窗口之外发送。
消息请求文件夹中的对话在闲置多久后不再由 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 只允许一条,之后的消息需等对方回复才能发送。
- 从对话的首条消息开始计算窗口时间。窗口应从对方最新的一条消息起算,因此对方每回复一次,账户就多获得一段时间。
自动化规则可用固定文本或 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 监控
验证时间