# 新增客户群事件

> 创建客户群事件推送，当企业内部员工通过企业微信创建外部客户群时，会推送本事件。

**请求参数（未加密）**

| 请求参数名           | 类型     | 说明                                     |
| -------------------- | -------- | ---------------------------------------- |
| data                 | `Object` | 消息体                                   |
| data.id              | `String` | 事件id                                   |
| data.event           | `String` | 事件主类型（固定：MID_QW_CALLBACK）      |
| data.action          | `String` | 事件子类型（固定：CreateQwExternalChat） |
| data.body            | `Object` | 数据内容                                 |
| data.body.account    | `String` | 租户id                                   |
| data.body.chatID     | `String` | 群聊id                                   |
| data.body.createTime | `Int`    | 企微客户群事件产生时间戳                 |
| data.body.version    | `String` | 群事件版本号                             |
| data.body.triggerTs  | `Int`    | 触发时间戳                               |

**请求参数示例**
`json` - Request-Example-加密:

```json
//明文信息推送
{
	"id": "4c6421ea-f503-4a89-ba5b-7c9524cf596f",
	"event": "MID_QW_CALLBACK",
	"action": "CreateQwExternalChat",
	"body": {
		"account": "W00000000516",
		"chatID": "wr6mJICgAAGwT55drBN9Qc8MC1hZBB_A",
		"createTime": 1703154690,
		"version": "v1"
	}
}

//信息加密推送
{
	"id": "4c6421ea-f503-4a89-ba5b-7c9524cf596f",
	"event": "MID_QW_CALLBACK",
	"action": "CreateQwExternalChat",
	"body": {
		"encrypt": "XOKphmyMEcuW94gYtL/5Nj4ueFcfjaEFecC507QGzXbnDmavLp7I+s7K5BI4Qjt+Ayy/mNbw9bUE2x0HkSWm9h57VKJc9VLBghTjALWJcJduBDC7L6doORsZdaNlfVJU6DJ0VLyd1NojW9PfrzS01eQ7GW/dgaO3tkXQP2AOrGTn3Ca8haZQiwEJDYN/NUjW1/9T+gIcBu8LbmZGyokwrOD+ZGy7uky37yq8w8SGpis1WR2pIlZUOo+QdmWnMY1kJ9bHelH9h3ERemmNRIh/oMZp7QvFaNl/iCgUVAkh14tOV0nniE9Ld29GxyIEFz0nxD5+s4AG4cvq+xl+FXhu0A==",
		"msgSignature": "d64cc4a02b22b725a6b50a9843ebf9c0fd7ca70f",
		"timeStamp": "1661233174",
		"nonce": "9ZvYhI4aFmR7wUNl"
	}
}
```

**成功响应**

| 响应参数名 | 类型     | 说明                         |
| ---------- | -------- | ---------------------------- |
| code       | `Int`    | 响应码:状态码 0 失败，1 成功 |
| msg        | `String` | 响应提示                     |

**成功响应示例**

```json
 {
    "code": 1,
    "msg": "成功"
}
```

**错误响应示例**

```json
 {
    "code": 0,
    "msg": "处理失败"
}
```