新增联系人事件
使用此推送需前往PC端管理后台配置推送数据地址链接,配置该对接后,创建联系人资料数据时,都将对事件类型和对应联系人信息进行接口回调,用于同步尘锋系统和三方系统中联系人信息
对接此事件请先阅读:开发指南->接入指南,文档中的回调“回调配置”模块;
请求参数名 | 类型 | 说明 |
---|---|---|
data | Object | 消息体 |
data.id | String | 事件id |
data.event | String | 事件主类型(固定:CRM_CONTACT) |
data.action | String | 事件子类型(CRM_CONTACT_CREATE) |
data.body.id | String | 联系人ID |
data.body.account | String | 租户ID |
data.body.uid | String | 操作人ID |
data.body.type | Int | 联系人类别 |
data.body.actionOrigin | String | 操作来源 ( normal-页面操作、tableImport-导入表格、sop-操作、autoByFriend-好友自动行为、wxGetContact-网销获客、openAPI-openAPI、cusgroup-人群分组、syncTagsByFriend-好友标签双向同步、autoRecycled-自动回收、autoAssignment-自动分配 miniProgramLogin-小程序授权 customerService-抖音、微客服) |
data.body.triggerTs | Int | 触发时间戳(页面操作或系统自动更新的时间) |
data.body.changed | ContactDetail | 创建的联系人信息 |
请求参数名 | 类型 | 说明 |
---|---|---|
remark | String | 备注 |
gender | String | 性别 0-未知 1-男性 2-女性 |
birthday | String | 生日 |
String | ||
age | Int | 年龄 |
national | String | 国籍 |
position | String | 职位 |
provCity | String | 省市区(县) |
address | String | 地址 |
coordinate | Float[] | 经纬度 |
String | ||
nationality | String | 国籍 |
education | String | 教育 |
idCard | String | 身份证 |
String | 微信 | |
major | String | 专业 |
categoryID | String | 联系人类型id |
avatar | String | 外部联系人头像 |
mobiles | String[] | 电话号码 |
unionID | String | unionID |
externalUserID | String | 好友外部联系人id |
tags | String[] | 企业标签id集合 |
ruleTags | String[] | 规则标签id集合 |
bizTags | String[] | 联系人标签id集合 |
sourceCode | String | 来源id |
description | String | 描述 |
mobileList | Object[] | 手机号信息 |
mobileList.tel | String | 手机号 |
mobileList.type | String | 类型 |
mobileList.display | String | 显示 |
customFields | Object[] | 自定义字段 仅变更部分, 非全量; 置空 value 为 "" |
customFields.id | String | 字段id |
customFields.type | String | 类型 |
customFields.value | String | 值 |
json
- Request-Example-加密://明文信息推送
{
"id": "995c220f-289b-4f69-a7c6-933db8b0dce3",
"event": "CRM_CONTACT",
"action": "CRM_CONTACT_CREATE",
"body": {
"id": "f5aa4111-c702-11ed-8ee9-5afe8656909e",
"account": "W00000000109",
"type": 3,
"actionOrigin": "normal",
"uid": "4254",
"changed": {
"remark": "23432",
"gender": 0,
"birthday": "",
"email": "",
"age": 0,
"national": "",
"position": "",
"provCity": 0,
"address": "",
"coordinate": [0, 0],
"qq": "",
"nationality": "",
"education": "",
"idCard": "",
"weChat": "",
"source": "",
"major": "",
"categoryID": "00000000-0000-0000-0000-000000000000",
"avatar": "",
"mobiles": [],
"unionID": "",
"externalUserID": "",
"tags": [],
"ruleTags": [],
"bizTags": [],
"sourceCode": "",
"description": "",
"mobileList": [],
"customFields": [{
"id": "field91",
"type": "date",
"value": "\"\""
}, {
"id": "field92",
"type": "datetime",
"value": "\"\""
}, {
"id": "field93",
"type": "text",
"value": "\"\""
}, {
"id": "field94",
"type": "checkbox",
"value": "[]"
}, {
"id": "field95",
"type": "number",
"value": "null"
}, {
"id": "field96",
"type": "textarea",
"value": "\"\""
}, {
"id": "field97",
"type": "radio",
"value": "\"\""
}, {
"id": "field98",
"type": "cascader",
"value": "[]"
}, {
"id": "field99",
"type": "files",
"value": "[]"
}]
},
"triggerTs": 1679305104
}
}
//信息加密推送
{
"id": "902e9918-ca15-4876-bd1e-7b0341587c5f",
"event": "CRM_CONTACT",
"action": "CRM_CONTACT_CREATE",
"body": {
"encrypt": "XOKphmyMEcuW94gYtL/5Nj4ueFcfjaEFecC507QGzXbnDmavLp7I+s7K5BI4Qjt+Ayy/mNbw9bUE2x0HkSWm9h57VKJc9VLBghTjALWJcJduBDC7L6doORsZdaNlfVJU6DJ0VLyd1NojW9PfrzS01eQ7GW/dgaO3tkXQP2AOrGTn3Ca8haZQiwEJDYN/NUjW1/9T+gIcBu8LbmZGyokwrOD+ZGy7uky37yq8w8SGpis1WR2pIlZUOo+QdmWnMY1kJ9bHelH9h3ERemmNRIh/oMZp7QvFaNl/iCgUVAkh14tOV0nniE9Ld29GxyIEFz0nxD5+s4AG4cvq+xl+FXhu0A==",
"msgSignature": "d64cc4a02b22b725a6b50a9843ebf9c0fd7ca70f",
"timeStamp": "1661233174",
"nonce": "9ZvYhI4aFmR7wUNl"
}
}
响应参数名 | 类型 | 说明 |
---|---|---|
code | Int | 响应码:状态码 0 失败,1 成功 |
msg | String | 响应提示 |
{
"code": 1,
"msg": "成功"
}
{
"code": 0,
"msg": "处理失败"
}