选择应用类型
企业内部应用开发
学习地图
动态与公告
应用开发平台简介(新版)
应用开发平台简介
开发应用(新版)
开发应用
服务端API
开发指南
API总览
身份验证(免登)
获取访问凭证
通讯录管理
上下游组织(原合作空间)
上下级组织(原关联组织)
考勤
日志
日程
签到
公告
音视频
钉工牌
工作台
服务窗
OA审批
即时通信IM
智能人事
智能填表
智能交互
组织大脑
待办任务
文档/文件
钉钉客联
互动卡片
应用管理
企业文化
专属开放
生态开放
智能硬件
行业开放
HCM 主数据
宜搭应用开发
客户管理(官方CRM)
概述
使用教程
权限申请
客户
联系人
跟进记录
自定义对象
客户群
控件格式
自定义控件字段格式说明V1
自定义控件字段格式说明V2
新增和更新客户字段格式说明V1
新增和更新客户字段格式说明V2
新增和更新联系人字段格式说明V1
新增和更新联系人字段格式说明V2
查询DSL说明
客户群查询DSL语法说明
Teambition 项目管理
钉钉快办
Agoal
炼丹炉(模型服务)
AI 助理
365会员
附录
客户端API
事件订阅
参考
常见问题
历史文档

新增和更新联系人字段格式说明V1

更新于 2023-01-18本文档介绍客户管理支持操作的联系人字段信息,在使用新增或更新联系人相关接口时需了解联系人字段信息。

适用接口

本文所示的字段格式说明适用于以下接口:

联系人字段说明

联系人存在两种字段:

  • 预设字段:预设字段用户不可删除,字段key是固定的(比如联系人名称的字段key为contact_name),本文主要描述预设字段的传参格式。

  • 自定义控件字段:自定义控件字段是用户可自定义的,用户可以随时进入客户管理后台新增或删除自定义控件字段。自定义控件字段的key可以通过调用获取联系人的元数据接口,获取字段列表fields下的字段名称name,自定义控件字段的传参格式参见自定义控件字段格式说明V1

如下字段可以任意组合使用,例如需要同时设置联系人名称和联系人电话:

Loading...

联系人-电话

字段类型

Key

Value

示例

联系人预设字段

contact_phone

value值格式为字符串:

  • 国际手机号需加国际区号,否则导致无法解析。

  • 国内手机号是否添加+86都符合value格式。

  • 固定电话是否添加区号都符合value格式。

Loading...

联系人-姓名

字段类型

Key

Value

示例

联系人预设字段

contact_name

value值格式为字符串。

Loading...

联系人-关联客户

字段类型

Key

Value

示例

联系人预设字段

contact_related_customer

value中包含关联客户名称和关联客户id,可以复制示例,并替换【XX公司】为关联客户名称,替换【INST_ID】为客户id即可。

Loading...
点击纠错