JSON格式(客服和管理员角色调用)

NameTypeComment
idinteger用户id,由系统自动分配
urlstring资源url
emailstring用户邮箱
namestring用户昵称
remark_namestring用户备注姓名
agent_display_namestring客服处理工单时显示名称
mark_starinteger是否是星标用户,可选值:1、0,默认为 0
rolestring用户角色,可选值:end_user、agent、admin
phonestring用户手机
phone_bindboolean手机是否绑定
landlinelandline座机号
signaturestring客服处理工单时显示签名
detailsstring详细信息
notesstring用户说明
organization_idinteger用户所属组织id
languagestring用户的偏好语言
created_atdate创建时间
updated_atdate最后更新时间
last_login_atdate最近登录时间
statusstring用户状态,可选值:suspended暂停,active正常,unverified未审核
groups_infoobject当该用户为客服及以上角色时,为该用户所在的所有客服组id和name
photostring用户头像图片的url地址
moderatorboolean客服文档权限,true表示能编辑文档
public_commentsboolean客服回复工单权限,false为只能私密回复
manage_peopleboolean客服管理用户权限,true表示可以管理用户
ticket_restrictionstring客服受理工单权限,all表示可以受理所有工单,
groups表示只能受理客服组的工单,
assigned表示只能受理分配的工单
custom_role_idinteger客服所属的自定义角色id,高级服务模式才有此功能。
若值不为空,那么上面的客服权限字段不再起作用,
权限按照custom_role里的设置生效
wechat_appidstring微信公众号的原始 id
wechat_openidstring微信用户的 openid
wechat_miniprogram_appidstring微信小程序的原始 id
wechat_miniprogram_openidstring微信小程序用户的 openid
tagsarray用户标签
user_fieldsarray用户自定义字段

JSON 示例(客服和管理员角色调用)

{
	"id": 733,
	"url": "https://support.kf5.com/apiv2/users/733.json",
	"email": "support@kf5.com",
	"name": "小叶",
	"agent_display_name": "客服小叶",
	"mark_star": 0,
	"role": "admin",
	"phone": "",
	"phone_bind": false,
	"signature": "客户==上帝?true:false",
	"details": "金牌客服",
	"notes": "一些简介",
	"organization_id": 186,
	"language": "zh_cn",
	"created_at": "2012-05-08 11:26:29",
	"updated_at": "2015-01-04 16:15:42",
	"last_login_at": "2015-01-09 16:20:29",
	"status": "active",
	"photo": "https://support.kf5.com/upload/4/201306/1371800160_490.gif",
	"moderator": false,
	"public_comments": false,
	"manage_people": false,
	"ticket_restriction": "all",
	"custom_role_id": null,
	"wechat_appid": "gh_e5103c9f4f0d",
	"wechat_openid": "olIHQ032sNbhlkBZDogwz06kQtxA",
	"wechat_miniprogram_appid": "gh_6a89cad623fb",
	"wechat_miniprogram_openid": "o22QC0WpvDp2Abj_MD7t3ne5MvNg",
	"tags": [
		"tag1",
		"tag2"
	],
	"user_fields": [
	{
		"name": "field_7",
		"value": "男"
	},
	{
		"name": "field_11",
		"value": "技术客服"
	}
]}