业务数据 API
业务数据是可以与呼叫的元数据相关联的自定义字段。 使用业务数据 API,您可以为任何已关闭的交互更新现有业务数据字段的值。 您无法使用此 API 添加新的业务数据字段。 此 API 与 Studio 中的 MCR META DATA 操作配合使用。 此操作可使您在实时交互期间发送单个联系人的交互数据。
业务数据API的文档可在开发人员社区门户
中找到。
在您开始之前
可以在CXone Mpower开发人员门户 上测试
API。 使用CXone Mpower帐户登录,然后您可以使用帐户的租户
高层级组织分组,用于管理 CXone Mpower 系统的技术支持、计费和全局设置。发出请求。
要开始使用 API,您必须向 NiCE 注册以接收用于身份验证的有效凭据。 有关说明,请查看开发人员门户上的入门页面
。
使用这些 API 需要以下权限:
实体:要更新业务数据 API,您需要拥有搜索和回放 > API > 更新业务数据权限。
更新业务数据
对于已关闭的交互,请更新给定 ACD contactId 的所有可用细分的现有业务数据字段信息。
方法:PUT
端点:/business-data-manager/v1/business-data/contact/{ACD contactId}
参数:
| contactId*: |
字符串 要为其更新业务数据值的 ACD contactId 的唯一标识符。 |
URL:https://na1.test.nice-incontact.com/business-data-manager/v1/business-data/contact/8675309
类型:PUT
[ { "business_data_name1": "string of text" }, { "business_data_name2": true, }, { "business_data_name3": 1234, } ]
应答
-
状态 204 - 服务器已成功满足请求,并且响应负载正文中没有要发送的其他内容。
-
状态 400 - 请求包含不正确的输入参数。
-
状态 401 - 身份验证失败。 凭据不正确。
-
状态 403 - 需要权限。
-
状态 404 - 未找到请求的联系人。
-
状态 500 - 内部服务器错误。
更新业务数据
对于已关闭的交互,请更新给定 ACD contactId 中指定细分的现有业务数据字段信息。
方法:PUT
端点:/business-data-manager/v1/business-data/contact/{ACD contactId}/segment/{segmentId}
参数:
| contactId*: |
字符串 ACD contactId的唯一标识符,其中包含具有要更新的业务数据值的细分。 |
| segmentId*: |
字符串 ACD contactId细分的唯一标识符,其中包含要更新的业务数据值。 |
URL:https://na1.test.nice-incontact.com/business-data-manager/v1/business-data/contact/{ACD contactId}/segment/b2e28d4e-ef22-4597-a104-2e740f729686
类型:PUT
[ { "business_data_name1": "string of text" }, { "business_data_name2": true, }, { "business_data_name3": 8675309, } ]
应答
-
状态 204 - 服务器已成功满足请求,并且响应负载正文中没有要发送的其他内容。
-
状态 400 - 请求包含不正确的输入参数。
-
状态 401 - 身份验证失败。 凭据不正确。
-
状态 403 - 需要权限。
-
状态 404 - 未找到请求的区段。
-
状态 500 - 内部服务器错误。