Webhook

更多执行动作可查看《变更属性》《移出标签组》《终止旅程》

什么是webhook?

——webhook(也被称为网络回调或HTTP推送API)是一个应用为其他应用提供实时信息的一种方法。
——当webhook被触发后,它将传送数据到其他应用程序中去,该应用程序会立即获取到数据,而不需要定时调用当前应用的openAPI批量获取数据。

Linkflow webhook 动作

——在Linkflow客户旅程中使用webhook动作图元,当客户旅程被触发,webhook可以向配置地址发起请求,将客户旅程触发事件信息、联系人信息、自定义信息发送给配置地址。

配置webhook 动作图元

  • 在客户旅程画板上,拖入webhook动作图元
  • 点击设置按钮,填写信息

消息接收URL:请填写接收消息地址
请求方法:目前只支持post方法
消息格式:目前只支持JSON
消息结构体配置:您可以在此自定义消息结构体中的参数

  • 用户详情
    选择:消息结构体增加contact参数
    不选择:消息结构体contact参数中只有id
  • 关注状态用户微信账号
    选择:contact结构体中增加wechatAccounts参数
    不选择:contact结构体中没有wechatAccounts参数
  • 用户自定义连接账号
    选择:contact结构体中增加udcAccounts参数
    不选择:contact结构体中没有udcAccounts参数
  • 触发事件
    选择:消息结构体中增加event
    不选择:消息结构体中没有event
  • 自定义参数
    选择:消息结构体中增加_custom参数
    不选择:消息结构体中没有_custom参数
    当您勾选自定义参数选项,并添加了自定义参数,就可在_custom结构体中解析出您的自定义参数。
    示例
{
  "sendTime": 1553249452973,
  "contact": {
    "id": 100,
    "name": "张三",
    "mobilePhone": "13912341234",
    "email": "zhangsan@example.com",
    "wechatAccounts": [
      {
        "appId": "appid1",  //微信公众账号appid
        "openId": "openId1",  //联系人openid
        "unionId": "unionId1"  //联系人unionId
      },
      {
        "appId": "appid2",
        "openId": "openId2",
        "unionId": "unionId2"
      }
    ],
    "udcAccounts": [
      {
        "externalId": "externId1",  //联系人在自定义渠道的账号
        "channelId": "abc.com",  //自定义渠道连接的channelid
        "channelName": "abc website"  //自定义渠道连接的名称
      }
    ]
  },
  "event": {
    "eventDate": 1553249452973,
    "channelId": "wx123",
    "channelName": "微信mp",
    "event": "WECHAT__SUBSCRIBE",
    "attr1": "XXX",
    "attr2": "XXX",
    "contactId":18257,  
    "id":104298,  
    "items": []
  },
   "_custom": {
    "foo": "bar"
  }
}


消息结构体参数字段含义

1.1联系人结构体参数字段含义

字段名类型描述示例
idstring联系人ID1553249452973
namestring联系人姓名张三
mobilestring联系人手机15150000000
emailstring联系人邮箱zhangsan@demo.com
wechatAccountslist联系微信账号列表(公众号、小程序)
udcAccountslist联系人自定义渠道账号列表

1.2事件结构体参数字段含义

字段名类型描述示例
idstring事件id104298
eventDatelong时间戳:事件发生时间1554798374000
channelIdstring连接idudc_1544vOULeekh
channelNamestring连接名称源犀科技
eventstring事件编码WECHAT__SUBSCRIBE
sdkVersionstringSDK的版本1.0.0
sdkTypestring记录此事件的SDKiOS SDK
platformstring应用平台iOS
screenWidthBigDecimal屏幕宽度
screenHeightBigDecimal屏幕高度
appVersionstring应用版本
bundleKeystring应用包名
osstring操作系统Linux
osVersionstring操作系统版本例如8.1.1
browserstring浏览器名称谷歌浏览器
browserVersionstring浏览器版本11
countrystring国家中国
provincestring省份江苏
citystring城市南京
networkTypestring网络类型WiFi
manufacturerstring设备供应商三星
deviceModelstring设备类型iPhone
operatorstring运营商中国联通
debugModeBoolean是否是测试数据true
imeistringIMEI
ipstringip地址
latitudeBigDecimal纬度
longitudeBigDecimal经度
attr1根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr2根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr3根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr4根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr5根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr6根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr7根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr8根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr9根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr10根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr11根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr12根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr13根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr14根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr15根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr16根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr17根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr18根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr19根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
attr20根据事件编码,查找事件metadata中的事件属性类型事件属性值 。可根据事件编码,查找事件metadata中的事件属性定义
itemslist子事件。
utmobjectutm参数。{ "source":"wechat", "medium":"qrcode", "content":"联否ALPHA", "term":"1" ,"campaign":"营销活动3"}
contactIdlong事件联系人id18257

1.3事件属性类型值定义

含义说明
text字符串
integer整数
number数字
datetime日期
enum枚举按照string处理
reference引用linkflow内部引用id,按照string处理

推送规则

当工作流被触发,webhook工作被触发,linkflow会向配置地址发起请求。
1、消息推送服务通过 POST 、参数编码为 JSON 的方式向开发者提供的地址推送消息;
2、开发者接收到消息后需要在10秒内回复code为 200的响应;
3、当推送没有成功返回会进入重发,最多重发三次。 规则是无法连通或者返回的http code 大于等于500(服务器异常);
4、消息推送成功的逻辑是开发者服务器返回200。

场景举例

场景描述:需要将每个加入标签组“webhook”的联系人同时同步到外部的服务器(如阿里云服务器等)
流程设计如下:


然后发布流程,凡是加入此标签组的人员均可以同步到外部服务器。

注:联系人信息可以实时同步到外部服务器,如网络缓慢问题,数据同步会稍后延后。

接口鉴权

1、当webhook配置的接口需要鉴权时,您可前往设置-App集成设置-授权设置中,配置一个用于获取令牌的授权,授权的配置请参考:《授权设置》
2、勾选webhook的启用鉴权功能,在下方填入需要鉴权的请求参数,令牌的值可以使用通配符#{auth.授权标识.令牌的key}获取(通配符外也可拼接空格与字符串)您需要根据您配置的授权返回结构自行判断填写令牌的key。