尘锋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. 企业管理

新增企业

仅当开启"企业模式"时,企业才会存在主跟进人;
开启路径为:"尘锋SCRM管理后台-配置-系统设置-业务模式-企业管理"
如未指定"公海"或"主跟进人",则企业数据将进入公海,名称为:"预设公海(领取)"
新增企业时,通过"企业全称"判断是否重复,如已重复,则会返回已存在的企业id
toB模式下,公海ID和跟进团队参数必选一个传递;
POST https://qw-openapi-tx.dustess.com/enterprise/v2/create/batch?accessToken=

Content-Type: application/json
接口限制:每分钟调用600次,单次最多500条;
请求参数
请求参数名类型说明是否必须
paramsObject[]批量新增参数列表 (单次不超过500)true
params.companyObject企业基础信息true
params.company.fullNameString企业全称true
params.company.categoryIDString企业类型true
params.company.nameString企业简称false
params.company.codeString企业编码false
params.company.telString电话false
params.company.webString网址false
params.company.provCityString省市Codefalse
params.company.addressString地址false
params.company.industryString行业类型, 枚举值:参考下方特殊说明false
params.company.peoplesString人员规模,枚举值 ("1-50人","51-100人","101-200人","201-500人","501-1000人","1000人以上",)false
params.company.levelString企业等级IDfalse
params.company.sourceCodeString来源id,可传任意层级的来源id,该联系人会挂在来源id的所属层级false
params.company.tagsString[]标签IDfalse
params.company.udfobject自定义字段false
params.company.udf.model_dataobject []自定义字段false
params.company.udf.model_data[].keystring自定义字段id查询企业字段IDfalse
params.company.udf.model_data[].valuestring自定义字段namefalse
params.poolString公海ID (不可与 主跟进人ID 同时存在)false
params.followerObject跟进团队false
params.follower.ownerString主跟进人IDfalse
params.followStatusObject跟进状态false
params.followStatus.followStatusIDString跟进状态IDfalse
params.followStatus.invalidReasonString无效原因IDfalse
params.followStatus.invalidOtherTextString其他无效原因, 无效原因为其他时必填false
行业类型枚举值
"出行行业",
"电商行业",
"教育行业",
"互联网金融/银行",
"医疗/健康",
"美容/健身",
"旅游/酒店",
"票务",
"直播",
"招聘/人力",
"餐饮",
"快递/物流",
"企业服务",
"婚恋",
"O2O生活",
"公共服务",
"制造业",
"房产行业",
"政府行业",
"保健品行业",
"软件系统行业",
"游戏行业",
"物业行业",
"婚纱摄影行业",
"农林牧渔行业",
"建筑装饰行业",
"其他",
文件类型枚举值
文件类型, 可填为: word、image、text、pdf、audio、spreadsheetml(excel)、presentationml(ppt)、video、other
请求参数示例
{
	"params": [
		{
			"company": {
				"fullName": "企业全称",
				"name": "简称",
				"tel": "13888888888",
				"web": "http://www.xxx.com",
				"provCity": "100000",
				"address": "四川省金牛区茶店子街道",
				"peoples": "1000人以上",
				"level": "level_id",
				"udf": {
					"model_data": [
						{
							"key": "f0ce66-lkroqp0e",
							"value": null  // 代表空值,置空该字段的值
						},
						{
							"key": "tqlcsb-ll4uqr23",
							"value": "单行/多行传入值"  // 单多行文本的值
						},
						{
							"key": "ytwhyh-ll4uqr23",
							"value": "2023-08-12"  // 日期的值
						},
						{
							"key": "wbwsja-ll4uqr23",
							"value": "2023-08-15 14:00:00"  // 时间日期的值
						},
						{
							"key": "c75noa-1h0hsvcb5",
							"value": "99"  // 数字类型传入实例
						},
						{
							"key": "60mdnv-lhen3uic",
							"value": "[\"1\"]"  // 单多选传入实例,单选仅支持传入一个值,多选可传入多个值
						},
						{
							"key": "75yey8-ljze44hq",
							// 多级联选传入实例,单选仅支持传入一个值,多选可传入多个值;每个值需包含父级选项id,使用「/」分割选项id:一级选项id/二级选项id/三级选项id
							"value": "[\"1679051431107665933/1679051431107665934\",\"1679051431107665933/1679051431107665934/1679051431107665935/1679051431107665940\"]"
						},
						{
							"key": "ys8xs5-lk0vvuoy",
							// 附件字段传入实例
							"value": "[{\"name\":\"企业列表.xlsx\",\"url\":\"https://cdn-member-test.dustess.com/W00000000545/static/l/l/d/9/lld9nnx7p91692084131697.xlsx\",\"size\":11085,\"type\":\"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\"]"
						}
					]
				},
				"tags": [
					"tag1"
				],
				"sourceCode": "xxx-xxx-xxx-xxx",
			},
			"pool": "xxx-xxx-xxx-xxx",  // 不可与follower同时存在
			"follower": {
				"owner": "1"
			},
			"followStatus": {
				"followStatusID": "xxx-xxx-xxx-xxx",
				"invalidReason": "other",
				"invalidOtherText": "其他原因"
			},
		}
	]
}
成功响应
响应参数名类型说明
codeInt响应码
msgString消息提示
dataObject返回数据
data.resultsObject[]返回数据列表
data.results.idString创建企业ID
data.results.msgBool创建企业消息返回
data.results.codeInt创建企业code码
注:返回的list与入参params的数量、顺序一致
成功响应示例
{
  "code": 0,
  "msg": "OK",
  "data": {
    "results": [
      {
        "id": "xxx",
        "msg": "",
        "code": 0
      }
    ]
  }
}

{
  "code": 0,
  "msg": "OK",
  "data": {
    "results": [
      {
        "id": "",
        "msg": "企业全称已存在",
        "code": 20070301,
      }
    ]
  }
}
上一页
查询企业列表
下一页
编辑企业
Built with