微信机器人协议（微信机器人协议是什么）

更新时间： 2026-09-07 13:03:21

本文约 2600 字，预计需要 7 分钟

知更Ai（zhigengai.com）微信机器人协议，这个词在不同人嘴里说的不是同一件事。有人把它理解成"微信官方给第三方工具的接口授权"，有人把它理解成"编程里用来控制微信操作的各种函数"，还有人把它理解成"某种类似网页协议的东西"。这三种理解各有道理，但对应的答案完全不同。下面从知更Ai 文档出发，把这个概念拆开来讲清楚——不是所有功能都适合所有人，但看完你能判断自己需要哪一块。

先把"协议"这个词说清楚

"微信机器人协议"不是一个官方术语，微信官方从来没有发过一个叫"协议"的东西。它是技术社区约定俗成的说法，指的是"通过技术手段与微信客户端通信的能力"。这种能力在知更Ai 里被拆成了两大类：

消息接口：控制"发什么、发给谁、怎么发"，包括文字、图片、文件、语音、视频、名片、小程序、XML 消息等各种消息类型的发送接口。
事件接口：接收"谁发了什么、谁进了群、谁通过了好友申请"，通过 WebSocket 实时推送，开发者可以订阅不同类型的事件来做自动化响应。

理解这个分类，是后面所有操作的前提。

知更Ai 支持的消息发送接口

消息发送是微信机器人最核心的能力。知更Ai 文档里列出了完整的消息接口清单，下面按消息类型逐一说明，每个接口对应一个明确的业务场景。

文本消息接口

接口路径：api-msg-text

最基础的消息类型。发送纯文本内容给指定联系人或群聊，文本长度上限 2000 字符。典型的使用场景是自动回复、活动通知、群发公告。这个接口的参数最少，只需要提供接收方（wxid 或群名）和消息内容。知更Ai 的 Ai 智脑也封装了这个能力——用户可以用自然语言说"给张三发一条消息告诉他明天开会"，系统自动调用文本消息接口完成发送。

图片消息接口

接口路径：api-msg-image

发送图片给指定联系人或群聊，支持网络图片 URL。知更Ai 会自动下载 URL 对应的图片，压缩到微信的限制范围内再发送。这个接口常用于产品图推送、活动海报发送、客户案例展示等场景。如果图片较大，系统会自动调整尺寸，不需要手动处理。

视频消息接口

接口路径：api-msg-video

发送视频文件给指定联系人或群聊，同样支持网络视频 URL。视频消息在朋友圈运营、活动预告、客户演示等场景下很常用。

文件消息接口

接口路径：api-msg-file

发送各类文件（PDF、Word、Excel、压缩包等）给指定联系人或群聊，文件大小建议不超过 20MB。常见的应用场景包括报价单发送、合同传输、资料分发。这个接口和图片、视频接口一样，支持直接填网络 URL，系统会自动下载后发送。

GIF 消息接口

接口路径：api-msg-gif

发送 GIF 动图。GIF 在聊天中常用于表情包、趣味内容传播，适合运营场景中需要增加互动趣味性的场合。

语音消息接口

接口路径：api-msg-voice

发送语音消息。如果已经有现成的语音文件，可以直接通过这个接口发送。知更Ai 还提供了配套的语音转文本接口（api-media-voice-to-text），可以先识别语音内容再做后续处理。

位置消息接口

接口路径：api-msg-location

发送位置分享。这是微信原生支持的一种消息类型，可以分享一个地点给对方，常用于线下门店导流、活动场地指引等场景。

名片消息接口

接口路径：api-msg-card

发送微信联系人名片。运营者可以把自己的账号或客户的名片转发给其他人，实现人脉推荐。这个接口在知更Ai 的 Ai 智脑里可以直接通过自然语言触发，比如"把张三的名片发给李四"。

文章消息接口

接口路径：api-msg-essay

发送公众号文章消息。接口会携带标题、描述、封面图和链接一起发送，和微信里转发文章的体验一致。适合运营者定期推送优质内容给客户。

XML / 小程序消息接口

接口路径：api-msg-xml

发送 XML 格式的卡片消息或小程序。这是微信接口中最灵活的一种消息类型，可以自定义标题、描述、图片、跳转链接等。小程序消息常用于电商场景的商品卡片、订单通知等。

群聊专项接口

群聊相关的接口在日常运营中使用频率很高，知更Ai 文档里列出了多个专项能力。

群内 @ 成员

接口路径：api-msg-at

在指定群聊中 @ 某个成员，引起对方注意。接口支持同时 @ 多个成员。可以和文本消息组合使用——发一条消息并 @ 指定的群成员。典型的业务场景是活动提醒、任务分配、问题跟进。

群内 @ 所有人

接口路径：api-msg-at-all

在群聊中 @ 所有人，发送全员通知。只有群主或管理员才能使用这个接口，日常运营中建议控制使用频率，避免打扰用户。

创建群聊

接口路径：api-group-create

创建一个新群并指定初始成员。可以一次性把多个好友拉进同一个群，省去手动建群的操作。

踢出群成员

接口路径：api-group-kick

将指定成员从群聊中移出。只有群主或管理员有权限执行。配合广告关键词过滤使用，可以实现自动踢出发广告的用户。

邀请好友进群

接口路径：api-group-invite

将指定好友邀请进入已有群聊。40 人以上的群需要对方同意才能邀请成功。知更Ai 支持批量邀请，一次调用可以邀请多个好友。

修改群公告

接口路径：api-group-announcement

发布或修改群公告，支持最多 500 字的内容，发布后所有成员都会收到通知。这是群运营中最常用的信息触达手段。

修改群名称

接口路径：api-group-name

修改群聊的显示名称。适合活动期间临时改群名做标识，活动结束后再改回来。

获取群成员昵称

接口路径：api-group-member-nickname

查询某个成员在群内的个性化昵称（群备注），而不是微信昵称。这在做精细化群运营时很有用——同一个用户在不同群里可能有不同的身份标识。

同意加入群聊

接口路径：api-group-agree-join

处理他人的入群申请。配合自动通过好友功能，可以实现新用户添加后自动入群的完整流程。

联系人管理接口

联系人管理是私域运营的基础，知更Ai 提供了从查询到操作的全套接口。

同意好友申请

接口路径：api-friend-verify

通过好友申请。配合自动通过好友功能（auto-accept），可以实现完全自动的好友添加流程。

修改好友备注

接口路径：api-friend-remark

修改已有好友的备注名称。这是在私域运营中保持联系人信息准确的关键操作——客户沟通中往往需要快速找到对应的人，备注名是最高效的标识。

移动好友到标签

接口路径：api-friend-label

将好友移动到指定的标签分组。支持批量操作，一次可以移动多个好友到同一标签。这是做客户分层运营的基础能力。

通过 v3/v4 添加好友

接口路径：api-friend-add

通过手机号或微信号主动发起好友申请。接口需要提供 v3/v4 信息才能添加，如果只知道手机号，系统会自动查询对应的 v3/v4 信息。可以设置自定义的验证语。

查询陌生人信息

接口路径：api-friend-stranger

通过手机号、微信号或二维码链接查询陌生用户的信息。适合在只知道联系方式的情况下先确认对方身份再决定是否添加。

网络查询好友信息

接口路径：api-friend-query

通过网络请求查询好友信息，区别于本地数据库查询。这个接口可以获取到更完整的好友资料。

获取联系人列表

接口路径：api-friend-list

获取当前账号的所有联系人列表。这是做批量运营的基础数据来源——先拿到联系人列表，再配合标签管理做分层触达。

数据查询接口

除了消息发送，知更Ai 还提供了一套本地数据库查询接口，用于获取聊天记录、联系人信息等数据。

执行 SQL 查询

接口路径：api-db-query

在本地数据库上执行 SQL 查询。这是一个灵活且强大的接口，适合有技术能力的用户做深度数据挖掘。比如查询特定联系人的聊天记录、统计消息数量、分析群活跃度等。

列出数据库表

接口路径：api-db-tables

列出本地数据库中的所有数据表。配合 SQL 查询接口使用，先了解数据结构，再写查询语句。

查询聊天记录

接口路径：api-db-chat-history

查询与指定联系人的历史聊天记录，支持按时间范围和关键词过滤。这是做客服质检、客户跟进回顾的重要数据来源。

朋友圈接口

朋友圈运营是私域流量激活的重要场景，知更Ai 提供了三个专项接口。

刷新朋友圈

接口路径：api-moments-timeline

触发朋友圈动态刷新，获取最新的朋友圈内容。这是在做朋友圈自动化运营前必须先执行的操作——先拉取最新动态，才能针对性地做点赞、评论。

朋友圈点赞

接口路径：api-moments-like

对指定朋友圈动态点赞。朋友圈运营中的基础互动动作，可以帮助客户的朋友圈内容获得更多曝光。

朋友圈评论

接口路径：api-moments-comment

对指定朋友圈动态发表评论。可以配合自动内容策略做精准评论互动，提升客户活跃度。

事件推送与接收

上面讲的都是"发送"方向的能力，但一个完整的微信机器人还需要"接收"方向的能力——也就是感知到新消息、好友申请、入群事件，然后做出响应。

知更Ai 文档里的 WebSocket 推送（websocket）提供了这个能力。通过 WebSocket 建立的持久连接，开发者可以实时接收到微信端的事件通知，包括：

新消息到达（私聊消息、群聊消息）
好友申请（新的好友验证请求）
群成员变动（有人入群、有人退群）
消息发送状态（发送成功、发送失败）

基于这些事件，开发者可以构建完整的自动化响应逻辑：收到特定关键词消息 → 触发 AI 回复；收到好友申请 → 自动通过并发送欢迎语；有人入群 → 发送新人入群欢迎语。

消息转发接口

知更Ai 还提供了一个高灵活度的转发接口：

转发任意消息

接口路径：api-forward-any

将任意类型的消息（图片、文件、语音、名片等）转发给指定的联系人或群聊。这个接口的适用场景很广——比如把客户发来的资料一键转发给客服，把收集到的名片批量转发给团队成员等。

转发公众号名片

接口路径：api-forward-gh-card

将公众号名片转发给好友，实现公众号的推荐和导流。

转发视频号

接口路径：api-forward-finder-video

转发视频号内容给指定联系人或群聊。

转发语音

接口路径：api-forward-voice

转发语音消息。这个接口配合语音转文本（api-media-voice-to-text），可以实现语音消息的内容存档和检索。

几个高频问题

第一个问题：这些接口需要写代码才能用吗？不一定。知更Ai 的图形界面封装了大部分接口的调用入口——比如在 Ai 智脑里用自然语言说"给张三发消息"，系统自动调用文本消息接口；通过关键词回复配置，系统自动处理触发逻辑。对于没有编程背景的用户，直接使用图形界面已经足够。只有在做深度定制、SQL 查询、或构建复杂自动化流程时，才需要用到文档里的接口定义。

第二个问题：接口调用有没有频率限制？微信本身对消息发送频率有风控，短时间内大量群发消息可能触发平台限制。知更Ai 文档的建议是在多次小批量、稳定节奏、间隔合理的场景下使用。

第三个问题：数据存储在哪里？知更Ai 的本地数据库查询接口（api-db-query）操作的是本地的聊天记录数据库，数据不经过第三方平台。如果对数据安全有更高要求，可以了解知更Ai 的本地化部署能力。

合规边界

使用这些接口能力，必须符合一个前提：以平台官方规则为准，了解并遵守微信相关平台政策与法律法规。接口是工具，工具怎么用决定了是否合规。具体来说：

消息发送应模拟正常的人类使用节奏，不做批量轰炸式群发。
好友添加应尊重对方意愿，不做强制推销式的频繁添加。
数据获取和使用应限于合法的业务场景，不做超出范围的采集和利用。
任何自动化行为都应以平台官方规则为准，避免使用接口能力规避平台检测或绕过风控机制。

写在最后

"微信机器人协议"这个词本质上指的是一套完整的消息发送与接收能力清单。知更Ai 文档里把这些能力拆得很细——从最基础的文本消息，到群聊管理、联系人操作、朋友圈互动，再到 WebSocket 事件推送和本地数据库查询，共数十个接口，覆盖了微信运营的各个环节。

第一次接触这些接口，先从自己最迫切的业务场景出发：想自动回复就关注消息接口，想做社群管理就关注群聊接口，想激活朋友圈就关注朋友圈接口。等基础场景跑通之后，再逐步探索更复杂的组合用法。接口是能力，能力怎么组合取决于你的业务目标。

文章目录