参考资料WTAPI框架
接口路径、参数与回调字段以api文档weiti.apifox.cn 为准。

在微信生态运营中，个人微信机器人开发已成为提升效率的关键技术。本文将详细介绍如何使用WTAPI框架进行微信机器人二次开发，从环境搭建到功能实现，帮助您快速掌握个人微信接口开发的核心技能。

获取通讯录列表

/finder/v2/api/contacts/fetchContactsList

import http.client
import json

conn = http.client.HTTPSConnection("wx.chuapi.com")
payload = json.dumps({
   "appId": "{{appid}}"
})
headers = {
   'X-finder-TOKEN': '',
   'Authorization': 'Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjAxNmM2ZDQ5LWIxNWMtNGRjMy05YzQzLWZmYzZmNDhhMTg3MyJ9.1JWq9ntjam20_XDlSbklWTxbV-vg-F_dY1LYVX05BndRAuaJbv3iSwoDY-BuMwe1sdKxDXtDTMWJgXNMff4nOg',
   'Content-Type': 'application/json'
}
conn.request("POST", "/finder/v2/api/contacts/fetchContactsList", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

消息接口

发送文字消息

/finder/v2/api/message/postText

import http.client
import json

conn = http.client.HTTPSConnection("wx.chuapi.com")
payload = json.dumps({
   "appId": "wx_e2PiMSX8ySDV6tQGroCDc",
   "toWxid": "wxid_tyyu4v9ykz3712",
   "content": "你好WT"
})
headers = {
   'X-finder-TOKEN': '',
   'Authorization': 'Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjAxNmM2ZDQ5LWIxNWMtNGRjMy05YzQzLWZmYzZmNDhhMTg3MyJ9.1JWq9ntjam20_XDlSbklWTxbV-vg-F_dY1LYVX05BndRAuaJbv3iSwoDY-BuMwe1sdKxDXtDTMWJgXNMff4nOg',
   'Content-Type': 'application/json'
}
conn.request("POST", "/finder/v2/api/message/postText", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

发送视频消息

/finder/v2/api/message/postVideo

import http.client
import json

conn = http.client.HTTPSConnection("wx.chuapi.com")
payload = json.dumps({
   "appId": "wx_e2PiMSX8ySDV6tQGroCDc",
   "toWxid": "wxid_tyyu4v9ykz3712",
   "videoUrl": "https://scrm-1308498490.cos.ap-shanghai.myqcloud.com/1/41734f00f3803ca1cd8f5ad6d5f8d559.mp4?q-sign-algorithm=sha1&q-ak=AKIDmOkqfDUUDfqjMincBSSAbleGaeQv96mB&q-sign-time=1724227372;2588140972&q-key-time=1724227372;2588140972&q-header-list=&q-url-param-list=&q-signature=4e18eb97ab165f27afe0444516e54204f506c7e1",
   "thumbUrl": "https://scrm-1308498490.cos.ap-shanghai.myqcloud.com/1/logo.jpg?q-sign-algorithm=sha1&q-ak=AKIDmOkqfDUUDfqjMincBSSAbleGaeQv96mB&q-sign-time=1724227462;2588141062&q-key-time=1724227462;2588141062&q-header-list=&q-url-param-list=&q-signature=0bc8b973567d2672e5eaada1b5d466e23ce6b750",
   "videoDuration": 10
})
headers = {
   'X-finder-TOKEN': '',
   'Authorization': 'Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjAxNmM2ZDQ5LWIxNWMtNGRjMy05YzQzLWZmYzZmNDhhMTg3MyJ9.1JWq9ntjam20_XDlSbklWTxbV-vg-F_dY1LYVX05BndRAuaJbv3iSwoDY-BuMwe1sdKxDXtDTMWJgXNMff4nOg',
   'Content-Type': 'application/json'
}
conn.request("POST", "/finder/v2/api/message/postVideo", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
名片，小程序，语音等接口可查看文档看详情

2. 好友管理接口

添加联系人/同意添加好友

/finder/v2/api/contacts/addContacts

import http.client
import json

conn = http.client.HTTPSConnection("wx.chuapi.com")
payload = json.dumps({
   "appId": "{{appid}}",
   "scene": 15,
   "content": "HI",
   "v4": "v4_070b708f0b04000001000000000054a9e826263634356493c57b8e651000000050ded0b020927e3c97896a09d47e6e9e455d674c2544e251e77c7cba08cc6cef8f7df9e52d2bd4a3cef771c8661331fa1939fbe54f4e479d6d9d4522d70aeba057ffd0dd82398730da44ee57332a7bdea4862304d4799758ba@stranger",
   "v3": "v3_060b3826fd030100000000003a070e7757675c000000501ea9a3dba12f95f6b60a0536a1adb690dcccc9bf58cc80765e6eb16bffa5996420bb1b2577634516ff82090419d8bdcd5689df8dfb21d40af93d286f72c3a0e8cfa6dcb68afed39226f008c6@stranger",
   "option": 2
})
headers = {
   'X-finder-TOKEN': '',
   'Authorization': 'Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjAxNmM2ZDQ5LWIxNWMtNGRjMy05YzQzLWZmYzZmNDhhMTg3MyJ9.1JWq9ntjam20_XDlSbklWTxbV-vg-F_dY1LYVX05BndRAuaJbv3iSwoDY-BuMwe1sdKxDXtDTMWJgXNMff4nOg',
   'Content-Type': 'application/json'
}
conn.request("POST", "/finder/v2/api/contacts/addContacts", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

设置好友备注

/finder/v2/api/contacts/setFriendRemark

import http.client
import json

conn = http.client.HTTPSConnection("wx.chuapi.com")
payload = json.dumps({
   "appId": "{{appid}}",
   "wxid": "wxid_br88xhuif7k322",
   "remark": "GGB"
})
headers = {
   'X-finder-TOKEN': '',
   'Authorization': 'Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjAxNmM2ZDQ5LWIxNWMtNGRjMy05YzQzLWZmYzZmNDhhMTg3MyJ9.1JWq9ntjam20_XDlSbklWTxbV-vg-F_dY1LYVX05BndRAuaJbv3iSwoDY-BuMwe1sdKxDXtDTMWJgXNMff4nOg',
   'Content-Type': 'application/json'
}
conn.request("POST", "/finder/v2/api/contacts/setFriendRemark", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

仅展示部分功能代码 其余功能可以登录后台开发文档查看

3. 群管理接口

创建微信群

/finder/v2/api/group/createChatroom

import http.client
import json

conn = http.client.HTTPSConnection("wx.chuapi.com")
payload = json.dumps({
   "appId": "wx_e2PiMSX8ySDV6tQGroCDc",
   "wxids": [
      "wxid_v5z9pqicwzlv22",
      "xuan588888888"
   ]
})
headers = {
   'X-finder-TOKEN': '',
   'Authorization': 'Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjAxNmM2ZDQ5LWIxNWMtNGRjMy05YzQzLWZmYzZmNDhhMTg3MyJ9.1JWq9ntjam20_XDlSbklWTxbV-vg-F_dY1LYVX05BndRAuaJbv3iSwoDY-BuMwe1sdKxDXtDTMWJgXNMff4nOg',
   'Content-Type': 'application/json'
}
conn.request("POST", "/finder/v2/api/group/createChatroom", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

邀请/添加 进群

/finder/v2/api/group/inviteMember

import http.client
import json

conn = http.client.HTTPSConnection("wx.chuapi.com")
payload = json.dumps({
   "appId": "{{appid}}",
   "wxids": "wxid_br88xhuif7k322",
   "chatroomId": "49620123483@chatroom",
   "reason": ""
})
headers = {
   'X-finder-TOKEN': '',
   'Authorization': 'Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjAxNmM2ZDQ5LWIxNWMtNGRjMy05YzQzLWZmYzZmNDhhMTg3MyJ9.1JWq9ntjam20_XDlSbklWTxbV-vg-F_dY1LYVX05BndRAuaJbv3iSwoDY-BuMwe1sdKxDXtDTMWJgXNMff4nOg',
   'Content-Type': 'application/json'
}
conn.request("POST", "/finder/v2/api/group/inviteMember", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
仅展示部分功能代码 其余功能可以登录后台开发文档查看

开发流程与最佳实践

Step 1：注册WTAPI账号，获取API凭证
Step 2：选择开发语言，下载对应SDK
Step 3：搭建开发环境，配置执行节点
Step 4：实现核心功能，进行联调测试
Step 5：部署上线，监控运行状态

常见应用场景

  • 智能客服系统：7×24小时自动回复，提升服务效率

  • 私域营销工具：批量消息推送，精准客户触达

  • 社群管理助手：自动欢迎、广告过滤、关键词监控

  • 预警监控系统：敏感话题检测、异常情况告警

基于WTAPI框架开发微信机器人，无需深入研究复杂的iPad协议细节，只需专注于业务逻辑实现。完善的文档支持和多语言SDK，让开发者能够快速上手，5分钟即可搭建第一个微信自动回复机器人。

# 微信 # 网络协议 # 用户运营 # ipad
Logo
DAMO开发者矩阵

DAMO开发者矩阵，由阿里巴巴达摩院和中国互联网协会联合发起，致力于探讨最前沿的技术趋势与应用成果，搭建高质量的交流与分享平台，推动技术创新与产业应用链接，围绕“人工智能与新型计算”构建开放共享的开发者生态。

更多推荐

cover

微信API如何处理知识库冲突？WechatApi 让AI机器人避免同时引用两套矛盾答案

avatar DAMO开发者矩阵
cover

AI与大模型新闻日报 | 2026-09-27

avatar DAMO开发者矩阵
cover

Agent不是聊天机器人：企业该给模型多大自由？

avatar DAMO开发者矩阵