@juzi/wechaty-grpc 1.0.100 → 1.0.102

package/dist/cjs/out/wechaty/puppet.openapi.yaml

@@ -9,7 +9,7 @@ info:
 
     Wechaty 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
@@ -24,6 +24,197 @@ consumes:
 produces:
   - 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
@@ -437,6 +628,9 @@ paths:
             - PAYLOAD_TYPE_POST
             - PAYLOAD_TYPE_TAG
             - PAYLOAD_TYPE_TAG_GROUP
+            - PAYLOAD_TYPE_WXXD_PRODUCT
+            - PAYLOAD_TYPE_WXXD_ORDER
+            - PAYLOAD_TYPE_CALL
           pattern: PAYLOAD_TYPE_CONTACT
       tags:
         - Puppet
@@ -669,57 +863,237 @@ paths:
           in: body
           required: true
           schema:
-            $ref: '#/definitions/PuppetMessageSendPostBody'
+            $ref: '#/definitions/PuppetMessageSendPostBody'
+      tags:
+        - Puppet
+  /conversations/{conversationId}/text:
+    post:
+      operationId: Puppet_MessageSendText
+      responses:
+        '200':
+          description: A successful response.
+          schema:
+            $ref: '#/definitions/puppetMessageSendTextResponse'
+        default:
+          description: An unexpected error response.
+          schema:
+            $ref: '#/definitions/rpcStatus'
+      parameters:
+        - name: conversationId
+          description: 对话id
+          in: path
+          required: true
+          type: string
+        - name: body
+          in: body
+          required: true
+          schema:
+            $ref: '#/definitions/PuppetMessageSendTextBody'
+      tags:
+        - Puppet
+  /conversations/{conversationId}/url-link:
+    post:
+      operationId: Puppet_MessageSendUrl
+      responses:
+        '200':
+          description: A successful response.
+          schema:
+            $ref: '#/definitions/puppetMessageSendUrlResponse'
+        default:
+          description: An unexpected error response.
+          schema:
+            $ref: '#/definitions/rpcStatus'
+      parameters:
+        - name: conversationId
+          description: 对话id
+          in: path
+          required: true
+          type: string
+        - name: body
+          in: body
+          required: true
+          schema:
+            $ref: '#/definitions/PuppetMessageSendUrlBody'
+      tags:
+        - Puppet
+  /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/{conversationId}/text:
+  /conversations:batchSendText:
     post:
-      operationId: Puppet_MessageSendText
+      operationId: Puppet_MessageBatchSendText
       responses:
         '200':
           description: A successful response.
           schema:
-            $ref: '#/definitions/puppetMessageSendTextResponse'
+            $ref: '#/definitions/puppetMessageBatchSendTextResponse'
         default:
           description: An unexpected error response.
           schema:
             $ref: '#/definitions/rpcStatus'
       parameters:
-        - name: conversationId
-          description: 对话id
-          in: path
-          required: true
-          type: string
         - name: body
           in: body
           required: true
           schema:
-            $ref: '#/definitions/PuppetMessageSendTextBody'
+            $ref: '#/definitions/puppetMessageBatchSendTextRequest'
       tags:
         - Puppet
-  /conversations/{conversationId}/url-link:
+  /conversations:batchSendUrl:
     post:
-      operationId: Puppet_MessageSendUrl
+      operationId: Puppet_MessageBatchSendUrl
       responses:
         '200':
           description: A successful response.
           schema:
-            $ref: '#/definitions/puppetMessageSendUrlResponse'
+            $ref: '#/definitions/puppetMessageBatchSendUrlResponse'
         default:
           description: An unexpected error response.
           schema:
             $ref: '#/definitions/rpcStatus'
       parameters:
-        - name: conversationId
-          description: 对话id
-          in: path
-          required: true
-          type: string
         - name: body
           in: body
           required: true
           schema:
-            $ref: '#/definitions/PuppetMessageSendUrlBody'
+            $ref: '#/definitions/puppetMessageBatchSendUrlRequest'
       tags:
         - Puppet
   /currentUser:
@@ -1036,6 +1410,9 @@ paths:
             - PAYLOAD_TYPE_POST
             - PAYLOAD_TYPE_TAG
             - PAYLOAD_TYPE_TAG_GROUP
+            - PAYLOAD_TYPE_WXXD_PRODUCT
+            - PAYLOAD_TYPE_WXXD_ORDER
+            - PAYLOAD_TYPE_CALL
           pattern: PAYLOAD_TYPE_FRIENDSHIP
       tags:
         - Puppet
@@ -1251,6 +1628,9 @@ paths:
             - PAYLOAD_TYPE_POST
             - PAYLOAD_TYPE_TAG
             - PAYLOAD_TYPE_TAG_GROUP
+            - PAYLOAD_TYPE_WXXD_PRODUCT
+            - PAYLOAD_TYPE_WXXD_ORDER
+            - PAYLOAD_TYPE_CALL
           pattern: PAYLOAD_TYPE_MESSAGE
       tags:
         - Puppet
@@ -1984,6 +2364,9 @@ paths:
             - PAYLOAD_TYPE_POST
             - PAYLOAD_TYPE_TAG
             - PAYLOAD_TYPE_TAG_GROUP
+            - PAYLOAD_TYPE_WXXD_PRODUCT
+            - PAYLOAD_TYPE_WXXD_ORDER
+            - PAYLOAD_TYPE_CALL
           pattern: PAYLOAD_TYPE_ROOM_MEMBER
       tags:
         - Puppet
@@ -2018,6 +2401,9 @@ paths:
             - PAYLOAD_TYPE_POST
             - PAYLOAD_TYPE_TAG
             - PAYLOAD_TYPE_TAG_GROUP
+            - PAYLOAD_TYPE_WXXD_PRODUCT
+            - PAYLOAD_TYPE_WXXD_ORDER
+            - PAYLOAD_TYPE_CALL
           pattern: PAYLOAD_TYPE_ROOM
       tags:
         - Puppet
@@ -2788,6 +3174,43 @@ definitions:
         type: array
         items:
           type: string
+  PuppetCallAcceptBody:
+    type: object
+    title: 被叫接听来电。
+  PuppetCallAddBody:
+    type: object
+    properties:
+      contactIds:
+        type: array
+        items:
+          type: string
+        title: 新增受邀方 contactId 列表（不含已在通话中的参与者）
+    title: |-
+      通话中途拉人（errors-only 契约）：
+      - 新参与者的应答回执（响铃/接听/拒接）一律经 EVENT_TYPE_CALL 事件上行，本响应恒为空；
+      - 拉人特有的失败（通话不存在/已结束、人数上限等）经 gRPC status error 返回。
+  PuppetCallCancelBody:
+    type: object
+    title: 接通前主叫取消呼叫。
+  PuppetCallHangupBody:
+    type: object
+    properties:
+      reason:
+        type: string
+        title: 可空，空串表示无
+    title: 接通后任一方挂断。
+  PuppetCallMediaEndpointBody:
+    type: object
+    title: |-
+      媒体入场券：按 call_id 向协议端换取媒体网关协商入口。
+      签发可能在网关侧预分配媒体会话（有副作用），故服务端不得缓存响应、客户端按需拉取。
+  PuppetCallRejectBody:
+    type: object
+    properties:
+      reason:
+        type: string
+        title: 可空，空串表示无
+    title: 被叫拒接来电。
   PuppetContactAliasBody:
     type: object
     properties:
@@ -3059,6 +3482,78 @@ definitions:
       - BROADCAST_TARGET_STATUS_NOT_FRIEND
       - BROADCAST_TARGET_STATUS_OCCUPIED
     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 通话，多元素 = 群通话；
+          无论几人，一通通话只铸造一个 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 响应：
+      - call_id 由 puppet 实现侧（协议端）生成并经本响应返回，全链路以此关联控制面与媒体旁路；
+      - 上行 EVENT_TYPE_CALL 事件可能先于本响应到达，客户端须容忍乱序；
+      - 后续控制 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:
@@ -3075,6 +3570,8 @@ definitions:
         $ref: '#/definitions/puppetCallType'
       status:
         $ref: '#/definitions/puppetCallStatus'
+  puppetCallRejectResponse:
+    type: object
   puppetCallStatus:
     type: string
     enum:
@@ -3089,7 +3586,7 @@ definitions:
       - CALL_STATUS_UNKNOWN: 不明确
        - CALL_STATUS_CANCELED: 自己取消
        - CALL_STATUS_REJECTED: 对方拒接
-       - CALL_STATUS_MISSED: 正在通话
+       - CALL_STATUS_MISSED: 未接
        - CALL_STATUS_ONGOING: 正在通话
        - CALL_STATUS_ENDED: 已结束
     title: 类型枚举
@@ -3507,6 +4004,7 @@ definitions:
       - EVENT_TYPE_ROOM_ANNOUNCE
       - EVENT_TYPE_VERIFY_CODE
       - EVENT_TYPE_VERIFY_SLIDE
+      - EVENT_TYPE_CALL
     default: EVENT_TYPE_UNSPECIFIED
   puppetFriendshipAcceptResponse:
     type: object
@@ -3712,6 +4210,262 @@ definitions:
         title: 地址名，例如xx大厦
   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:
@@ -4107,7 +4861,11 @@ definitions:
       - PAYLOAD_TYPE_POST
       - PAYLOAD_TYPE_TAG
       - PAYLOAD_TYPE_TAG_GROUP
+      - PAYLOAD_TYPE_WXXD_PRODUCT
+      - PAYLOAD_TYPE_WXXD_ORDER
+      - PAYLOAD_TYPE_CALL
     default: PAYLOAD_TYPE_UNSPECIFIED
+    title: 数值必须与 @juzi/wechaty-puppet 的 DirtyType 严格一致。
   puppetPostPayloadClient:
     type: object
     properties:
@@ -4596,7 +5354,7 @@ definitions:
     type: object
     properties:
       payload:
-        $ref: '#/definitions/wechatypuppetTagGroupPayload'
+        $ref: '#/definitions/wechatyPuppetTagGroupPayload'
   puppetTagGroupTagListResponse:
     type: object
     properties:
@@ -4613,7 +5371,7 @@ definitions:
     type: object
     properties:
       payload:
-        $ref: '#/definitions/wechatypuppetTagPayload'
+        $ref: '#/definitions/wechatyPuppetTagPayload'
   puppetTagTagAddRequest:
     type: object
     properties:
@@ -4771,7 +5529,7 @@ definitions:
         items:
           type: object
           $ref: '#/definitions/protobufAny'
-  wechatypuppetTagGroupPayload:
+  wechatyPuppetTagGroupPayload:
     type: object
     properties:
       id:
@@ -4780,7 +5538,7 @@ definitions:
         type: string
       type:
         $ref: '#/definitions/puppetTagType'
-  wechatypuppetTagPayload:
+  wechatyPuppetTagPayload:
     type: object
     properties:
       id: