创建Webhook

点击 DM Hub > 设置中心 > Webhook 进入Webhook列表页,点击右上角的 新建 按钮创建新的Webhook。



参数说明

  • 名称:给Webhook取一个有意义的名称,方便后续查看和更改。

  • 消息接收地址:Webhook消息的接收地址。该地址必须是合法的完整地址,包含使用的协议(如 http 或 https)。

  • 鉴权方式:为了防止非授信主体访问消息接收地址,消息接收地址的提供方需要提供一定的鉴权机制。DM Hub支持用以下鉴权机制来访问消息接收地址,具体内容参见 Webhook鉴权

    • 秘钥:DM Hub在发送消息的时候会使用该密钥对消息内容进行签名,消息接收地址在接收到消息时进行验签,从而保证消息来源以及消息内容没有被篡改过。
    • 基本认证: DM Hub发送消息时,使用HTTP基本认证访问消息接收地址。
    • OAuth2:DM Hub发送消息时,使用OAuth2的客户端凭证方式(client crendentials)访问消息接收地址。
    • 无:DM Hub发送消息时,不使用任何鉴权方式。
  • 触发类型

    • 自定义: 可在自动流程中作为一个动作组件,或手动圈选人群推送消息。选择此触发类型,需设置消息类型和消息体。

      • 消息类型: 可选择以JSON或者文本格式发送消息。如果消息类型为JSON格式,则HTTP header中的Content-Type为application/json,如果为文本格式,则Content-Type为text/plain
      • 消息体:可自定义消息内容,并可选择插入内容变量。内容变量有两种:
        • 一种是消息发送时的上下文变量,即消息发送时对应客户的属性、会员属性,事件属性(当webhook由事件触发时存在)。
        • 另一种是场景参数。比如用自动流发送优惠券,可以在自动流的webhook节点里插入优惠券的ID,这样在发送消息时,就可以将优惠券ID插入到消息内容中发送给下游系统。设置场景参数后,可以在自动流的webhook节点、表单提交后的webhook动作、批量群发时设置场景参数值。
    • 事件订阅:指定事件发生后,该事件的内容会被发送给消息接收地址。DM Hub支持如下事件的订阅:客户事件、会员事件、客户属性变更、客户身份变更和营销活动属性变更。当订阅多个事件时,多个事件会分别逐条发送给消息接收地址,而不是一次性发送给消息接收地址。事件订阅的消息格式参见Webhook消息格式

    • 异常通知: 创建供自动流、智能群组和智能标签等功能发生异常时的通知地址。详情请见该选项下的帮助链接。

  • 自动重试:如果推送失败,会自动进行重试。自动重试开启后,DM Hub会最多重试3次:分别为发送后的30分钟,60分钟和90分钟。