CreateAnnotationMission - 创建标注任务

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
outboundbot:CreateAnnotationMissionnone
*全部资源
*

请求参数

名称类型必填描述示例值
AnnotationMissionDataSourceTypeinteger

标注任务数据类型。

  • 1:外呼
1
ScriptIdstring

外呼场景 ID

6236f21e-2e04-4dad-a47b-ae77e6a48325
InstanceIdstring

实例 ID

bf3b51a5-e88a-4636-98b0-1a34725a085b
Finishedboolean

业务是否正常结束。

说明 当 SessionEndReasonFilterList 没有传入值时,这个参数才生效。
  • true:正常通话记录
  • false:非正常完结通话记录
  • True
    SessionEndReasonFilterListarray

    通话结果状态过滤条件

    说明 与 SessionEndReasonFilterListJsonString 相同,二者选其一填入即可。
    SessionEndReasonFilterListinteger

    关键词过滤规则。

    通话记录过滤枚举值

    • 1:正常完结
    • 2:拒识后机器人挂机
    • 3:静默超时挂机
    • 4:拒识后用户挂机
    • 5:用户无理由挂机
    • 6:命中意图转人工
    • 7:拒识转人工
    • 8:用户侧无交互
    • 9:系统异常中断
    • 10:命中意图转 IVR
    • 11:拒识别转 IVR
    1
    SessionEndReasonFilterListJsonStringstring

    通话结果状态过滤条件

    说明 与 SessionEndReasonFilterList 作用相同,两个参数任选其一填入即可。 格式为[1]、[1,2]等。数组中可填入多个过滤条件,过滤条件对应的枚举值如下。

    通话记录过滤枚举值

    • 1:正常完结
    • 2:拒识后机器人挂机
    • 3:静默超时挂机
    • 4:拒识后用户挂机
    • 5:用户无理由挂机
    • 6:命中意图转人工
    • 7:拒识转人工
    • 8:用户侧无交互
    • 9:系统异常中断
    • 10:命中意图转 IVR
    • 11:拒识别转 IVR
    [1]
    ExcludeOtherSessionboolean

    是否排除其他任务已标注的通话记录,不填写默认为 false

    true
    ConversationTimeStartFilterlong

    通话时间过滤开始时间

    1683302400000
    ConversationTimeEndFilterlong

    通话时间过滤结束时间

    1682956800000
    SamplingTypeinteger

    抽样类型。

    • 1:全量
    • 2:百分比
    • 3:自定义量
    1
    SamplingRateinteger

    抽样比例

    说明 该参数当 SamplingType 为 2 时生效,同时需要必填,否则会导致创建失败。
    1
    SamplingCountinteger

    抽样数量自定义量

    说明 该参数当 SamplingType 为 3 时生效,同时需要必填,否则会导致创建失败。
    1
    AnnotationMissionNamestring

    标注任务名称

    询问卖车-标注任务-20230506-112934
    AnnotationMissionDebugDataSourceListarray

    标注数据来源列表

    说明 与 AnnotationMissionDebugDataSourceListJsonString 参数作用相同,两者任选其一即可。
    integer

    业务数据列表

    枚举值:

    • 1:外呼任务
    • 2:测试任务
    1
    AnnotationMissionDebugDataSourceListJsonStringstring

    调试数据 JSON

    说明 与 AnnotationMissionDebugDataSourceList 参数作用相同,两者任选其一即可。格式为[1]、[2]、[1,2]。数组中可填入多个过滤条件,过滤条件对应的枚举值如下
    • 1:外呼任务
    • 2:测试任务
    [1]
    ChatbotIdstring

    机器人 ID

    说明 可从 DescribeScript 接口中拿到
    chatbot-cn-fqEnFZBYnb
    AgentIdstring

    坐席 ID

    说明 可从 DescribeInstance 接口中获取
    1168702
    AgentKeystring

    业务空间 key

    说明 可从 DescribeInstance 接口中获取
    9137ab9c27044921860030adf8590ec4_p_outbound_public

    返回参数

    名称类型描述示例值
    object

    BaseResponse

    Successboolean

    是否调用成功。true:调用成功。 false:调用失败。

    True
    Codestring

    接口状态码

    OK
    Messagestring

    附加信息。取值说明如下:请求正常,返回 success。请求异常,返回具体异常错误码。

    执行失败:查找元素或操作超时,outTaskId:trademark_regnew_public_cn-uax33hol2uu,flowId:null,nodeUUID:541b6c71-8cce-4ab0-af84-713ca9741821
    Dataobject

    返回数据。

    Successboolean

    是否成功

    True
    Messagestring

    附加信息。取值说明如下:请求正常,返回 success。请求异常,返回具体异常错误码。

    执行失败:查找元素或操作超时,outTaskId:trademark_regnew_public_cn-uax33hol2uu,flowId:null,nodeUUID:541b6c71-8cce-4ab0-af84-713ca9741821
    HttpStatusCodeinteger

    HTTP 状态码

    200
    RequestIdstring

    请求 ID。

    254EB995-DEDF-48A4-9101-9CA5B72FFBCC

    示例

    正常返回示例

    JSON格式

    {
      "Success": true,
      "Code": "OK",
      "Message": "执行失败:查找元素或操作超时,outTaskId:trademark_regnew_public_cn-uax33hol2uu,flowId:null,nodeUUID:541b6c71-8cce-4ab0-af84-713ca9741821",
      "Data": {
        "Success": true,
        "Message": "执行失败:查找元素或操作超时,outTaskId:trademark_regnew_public_cn-uax33hol2uu,flowId:null,nodeUUID:541b6c71-8cce-4ab0-af84-713ca9741821"
      },
      "HttpStatusCode": 200,
      "RequestId": "254EB995-DEDF-48A4-9101-9CA5B72FFBCC"
    }

    错误码

    HTTP status code错误码错误信息描述
    500InternalErrorAn error occurred while processing your request. Please try again later. Submit a ticket if the error still exists.内部错误。建议重试,如果多次重试报错请提交工单。

    访问错误中心查看更多错误码。

    变更历史

    变更时间变更内容概要操作
    暂无变更历史