🚀 Get TikTok DMs and Ads in Wati Team Inbox and convert social engagement into revenue See TikTok on Wati🚀 TikTok DMs + Ads now in Team Inbox →

Instagram API

Instagram API:通过 REST 获取评论,通过 MCP 实现私信。

读取新评论、公开回复、发送私信回复,并通过私信继续对话。专为开发者和高效编程者打造。更喜欢 WhatsApp?在回复中附上您的手机号码链接。

  • API 中可用评论:列表、回复、私信回复、权限

最后更新于

目前 Instagram API 支持的功能

功能使用方式状态
评论:获取帖子和评论列表、公开回复REST API上线
对评论进行私信回复REST API上线
私信:发送和接收MCP 服务器通过 MCP 上线
私信REST API即将推出,开放候补名单

暂不支持:隐藏或删除评论,以及 Instagram Webhook 事件。

  • 16,000+家企业分布在 190+ 个国家/地区
  • 4.6/5G2 上的平均评分
  • 官方Meta 业务合作伙伴和 WhatsApp BSP
G2 聊天机器人领导者G2 中端市场聊天机器人领导者G2 聊天机器人发展势头领导者G2 最佳实施 WhatsApp 营销奖ISO 27001GDPR

一条评论。 一次全新的对话。

公开回复、私信回复并在私信中持续交流。或者将聊天转移到 WhatsApp。

  • 从模板开始使用经批准的模板开启对话,无论是面向单个客户还是 10,000 名客户。
  • 在聊天中继续客户回复后即可发送文本、媒体和按钮。
  • 由您的团队完成收尾Webhook 将消息通知给您的代码。团队收件箱则由您的团队人工处理。
产品特性

发送。回复。倾听。转接。

InstagramInstagram 评论与私信

构建 Instagram 自动化功能。

列出帖子评论,进行公开回复或发送私信回复。

群发消息

个性化消息,规模化发送。

选择已审批的模板,向多达 10,000 名收件人发送。每位收件人拥有各自的变量,每个发送结果均会按编号返回。

消息收发

回复不限于纯文本。

在 24 小时窗口内,可发送文本、图片、文件、回复按钮和列表选择器,并在您操作时显示正在输入的提示符。

订单更新与提醒

适时推送恰当的更新。

当状态发生变化时,您的商店、预订或计费系统会自动发送已批准的模板。客户只需点击按钮或直接回复。

自动回复与聊天机器人

由您的代码进行解答。

消息 Webhook 会将每条新消息实时推送到您的服务器。使用发送端点进行回复,或在 Pro 和 Business 版本中启动 Wati 聊天机器人。

Webhooks

每次回复,即时到达。

Webhooks 会将新消息、已读回执、点击事件和失败通知实时推送至您的 URL,无需轮询。

团队收件箱

代码发起,人工跟进。

回复将统一汇入 Wati 团队收件箱。可通过 API 指派操作人员、设置状态并添加标签,确保合适的人员及时跟进。

联系人与分群

您的 CRM,在 Wati 中完美映射。

通过自定义属性创建和更新联系人,并在发送消息前预览受众分群。

快速上手

三步即可上线。

  1. 连接

    连接您的号码

    通过 Wati 内 Meta 的嵌入式注册(Embedded Signup)链接您的 WhatsApp 号码。

  2. 验证

    获取令牌

    在 Wati 中创建一个 API 令牌,并仅授予您所需的权限范围。请将其保存在您的服务器上。

  3. 发送

    发起您的第一次调用

    通过单个请求发送经过批准的模板。然后添加 Webhook 以跟踪投递情况。

您的第一个请求解析

以下是一个请求包含的内容,以及每个部分在消息中显示的位置。

  1. 回复哪条评论

    您正在回复的评论。当您列出帖子的评论时,会获取其 ID。

    comment_id在 URL 路径中
  2. 来自哪个账号

    您连接到 Wati 的 Instagram 账号。

    channel
  3. 发给谁

    撰写评论的人,取自同一评论。

    userIduserName
  4. 发送什么内容

    最多 1,000 个字符的纯文本,或带有按钮的模板。

    type = texttexttype = template
  5. 您将获得的回应

    200 且 ok 设置为 true 表示私密回复已成功发送。请使用与所有其他调用相同的 Authorization 标头。

    ok: trueresult: success

POST /api/ext/v3/comments/{comment_id}/privateReply。评论和回复文本仅为示例。在文档中查看请求详情

随时可用的代码隐藏代码
POST/api/ext/v3/comments/{comment_id}/privateReply
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/comments/$COMMENT_ID/privateReply" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "yourbrand",
    "userId": "17841400000000000",
    "userName": "maya",
    "type": "text",
    "text": "Hi Maya, yes we do. Chat with us on WhatsApp for shipping options."
  }'
200 示例响应来自文档架构的响应结构
{
  "ok": true,
  "result": "success"
}
内置功能

Wati 为您处理的一切,无需劳心。

号码入驻

通过 Meta 的嵌入式注册连接。WhatsApp 业务账号将注册到您的企业。

模板状态

审批、质量和类别更改将作为 Webhook 到达,让您在发送失败前即可知晓。

Webhook 重试

最多重试 144 次,每 10 分钟一次。如果您的端点持续失败,Wati 会向您发送电子邮件。

速率限制与排队

请求过快会收到带 Retry-After 标头的 429 响应。接受的消息将在队列中等待。

人工接管

为不应仅由代码独自回答的对话提供共享的团队收件箱。

作用域 API 令牌

v3 支持作用域令牌,因此每个集成仅获得其所需的访问权限。

定时发送

通过一次调用安排稍后发送模板。Wati 会按时发送。

成本预估优先

在发送任何内容之前预估群发成本。

底层逻辑

按功能分类的端点。

模板

通过已批准的模板立即或定时发起对话。

文档 →
GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/schedule

群发

读取营销活动结果及每个收件人的状态,并优先预估成本。

文档 →
GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-cost

消息发送

在 24 小时窗口内使用文本、媒体或按钮回复。

文档 →
POST/conversations/messages/textPOST/conversations/messages/fileViaUrlPOST/conversations/messages/interactivePOST/conversations/typingIndicator

聊天机器人 Pro+

列出您的 Wati 聊天机器人并为联系人启动一个聊天机器人。

文档 →
GET/chatbotsPOST/chatbots/start

Webhooks

管理订阅并列出您可以接收的事件类型。

文档 →
GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}

联系人与分群

从您的 CRM 同步联系人和属性,然后针对特定分群进行精准定位。

文档 →
POST/contactsPUT/contactsPOST/segments/evaluate

团队收件箱

分配操作员、更改状态、添加或移除标签。

文档 →
PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tags

Instagram

列出帖子和评论、公开或私下回复、检查权限。

文档 →
GET/posts/{post_id}/commentsPOST/comments/{comment_id}/repliesPOST/comments/{comment_id}/privateReplyGET/channels/{channel}/permissions

路径相对于 https://live-mt-server.wati.io/api/ext/v3。创建 webhook 使用旧版路径 POST /{tenantId}/api/v2/webhookEndpoints。

对于 AI 智能体,Wati MCP 服务端涵盖相同的 WhatsApp 操作,并且可以使用文本回复 Instagram 私信和 Messenger 聊天。

查看全部 19 种 WhatsApp webhook 事件类型

消息

  • message
  • newContactMessageReceived
  • sessionMessageSent_v2
  • templateMessageSent_v2

投递状态

  • sentMessageDELIVERED_v2
  • sentMessageREAD_v2
  • sentMessageREPLIED_v2
  • templateMessageFailed

模板与账号

  • templateReviewed
  • templateQualityUpdated
  • templateCategoryUpdated
  • wabaStatusReviewUpdate
  • PhoneNumberQualityUpdatedEvent
  • accountUpdated
  • accountDeleted
  • phoneNumberDeleted

互动与通话

  • chatbotTriggered
  • ctaUrlClicked
  • call.status

多个事件也提供 BSUID 版本。Webhook 文档

限制与套餐

清晰的限制。公开透明。

30 至 100 每 10 秒

模板发送

调用发送模板的频率,取决于您的套餐(Growth、Pro 或 Business)。

10,000 个收件人

每次 v3 发送调用

一个模板,最多可发给 10,000 人,每人拥有各自的变量。

24 小时 窗口

自由格式回复

文本、媒体和按钮需要开放的客户服务窗口。在此之外,请发送模板。

429 Retry-After

请求过快时

Wati 会告知您需要等待多长时间。接受的消息将在队列中处理。

详细的速率限制与套餐可用性
按套餐划分的记录速率限制
端点GrowthProBusiness
/addContact, /getContacts10 / 10 s10 / 10 s10 / 10 s
/getMessages10 / 10 s10 / 10 s10 / 10 s
/sendTemplateMessage30 / 10 s60 / 10 s100 / 10 s
/sendTemplateMessages30 / 10 s60 / 10 s100 / 10 s

限制如 错误与速率限制 上所公布,按端点名称列出。v1 批量调用最多支持 1,000 个联系人。核心消息发送、模板和联系人端点适用于所有套餐。团队分配、聊天状态、聊天机器人和自定义分群需要 Pro 或 Business 套餐。同时更新许多联系人的属性需要 Business 套餐。各套餐的端点可用性。如需更高的限制,请联系 Wati 讨论您的具体用例。

常见问题

常见疑问

完整的 API 参考文档已公开。阅读文档

Wati Instagram API 可以做什么?

目前,该 API 可以列出您的 Instagram 帖子及其评论、返回未读评论数、公开回复评论、向评论者发送私信回复,以及检查您账户的评论权限。公开回复最多可支持 2,200 个字符,私信文本回复最多支持 1,000 个字符。

我可以在没有庞大工程团队的情况下构建 Instagram 自动化吗?

可以。评论端点是带有 bearer 令牌的普通 REST 调用,因此 AI 应用构建器可以根据简短的描述编写代码。一个好的首个构建方案:检查新评论、公开回复,然后发送私信回复。如果您已经在使用 AI 代理(AI agent),Wati MCP server 可以使用文本回复 Instagram 私信。

如何在回复前检查我的 Instagram 权限?

使用您连接的 Instagram 渠道调用 GET /channels/{channel}/permissions。响应会告诉您是否已授予评论权限并列出任何缺失的范围(scopes),以便您的自动化程序在回复失败之前停止运行。

我需要懂编程吗?

比过去的要求低了。AI 应用构建器可以根据简单的英文指令编写 API 调用,并且本页面上的示例展示了每个调用。

在开始对话之前,您仍然需要一个连接到 Wati 的 WhatsApp 号码、一个 API 令牌以及一个经 Meta 批准的模板。如果 AI 工具编写了代码,请确保您的令牌保留在服务器上。

API 速率限制是多少?

在所有套餐中,联系人和消息历史记录调用均限制为每 10 秒 10 个请求。Growth、Pro 和 Business 套餐的模板发送限制分别为每 10 秒 30、60 或 100 个请求。当您达到限制时,您将收到带有 Retry-After 标头的 HTTP 429。如需更高的限制,请联系 Wati。

我可以随时给客户发消息吗?

在 WhatsApp 上,自由格式的文本、媒体和交互式消息需要一个开放的 24 小时客户服务窗口。在该窗口之外,请使用经 Meta 批准的模板开始对话。

WhatsApp Business 应用与 API 之间有什么区别?

Business 应用适用于手机上的手动聊天,最多支持 5 台链接设备,广播列表上限为 256 个联系人。API 将 WhatsApp 连接到您自己的系统。您可以批量发送获批的模板、自动回复、接收 Webhooks 并跨团队收件箱共享一个号码。

我的套餐包含哪些端点?

所有套餐都包含核心消息传递、模板和联系人端点。团队分派、聊天状态、聊天机器人和自定义细分需要 Pro 或 Business 套餐。文档按套餐列出了端点的可用性。

您的第一条消息只需一个请求即可发送。

免费开始,在 Wati 中连接您的 WhatsApp 号码并进行您的第一次调用。