配置自定义面板

自定义面板会显示一个或多个外部资源网址。这些资源可以是文档、工具或其他资源。您可以配置自定义网址面板或包含多个链接的自定义链接面板。这些面板类型的配置选项略有不同。例如，您可以在“自定义链接”面板中指定链接文本。

重要提示： 自定义网址必须支持 iframe。否则，面板中不会显示任何内容。Google 建议您测试网址，以确保该网址显示在 iframe 中。

为自定义网址配置面板

您可以配置一个包含指向外部资源的网址的自定义面板。您可以选择在面板中添加导航栏。您还可以添加 HTTP 标头，例如用于身份验证。

如需为自定义网址配置面板，请按以下步骤操作：

1. 在 CCAI Platform 门户中，依次点击设置 > 运营管理。如果您没有看到设置菜单，请点击 菜单。

2. 前往代理桌面窗格。

3. 对于自定义面板管理，请点击管理自定义面板列表。系统会显示自定义面板窗格。

4. 依次点击添加自定义面板 > 自定义网址。系统会显示添加自定义网址窗格。

5. 如需为自定义面板添加名称，请执行以下操作：

   1. 点击选择语言字段，然后点击自定义面板名称的语言。

   2. 在输入自定义面板名称字段中，输入面板的名称。

6. 可选：如需使用其他语言添加面板名称，请点击添加自定义面板名称，然后使用其他语言重复执行上述步骤。

7. 如果您以多种语言添加了面板名称，请选择默认语言。

8. 在显示网址字段中，输入外部资源的网址。您可以在网址中使用变量和函数。

9. 可选：如需根据客服人员的分配位置或语言选择动态控制自定义面板语言，请参阅动态控制自定义面板语言。

10. 如果您希望此面板显示导航栏，请选中在自定义面板中显示导航栏复选框。

11. 如需添加 HTTP 标头，请执行以下操作：

    1. 对于 HTTP 标头，请点击添加字段。

    2. 为 HTTP 标头输入键和值。您可以在值中使用变量和函数。

12. 如需添加其他 HTTP 标头，请点击添加字段，然后重复执行上述步骤。

13. 点击添加自定义网址面板。您的自定义面板会显示在自定义面板列表中。

配置自定义链接面板

您可以配置包含外部资源链接列表的自定义面板。此面板可让客服人员在处理通话和聊天会话时快速访问所需资源。

如需配置自定义链接面板，请按以下步骤操作：

1. 在 CCAI Platform 门户中，依次点击设置 > 运营管理。如果您没有看到设置菜单，请点击 菜单。

2. 前往代理桌面窗格。

3. 对于自定义面板管理，请点击管理自定义面板列表。系统会显示自定义面板窗格。

4. 依次点击添加自定义面板 > 自定义链接。系统会显示添加自定义链接面板窗格。

5. 如需为自定义面板添加名称，请执行以下操作：

   1. 点击选择语言字段，然后点击自定义面板名称的语言。

   2. 在输入自定义面板名称字段中，输入面板的名称。

6. 可选：如需添加其他语言的面板名称，请点击添加自定义面板名称，然后使用其他语言填写新行。

7. 如果您以多种语言添加了面板名称，请选择默认语言。

8. 如需添加链接，请执行以下操作：

   1. 点击添加链接。系统会显示添加链接窗格。

   2. 在网址字段中，输入外部资源的网址。您可以在网址中使用变量和函数。

   3. 可选：如需根据客服人员的分配位置或语言选择动态控制自定义面板语言，请参阅动态控制自定义面板语言。

9. 如需为网址添加链接文本，请执行以下操作：

   1. 点击选择语言字段，然后点击链接文字所用的语言。

   2. 在链接文本字段中，输入链接的链接文本。

10. 可选：如需添加其他语言的链接文字，请点击添加链接文字，然后使用其他语言填写新行。

11. 如果您添加了多种语言的链接文字，请选择默认语言。

12. 对于显示链接位置，请指定链接是在新标签页中打开还是在面板中打开。

13. 如需添加 HTTP 标头，请执行以下操作：

    1. 对于 HTTP 标头，请点击添加字段。

    2. 为 HTTP 标头输入键和值。您可以在值中使用变量和函数。

14. 如需添加其他 HTTP 标头，请点击添加字段，然后重复执行上述步骤。

15. 点击 Add（添加）。

16. 点击添加自定义网址面板。您的自定义面板会显示在自定义面板列表中。

动态控制自定义面板语言

您可以在自定义网址中使用 {AGENT_LOCATION_LANGUAGE} 或 {AGENT_LANGUAGE} 变量，以动态控制自定义面板的语言：

• 代理位置语言：在网址中添加 {AGENT_LOCATION_LANGUAGE} 变量，以使用代理分配的位置的语言显示自定义面板。示例：https://YOUR_CCAAS_HOST/lang={AGENT_LOCATION_LANGUAGE}。如需了解详情，请参阅变量。

• 代理语言：将 {AGENT_LANGUAGE} 变量添加到您的网址，以使用代理在代理桌面语言选择器中选择的语言显示自定义面板。如果客服人员在语言选择器中更改语言，自定义面板会重新加载并显示新选择的语言。 示例：https://YOUR_CCAAS_HOST/lang={AGENT_LANGUAGE}。如需了解详情，请参阅变量。

变量

您可以在网址和 HTTP 标头字段值中添加以下变量。 这些变量用于捕获代理、最终用户和会话信息。

代理变量

• {AGENT_ID}：代理 ID

• {AGENT_CUSTOM_ID}：代理的自定义 ID

• {AGENT_EMAIL}：代理的电子邮件地址

• {AGENT_ALIAS}：代理的别名

• {AGENT_LOCATION_LANGUAGE}：客服人员分配到的位置所用语言的语言代码，例如 en-US。如需使用此变量，代理需要具有已分配的位置和已分配的语言。如需了解详情，请参阅配置位置和语言。

• {AGENT_LANGUAGE}：代理在代理桌面语言选择器中选择的显示语言的语言代码，例如 en-US。如果客服人员在语言选择器中更改语言，自定义面板会重新加载并显示新选择的语言。如需了解详情，请参阅更改显示语言。

最终用户变量

• {UJET_ID}：最终用户 ID

• {ANI}：最终用户的手机号码

• {DEVICE_TYPE}：最终用户的设备类型

会话变量

• {SESSION_TYPE}：会话类型

• {PHONE_NUMBER}：最终用户的手机号码

• {SESSION_ID}：通话 ID 或聊天 ID

• {MENU_PATH}：菜单的网址路径

• {QUEUE_NAME}：队列的名称

• {QUEUE_ID}：内部队列 ID

• {LANGUAGE}：队列语言

• {OUTBOUND_PHONE_NUMBER}：出站手机号码

• {SUPPORT_PHONE_NUMBER}：最终用户拨打的支持手机号码

函数

您可以在网址和 HTTP 标头字段值中包含下表中的函数。

函数	语法	说明
默认值	=DEFAULT_VALUE(value_1, value_2)	使用 value_1，除非为 null 或空，否则使用 value_2。
串联 OR	=CONCAT_OR(value_1, value_2, value_3)	使用 OR 串联多个值。示例：value_1 OR value_2 OR value_3。
串联 AND	=CONCAT_AND(value_1, value_2, value_3)	使用 AND 串联多个值。示例：value_1 AND value_2 AND value_3。
JSON	=JSON({"key_1":"value_1", "key_2":"[value_2]"})	JSON 转为字符串。示例：{"key_1":"value_1","key_2":"value_2"}。
JSON 数组	=JSON_ARRAY({"key_1":"value_1"},{"key_2":"value_2"})	JSON 数组到字符串。示例：[{"key_1":"value_1"},{"key_2":"value_2"}]。