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

## 如何解析回调通知事件？

---

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

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

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

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

---

### 事件类型：

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

这里给出一种解决方案：

```csharp
string msgType = eventModel = client.DeserializeEventFromXml(webhookXml).MessageType?.ToUpper();
switch (msgType)
{
    case "TEXT":
        {
            var webhookModel = client.DeserializeEventFromXml<Events.TextMessageEvent>(webhookXml);
        }
        break;
    // 其他情况略
}
```

---

### 安全模式：

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

上文提到的扩展方法，已自动做解密处理，无需开发者手动干预。

为此，你需要在构造得到 `WechatWorkClient` 对象时指定推送参数：

```csharp
var options = new WechatWorkClientOptions()
{
    // 其他配置项略
    PushToken = "Token",
    PushEncodingAESKey = "EncodingAESKey"
};
var client = WechatWorkClientBuilder.Create(options).Build();
```

---

### 被动回复：

当用户发送消息给企业微信应用、或某些特定的用户操作引发的事件推送时，开发者可以在响应中返回特定 XML 结构，来对该消息进行响应。

本库还封装了直接序列化被动回复事件的扩展方法，下面给出一个示例代码：

```csharp
/* 以被动回复文本消息为例 */
var replyModel = new Events.TextMessageReply()
{
    ToUserName = "接收方 OpenId",
    FromUserName = "开发者 GhId",
    MessageType = "text",
    Content = "被动回复的文本内容",
    CreateTimestamp = 1234567890
};
string replyXml = client.SerializeEventToXml(replyModel);
```

完整的被动回复模型定义可以参考项目目录下的 _src/SKIT.FlurlHttpClient.Wechat.Work/Events/Reply_ 目录。