审批申请状态变化回调通知

订阅后,当企业内第三方应用所添加的企业微信“审批应用”单据流程发生变化时,会将审批单最新的流程状态回调给开发者。

1.设置接收事件服务器

查看事件回调详细说明

1.1 设置入口

目前,支持将第三方应用添加的模板所对应的申请单的审批状态变化通知回调给第三方应用。
第三方应用开发者可在服务商后台配置回调地址,接受此类型回调通知。

1.2 配置说明

进入配置页面,要求填写指令回调URL、Token、EncodingAESKey三个参数。

  • 指令回调URL是第三方应用后台接收企业微信推送请求的访问协议和地址,支持http或https协议(建议使用https)。
  • Token可由企业任意填写,用于生成签名。
  • EncodingAESKey用于消息体的加密,是AES密钥的Base64编码。

2.事件格式

当指定类型的审批申请发生状态变化时,企业微信将向回调地址发送相应的通知事件。
状态变化包括但不限于:催办、撤销、同意、驳回、转审、添加备注等情况。

示例:

<xml>
  <ToUserName><![CDATA[ww1cSD21f1e9c0caaa]]></ToUserName>
  <FromUserName><![CDATA[sys]]></FromUserName>
  <CreateTime>1571732272</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[sys_approval_change]]></Event>
  <AgentID>3010040</AgentID>
  <ApprovalInfo>
    <SpNo>201910220003</SpNo>
    <SpName><![CDATA[示例模板]]></SpName>
    <SpStatus>1</SpStatus>
    <TemplateId><![CDATA[3TkaH5KFbrG9heEQWLJjhgpFwmqAFB4dLEnapaB7aaa]]></TemplateId>
    <ApplyTime>1571728713</ApplyTime>
    <Applyer>
      <UserId><![CDATA[WuJunJie]]></UserId>
      <Party><![CDATA[1]]></Party>
    </Applyer>
    <SpRecord>
      <SpStatus>1</SpStatus>
      <ApproverAttr>2</ApproverAttr>
      <Details>
        <Approver>
          <UserId><![CDATA[WangXiaoMing]]></UserId>
        </Approver>
        <Speech><![CDATA[]]></Speech>
        <SpStatus>1</SpStatus>
        <SpTime>0</SpTime>
      </Details>
      <Details>
        <Approver>
          <UserId><![CDATA[XiaoGangHuang]]></UserId>
        </Approver>
        <Speech><![CDATA[]]></Speech>
        <SpStatus>1</SpStatus>
        <SpTime>0</SpTime>
      </Details>
    </SpRecord>
    <SpRecord>
      <SpStatus>1</SpStatus>
      <ApproverAttr>1</ApproverAttr>
      <Details>
        <Approver>
          <UserId><![CDATA[XiaoHongLiu]]></UserId>
        </Approver>
        <Speech><![CDATA[]]></Speech>
        <SpStatus>1</SpStatus>
        <SpTime>0</SpTime>
      </Details>
    </SpRecord>
    <Notifyer>
      <UserId><![CDATA[ChengLiang]]></UserId>
    </Notifyer>
    <Comments>
      <CommentUserInfo>
        <UserId><![CDATA[LiuZhi]]></UserId>
      </CommentUserInfo>
      <CommentTime>1571732272</CommentTime>
      <CommentContent><![CDATA[这是一个备注]]></CommentContent>
      <CommentId><![CDATA[6750538708562308220]]></CommentId>
    </Comments>
    <StatuChangeEvent>10</StatuChangeEvent>
  </ApprovalInfo>
</xml>

参数说明:

参数 说明
Event 事件名称:sys_approval_change
SpNo 审批编号
SpName 审批申请类型名称(审批模板名称)
SpStatus 申请单状态:1-审批中;2-已通过;3-已驳回;4-已撤销;6-通过后撤销;7-已删除;10-已支付
TemplateId 审批模板id。可在“获取审批申请详情”、“审批状态变化回调通知”中获得,也可在审批模板的模板编辑页面链接中获得。
ApplyTime 审批申请提交时间,Unix时间戳
Applyer 申请人信息
└ UserId 申请人userid
└ Party 申请人所在部门pid
SpRecord 审批流程信息,可能有多个审批节点。
└ SpStatus 审批节点状态:1-审批中;2-已同意;3-已驳回;4-已转审
└ ApproverAttr 节点审批方式:1-或签;2-会签
└ Details 审批节点详情。当节点为标签或上级时,一个节点可能有多个分支
└ └ Approvor 分支审批人
└ └ └ UserId 分支审批人userid
└ └ Speech 审批意见字段
└ └ SpStatus 分支审批人审批状态:1-审批中;2-已同意;3-已驳回;4-已转审
└ └ SpTime 节点分支审批人审批操作时间,0为尚未操作
└ └ MediaId 节点分支审批人审批意见附件,media_id具体使用请参考:文档-获取临时素材
Notifyer 抄送信息,可能有多个抄送节点
└ UserId 节点抄送人userid
Comments 审批申请备注信息,可能有多个备注节点
└ CommentUserInfo 备注人信息
└ └ UserId 备注人userid
└ CommentTime 备注提交时间
└ CommentContent 备注文本内容
└ CommentId 备注id
└ └ MediaId 节点分支审批人审批意见附件,media_id具体使用请参考:文档-获取临时素材
StatuChangeEvent 审批申请状态变化类型:1-提单;2-同意;3-驳回;4-转审;5-催办;6-撤销;8-通过后撤销;10-添加备注
© 1998 - 2021 Tencent Inc. All Rights Reserved