DotNetCore.SKIT.FlurlHttpClient.Wechat/docs/WechatWork/Advanced_EventDataDeserialization.md

如何解析回调通知事件？

---

对于企业微信推送过来的回调通知事件，本库封装了直接解析成事件模型的扩展方法，下面给出一个示例：

/* 如果是 JSON 格式的通知内容，以 add_schedule 事件为例 */
string callbackJson = "{ ... }";
var callbackModel = client.DeserializeEventFromJson<Events.AddScheduleEvent>(callbackJson);

/* 如果是 XML 格式的通知内容，以 text 事件为例 */
string callbackXml = "<xml> ... </xml>";
var callbackModel = client.DeserializeEventFromXml<Events.TextMessageEvent>(callbackXml);

完整的回调通知模型定义可以参考项目目录下的 src/SKIT.FlurlHttpClient.Wechat.Work/Events 目录。

---

事件类型：

由于企业微信会将全部事件推送到同一个回调通知地址上，开发者需要根据事件类型才能决定如何反序列化。

这里给出一种解决方案：

WechatApiEvent eventModel = client.DeserializeEventFromXml(callbackXml);
string msgType = eventModel.MessageType?.ToUpper();

switch (msgType)
{
    case "TEXT":
        {
            var callbackModel = client.DeserializeEventFromXml<Events.TextMessageEvent>(callbackXml);
        }
        break;
    // 省略其他情况
}

---

安全模式：

与微信公众号不同的是，企业微信默认启用了安全模式，且不支持切换至明文模式。

开发者可利用本库提供的 WxBizMsgCryptor 工具类自行解密相关字段。

上文提到的扩展方法，已自动做解密处理。