@juzi/wechaty-grpc 1.0.100 → 1.0.102

package/dist/cjs/out/wechaty/puppet.swagger.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "Wechaty Puppet Service OpenAPI Specification",
     "description": "Wechaty is a Conversational RPA SDK for chatbot makers. With only 6 lines of code, you can create a bot on the most popular IMs like WeChat, Whatsapp, WeCom, Gitter, etc.\n\nWechaty Puppet Service is the RESTful API for Wechaty API, which is build on top of the Wechaty Puppet Abstraction and the gRPC proto definition.",
-    "version": "1.0.100",
+    "version": "1.0.102",
     "contact": {
       "name": "Wechaty",
       "url": "https://github.com/wechaty/openapi",
@@ -26,6 +26,304 @@
     "application/json"
   ],
   "paths": {
+    "/call/invite": {
+      "post": {
+        "operationId": "Puppet_CallInvite",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetCallInviteResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/puppetCallInviteRequest"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/call/{callId}/accept": {
+      "post": {
+        "operationId": "Puppet_CallAccept",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetCallAcceptResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "callId",
+            "description": "由 CallInvite 响应获得；协议端持有会话状态，凭此即可定位会话（无需 peer/media）",
+            "in": "path",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/PuppetCallAcceptBody"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/call/{callId}/add": {
+      "post": {
+        "operationId": "Puppet_CallAdd",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetCallAddResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "callId",
+            "description": "由 CallInvite 响应获得",
+            "in": "path",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/PuppetCallAddBody"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/call/{callId}/cancel": {
+      "post": {
+        "operationId": "Puppet_CallCancel",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetCallCancelResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "callId",
+            "description": "由 CallInvite 响应获得；协议端持有会话状态，凭此即可定位会话（无需 peer/media）",
+            "in": "path",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/PuppetCallCancelBody"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/call/{callId}/hangup": {
+      "post": {
+        "operationId": "Puppet_CallHangup",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetCallHangupResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "callId",
+            "description": "由 CallInvite 响应获得；协议端持有会话状态，凭此即可定位会话（无需 peer/media）",
+            "in": "path",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/PuppetCallHangupBody"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/call/{callId}/media-endpoint": {
+      "post": {
+        "summary": "POST：签发可能在网关侧预分配媒体会话（有副作用），非幂等读取。",
+        "operationId": "Puppet_CallMediaEndpoint",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetCallMediaEndpointResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "callId",
+            "description": "由 CallInvite 响应获得",
+            "in": "path",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/PuppetCallMediaEndpointBody"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/call/{callId}/reject": {
+      "post": {
+        "operationId": "Puppet_CallReject",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetCallRejectResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "callId",
+            "description": "由 CallInvite 响应获得；协议端持有会话状态，凭此即可定位会话（无需 peer/media）",
+            "in": "path",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/PuppetCallRejectBody"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/call/{id}": {
+      "get": {
+        "operationId": "Puppet_CallPayload",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetCallPayloadResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "id",
+            "description": "call_id",
+            "in": "path",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
     "/cancel_verify_code": {
       "post": {
         "operationId": "Puppet_CancelVerifyCode",
@@ -658,7 +956,10 @@
               "PAYLOAD_TYPE_FRIENDSHIP",
               "PAYLOAD_TYPE_POST",
               "PAYLOAD_TYPE_TAG",
-              "PAYLOAD_TYPE_TAG_GROUP"
+              "PAYLOAD_TYPE_TAG_GROUP",
+              "PAYLOAD_TYPE_WXXD_PRODUCT",
+              "PAYLOAD_TYPE_WXXD_ORDER",
+              "PAYLOAD_TYPE_CALL"
             ],
             "pattern": "PAYLOAD_TYPE_CONTACT"
           }
@@ -1103,9 +1404,297 @@
         ]
       }
     },
-    "/currentUser": {
-      "get": {
-        "operationId": "Puppet_CurrentUser",
+    "/conversations:batchForward": {
+      "post": {
+        "operationId": "Puppet_MessageBatchForward",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchForwardResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchForwardRequest"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/conversations:batchSendChannel": {
+      "post": {
+        "operationId": "Puppet_MessageBatchSendChannel",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendChannelResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendChannelRequest"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/conversations:batchSendChannelCard": {
+      "post": {
+        "operationId": "Puppet_MessageBatchSendChannelCard",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendChannelCardResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendChannelCardRequest"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/conversations:batchSendContact": {
+      "post": {
+        "operationId": "Puppet_MessageBatchSendContact",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendContactResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendContactRequest"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/conversations:batchSendFile": {
+      "post": {
+        "operationId": "Puppet_MessageBatchSendFile",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendFileResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendFileRequest"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/conversations:batchSendLocation": {
+      "post": {
+        "operationId": "Puppet_MessageBatchSendLocation",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendLocationResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendLocationRequest"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/conversations:batchSendMiniProgram": {
+      "post": {
+        "operationId": "Puppet_MessageBatchSendMiniProgram",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendMiniProgramResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendMiniProgramRequest"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/conversations:batchSendText": {
+      "post": {
+        "operationId": "Puppet_MessageBatchSendText",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendTextResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendTextRequest"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/conversations:batchSendUrl": {
+      "post": {
+        "operationId": "Puppet_MessageBatchSendUrl",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendUrlResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/puppetMessageBatchSendUrlRequest"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/currentUser": {
+      "get": {
+        "operationId": "Puppet_CurrentUser",
         "responses": {
           "200": {
             "description": "A successful response.",
@@ -1525,7 +2114,10 @@
               "PAYLOAD_TYPE_FRIENDSHIP",
               "PAYLOAD_TYPE_POST",
               "PAYLOAD_TYPE_TAG",
-              "PAYLOAD_TYPE_TAG_GROUP"
+              "PAYLOAD_TYPE_TAG_GROUP",
+              "PAYLOAD_TYPE_WXXD_PRODUCT",
+              "PAYLOAD_TYPE_WXXD_ORDER",
+              "PAYLOAD_TYPE_CALL"
             ],
             "pattern": "PAYLOAD_TYPE_FRIENDSHIP"
           }
@@ -1859,7 +2451,10 @@
               "PAYLOAD_TYPE_FRIENDSHIP",
               "PAYLOAD_TYPE_POST",
               "PAYLOAD_TYPE_TAG",
-              "PAYLOAD_TYPE_TAG_GROUP"
+              "PAYLOAD_TYPE_TAG_GROUP",
+              "PAYLOAD_TYPE_WXXD_PRODUCT",
+              "PAYLOAD_TYPE_WXXD_ORDER",
+              "PAYLOAD_TYPE_CALL"
             ],
             "pattern": "PAYLOAD_TYPE_MESSAGE"
           }
@@ -2972,7 +3567,10 @@
               "PAYLOAD_TYPE_FRIENDSHIP",
               "PAYLOAD_TYPE_POST",
               "PAYLOAD_TYPE_TAG",
-              "PAYLOAD_TYPE_TAG_GROUP"
+              "PAYLOAD_TYPE_TAG_GROUP",
+              "PAYLOAD_TYPE_WXXD_PRODUCT",
+              "PAYLOAD_TYPE_WXXD_ORDER",
+              "PAYLOAD_TYPE_CALL"
             ],
             "pattern": "PAYLOAD_TYPE_ROOM_MEMBER"
           }
@@ -3020,7 +3618,10 @@
               "PAYLOAD_TYPE_FRIENDSHIP",
               "PAYLOAD_TYPE_POST",
               "PAYLOAD_TYPE_TAG",
-              "PAYLOAD_TYPE_TAG_GROUP"
+              "PAYLOAD_TYPE_TAG_GROUP",
+              "PAYLOAD_TYPE_WXXD_PRODUCT",
+              "PAYLOAD_TYPE_WXXD_ORDER",
+              "PAYLOAD_TYPE_CALL"
             ],
             "pattern": "PAYLOAD_TYPE_ROOM"
           }
@@ -4203,7 +4804,52 @@
         }
       }
     },
-    "PuppetContactAliasBody": {
+    "PuppetCallAcceptBody": {
+      "type": "object",
+      "title": "被叫接听来电。"
+    },
+    "PuppetCallAddBody": {
+      "type": "object",
+      "properties": {
+        "contactIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "title": "新增受邀方 contactId 列表（不含已在通话中的参与者）"
+        }
+      },
+      "title": "通话中途拉人（errors-only 契约）：\n- 新参与者的应答回执（响铃/接听/拒接）一律经 EVENT_TYPE_CALL 事件上行，本响应恒为空；\n- 拉人特有的失败（通话不存在/已结束、人数上限等）经 gRPC status error 返回。"
+    },
+    "PuppetCallCancelBody": {
+      "type": "object",
+      "title": "接通前主叫取消呼叫。"
+    },
+    "PuppetCallHangupBody": {
+      "type": "object",
+      "properties": {
+        "reason": {
+          "type": "string",
+          "title": "可空，空串表示无"
+        }
+      },
+      "title": "接通后任一方挂断。"
+    },
+    "PuppetCallMediaEndpointBody": {
+      "type": "object",
+      "title": "媒体入场券：按 call_id 向协议端换取媒体网关协商入口。\n签发可能在网关侧预分配媒体会话（有副作用），故服务端不得缓存响应、客户端按需拉取。"
+    },
+    "PuppetCallRejectBody": {
+      "type": "object",
+      "properties": {
+        "reason": {
+          "type": "string",
+          "title": "可空，空串表示无"
+        }
+      },
+      "title": "被叫拒接来电。"
+    },
+    "PuppetContactAliasBody": {
       "type": "object",
       "properties": {
         "aliasStringValueDeprecated": {
@@ -4575,6 +5221,99 @@
       ],
       "default": "BROADCAST_TARGET_STATUS_UNSENT"
     },
+    "puppetCallAcceptResponse": {
+      "type": "object"
+    },
+    "puppetCallAddResponse": {
+      "type": "object"
+    },
+    "puppetCallCancelResponse": {
+      "type": "object"
+    },
+    "puppetCallHangupResponse": {
+      "type": "object"
+    },
+    "puppetCallInviteRequest": {
+      "type": "object",
+      "properties": {
+        "contactIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "title": "受邀方 contactId 列表（不含发起方）：单元素 = 1v1 通话，多元素 = 群通话；\n无论几人，一通通话只铸造一个 call_id。"
+        },
+        "media": {
+          "$ref": "#/definitions/puppetCallType",
+          "title": "必填：媒体类型（VOICE/VIDEO），复用既有 CallType；零值 CALL_TYPE_UNKNOWN 会被 server 拒绝"
+        }
+      },
+      "title": "发起呼叫请求：callId 不由主叫携带，而是由 puppet 实现侧生成并经 CallInviteResponse 返回。"
+    },
+    "puppetCallInviteResponse": {
+      "type": "object",
+      "properties": {
+        "callId": {
+          "type": "string"
+        }
+      },
+      "title": "CallInvite 响应：\n- call_id 由 puppet 实现侧（协议端）生成并经本响应返回，全链路以此关联控制面与媒体旁路；\n- 上行 EVENT_TYPE_CALL 事件可能先于本响应到达，客户端须容忍乱序；\n- 后续控制 RPC（CallAccept/CallReject/CallCancel/CallHangup）凭此 call_id 引用本通通话。"
+    },
+    "puppetCallMediaEndpointResponse": {
+      "type": "object",
+      "properties": {
+        "url": {
+          "type": "string",
+          "title": "媒体网关协商入口（非媒体流地址本身）"
+        },
+        "token": {
+          "type": "string",
+          "title": "短时效凭证，绑定 call_id + 本端身份"
+        },
+        "expiresAt": {
+          "type": "string",
+          "format": "date-time",
+          "title": "凭证过期时刻；不设置 = 不过期；过期后重新拉取本 RPC"
+        },
+        "protocol": {
+          "type": "string",
+          "title": "入口方言（如 whip / livekit / 自定义），由媒体 SDK 消费"
+        }
+      }
+    },
+    "puppetCallPayloadResponse": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "starter": {
+          "type": "string",
+          "title": "发起方 contactId；空串 = 协议端不可知（如中途被拉入者视角）"
+        },
+        "participants": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "title": "当前全量参与者名册"
+        },
+        "media": {
+          "$ref": "#/definitions/puppetCallType",
+          "title": "当前媒体类型（语音↔视频切换经 dirty 反映）"
+        },
+        "startTime": {
+          "type": "string",
+          "format": "date-time",
+          "title": "通话发起时刻；接通时刻不在此（等于上行 Accept 事件的 timestamp）"
+        },
+        "endTime": {
+          "type": "string",
+          "format": "date-time",
+          "title": "通话结束时刻；未设置 = 通话进行中"
+        }
+      }
+    },
     "puppetCallRecordPayload": {
       "type": "object",
       "properties": {
@@ -4599,6 +5338,9 @@
         }
       }
     },
+    "puppetCallRejectResponse": {
+      "type": "object"
+    },
     "puppetCallStatus": {
       "type": "string",
       "enum": [
@@ -4610,7 +5352,7 @@
         "CALL_STATUS_ENDED"
       ],
       "default": "CALL_STATUS_UNKNOWN",
-      "description": "- CALL_STATUS_UNKNOWN: 不明确\n - CALL_STATUS_CANCELED: 自己取消\n - CALL_STATUS_REJECTED: 对方拒接\n - CALL_STATUS_MISSED: 正在通话\n - CALL_STATUS_ONGOING: 正在通话\n - CALL_STATUS_ENDED: 已结束",
+      "description": "- CALL_STATUS_UNKNOWN: 不明确\n - CALL_STATUS_CANCELED: 自己取消\n - CALL_STATUS_REJECTED: 对方拒接\n - CALL_STATUS_MISSED: 未接\n - CALL_STATUS_ONGOING: 正在通话\n - CALL_STATUS_ENDED: 已结束",
       "title": "类型枚举"
     },
     "puppetCallType": {
@@ -5149,7 +5891,8 @@
         "EVENT_TYPE_POST_TAP",
         "EVENT_TYPE_ROOM_ANNOUNCE",
         "EVENT_TYPE_VERIFY_CODE",
-        "EVENT_TYPE_VERIFY_SLIDE"
+        "EVENT_TYPE_VERIFY_SLIDE",
+        "EVENT_TYPE_CALL"
       ],
       "default": "EVENT_TYPE_UNSPECIFIED"
     },
@@ -5397,6 +6140,399 @@
     "puppetLogoutResponse": {
       "type": "object"
     },
+    "puppetMessageBatchForwardRequest": {
+      "type": "object",
+      "properties": {
+        "conversationIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "messageId": {
+          "type": "string"
+        },
+        "messageIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "batchTaskId": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchForwardResponse": {
+      "type": "object",
+      "properties": {
+        "results": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/puppetMessageBatchForwardResponseResult"
+          }
+        }
+      }
+    },
+    "puppetMessageBatchForwardResponseResult": {
+      "type": "object",
+      "properties": {
+        "conversationId": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendChannelCardRequest": {
+      "type": "object",
+      "properties": {
+        "conversationIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "channelCard": {
+          "$ref": "#/definitions/puppetChannelCardPayload"
+        },
+        "batchTaskId": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendChannelCardResponse": {
+      "type": "object",
+      "properties": {
+        "results": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/puppetMessageBatchSendChannelCardResponseResult"
+          }
+        }
+      }
+    },
+    "puppetMessageBatchSendChannelCardResponseResult": {
+      "type": "object",
+      "properties": {
+        "conversationId": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendChannelRequest": {
+      "type": "object",
+      "properties": {
+        "conversationIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "channel": {
+          "$ref": "#/definitions/puppetChannelPayload"
+        },
+        "batchTaskId": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendChannelResponse": {
+      "type": "object",
+      "properties": {
+        "results": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/puppetMessageBatchSendChannelResponseResult"
+          }
+        }
+      }
+    },
+    "puppetMessageBatchSendChannelResponseResult": {
+      "type": "object",
+      "properties": {
+        "conversationId": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendContactRequest": {
+      "type": "object",
+      "properties": {
+        "conversationIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "contactId": {
+          "type": "string"
+        },
+        "batchTaskId": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendContactResponse": {
+      "type": "object",
+      "properties": {
+        "results": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/puppetMessageBatchSendContactResponseResult"
+          }
+        }
+      }
+    },
+    "puppetMessageBatchSendContactResponseResult": {
+      "type": "object",
+      "properties": {
+        "conversationId": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendFileRequest": {
+      "type": "object",
+      "properties": {
+        "conversationIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "fileBox": {
+          "type": "string"
+        },
+        "batchTaskId": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendFileResponse": {
+      "type": "object",
+      "properties": {
+        "results": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/puppetMessageBatchSendFileResponseResult"
+          }
+        }
+      }
+    },
+    "puppetMessageBatchSendFileResponseResult": {
+      "type": "object",
+      "properties": {
+        "conversationId": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendLocationRequest": {
+      "type": "object",
+      "properties": {
+        "conversationIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "location": {
+          "$ref": "#/definitions/puppetLocationPayload"
+        },
+        "batchTaskId": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendLocationResponse": {
+      "type": "object",
+      "properties": {
+        "results": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/puppetMessageBatchSendLocationResponseResult"
+          }
+        }
+      }
+    },
+    "puppetMessageBatchSendLocationResponseResult": {
+      "type": "object",
+      "properties": {
+        "conversationId": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendMiniProgramRequest": {
+      "type": "object",
+      "properties": {
+        "conversationIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "miniProgram": {
+          "$ref": "#/definitions/puppetMiniProgramPayload"
+        },
+        "batchTaskId": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendMiniProgramResponse": {
+      "type": "object",
+      "properties": {
+        "results": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/puppetMessageBatchSendMiniProgramResponseResult"
+          }
+        }
+      }
+    },
+    "puppetMessageBatchSendMiniProgramResponseResult": {
+      "type": "object",
+      "properties": {
+        "conversationId": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendTextRequest": {
+      "type": "object",
+      "properties": {
+        "conversationIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "text": {
+          "type": "string"
+        },
+        "batchTaskId": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendTextResponse": {
+      "type": "object",
+      "properties": {
+        "results": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/puppetMessageBatchSendTextResponseResult"
+          }
+        }
+      }
+    },
+    "puppetMessageBatchSendTextResponseResult": {
+      "type": "object",
+      "properties": {
+        "conversationId": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendUrlRequest": {
+      "type": "object",
+      "properties": {
+        "conversationIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "urlLink": {
+          "$ref": "#/definitions/puppetUrlLinkPayload"
+        },
+        "batchTaskId": {
+          "type": "string"
+        }
+      }
+    },
+    "puppetMessageBatchSendUrlResponse": {
+      "type": "object",
+      "properties": {
+        "results": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/puppetMessageBatchSendUrlResponseResult"
+          }
+        }
+      }
+    },
+    "puppetMessageBatchSendUrlResponseResult": {
+      "type": "object",
+      "properties": {
+        "conversationId": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      }
+    },
     "puppetMessageCallRecordResponse": {
       "type": "object",
       "properties": {
@@ -5867,9 +7003,13 @@
         "PAYLOAD_TYPE_FRIENDSHIP",
         "PAYLOAD_TYPE_POST",
         "PAYLOAD_TYPE_TAG",
-        "PAYLOAD_TYPE_TAG_GROUP"
+        "PAYLOAD_TYPE_TAG_GROUP",
+        "PAYLOAD_TYPE_WXXD_PRODUCT",
+        "PAYLOAD_TYPE_WXXD_ORDER",
+        "PAYLOAD_TYPE_CALL"
       ],
-      "default": "PAYLOAD_TYPE_UNSPECIFIED"
+      "default": "PAYLOAD_TYPE_UNSPECIFIED",
+      "title": "数值必须与 @juzi/wechaty-puppet 的 DirtyType 严格一致。"
     },
     "puppetPostPayloadClient": {
       "type": "object",
@@ -6563,7 +7703,7 @@
       "type": "object",
       "properties": {
         "payload": {
-          "$ref": "#/definitions/wechatypuppetTagGroupPayload"
+          "$ref": "#/definitions/wechatyPuppetTagGroupPayload"
         }
       }
     },
@@ -6590,7 +7730,7 @@
       "type": "object",
       "properties": {
         "payload": {
-          "$ref": "#/definitions/wechatypuppetTagPayload"
+          "$ref": "#/definitions/wechatyPuppetTagPayload"
         }
       }
     },
@@ -6825,7 +7965,7 @@
         }
       }
     },
-    "wechatypuppetTagGroupPayload": {
+    "wechatyPuppetTagGroupPayload": {
       "type": "object",
       "properties": {
         "id": {
@@ -6839,7 +7979,7 @@
         }
       }
     },
-    "wechatypuppetTagPayload": {
+    "wechatyPuppetTagPayload": {
       "type": "object",
       "properties": {
         "id": {