本文章中描述的可用性检查应仅用于 Zendesk 以外的客户关系管理整合。要检查 Zendesk 专员空闲状态，请参阅 在与高级人工智能专员对话期间检查营业时间和专员空闲状态 。
使用高级人工智能专员提供客户支持时，了解人工专员何时可以介入会很有帮助。专员空闲状态 API 可以帮助您的人工智能专员根据某些标准检查特定专员或专员组的空闲状态。
API 通过消息传送等不同渠道，提供关于每个专员状态的详细信息，包括专员是在线、离开还是离线。它还显示他们在所有渠道中的总体空闲状态、当前正在处理的任务，以及特定渠道的工作量限制。
通过使用专员空闲状态 API，您可以使人工智能专员在以下方面更加智能：切换对话、将客户查询转发给合适的专员，或跟踪专员空闲状态或预计等待时间。
在本文章中，我们将向您展示如何进行设置，以便您的人工智能专员和支持团队更高效地合作，为客户提供更快、更准确的帮助。
本文章包含以下主题：
在整合生成器中设置专员空闲状态 API 的先决条件
要在整合生成器中设置专员空闲状态 API，您需要收集以下关键信息：
- Zendesk 子域名。这是您在 Zendesk 实例中的公司名称。这是 URL 所必需的，以便使用整合生成器调用 API。
- 身份验证密钥和管理员电邮。此密钥在管理中心创建，将授权您的人工智能专员请求获取专员空闲状态数据。
- 任意组 ID（如适用）。如果您想筛选属于特定组的在线专员，可以使用 URL 查询来完成。
创建密钥以访问 API
要访问 Zendesk API，您需要在管理中心创建一个密钥。
创建 API 密钥
- 在 管理中心，单击侧栏中的 应用和整合 ，然后选择 API> Zendesk API。
- 单击 添加 API 密钥。
- 为密钥指定一个描述性名称，例如 专员空闲状态。
- 将密钥复制到安全的地方，因为您需要使用它在整合生成器中设置整合。
在整合生成器中创建整合
- 在整合生成器中创建整合。
- 转到 环境 标签，然后选择您的环境（例如 Production，或者您可以将其更改为更具描述性的内容，例如 getAgents）。
- 使用以下格式设置端点，并将 [your-subdomain] 替换为您的子域名：
https://[您的子域名].zendesk.com/api/v2/agent_availability - （可选）通过筛选进一步自定义查询 URL。
- 示例 1：如果您想查看消息传送渠道中现在有多少专员在线：
https://[您的子域名].zendesk.com/api/v2/agent_availability?filter[channel_status]=messaging:online - 如果您要检查特定服务组中是否有空专员：
https://l[your-subdomain].zendesk.com/api/v2/agent_availability?filter[channel_status]=messaging:online&filter[group_id]={{groupId}}
有关更多信息，请参阅 专员空闲状态 API。
- 示例 1：如果您想查看消息传送渠道中现在有多少专员在线：
- 在 授权 标签上，将 授权类型 设置为 基本身份验证。
- 用户名：您的管理员电邮地址，后缀“/token”（例如，admin@yourcompany.com/token）。
- 密码：将您之前生成的 API 密钥粘贴到管理中心。
- 在 标头 标签上，单击 添加标头。
- 在 Key（密钥 ）字段中，输入 Authorization（授权）。
- 在 值 字段中，输入 Basic {{apiToken}}.
- （可选）如果您要检查特定的 groupId，可以将其静态添加到 URL 查询中，也可以在 请求参数 中使用 groupId 这样的键值并添加 &filter[group_id] 创建参数，以创建动态链接={{groupId}}替换为 URL（如步骤 4 所示）。
设置完成后，您应该可以成功测试整合以查看响应。
对于成功场景，您现在可以添加会话参数。以下是三个常用参数的范例：
-
agentCheck：提供一系列相关的空闲专员。
- 在对话生成器中，使用包含条件块。
-
可用专员：提供一定数量的相关空闲专员。
- 在对话生成器中，使用带有大于/小于的条件块。
-
预估等待：将已开启工作项目的数量除以活跃的专员，再乘以平均处理时间。此值以分钟为单位。
- 在对话生成器中，使用带有大于/小于的条件块。
- 在对话生成器中，使用带有大于/小于的条件块。
这些参数现在可用于对话生成器，并带有一个 API 节点，可调用您在整合生成器中构建的专员空闲状态整合。
翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性
如对翻译准确性有任何疑问，请以文章的英语版本为准。