End a Contact

用于根据唯一的联系人 ID 终止一个活动的联系。可用于任何媒体类型或渠道中，并通过合理执行操作来强制性让活动的联系结束。典型的用例是在紧急情况下、从队列中清除卡住不动的联系、终止特定的脚本（比如生成的脚本）或者当使用 API 调用运行坐席应用程序时。 如果要终止特定的脚本，可以使用 End 操作。要在同一脚本中终止活动语音联系，可以使用 End a Contact操作。

支持的脚本类型

通用	Email	聊天	电话	语音信箱	工作项目	短信

类似操作比较

以下操作具有类似功能，但存在一些关键区别：

• DiscardDiscard：终止电子邮件脚本。
• EndEnd：终止电话、语音邮件、SMS 或数字脚本。不终止数字联系人，但终止使用其他媒体类型的脚本中的联系人。
• End a ContactEnd a Contact：终止活动联系人。不终止当前脚本。
• EndTextEndText：终止不包含 Regagent 操作的 SMS 工作流（仅适用于数字 与Digital Experience相关的任何渠道、联系或技能。渠道）。
• EndWiEndWi：使用原因代码终止工作项。不终止当前脚本。
• ExitExit：终止聊天会话并断开聊天联系。
• HangupHangup：终止电话脚本。
• ReturnReturn：终止下标并将控制权返回给原始脚本。

输入属性

这些属性定义操作在执行时使用的数据。

属性	说明
SecurityUser	SetSecurityUser 操作的输出值，该操作会根据安全配置文件中的坐席权限对选定的坐席进行身份验证。此字段接受用花括号 ( { } ) 格式化的变量。默认值为 SecurityUser（与 SetSecurityUser 的默认输出值相同）。
ContactID	在成功执行此操作之后，坐席将被设置为的所需状态。选项包括 Unavailable 或 Available，并且可以作为变量使用。

输出属性

这些属性包含保存执行操作返回的数据的变量。它们在操作完成后供引用和使用。

属性	说明
__DISCONNECTREASON	TerminateScript

结果分支条件

结果分支条件允许您在脚本中创建分支，以在执行操作时处理不同的结果。

条件	说明
Default	除了脚本满足条件要求其接受其他分支的情况之外，所要采用的路径。如果未定义操作的其他分支，也会执行此操作。
OnSuccess	完成操作而无错误，且 API 调用或数据返回全部成功时所采用的路径（2xx 响应代码）。
OnInvalidContactID	所请求的联系人 ID 无效时所采用的路径。
OnUnauthorized	SecurityUser 没有正确的角色/权限来执行 API 操作时所采用的路径。
OnInvalidSecurityUser	使用无效的安全用户时所采用的路径。