优先服务
微信 Webhook 机器人是基于 Web 协议实现的，用于研究和学习目的。该项目能够使用户通过HTTP服务运行一个微信机器人，支持消息的发送和接收。
特点
-
发送文字、图片、文件
-
接收文字、链接卡片、图片、视频、附件、语音
-
Webhook 接口
-
易于部署和使用
如何部署
部署的过程和方式非常简单，这里需要使用Docker快速部署微信机器人服务。
拉取镜像
首先我将需要的镜像拉取下来：
docker pull dannicool/docker-wechatbot-webhook创建我们的容器：
docker run \
-d \
--name wxBotWebhook \
-p 3001:3001 \
-e RECVD_MSG_API=http://192.168.31.100:8080/api \
-e DISABLE_AUTO_LOGIN=true
-e LOGIN_API_TOKEN=abc
-v ~/wxBot_logs:/app/log \
dannicool/docker-wechatbot-webhook环境变量解读：
-
RECVD_MSG_API：当机器人收到消息时会将将消息推送到此接口上。 -
DISABLE_AUTO_LOGIN：服务重启时自动登录微信号。 -
LOGIN_API_TOKEN：自定义登录 API token。
也可以使用compose部署：
version: '3.8'
services:
wxBotWebhook:
image: dannicool/docker-wechatbot-webhook
container_name: wxbot_app
volumes:
- ./wxBot_logs:/app/log
ports:
- "3001:3001"
environment:
- LOG_LEVEL=info # 调整容器输出级别（不影响日志文件输出等级）运行时提示的消息等级（默认info，debug级别会输出详细的日志)
# - DISABLE_AUTO_LOGIN=true # 如果不希望登录一次后就记住当前账号，想每次都扫码登陆，填 true
# - ACCEPT_RECVD_MSG_MYSELF=true # 如果希望机器人可以自己接收消息，填 true
# - RECVD_MSG_API= # 如果想自己处理收到消息的逻辑，在下面填上你的API地址, 默认为空
# - LOGIN_API_TOKEN= # 登录地址Token访问地址：http://localhost:3001/login?token=[LOCAL_LOGIN_API_TOKEN]
restart: unless-stopped登录机器人账号
服务部署成功时，通过访问：
https://localhost:3001/login?token=abc 此处的token参数即为你设定的LOGIN_API_TOKEN值，访问后可以看到一个二维码，使用微信扫码登录账号。
扫码登录后，再次访问该登录页面即可看到账号登录成功了。
发送消息
在成功登录微信账号后，如何给某个微信好友发送消息呢？wechatbot-webhook提供了一种以http协议的API接口，通过调用提供的api接口即可操控机器人给好友发送消息。
API接口地址：
http://your_server_ip:3001/webhook/msg/v2?token=[LOGIN_API_TOKEN]
发送文本消息
我们通过向API接口推送指定的消息结构即可完成消息的发送。
curl --location --request POST 'http://localhost:3001/webhook/msg/v2?token=[LOGIN_API_TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
"to": "好友昵称",
"data": {
"type": "text" ,
"content": "你好👋"
}
}'参数解析：
to：消息接收方，传入String 默认是发给昵称（群名同理）, 传入Object 结构支持发给备注过的人，比如：{alias: '备注名'}，群名不支持备注名。
type：消息类型, 字段留空或者为text解析为纯文本。也可以填写fileUrl表示发送此链接的文件给好友。
content：消息内容，如果希望发多个Url并解析，type 指定为 fileUrl 同时，content 里填 url 以英文逗号分隔。
还有一些其他的参数，例如：
isRoom：是否发给群消息（true/false），这个参数决定了找人的时候找的是群还是人（默认发送给人），因为昵称其实和群名相同在技术处理上。
发送消息到群组
curl --location 'http://localhost:3001/webhook/msg/v2?token=[LOGIN_API_TOKEN]' \
--header 'Content-Type: application/json' \
--data '{
"to": "群组名称",
"isRoom": true,
"data": {
"type": "text",
"content": "你好这是一条群组消息。"
}
}'多发消息
一次性发送多条消息到指定的好友：
curl --location 'http://localhost:3001/webhook/msg/v2?token=[LOGIN_API_TOKEN]' \
--header 'Content-Type: application/json' \
--data '{
"to": "好友昵称",
"data": [
{
"type": "text",
"content": "你好👋"
},
{
"type": "fileUrl",
"content": "https://samplelib.com/lib/preview/mp3/sample-3s.mp3"
}
]
}'群发消息
一次发送多条消息到多个人：
curl --location 'http://localhost:3001/webhook/msg/v2?token=[LOGIN_API_TOKEN]' \
--header 'Content-Type: application/json' \
--data '[
{
"to": "好友1",
"data": {
"content": "你好👋"
}
},
{
"to": "好友2",
"data": [
{
"content": "你好👋"
},
{
"content": "近况如何？"
}
]
}
]'发送文件
我们可以给好友发送指定的文件信息：
curl --location 'http://localhost:3001/webhook/msg/v2?token=[LOGIN_API_TOKEN]' \
--header 'Content-Type: application/json' \
--data '{
"to": "好友昵称",
"data": {
"type": "fileUrl" ,
"content": "https://download.samplelib.com/jpeg/sample-clouds-400x300.jpg?$alias=cloud.jpg"
}
}'其中的content对应的内容：
https://xxxx.jpg?$alias=cloud.jpg后面跟随的alias参数则代表发送的此文件自定义的名称，也可以不追加此参数。
消息是否发送成功
在我们调用消息推送的接口是，该接口会返回数据高知我们是否成功的发送了消息：
{
# 消息发送成功与否
"success": true,
# 出错时提示的消息
"message": "",
"task": {
# 发送成功条数
"successCount": 0,
# 总消息条数
"totalCount": 0,
# 发送失败条数
"failedCount": 0,
"reject": [],
"sentFailed": [],
# 因为未找到用户或者群和 error 提示
"notFound": []
}
}接收消息
学习完消息的发送，我们来看看如何接收来自群组以及好友的消息。
在容器部署的时候我们指定过一个环境变量RECVD_MSG_API。当机器人收到消息时会将消息主体以POST形式推送到该接口上。
消息结构
{
# 消息类型
"type": "text",
# 消息内容
"content": "你好",
# 消息发送方的数据
"source": "{}",
# 是否被艾特
"isMentioned": "0",
# 是否自己发送给自己的消息
"isMsgFromSelf": "0",
# 被遗弃的参数
"isSystemEvent": "0"
}消息类型对应的有：
功能类型：文字消息 text、链接卡片 urlLink、图片 视频 附件 语音 file、添加好友邀请 friendship。
系统类型：登录 system_event_login、登出 system_event_logout、异常报错 system_event_error、 快捷回复后消息推送状态通知 system_event_push_notify。
其他类型：未实现的消息类型 unknown。
处理收到的消息
如果在收到消息后，可以快速回复该消息。只需要给请求方响应对应的结构即可回复该好友的消息：
{
"success": true,
"data": {
"type": "text",
"content": "hello world！"
}
}此处的消息结构与主动发送给好友消息结构是一样的，只不过这里不添加isRoom参数。
写在末尾
由于该项目是一个webhook服务，所有的事件响应以及处理都是通过http协议来交互。使用有一定的门槛，需要自己开发一个Server服务端来接收并相应由机器人服务推送过来的消息。这里欢迎大家可以使用自己擅长的语言来针对此服务开发一个SDK，届时可以来我测试并宣传一波😊。
