使用此推送需前往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": "处理失败"
}