Zendesk

在 Zendesk 中管理支持工单、用户和组织

配置

获取工单

操作
获取工单
邮箱*
您的 Zendesk 邮箱地址
与您的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
您的 Zendesk 子域名(例如 "mycompany")
Zendesk URL 中的子域名(mycompany.zendesk.com)
状态
状态(new、open、pending、hold、solved、closed)
优先级
优先级(low、normal、high、urgent)
类型
类型(problem、incident、question、task)
受理人 ID
要分配工单的用户 ID
组织 ID
组织 ID
每页数量
每页结果数(默认:100,最大:100)
页码
页码
获取工单列表 (zendesk_get_tickets)

从 Zendesk 获取工单列表,可按条件筛选

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名(例如 mycompany.zendesk.com 中的 "mycompany")
statusstring否按状态筛选(new、open、pending、hold、solved、closed)
prioritystring否按优先级筛选(low、normal、high、urgent)
typestring否按类型筛选(problem、incident、question、task)
assigneeIdstring否按受理人用户 ID 筛选
organizationIdstring否按组织 ID 筛选
sortBystring否排序字段(created_at、updated_at、priority、status)
sortOrderstring否排序顺序(asc 或 desc)
perPagestring否每页结果数(默认:100,最大:100)
pagestring否页码
输出
参数类型说明
ticketsarray工单对象数组
pagingobject分页信息
metadataobject操作元数据

获取工单

操作
获取工单
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
工单 ID*
工单 ID
获取工单 (zendesk_get_ticket)

按 ID 从 Zendesk 获取单个工单

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
ticketIdstring是要获取的工单 ID
输出
参数类型说明
ticketobject工单对象
metadataobject操作元数据

创建工单

操作
创建工单
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
主题
工单主题
描述*
工单描述
状态
状态(new、open、pending、hold、solved、closed)
优先级
优先级(low、normal、high、urgent)
类型
类型(problem、incident、question、task)
标签
逗号分隔的标签
受理人 ID
要分配工单的用户 ID
组 ID
组 ID
自定义字段
包含自定义字段的 JSON 对象
组织 ID
组织 ID
创建工单 (zendesk_create_ticket)

在 Zendesk 中创建新工单,支持自定义字段

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
subjectstring否工单主题 (可选 - 未提供时将自动生成)
descriptionstring是工单描述 (第一条评论)
prioritystring否优先级 (low、normal、high、urgent)
statusstring否状态 (new、open、pending、hold、solved、closed)
typestring否类型 (problem、incident、question、task)
tagsstring否逗号分隔的标签
assigneeIdstring否受理人用户 ID
groupIdstring否群组 ID
requesterIdstring否请求者用户 ID
customFieldsstring否自定义字段,JSON 对象 (例如:{"field_id": "value"})
输出
参数类型说明
ticketobject已创建的工单对象
metadataobject操作元数据

批量创建工单

操作
批量创建工单
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
工单*
工单对象的 JSON 数组
批量创建工单(zendesk_create_tickets_bulk)

一次性在 Zendesk 中创建多张工单(最多 100 张)

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
ticketsstring是要创建的工单对象 JSON 数组(最多 100 个)。每张工单应包含 subject 和 comment 属性。
输出
参数类型说明
jobStatusobject任务状态对象
metadataobject操作元数据

更新工单

操作
更新工单
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
Zendesk URL 中的子域名(mycompany.zendesk.com)
工单 ID*
工单 ID
主题
工单主题
描述
工单描述
状态
状态(new、open、pending、hold、solved、closed)
优先级
优先级(low、normal、high、urgent)
类型
类型(problem、incident、question、task)
标签
逗号分隔的标签
受理人 ID
要分配工单的用户 ID
组 ID
组 ID
自定义字段
包含自定义字段的 JSON 对象
更新工单(zendesk_update_ticket)

更新 Zendesk 中的现有工单,支持自定义字段

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
ticketIdstring是要更新的工单 ID
subjectstring否新的工单主题
commentstring否向工单添加评论
prioritystring否优先级 (low, normal, high, urgent)
statusstring否状态 (new, open, pending, hold, solved, closed)
typestring否类型 (problem, incident, question, task)
tagsstring否逗号分隔的标签
assigneeIdstring否受理人用户 ID
groupIdstring否群组 ID
customFieldsstring否自定义字段(JSON 对象)
输出
参数类型说明
ticketobject已更新的工单对象
metadataobject操作元数据

批量更新工单

操作
批量更新工单
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
工单*
工单对象的 JSON 数组
批量更新工单(zendesk_update_tickets_bulk)

一次性更新多张 Zendesk 工单(最多 100 张)

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
ticketIdsstring是要更新的工单 ID,逗号分隔 (最多 100 个)
statusstring否所有工单的新状态
prioritystring否所有工单的新优先级
assigneeIdstring否所有工单的新受理人 ID
groupIdstring否所有工单的新组 ID
tagsstring否要添加到所有工单的标签,逗号分隔
输出
参数类型说明
jobStatusobject作业状态对象
metadataobject操作元数据

删除工单

操作
删除工单
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
Zendesk URL 中的子域名(mycompany.zendesk.com)
工单 ID*
工单 ID
删除工单 (zendesk_delete_ticket)

从 Zendesk 删除工单

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
ticketIdstring是要删除的工单 ID
输出
参数类型说明
deletedboolean是否删除成功
metadataobject操作元数据

合并工单

操作
合并工单
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
目标工单 ID*
要合并到的工单 ID
源工单 ID*
要合并的工单 ID,以逗号分隔
合并工单(zendesk_merge_tickets)

将多个工单合并到目标工单

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
targetTicketIdstring是目标工单 ID (工单将合并到此工单)
sourceTicketIdsstring是要合并的源工单 ID,以逗号分隔
targetCommentstring否合并后添加到目标工单的评论
输出
参数类型说明
jobStatusobject作业状态对象
metadataobject操作元数据

获取用户

操作
获取用户
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
每页条数
每页结果数(默认:100,最大:100)
页码
页码
获取用户列表(zendesk_get_users)

从 Zendesk 获取用户列表,支持可选筛选

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名(例如 mycompany.zendesk.com 中的 "mycompany")
rolestring否按角色筛选(end-user、agent、admin)
permissionSetstring否按权限集 ID 筛选
perPagestring否每页结果数(默认:100,最大:100)
pagestring否页码
输出
参数类型说明
usersarray用户对象数组
pagingobject分页信息
metadataobject操作元数据

获取用户

操作
获取用户
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
用户 ID*
用户 ID
获取用户 (zendesk_get_user)

根据 ID 从 Zendesk 获取单个用户

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
userIdstring是要获取的用户 ID
输出
参数类型说明
userobject用户对象
metadataobject操作元数据

获取当前用户

操作
获取当前用户
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
Zendesk URL 中的子域名(mycompany.zendesk.com)
获取当前用户(zendesk_get_current_user)

从 Zendesk 获取当前已认证用户

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
输出
参数类型说明
userobject当前用户对象
metadataobject操作元数据

搜索用户

操作
搜索用户
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
查询
搜索查询
每页数量
每页结果数(默认:100,最大:100)
页码
页码
搜索用户 (zendesk_search_users)

使用查询字符串在 Zendesk 中搜索用户

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
querystring否搜索查询字符串
externalIdstring否用于搜索的外部 ID
perPagestring否每页结果数(默认:100,最大:100)
pagestring否页码
输出
参数类型说明
usersarray用户对象数组
pagingobject分页信息
metadataobject操作元数据

创建用户

操作
创建用户
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
名称*
用户名称
邮箱
用户邮箱
组织 ID
组织 ID
创建用户(zendesk_create_user)

在 Zendesk 中创建新用户

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
namestring是用户名称
userEmailstring否用户邮箱
rolestring否用户角色(end-user、agent、admin)
phonestring否用户电话号码
organizationIdstring否组织 ID
verifiedstring否设为 "true" 可跳过邮箱验证
tagsstring否逗号分隔的标签
customFieldsstring否自定义字段,JSON 对象(例如 {"field_id": "value"})
输出
参数类型说明
userobject已创建的用户对象
metadataobject操作元数据

批量创建用户

操作
批量创建用户
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
用户*
用户对象的 JSON 数组
批量创建用户 (zendesk_create_users_bulk)

通过批量导入在 Zendesk 中创建多个用户

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
usersstring是要创建的用户对象 JSON 数组
输出
参数类型说明
jobStatusobject任务状态对象
metadataobject操作元数据

更新用户

操作
更新用户
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
用户 ID*
用户 ID
名称
用户名称
邮箱
用户邮箱
组织 ID
组织 ID
更新用户 (zendesk_update_user)

更新 Zendesk 中的现有用户

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
userIdstring是要更新的用户 ID
namestring否新用户名
userEmailstring否新用户邮箱
rolestring否用户角色 (end-user, agent, admin)
phonestring否用户电话号码
organizationIdstring否组织 ID
verifiedstring否设为 "true" 可将用户标记为已验证
tagsstring否逗号分隔的标签
customFieldsstring否自定义字段,JSON 对象
输出
参数类型说明
userobject更新后的用户对象
metadataobject操作元数据

批量更新用户

操作
批量更新用户
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账号关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
用户*
用户对象的 JSON 数组
批量更新用户 (zendesk_update_users_bulk)

使用批量更新在 Zendesk 中更新多个用户

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
usersstring是要更新的用户对象 JSON 数组(必须包含 id 字段)
输出
参数类型说明
jobStatusobject作业状态对象
metadataobject操作元数据

删除用户

操作
删除用户
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
用户 ID*
用户 ID
删除用户 (zendesk_delete_user)

从 Zendesk 删除用户

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
userIdstring是要删除的用户 ID
输出
参数类型说明
deletedboolean删除是否成功
metadataobject操作元数据

获取组织

操作
获取组织
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
每页条数
每页结果数(默认:100,最大:100)
页码
页码
获取组织列表 (zendesk_get_organizations)

从 Zendesk 获取组织列表

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名(例如 mycompany.zendesk.com 中的 "mycompany")
perPagestring否每页结果数(默认:100,最大:100)
pagestring否页码
输出
参数类型说明
organizationsarray组织对象数组
pagingobject分页信息
metadataobject操作元数据

获取组织

操作
获取组织
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
组织 ID*
组织 ID
获取组织 (zendesk_get_organization)

根据 ID 从 Zendesk 获取单个组织

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
organizationIdstring是要获取的组织 ID
输出
参数类型说明
organizationobject组织对象
metadataobject操作元数据

自动补全组织

操作
自动补全组织
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
组织名称*
组织名称
每页数量
每页结果数(默认:100,最大:100)
页码
页码
组织自动补全(zendesk_autocomplete_organizations)

按名称前缀在 Zendesk 中自动补全组织(用于名称匹配/自动补全)

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
namestring是要搜索的组织名称
perPagestring否每页结果数(默认:100,最大:100)
pagestring否页码
输出
参数类型说明
organizationsarray组织对象数组
pagingobject分页信息
metadataobject操作元数据

创建组织

操作
创建组织
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如,"mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
组织名称
组织名称
创建组织(zendesk_create_organization)

在 Zendesk 中创建新组织

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
namestring是组织名称
domainNamesstring否逗号分隔的域名
detailsstring否组织详情
notesstring否组织备注
tagsstring否逗号分隔的标签
customFieldsstring否自定义字段,JSON 对象(例如 {"field_id": "value"})
输出
参数类型说明
organizationobject已创建的组织对象
metadataobject操作元数据

批量创建组织

操作
批量创建组织
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
组织*
组织对象的 JSON 数组
批量创建组织 (zendesk_create_organizations_bulk)

使用批量导入在 Zendesk 中创建多个组织

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
organizationsstring是要创建的组织对象的 JSON 数组
输出
参数类型说明
jobStatusobject作业状态对象
metadataobject操作元数据

更新组织

操作
更新组织
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
组织 ID
组织 ID
组织名称
组织名称
更新组织 (zendesk_update_organization)

更新 Zendesk 中的现有组织

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
organizationIdstring是要更新的组织 ID
namestring否新的组织名称
domainNamesstring否逗号分隔的域名
detailsstring否组织详情
notesstring否组织备注
tagsstring否逗号分隔的标签
customFieldsstring否自定义字段(JSON 对象)
输出
参数类型说明
organizationobject更新后的组织对象
metadataobject操作元数据

删除组织

操作
删除组织
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
组织 ID*
组织 ID
删除组织 (zendesk_delete_organization)

从 Zendesk 删除组织

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
organizationIdstring是要删除的组织 ID
输出
参数类型说明
deletedboolean删除成功
metadataobject操作元数据

搜索

操作
搜索
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
查询*
搜索查询
排序依据
Select...
排序方式
Select...
每页条数
每页结果数(默认:100,最大:100)
页码
页码
搜索 (zendesk_search)

在 Zendesk 中统一搜索工单、用户和组织

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
querystring是搜索查询字符串
sortBystring否排序字段 (relevance、created_at、updated_at、priority、status、ticket_type)
sortOrderstring否排序顺序 (asc 或 desc)
perPagestring否每页结果数 (默认:100,最大:100)
pagestring否页码
输出
参数类型说明
resultsarray结果对象数组
pagingobject分页信息
metadataobject操作元数据

搜索计数

操作
搜索计数
邮箱*
你的 Zendesk 邮箱地址
与你的 Zendesk 账户关联的邮箱地址
API 令牌*
••••••••
子域名*
你的 Zendesk 子域名(例如 "mycompany")
你的 Zendesk URL 中的子域名(mycompany.zendesk.com)
查询*
搜索查询
搜索计数 (zendesk_search_count)

统计 Zendesk 中匹配查询的搜索结果数量

输入
参数类型必填说明
emailstring是你的 Zendesk 邮箱地址
subdomainstring是你的 Zendesk 子域名
querystring是搜索查询字符串
输出
参数类型说明
countnumber匹配结果数量
metadataobject操作元数据

使用说明

将 Zendesk 集成到工作流中。可获取工单列表、获取工单、创建工单、批量创建工单、更新工单、批量更新工单、删除工单、合并工单、获取用户列表、获取用户、获取当前用户、搜索用户、创建用户、批量创建用户、更新用户、批量更新用户、删除用户、获取组织列表、获取组织、组织自动补全、创建组织、批量创建组织、更新组织、删除组织、搜索、搜索计数。

备注

  • 分类: tools
  • 类型: zendesk