尘锋SCRM开放平台
  1. 联系人
尘锋SCRM开放平台
  • 接入前准备
    • 接口鉴权说明
    • 回调接入指南
    • 报错code码说明
    • 省市区code码
    • 获取附件URL访问签名
    • 更新日志
  • 对接方案介绍
    • 联系人架构介绍
    • 员工概览
    • ERP打通
    • 客户信息打通
    • 订单打通
    • 微信unionid互通场景
    • 获客助手对接场景
  • API文档
    • 客户
      • 联系人
        • 联系人管理
          • 查询联系人
          • 新增联系人
          • 编辑联系人
          • 删除联系人
          • 编辑联系人状态
          • 获取联系客户统计数据
          • 外部ID
            • 删除联系人外部ID
            • 更新联系人外部ID
            • 绑定外部ID与联系人ID
        • 联系人字段ID
          • 查询联系人自定义字段模板
          • 查询跟进状态列表
          • 查询联系人公海列表
          • 无效&放弃&删除原因查询
          • 联系人类型与标签和自定义字段关联关系
          • 联系人类型
          • 联系人联系方式
          • 多级联选列表
          • 来源
            • 来源列表查询(企业&联系人)
            • 编辑来源
            • 创建来源
        • 标签库
          • 给联系人打标签
          • 好友标签(企业微信标签)
            • 查询好友标签列表
            • 编辑好友标签
            • 新增好友标签
          • 联系人标签
            • 编辑联系人标签值
            • 新增联系人标签组
            • 编辑联系人标签组
            • 新增联系人标签值
            • 查询联系人标签列表
        • 跟进团队
          • 编辑(联系人/企业)共享人
          • 查询创建⼈跟进⼈和共享⼈
        • 跟进提醒
          • 查询跟进提醒
          • 新增跟进提醒
          • 编辑跟进提醒
          • 完成跟进提醒
          • 删除跟进提醒
        • 跟进记录
          • 查询跟进记录
          • 查询跟进记录模板
          • 新增跟进记录
        • 在职继承
          • 分配在职成员联系人
          • 查询接替状态
        • 签到
          • 查询签到记录
        • 行为轨迹
          • 轨迹参数说明
          • 上报轨迹事件
          • 查询轨迹事件
          • 查询旅程项目
      • 企业
        • 企业字段ID
          • 查询企业字段ID
          • 查询企业跟进状态
          • 查询企业公海列表
          • 来源列表查询(企业&联系人)
          • 查询企业类型
          • 查询企业删除原因
          • 查询多级联选
        • 企业管理
          • 查询企业列表
          • 新增企业
          • 编辑企业
          • 删除企业
          • 企业绑定联系人
          • 更新企业跟进人
          • 放弃企业到公海
          • 分配公海中企业
        • 企业标签
          • 查询企业标签
      • 好友
        • 查询好友列表
        • 编辑好友信息
        • 好友关联联系人
        • 好友取消关联联系人
        • unionId上传&关联externalUserId
      • 客户群
        • 查询客户群列表
        • 查询客户群详情
        • 编辑客户群标签
        • 查询群标签列表
        • 查询群聊数据统计-按群主聚合方式
        • 查询群聊数据统计-按自然日聚合方式
    • 销售机会
      • 销售机会管理
        • 查询销售机会列表
        • 新增销售机会
        • 编辑销售机会
        • 删除销售机会
        • 新增销售机会协同人
        • 移除销售机会协同人
        • 销售机会绑定订单
        • 销售机会解绑订单
        • 销售机会阶段变更记录
      • 销售机会字段ID
        • 查询销售机会字段ID
        • 查询销售机会类型
        • 查询销售机会阶段
        • 查询协同角色ID
        • 查询竞争对手
        • 查询丢单原因
        • 查询销售机会多级联选选项
        • 修改销售机会多级联选选项
    • 交易
      • 订单
        • 查询订单列表
        • 新增&编辑订单
        • 查询订单自定义字段ID
        • 修改订单归属人/归属部门
        • 订单发货
        • 查询物流公司列表
        • 查询订单来源
        • 编辑自主下单
      • 售后单
        • 查询售后单列表
        • 创建售后单
        • 售后单操作退款
      • 回款单
        • 查询回款单列表
        • 创建回款单
      • 会员积分
        • 查询会员列表
        • 新增会员
        • 变更会员等级
        • 查询会员等级变更明细
        • 变更会员积分
        • 变更会员成长值
        • 查询会员积分变更明细
      • 商品类
        • 查询商品列表
        • 查询商品详情
        • 新增商品
        • 商品图片/视频上传
        • 编辑商品库存
    • 员工
      • 查询员工信息
      • 编辑员工信息
      • 部门信息查询
      • 批量为员工启用系统
      • 给员工发送企微通知
    • 预约单
      • 查询预约列表
    • 评论
      • 查询评论列表接口
    • 运营
      • 活码
        • 查询活码详情
        • 查询活码列表
      • 表单
        • 查询表单字段模板
        • 查询表单填写内容
      • sop
        • 查询sop列表
        • 查询sop执行情况列表
      • 素材
        • 查询素材列表
        • 查询素材详情
        • 查询员工发送素材明细
      • 营销任务
        • 查询营销任务执行情况
        • 查询营销任务列表
      • 朋友圈
        • 获取企业发布的朋友圈员工执行情况
        • 获取朋友圈的互动数据
        • 获取企业全部发布列表
      • 获客助手短链
        • 查询获客助手来源及链接信息
        • 查询获客助手配置列表
        • 获取专属短链详情列表
        • 生成用户专属短链接
    • 会话存档
      • 上传会话存档记录
    • 通话短信
      • 查询通话记录列表
      • 电销手机外呼
      • 查询通话录音转文字结果
      • 查询短信记录列表
    • 页面嵌入
      • 页面嵌入配置说明
      • 解密嵌入页面传参
      • 菜单嵌入说明
    • 应用
      • 楼盘管理
        • 查询楼盘
        • 新增楼盘
        • 删除楼盘
      • 外联盟管理
        • 查询外联盟
        • 新增外联盟
        • 编辑外联盟
        • 删除外联盟
        • 启停用外联盟
        • 查询外联盟字段ID
        • 外联盟多级联选选项
  • 事件推送
    • 联系人
      • 新增联系人事件
      • 编辑联系人事件
      • 联系人跟进状态变更事件
      • 删除联系人事件
      • 联系人合并事件
      • 跟进提醒
        • 联系人跟进提醒状态变更
      • 联系人流转
        • 跟进团队变更事件
        • 联系人流转事件
      • 跟进记录
        • 跟进记录操作事件
    • 好友
      • 添加好友事件
      • 好友与联系人绑定事件
      • 好友与联系人解绑事件
      • 好友主动删除员工事件
      • 员工主动删除好友事件
      • 更新好友信息事件
    • 客户群
      • 新增客户群事件
      • 变更客户群事件
      • 解散客户群事件
    • 销售机会
      • 销售机会负责人变更
      • 销售机会协同人变更
      • 销售机会操作事件
    • 企业
      • 企业跟进团队流转事件
      • 企业新增事件
      • 编辑企业事件
      • 企业跟进状态变更事件
      • 企业删除事件
    • 交易
      • 推送说明
      • 订单
        • 新增订单事件
        • 编辑订单事件
        • 订单状态变更事件
        • 订单支付完成事件
        • 删除订单事件
      • 售后单
        • 售后单创建事件
        • 编辑售后单事件
        • 售后单状态变更事件
        • 删除售后单事件
        • 售后单退款成功事件
      • 商品
        • 新增商品事件
        • 商品库存变更事件
        • 编辑商品事件
        • 商品状态变更事件
      • 会员积分
        • 新增会员事件
        • 会员合并事件
        • 成长值变更事件
        • 会员等级变更事件
        • 会员积分变更事件
    • 工单
      • 新增工单事件
      • 流转工单事件
      • 编辑工单事件
    • 运营
      • 提交表单事件
    • 通话短信
      • 通话记录操作事件
      • 短信记录操作事件
    • 预约单
      • 新增预约单事件
    • 应用
      • 楼盘
        • 新增楼盘事件
        • 编辑楼盘事件
        • 删除楼盘事件
      • 外联盟
        • 新增外联盟事件
        • 编辑外联盟事件
        • 删除外联盟事件
        • 启/停外联盟事件
        • 外联盟审批完成事件
  1. 联系人

联系人合并事件

使用此推送需前往PC端管理后台配置推送数据地址链接,配置该对接后,联系人合并时,都将对事件类型和对应联系人信息进行接口回调,用于同步尘锋系统和三方系统中联系人信息
对接此事件请先阅读:开发指南->接入指南,文档中的回调“回调配置”模块;
请求参数(未加密)
请求参数名类型说明
dataObject消息体
data.idString事件id
data.eventString事件主类型(固定:CRM_MERGE)
data.actionString事件子类型(CRM_CONTACT_MERGED)
data.bodyObject数据内容
data.body.idStringID
data.body.mainIDString合并到的主数据id
data.body.accountString租户ID
data.body.uidString操作人ID
data.body.actionOriginString操作来源 ( normal-页面操作、tableImport-导入表格、sop-操作、autoByFriend-好友自动行为、wxGetContact-网销获客、openAPI-openAPI、cusgroup-人群分组、syncTagsByFriend-好友标签双向同步、autoRecycled-自动回收、autoAssignment-自动分配)
data.body.mergedIDsString[]源联系人ID
data.body.triggerTsInt触发时间戳(页面操作或系统自动更新的时间)
data.body.mergedContactsContactDetail[]被合并联系人信息
data.body.changedContactDetail变更后的信息,仅仅包含变更的信息字段(针对主id的信息变更)
data.body.oldContactDetail原信息
联系人信息详情对象-ContactDetail
请求参数名类型说明
remarkString备注
genderString性别 0-未知 1-男性 2-女性
birthdayString生日
emailStringemail
ageInt年龄
nationalString国籍
positionString职位
provCityString省市区(县)
addressString地址
coordinatefloat[]经纬度
qqStringqq
nationalityString国籍
educationString教育
idCardString身份证
weChatString微信
majorString专业
categoryIDString联系人类型id
avatarString外部联系人头像
mobilesString[]电话号码
unionIDStringunionID
externalUserIDString好友外部联系人id
tagsString[]企业标签id集合
ruleTagsString[]规则标签id集合
bizTagsString[]联系人标签id集合
sourceCodeString来源id
descriptionString描述
mobileListObject[]手机号信息
mobileList.telString手机号
mobileList.typeString类型
mobileList.displayString显示
customFieldsObject[]自定义字段 仅变更部分, 非全量; 置空 value 为 ""
customFields.idString字段id
customFields.typeString类型
customFields.valueString值
请求参数示例
json - Request-Example-加密:
//明文信息推送
{
    "id": "d7ed8618-6180-4ded-a5a5-a315369e6b1e",
    "event": "CRM_MERGE",
    "action": "CRM_CONTACT_MERGED",
    "body": {
        "id": "eb2198d0-04dd-11ee-bf9b-c64788aed849",
        "mainID": "eb2198d0-04dd-11ee-bf9b-c64788aed849",
        "account": "W00000000082",
        "actionOrigin": "",
        "uid": "34",
        "mergedIDs": [
            "2df106aa-7057-11ed-a049-a2eb63fbe44a"
        ],
        "mergedContacts": [
            {
                "remark": "好",
                "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": "field10",
                        "type": "text",
                        "value": "\"\""
                    },
                    {
                        "id": "field34",
                        "type": "radio",
                        "value": "\"\""
                    },
                    {
                        "id": "field35",
                        "type": "datetime",
                        "value": "\"\""
                    },
                    {
                        "id": "field36",
                        "type": "date",
                        "value": "\"\""
                    }
                ]
            }
        ],
        "changed": {
            "customFields": [
                {
                    "id": "field10",
                    "type": "text",
                    "value": "\"\""
                },
                {
                    "id": "field34",
                    "type": "radio",
                    "value": "\"\""
                },
                {
                    "id": "field35",
                    "type": "datetime",
                    "value": "\"\""
                },
                {
                    "id": "field36",
                    "type": "date",
                    "value": "\"\""
                }
            ]
        },
        "old": {
            "remark": "eaasdadasd",
            "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": [
                "13299932123"
            ],
            "unionID": "",
            "externalUserID": "",
            "tags": [],
            "ruleTags": [],
            "bizTags": [],
            "sourceCode": "00101f",
            "description": "",
            "mobileList": [
                {
                    "tel": "13299932123",
                    "type": "mobile",
                    "display": "手机"
                }
            ],
            "customFields": []
        },
        "triggerTs": 1686107367
    }
}

//信息加密推送
{
	"id": "4c6421ea-f503-4a89-ba5b-7c9524cf596f",
	"event": "CRM_MERGE",
	"action": "CRM_CONTACT_MERGED",
	"body": {
		"encrypt": "XOKphmyMEcuW94gYtL/5Nj4ueFcfjaEFecC507QGzXbnDmavLp7I+s7K5BI4Qjt+Ayy/mNbw9bUE2x0HkSWm9h57VKJc9VLBghTjALWJcJduBDC7L6doORsZdaNlfVJU6DJ0VLyd1NojW9PfrzS01eQ7GW/dgaO3tkXQP2AOrGTn3Ca8haZQiwEJDYN/NUjW1/9T+gIcBu8LbmZGyokwrOD+ZGy7uky37yq8w8SGpis1WR2pIlZUOo+QdmWnMY1kJ9bHelH9h3ERemmNRIh/oMZp7QvFaNl/iCgUVAkh14tOV0nniE9Ld29GxyIEFz0nxD5+s4AG4cvq+xl+FXhu0A==",
		"msgSignature": "d64cc4a02b22b725a6b50a9843ebf9c0fd7ca70f",
		"timeStamp": "1661233174",
		"nonce": "9ZvYhI4aFmR7wUNl"
	}
}
成功响应
响应参数名类型说明
codeInt响应码:状态码 0 失败,1 成功
msgString响应提示
成功响应示例
 {
    "code": 1,
    "msg": "成功"
}
错误响应示例
 {
    "code": 0,
    "msg": "处理失败"
}
上一页
删除联系人事件
下一页
联系人跟进提醒状态变更
Built with