机器人支持回调接口配置（详细教程）

大家伙，我是雄雄，欢迎关注微信公众号：雄雄的小课堂。

一、前言

今天，给大家介绍一下，如何在机器人中配置回调地址和接口编写。很多时候我们可能有这样的场景，收到消息后，想自己处理一下消息的内容，然后操作完后给用户返回出去，那么，这种场景下，就离不开接口的回调了。

目前支持的回调：

收到消息
撤回消息
注入成功
登录成功
进群
退群
通过好友申请
转账退款
转账收款
…其他的还在开发中

二、开发回调接口

我这边以python为例，因为回调接口我们需要接收一个json格式的数据，所以，先创建个类，如下所示：


from fastapi import FastAPI, HTTPException
from pydantic import BaseModel
from typing import Optional, List
from fastapi import APIRouterapp = FastAPI()huidiao_router = APIRouter()# 消息实体
class CallBackDataEntity(BaseModel):wxid: Optional[str] = None  # wxidwxNum: Optional[str] = None  # 微信号nick: Optional[str] = None  # 昵称device: Optional[str] = None  # 登录设备phone: Optional[str] = None  # 电话avatarUrl: Optional[str] = None  # 头像country: Optional[str] = None  # 国家province: Optional[str] = None  # 省city: Optional[str] = None  # 城市email: Optional[str] = None  # 邮箱qq: Optional[str] = None  # QQtimeStamp: Optional[int] = None # 时间戳fromType: Optional[int] = None # 来源类型：1|私聊 2|群聊 3|公众号# 消息类型：1|文本 3|图片 34|语音 42|名片 43|视频 47|动态表情# 48|地理位置 49|分享链接或附件 2001|红包 2002|小程序# 2003|群邀请 10000|系统消息# 60 撤回消息  61 登录成功  62退群 63 进群 64通过好友申请 65注入成功 66转账msgType: Optional[int] = NonemsgSource: Optional[int] = None # 消息来源：0|别人发送 1|自己手机发送fromWxid: Optional[str] = None # fromType=1时为好友wxid，fromType=2时为群wxid，fromType=3时公众号wxidfromNick: Optional[str] = None # fromType=1时为好友wxid，fromType=2时为群昵称，fromType=3时公众号昵称finalFromWxid: Optional[str] = None  # 仅fromType=2时有效，为群内发言人wxidfinalFromNick: Optional[str] = None  # 仅fromType=2时有效，为群内发言人昵称atWxidList: Optional[list] = None  # 仅fromType=2，且msgSource=0时有效，为消息中艾特人wxid列表silence: Optional[int] = None # 仅fromType=2时有效，0membercount: Optional[int]= None  # 仅fromType=2时有效，群成员数量signature: Optional[str] = None# 消息内容msg: Optional[str]= None# 性别sex: Optional[str]= None# 创建get方法def get(self, param):return getattr(self, param)

接下来就比较简单了，写个接口，接收一下消息就行。


# 回调接口信息处理
@huidiao_router.post("/receive_message_callback")
async def receive_message(data: CallBackDataEntity):# 将收到的消息转换成jsondata = data.dict()print(f"接收到了回调消息，内容是：{data}")# 这里可以添加你的业务逻辑return {"message": "success"}

可以从实体中看到，我们将所有关键信息都已经传递到回调接口中，剩下的实现就得看自己的了。

收到消息的json:


{"atWxidList": [],"finalFromNick": "雄雄的小课堂","finalFromWxid": "wxid_ehfdz38cq3bt22","fromNick": "雄雄的大家庭","fromType": 2,"fromWxid": "47747688531@chatroom","membercount": 4,"msg": "哈哈","msgSource": 0,"msgType": 1,"signature": "V1_HbNcDfZr|v1_HbNcDfZr","silence": 0,"timeStamp": "1716713595"
}