1. 终端接入
企业号二次开发 & wechatapi.net
  • API文档目录
    • 介绍目录
    • 开放接口
      • 终端接入
        • 创建终端(步骤一)
          POST
        • 获取登录二维码(步骤二)
          POST
        • 校验登录验证码(步骤三)
          POST
        • 查询扫码状态(步骤四)
          POST
        • 查询登录状态
          POST
        • 执行登录
          POST
        • 恢复终端
          POST
        • 停止终端
          POST
        • 配置回调地址
          POST
      • 会话能力
        • 会话列表分页
        • 编辑会话分组
        • 查询会话分组
      • 联系人能力
        • 批量获取联系人详情
        • 外部联系人分页
        • 内部联系人分页
        • 搜索联系人
        • 添加个微联系人
        • 添加企微联系人
        • 添加群成员好友
        • 添加企微名片
        • 添加单删联系人
        • 同意好友申请
        • 更新个微联系人信息
        • 更新企微联系人信息
        • 删除联系人
        • OpenID
      • 消息能力
        • 发送文本消息
        • 发送富文本消息
        • 发送图片
        • 发送GIF表情
        • 发送视频
        • 发送文件
        • 发送语音
        • 发送链接
        • 发送小程序
        • 发送名片
        • 发送视频号
        • 发送位置
        • 撤回消息
        • 修改消息状态
        • 群消息置顶列表
        • 添加群消息置顶
        • 移除群消息置顶
        • 发起群发消息
        • 查询群发状态
        • 查询群发规则
        • 同步历史消息分页
      • 群组能力
        • 群组列表分页
        • 批量获取群详情
        • 创建群组
        • 修改群组名称
        • 修改群组备注
        • 修改群内昵称
        • 邀请或添加成员
        • 移除群成员
        • 获取群二维码
        • 修改群公告
        • 添加群管理员
        • 取消群管理员
        • 退出群组
        • 转让群主
        • 解散群组
        • OpenID
        • 开启群改名权限
        • 开启入群确认
        • 通过链接接受邀请
      • 云存储能力
        • 异步上传文件
        • 上传文件
        • 通过URL上传文件
        • 下载企微文件
        • 异步下载企微文件
        • 异步下载企微大文件
        • 下载个微文件
        • CDN文件转URL
        • 异步下载个微文件
      • 账号能力
        • 生成个人二维码
        • 获取账号信息
        • 更新账号信息
        • 查询企业资料
        • 账号注销
        • 个人收藏分页
        • 收藏GIF表情
      • 动态能力
        • 朋友圈列表分页
        • 朋友圈互动列表分页
        • 批量获取详情
        • 上传文件
        • 发布朋友圈
        • 删除朋友圈
        • 点赞或取消赞
        • 评论或追评
        • 删除评论
      • 标签能力
        • 标签列表分页
        • 个人标签增删改
        • 客户标签增删
  • 数据模型
    • 响应成功
    • GUID请求
  1. 终端接入

配置回调地址

POST
/api/qw/doApi
回调按用户token来推送消息,该token下的所有账号消息都会推送到此URL。
各租户间的消息有数据隔离
回调内容必定包含guid,如下
{
  "code": 0,
  "msg": "成功",
  "data": [{
    "guid": "76d721b7-dce8-4794-b544-a7a13007dde4",
    "requestId": "",
    "base64RawData": "Ch8IABIbChkyMjMzMzMzMzMzMzMzMzMzMzMzMzMzMzMz",
    "fromRoomId": 10791082136095292,
    "isRoomNotice": 0,
    "msgData": {
      "content": "2233333333333333333333333",
      "atList": []
    },
    "msgServerId": 1004532,
    "msgType": 0,
    "msgUniqueIdentifier": "CAIQn7+JsQYY1+C/qomAgAMgvZ+P6Qo=",
    "receiverId": 0,
    "senderId": 1688852365307991,
    "senderName": "",
    "timestamp": 1713528735
  }]
}
msgType包含系统、聊天消息类型,详见消息回调接口说明

请求参数

Header 参数

Body 参数application/json

示例
{
  "method": "/client/setCallback",
  "params": {
    "callbackUrl": "https://open.wechatapi.net/webhook/events"
  }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/qw/doApi' \
--header 'X-QIWEI-TOKEN: {{tenantToken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "method": "/client/setCallback",
  "params": {
    "callbackUrl": "https://open.wechatapi.net/webhook/events"
  }
}'

返回响应

🟢200成功
application/json
Body

示例
{
  "code": 0,
  "msg": "成功"
}
修改于 2026-03-13 09:09:17
上一页
停止终端
下一页
会话列表分页
Built with