API de encerramento

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 36 min. de leitura

    • . Encerramento A API fornece endpoints para gerenciar a funcionalidade de encerramento de sistemas de Contact Center como serviço (CCaaS) externos ou ServiceNow AI Platform espaços de trabalho.

    Esta API requer o plug-in Gestão de interações (com.glide.interaction). Para chamar esta API, você deve ter a função interaction_integration_user.

    Quando os agentes encerram uma interação, o recurso de encerramento permite que eles insiram detalhes de encerramento e códigos de encerramento para referência futura. Para obter mais informações sobre a funcionalidade de encerramento, consulte Wrap up overview.

    Para usar o. Encerramento API Para encerramento segmentado de interações de sistemas externos, você deve implementar o ponto de extensão com script InteractionSegment para criar e recuperar registros de segmento na tabela escolhida. Se você estiver usando OpenFrame , O ponto de extensão tem uma implementação existente para criar e recuperar registros de segmento na tabela Log de telefone [sn_openframe_phone_log].

    Encerramento - OBTER /now/wrapup/code/

    Recupera detalhes de um código de encerramento especificado.

    Formato de URL

    URL com controle de versão: /api/now/

    URL padrão: /api/now/wrapup/code/

    Parâmetros de solicitação compatíveis

    Tabela 1. Parâmetros de caminho
    Nome Descrição
    api_version Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente.

    Tipo de dados: Cadeia de caracteres
    code_id Sys_id do código de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Código de encerramento da interação [interaction_wrap_up_code]
    Tabela 2. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 3. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    Nenhum(a)

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 4. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tabela 5. Cabeçalhos de resposta
    Cabeçalho Descrição
    Nenhum(a)

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 6. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    400 Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
    401 Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Nome Descrição
    resultado Objeto que contém informações sobre a solicitação de API e o código de encerramento.

    Tipo de dados: Objeto

    "result": {
   "message": "String",
   "resultMap": {Object},
   "success": Boolean
}
    resultado.mensagem Mensagem que descreve o resultado da solicitação de API.

    Tipo de dados: Cadeia de caracteres
    result.result_map Objeto que contém o código de encerramento.

    Tipo de dados: Objeto

    "result_map": {
   "wrap_up_code": {Object}
}
    result.result_map.wrap_up_code Objeto com detalhes sobre o código de encerramento.

    Tipo de dados: Objeto

    "wrap_up_code": {
   "active": Boolean,
   "code": "String",
   "description": "String",
   "external": Boolean,
   "sys_id": "String",
   "translated_code": "String",
   "translated_description": "String"
}
    result.result_map.wrap_up_code.active Sinalizador que indica se o código de encerramento está ativo.
    Valores válidos:
    • Verdadeiro: O código de encerramento está ativo.
    • Falso: O código de encerramento não está ativo.

    Tipo de dados: Booliano

    Padrão: verdadeiro
    result.result_map.wrap_up_code.code Rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    result.result_map.wrap_up_code.description Descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    result.result_map.wrap_up_code.external Sinalizador que indica se o código de encerramento é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O código de encerramento é de um sistema externo.
    • Falso: O código de encerramento é interno.

    Tipo de dados: Booliano
    result.result_map.wrap_up_code.sys_id Sys_id do código de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Código de encerramento da interação [interaction_wrap_up_code]
    result.result_map.wrap_up_code.translated_code Uma tradução do rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    result.result_map.wrap_up_code.translated_description Uma tradução da descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    resultado.sucesso Sinalizador que indica se a solicitação de API foi processada com sucesso.
    Valores válidos:
    • Verdadeiro: A solicitação de API foi bem-sucedida.
    • Falso: Falha na solicitação de API.

    Tipo de dados: Booliano

    Solicitação de curl

    Este exemplo recupera detalhes de um código de encerramento especificado.

    curl "https://instance.service-now.com/api/now/v1/wrapup/code/49c27b679f201210c89656effa0a1cd7" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Corpo da resposta.

    {
  "result": {
    "message": "Wrap up code found.",
    "result_map": {
      "wrap_up_code": {
        "code": "Billing Issue",
        "description": "A code for billing issues",
        "active": true,
        "external": true,
        "sys_id": "49c27b679f201210c89656effa0a1cd7",
        "translated_code": "Abrechnungsproblem",
        "translated_description": "Ein code für Abrechnungsprobleme"
      }
    },
    "success": true
  }
}

    Encerramento - OBTER /now/wrapup/segment/(segment_id)

    Recupera detalhes de um segmento de encerramento especificado.

    Formato de URL

    URL com controle de versão: /api/now/

    URL padrão: /api/now/wrapup/segment/

    Parâmetros de solicitação compatíveis

    Tabela 7. Parâmetros de caminho
    Nome Descrição
    api_version Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente.

    Tipo de dados: Cadeia de caracteres
    segment_id Sys_id do segmento de encerramento na tabela Segmento de encerramento da interação [interaction_wrap_up_segment] ou identificador que representa o segmento de interação no sistema externo.

    Tipo de dados: Cadeia de caracteres
    Tabela 8. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 9. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    Nenhum(a)

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 10. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tabela 11. Cabeçalhos de resposta
    Cabeçalho Descrição
    Nenhum(a)

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 12. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    400 Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
    401 Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Nome Descrição
    mensagem Mensagem que descreve o resultado da solicitação de API.

    Tipo de dados: Cadeia de caracteres
    segmento Objeto que contém dados sobre a interação e o segmento de encerramento.

    Tipo de dados: Objeto

    "segment": {
  "agent": "String",
  "awaiting_confirmation": Boolean,
  "confirmed_on": "String",
  "external": Boolean,
  "interaction": "String",
  "opened_on": "String",
  "segmented": Boolean,
  "segment_id": "String",
  "segment_table": "String",
  "state": "String",
  "submitted_on": "String",
  "sys_id": "String",
  "wrap_up_configuration": {Object} 
}
    segment.agent Sys_id do agente atribuído à interação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    segment.waiting_confirmation Sinalizador que indica se o segmento de encerramento enviado pelo agente está aguardando confirmação de que foi processado pelo sistema CCaaS externo.
    Valores válidos:
    • Verdadeiro: O segmento de encerramento está aguardando confirmação.
    • Falso: O segmento de encerramento foi processado pelo sistema externo.

    Tipo de dados: Booliano
    segment.confirmed_on Data e hora em que o segmento de encerramento enviado é processado no sistema CCaaS externo.

    Tipo de dados: Cadeia de caracteres
    segment.external Sinalizador que indica se o segmento de interação é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O segmento de interação é de um sistema externo.
    • Falso: O segmento de interação é interno.

    Tipo de dados: Booliano

    Padrão: falso
    segment.interaction Sys_id da interação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Interação [interaction]
    segment.opened_on A data e a hora de início do período de encerramento de acordo com o sistema externo.

    Tipo de dados: Cadeia de caracteres
    segment.segmented Sinalizador que indica se o encerramento está segmentado.
    Valores válidos:
    • Verdadeiro: O encerramento é segmentado em várias partes.
    • Falso: O encerramento é um segmento completo.

    Tipo de dados: Booliano

    Padrão: falso
    segment.segment_id Sys_id do segmento de interação.

    Tipo de dados: Cadeia de caracteres
    segment.segment_table Nome da tabela que contém o segmento de interação.

    Tipo de dados: Cadeia de caracteres
    segment.state Estado do segmento de interação.

    Tipo de dados: Cadeia de caracteres
    segment.submited_on Data e hora em que o agente enviou o segmento de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.sys_id Sys_id do segmento de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Segmento de encerramento da interação [interaction_wrap_up_segment]
    segment.wrap_up_configuration Objeto que contém detalhes sobre a configuração de encerramento usada para o segmento de encerramento.

    Tipo de dados: Objeto

    "wrap_up_configuration": {  
  "allowed_codes": [Array],
  "default_code": {Object},
  "enable_codes": Boolean
}
    segment.wrap_up_configuration.allowed_codes Matriz de objetos, cada um representando um código de encerramento que o agente tem permissão para usar.

    Tipo de dados: Matriz

    "allowed_codes": [
  {
    "active": Boolean, 
    "code": "String",
    "description": "String",
    "external": Boolean,
    "sys_id": "String",
    "translated_code": "String",
    "translated_description": "String"
  }
]
    segment.wrap_up_configuration.allowed_codes.active Sinalizador que indica se o código de encerramento está ativo.
    Valores válidos:
    • Verdadeiro: O código de encerramento está ativo.
    • Falso: O código de encerramento não está ativo.

    Tipo de dados: Booliano

    Padrão: verdadeiro
    segment.wrap_up_configuration.allowed_codes.code Rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.allowed_codes.description Descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.allowed_codes.external Sinalizador que indica se o código de encerramento é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O código de encerramento é de um sistema externo.
    • Falso: O código de encerramento é interno.

    Tipo de dados: Booliano
    segment.wrap_up_configuration.allowed_codes.sys_id Sys_id do código de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Código de encerramento da interação [interaction_wrap_up_code]
    segment.wrap_up_configuration.allowed_codes.translated_code Uma tradução do rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.allowed_codes.translated_description Uma tradução da descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code Objeto que contém o código de encerramento a ser usado como padrão.

    Tipo de dados: Objeto

    "default_code": {
  "active": Boolean,
  "code": "String",
  "description": "String",
  "external": Boolean,
  "sys_id": "String",
  "translated_code": "String",
  "translated_description": "String"
}
    segment.wrap_up_configuration.default_code.active Sinalizador que indica se o código de encerramento está ativo.
    Valores válidos:
    • Verdadeiro: O código de encerramento está ativo.
    • Falso: O código de encerramento não está ativo.

    Tipo de dados: Booliano

    Padrão: verdadeiro
    segment.wrap_up_configuration.default_code.code Rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code.description Descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code.external Sinalizador que indica se o código de encerramento é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O código de encerramento é de um sistema externo.
    • Falso: O código de encerramento é interno.

    Tipo de dados: Booliano
    segment.wrap_up_configuration.default_code.sys_id Sys_id do código de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Código de encerramento da interação [interaction_wrap_up_code]
    segment.wrap_up_configuration.default_code.translated_code Uma tradução do rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code.translated_description Uma tradução da descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.enable_codes Sinalizador que indica se o agente deve selecionar um código de encerramento.
    Valores válidos:
    • Verdadeiro: O agente deve selecionar um código de encerramento.
    • Falso: O agente não é necessário para selecionar um código de encerramento.

    Tipo de dados: Booliano

    Padrão: falso
    segment_id Sys_id do segmento de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Segmento de encerramento da interação [interaction_wrap_up_segment]
    êxito Sinalizador que indica se a solicitação de API foi processada com sucesso.
    Valores válidos:
    • Verdadeiro: A solicitação de API foi bem-sucedida.
    • Falso: Falha na solicitação de API.

    Tipo de dados: Booliano

    Solicitação de curl

    Este exemplo recupera detalhes de um segmento de encerramento especificado.

    curl "https://instance.service-now.com/api/now/v1/wrapup/segment/dgajbcef12345678defdbxef123435678" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Corpo da resposta.

    {
  "success": true,
  "message": "Wrap up segment retrieved successfully.",
  "segment_id": "dgajbcef12345678defdbxef123435678",
  "segment": {
    "agent": "123412345678567890ab90abcdefcdef",
    "segment_table": "sn_openframe_phone_log",
    "segment_id": "dgajbcef12345678defdbxef123435678",
    "external": true,
    "interaction": "213412345678567890ab90abcdefcdef",
    "state": "closed",
    "wrap_up_configuration": {
      "enable_codes": true,
      "allowed_codes": [
        {
          "code": "Billing Issue",
          "description": "",
          "active": true,
          "external": true,
          "sys_id": "49c27b679f201210c89656effa0a1cd7",
          "translated_code": "Abrechnungsproblem",
          "translated_description": ""
        },
        {
          "code": "Store Issue",
          "description": "",
          "active": true,
          "external": true,
          "sys_id": "54327b679f201210c89656effa0a1cd7",
          "translated_code": " Einkaufsproblem",
          "translated_description": ""
        }
      ],
      "default_code": {
        "code": "Billing Issue",
        "description": "",
        "active": true,
        "external": true,
        "sys_id": "49c27b679f201210c89656effa0a1cd7",
        "translated_code": "Abrechnungsproblem",
        "translated_description": ""
      }
    },
    "segmented": true,
    "sys_id": "dgajbcef12345678defdbxef123435678",
    "opened_on": "2024-09-16 17:52:01",
    "submitted_on": "2024-09-16 18:51:59",
    "confirmed_on": "2024-09-16 18:52:01",
    "awaiting_confirmation": false
  }
}

    Encerramento - OBTER /now/wrapup/segment/agent/

    Recupera detalhes de um segmento de encerramento com base em um agente e interação especificados.

    Formato de URL

    URL com controle de versão: /api/now//wrapup/segment/agent//agent//interaction/

    URL padrão: /api/now/wrapp/segment/agent//interaction/

    Parâmetros de solicitação compatíveis

    Tabela 13. Parâmetros de caminho
    Nome Descrição
    api_version Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente.

    Tipo de dados: Cadeia de caracteres
    agent_id Sys_id do agente atribuído à interação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    interaction_id Sys_id da interação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Interação [interaction]
    Tabela 14. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 15. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    Nenhum(a)

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 16. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tabela 17. Cabeçalhos de resposta
    Cabeçalho Descrição
    Nenhum(a)

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 18. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    400 Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
    401 Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Nome Descrição
    mensagem Mensagem que descreve o resultado da solicitação de API.

    Tipo de dados: Cadeia de caracteres
    segmento Objeto que contém dados sobre a interação e o segmento de encerramento.

    Tipo de dados: Objeto

    "segment": {
  "agent": "String",
  "awaiting_confirmation": Boolean,
  "confirmed_on": "String",
  "external": Boolean,
  "interaction": "String",
  "opened_on": "String",
  "segmented": Boolean,
  "segment_id": "String",
  "segment_table": "String",
  "state": "String",
  "submitted_on": "String",
  "sys_id": "String",
  "wrap_up_configuration": {Object} 
}
    segment.agent Sys_id do agente atribuído à interação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    segment.waiting_confirmation Sinalizador que indica se o segmento de encerramento enviado pelo agente está aguardando confirmação de que foi processado pelo sistema CCaaS externo.
    Valores válidos:
    • Verdadeiro: O segmento de encerramento está aguardando confirmação.
    • Falso: O segmento de encerramento foi processado pelo sistema externo.

    Tipo de dados: Booliano
    segment.confirmed_on Data e hora em que o segmento de encerramento enviado é processado no sistema CCaaS externo.

    Tipo de dados: Cadeia de caracteres
    segment.external Sinalizador que indica se o segmento de interação é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O segmento de interação é de um sistema externo.
    • Falso: O segmento de interação é interno.

    Tipo de dados: Booliano

    Padrão: falso
    segment.interaction Sys_id da interação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Interação [interaction]
    segment.opened_on A data e a hora de início do período de encerramento de acordo com o sistema externo.

    Tipo de dados: Cadeia de caracteres
    segment.segmented Sinalizador que indica se o encerramento está segmentado.
    Valores válidos:
    • Verdadeiro: O encerramento é segmentado em várias partes.
    • Falso: O encerramento é um segmento completo.

    Tipo de dados: Booliano

    Padrão: falso
    segment.segment_id Sys_id do segmento de interação.

    Tipo de dados: Cadeia de caracteres
    segment.segment_table Nome da tabela que contém o segmento de interação.

    Tipo de dados: Cadeia de caracteres
    segment.state Estado do segmento de interação.

    Tipo de dados: Cadeia de caracteres
    segment.submited_on Data e hora em que o agente enviou o segmento de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.sys_id Sys_id do segmento de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Segmento de encerramento da interação [interaction_wrap_up_segment]
    segment.wrap_up_configuration Objeto que contém detalhes sobre a configuração de encerramento usada para o segmento de encerramento.

    Tipo de dados: Objeto

    "wrap_up_configuration": {  
  "allowed_codes": [Array],
  "default_code": {Object},
  "enable_codes": Boolean
}
    segment.wrap_up_configuration.allowed_codes Matriz de objetos, cada um representando um código de encerramento que o agente tem permissão para usar.

    Tipo de dados: Matriz

    "allowed_codes": [
  {
    "active": Boolean, 
    "code": "String",
    "description": "String",
    "external": Boolean,
    "sys_id": "String",
    "translated_code": "String",
    "translated_description": "String"
  }
]
    segment.wrap_up_configuration.allowed_codes.active Sinalizador que indica se o código de encerramento está ativo.
    Valores válidos:
    • Verdadeiro: O código de encerramento está ativo.
    • Falso: O código de encerramento não está ativo.

    Tipo de dados: Booliano

    Padrão: verdadeiro
    segment.wrap_up_configuration.allowed_codes.code Rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.allowed_codes.description Descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.allowed_codes.external Sinalizador que indica se o código de encerramento é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O código de encerramento é de um sistema externo.
    • Falso: O código de encerramento é interno.

    Tipo de dados: Booliano
    segment.wrap_up_configuration.allowed_codes.sys_id Sys_id do código de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Código de encerramento da interação [interaction_wrap_up_code]
    segment.wrap_up_configuration.allowed_codes.translated_code Uma tradução do rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.allowed_codes.translated_description Uma tradução da descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code Objeto que contém o código de encerramento a ser usado como padrão.

    Tipo de dados: Objeto

    "default_code": {
  "active": Boolean,
  "code": "String",
  "description": "String",
  "external": Boolean,
  "sys_id": "String",
  "translated_code": "String",
  "translated_description": "String"
}
    segment.wrap_up_configuration.default_code.active Sinalizador que indica se o código de encerramento está ativo.
    Valores válidos:
    • Verdadeiro: O código de encerramento está ativo.
    • Falso: O código de encerramento não está ativo.

    Tipo de dados: Booliano

    Padrão: verdadeiro
    segment.wrap_up_configuration.default_code.code Rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code.description Descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code.external Sinalizador que indica se o código de encerramento é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O código de encerramento é de um sistema externo.
    • Falso: O código de encerramento é interno.

    Tipo de dados: Booliano
    segment.wrap_up_configuration.default_code.sys_id Sys_id do código de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Código de encerramento da interação [interaction_wrap_up_code]
    segment.wrap_up_configuration.default_code.translated_code Uma tradução do rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code.translated_description Uma tradução da descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.enable_codes Sinalizador que indica se o agente deve selecionar um código de encerramento.
    Valores válidos:
    • Verdadeiro: O agente deve selecionar um código de encerramento.
    • Falso: O agente não é necessário para selecionar um código de encerramento.

    Tipo de dados: Booliano

    Padrão: falso
    segment_id Sys_id do segmento de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Segmento de encerramento da interação [interaction_wrap_up_segment]
    êxito Sinalizador que indica se a solicitação de API foi processada com sucesso.
    Valores válidos:
    • Verdadeiro: A solicitação de API foi bem-sucedida.
    • Falso: Falha na solicitação de API.

    Tipo de dados: Booliano

    Solicitação de curl

    Este exemplo recupera detalhes de um segmento de encerramento com base em um agente e interação especificados.

    curl "https://instance.service-now.com/api/now/v1/wrapup/segment/agent/123412345678567890ab90abcdefcdef/interaction/213412345678567890ab90abcdefcdef" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Corpo da resposta.

    {
  "success": true,
  "message": "Wrap up segment retrieved successfully.",
  "segment_id": "dgajbcef12345678defdbxef123435678",
  "segment": {
    "agent": "123412345678567890ab90abcdefcdef",
    "segment_table": "sn_openframe_phone_log",
    "segment_id": "dgajbcef12345678defdbxef123435678",
    "external": true,
    "interaction": "213412345678567890ab90abcdefcdef",
    "state": "closed",
    "wrap_up_configuration": {
      "enable_codes": true,
      "allowed_codes": [
        {
          "code": "Billing Issue",
          "description": "",
          "active": true,
          "external": true,
          "sys_id": "49c27b679f201210c89656effa0a1cd7",
          "translated_code": "Abrechnungsproblem",
          "translated_description": ""
        },
        {
          "code": "Store Issue",
          "description": "",
          "active": true,
          "external": true,
          "sys_id": "54327b679f201210c89656effa0a1cd7",
          "translated_code": " Einkaufsproblem",
          "translated_description": ""
        }
      ],
      "default_code": {
        "code": "Billing Issue",
        "description": "",
        "active": true,
        "external": true,
        "sys_id": "49c27b679f201210c89656effa0a1cd7",
        "translated_code": "Abrechnungsproblem",
        "translated_description": ""
      }
    },
    "segmented": true,
    "sys_id": "dgajbcef12345678defdbxef123435678",
    "opened_on": "2024-09-16 17:52:01",
    "submitted_on": "2024-09-16 18:51:59",
    "confirmed_on": "2024-09-16 18:52:01",
    "awaiting_confirmation": false
  }
}

    Encerramento - PUBLICAR /now/wrapup/code

    Cria ou atualiza códigos de encerramento.

    Os códigos de encerramento são criados na tabela Código de encerramento da interação [interaction_wrap_up_code].

    Formato de URL

    URL com controle de versão: /api/now/

    URL padrão: /api/now/wrapup/code

    Parâmetros de solicitação compatíveis

    Tabela 19. Parâmetros de caminho
    Nome Descrição
    api_version Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente.

    Tipo de dados: Cadeia de caracteres
    Tabela 20. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 21. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    códigos Obrigatório. Matriz de objetos, cada um representando um código de encerramento.

    Tipo de dados: Matriz

    "codes": [
   {
      "active": Boolean,
      "code": "String",
      "description": "String",
      "translations": [Array]
   }
]
    códigos.ativo Sinalizador que indica se o código de encerramento está ativo.
    Valores válidos:
    • Verdadeiro: O código de encerramento está ativo.
    • Falso: O código de encerramento não está ativo.

    Tipo de dados: Booliano

    Padrão: verdadeiro
    codes.code Obrigatório. Rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    codes.description Descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    codes.translations Matriz de objetos, cada um representando uma tradução do código de encerramento.

    Tipo de dados: Matriz

    "translations": [
   {    
      "code": "Abrechnungsproblem",
      "description": "Ein code für Abrechnungsprobleme",
      "language": "de"
   }
]
    codes.translations.code Uma tradução do rótulo do código de encerramento ( codes.code). Necessário se estiver usando codes.translationsparâmetro.

    Tipo de dados: Cadeia de caracteres
    codes.translations.description Uma tradução da descrição do código de encerramento ( codes.description). Necessário se estiver usando codes.translationse um valor foi fornecido para codes.description.

    Tipo de dados: Cadeia de caracteres
    códigos.traduções.idioma Código de duas letras para o idioma usado na tradução. Necessário se estiver usando codes.translationsparâmetro.

    Tipo de dados: Cadeia de caracteres

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 22. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tipo de conteúdo Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tabela 23. Cabeçalhos de resposta
    Cabeçalho Descrição
    Nenhum(a)

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 24. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    207 Bem-sucedido. Alguns códigos de encerramento criados com sucesso. Erros de validação ao criar outros.
    400 Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
    401 Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Nome Descrição
    resultado Objeto que contém informações sobre a solicitação de API e os códigos de encerramento criados.

    Tipo de dados: Objeto

    "result": {
   "message": "String",
   "resultMap": {Object},
   "success": Boolean
}
    resultado.mensagem Mensagem que descreve o resultado da solicitação de API.

    Tipo de dados: Cadeia de caracteres
    result.result_map Objeto que contém uma matriz de códigos de encerramento criados.

    Tipo de dados: Objeto

    "result_map": {
   "created_wrap_up_codes": [Array]
}
    result.result_map.created_wrap_up_codes Matriz de objetos, cada um representando um código de encerramento criado.

    Tipo de dados: Matriz

    "created_wrap_up_codes": [
   {
      "active": Boolean,
      "code": "String",
      "description": "String",
      "external": Boolean,
      "sys_id": "String",
      "translated_code": "String",
      "translated_description": "String"
   }
]
    result.result_map.created_wrap_up_codes.active Sinalizador que indica se o código de encerramento está ativo.
    Valores válidos:
    • Verdadeiro: O código de encerramento está ativo.
    • Falso: O código de encerramento não está ativo.

    Tipo de dados: Booliano

    Padrão: verdadeiro
    result.result_map.created_wrap_up_codes.code Rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    result.result_map.created_wrap_up_codes.description Descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    result.result_map.created_wrap_up_codes.external Sinalizador que indica se o código de encerramento é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O código de encerramento é de um sistema externo.
    • Falso: O código de encerramento é interno.

    Tipo de dados: Booliano
    result.result_map.created_wrap_up_codes.sys_id Sys_id do código de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Código de encerramento da interação [interaction_wrap_up_code]
    result.result_map.created_wrap_up_codes.translated_code Uma tradução do rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    result.result_map.created_wrap_up_codes.translated_description Uma tradução da descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    resultado.sucesso Sinalizador que indica se a solicitação de API foi processada com sucesso.
    Valores válidos:
    • Verdadeiro: A solicitação de API foi bem-sucedida.
    • Falso: Falha na solicitação de API.

    Tipo de dados: Booliano

    Solicitação de curl

    Este exemplo cria um código de encerramento para problemas de faturamento com uma tradução em alemão.

    curl "https://instance.service-now.com/api/now/v1/wrapup/code" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
  \"codes\": [
    {
      \"code\": \"Billing Issue\",
      \"description\": \"A code for billing issues\",
      \"translations\": [
        {
          \"language\": \"de\",
          \"code\": \"Abrechnungsproblem\",
          \"description\": \"Ein code für Abrechnungsprobleme\"
        }
      ]
    }
  ]
}" \
--user 'username':'password'

    Corpo da resposta.

    {
  "result": {
    "message": "All wrap up codes created successfully.",
    "result_map": {
      "created_wrap_up_codes": [
        {
          "code": "Billing Issue",
          "description": "A code for billing issues",
          "active": true,
          "external": true,
          "sys_id": "49c27b679f201210c89656effa0a1cd7",
          "translated_code": "Abrechnungsproblem",
          "translated_description": "Ein code für Abrechnungsprobleme"
        }
      ]
    },
    "success": true
  }
}

    Encerramento - PUBLICAR /now/wrapup/segment/create

    Abre um segmento de encerramento para uma interação.

    Os encerramentos são criados na tabela Segmento de encerramento da interação [interaction_wrap_up_segment].

    Formato de URL

    URL com controle de versão: /api/now//wrapup/segment/create

    URL padrão: /api/now/wrapup/segment/create

    Parâmetros de solicitação compatíveis

    Tabela 25. Parâmetros de caminho
    Nome Descrição
    api_version Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente.

    Tipo de dados: Cadeia de caracteres
    Tabela 26. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 27. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    agent_sys_id Obrigatório. Sys_id do agente atribuído à interação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    configuração Objeto que contém o código e os detalhes de duração de um encerramento externo. Necessário se external. verdadeiro .

    Tipo de dados: Objeto

    "configuration": {  
   "allowed_codes": [Array], 
   "default_code": "String", 
   "duration": "String", 
   "enable_codes": Boolean  
}
    configuration.allowed_codes Matriz de objetos, cada um representando um código de encerramento que o agente tem permissão para usar. Necessário se externale. configuration.enable_codesambos verdadeiro .

    Tipo de dados: Matriz

    "allowed_codes": [ 
   { 
      "code": "String", 
      "translation": {Object}  
   } 
]
    configuration.allowed_codes.code Rótulo do código de encerramento.Necessário se estiver usando configuration.allowed_codesparâmetro.

    Tipo de dados: Cadeia de caracteres
    configuration.allowed_codes.translation Uma tradução do código de encerramento.

    Tipo de dados: Objeto

    "translation": {  
   "code": "String",
   "language": "String"  
}
    configuration.allowed_codes.translation.code Uma tradução do rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    configuration.allowed_codes.translation.language Código de duas letras para o idioma usado na tradução.

    Tipo de dados: Cadeia de caracteres
    configuration.default_code Rótulo do código de encerramento a ser usado como padrão. Necessário se externale. configuration.enable_codesambos verdadeiro .

    Tipo de dados: Cadeia de caracteres

    Tabela: Código de encerramento da interação [interaction_wrap_up_code]

    Campo: Código
    configuration.duration Duração máxima de encerramento permitida.

    Tipo de dados: Cadeia de caracteres

    Unidade: segundos

    Cadeia de caracteres vazia (sem limite de tempo).
    configuration.enable_codes Sinalizador que indica se o agente deve selecionar um código de encerramento.
    Valores válidos:
    • Verdadeiro: O agente deve selecionar um código de encerramento.
    • Falso: O agente não é necessário para selecionar um código de encerramento.

    Tipo de dados: Booliano

    Padrão: falso
    externo Sinalizador que indica se o segmento de interação é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O segmento de interação é de um sistema externo.
    • Falso: O segmento de interação é interno.

    Tipo de dados: Booliano

    Padrão: falso
    external_segment_id Identificador que representa o segmento de interação no sistema externo. Necessário se external. verdadeiro .

    Tipo de dados: Cadeia de caracteres
    interaction_sys_id Obrigatório. Sys_id da interação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Interação [interaction]
    opened_on A data e a hora de início do período de encerramento de acordo com o sistema externo.Necessário se estiver usando configuration.durationparâmetro.

    Tipo de dados: Cadeia de caracteres
    segmentado Sinalizador que indica se o encerramento está segmentado.
    Valores válidos:
    • Verdadeiro: O encerramento é segmentado em várias partes.
    • Falso: O encerramento é um segmento completo.

    Tipo de dados: Booliano

    Padrão: falso
    segment_id Sys_id do segmento de interação. Necessário se externale. segmentedambos verdadeiro .
    Nota:
    Você deve implementar o ponto de extensão com script InteractionSegment para criar e recuperar registros de segmento na tabela escolhida ou usar o. OpenFrame Implementação para criar e recuperar registros de segmento na tabela Log de telefone [sn_openframe_phone_log].

    Tipo de dados: Cadeia de caracteres
    segment_table Nome da tabela que contém o segmento de interação. Necessário se externale. segmentedambos verdadeiro .

    Tipo de dados: Cadeia de caracteres
    wrap_up_configuration_sys_id Sys_id da configuração de encerramento a ser usada. Necessário se external. falso .

    Tipo de dados: Cadeia de caracteres

    Tabela: Configuração de encerramento da interação [interaction_wrap_up_configuration]

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 28. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tipo de conteúdo Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tabela 29. Cabeçalhos de resposta
    Cabeçalho Descrição
    Nenhum(a)

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 30. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    400 Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
    401 Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Nome Descrição
    mensagem Mensagem que descreve o resultado da solicitação de API.

    Tipo de dados: Cadeia de caracteres
    segmento Objeto que contém dados sobre a interação e o segmento de encerramento.

    Tipo de dados: Objeto

    "segment": {
  "agent": "String",
  "external": Boolean,
  "interaction": "String",
  "opened_on": "String",
  "segmented": Boolean,
  "segment_id": "String",
  "segment_table": "String",
  "state": "String",
  "sys_id": "String",
  "wrap_up_configuration": {Object} 
}
    segment.agent Sys_id do agente atribuído ao segmento de interação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    segment.external Sinalizador que indica se o segmento de interação é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O segmento de interação é de um sistema externo.
    • Falso: O segmento de interação é interno.

    Tipo de dados: Booliano

    Padrão: falso
    segment.interaction Sys_id da interação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Interação [interaction]
    segment.opened_on A data e a hora de início do período de encerramento de acordo com o sistema externo.

    Tipo de dados: Cadeia de caracteres
    segment.segmented Sinalizador que indica se o encerramento está segmentado.
    Valores válidos:
    • Verdadeiro: O encerramento é segmentado em várias partes.
    • Falso: O encerramento é um segmento completo.

    Tipo de dados: Booliano

    Padrão: falso
    segment.segment_id Sys_id do segmento de interação.

    Tipo de dados: Cadeia de caracteres
    segment.segment_table Nome da tabela que contém o segmento de interação.

    Tipo de dados: Cadeia de caracteres
    segment.state Estado do segmento de interação. Segmentos de interação que o Encerramento As APIs criadas com sucesso estão no estado Aberto.

    Tipo de dados: Cadeia de caracteres
    segment.sys_id Sys_id do segmento de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Segmento de encerramento da interação [interaction_wrap_up_segment]
    segment.wrap_up_configuration Objeto que contém detalhes sobre a configuração de encerramento usada para o segmento de encerramento.

    Tipo de dados: Objeto

    "wrap_up_configuration": {  
  "allowed_codes": [Array],
  "default_code": {Object},
  "enable_codes": Boolean
}
    segment.wrap_up_configuration.allowed_codes Matriz de objetos, cada um representando um código de encerramento que o agente tem permissão para usar.

    Tipo de dados: Matriz

    "allowed_codes": [
  {
    "active": Boolean, 
    "code": "String",
    "description": "String",
    "external": Boolean,
    "sys_id": "String",
    "translated_code": "String",
    "translated_description": "String"
  }
]
    segment.wrap_up_configuration.allowed_codes.active Sinalizador que indica se o código de encerramento está ativo.
    Valores válidos:
    • Verdadeiro: O código de encerramento está ativo.
    • Falso: O código de encerramento não está ativo.

    Tipo de dados: Booliano

    Padrão: verdadeiro
    segment.wrap_up_configuration.allowed_codes.code Rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.allowed_codes.description Descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.allowed_codes.external Sinalizador que indica se o código de encerramento é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O código de encerramento é de um sistema externo.
    • Falso: O código de encerramento é interno.

    Tipo de dados: Booliano
    segment.wrap_up_configuration.allowed_codes.sys_id Sys_id do código de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Código de encerramento da interação [interaction_wrap_up_code]
    segment.wrap_up_configuration.allowed_codes.translated_code Uma tradução do rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.allowed_codes.translated_description Uma tradução da descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code Objeto que contém o código de encerramento a ser usado como padrão.

    Tipo de dados: Objeto

    "default_code": {
  "active": Boolean,
  "code": "String",
  "description": "String",
  "external": Boolean,
  "sys_id": "String",
  "translated_code": "String",
  "translated_description": "String"
}
    segment.wrap_up_configuration.default_code.active Sinalizador que indica se o código de encerramento está ativo.
    Valores válidos:
    • Verdadeiro: O código de encerramento está ativo.
    • Falso: O código de encerramento não está ativo.

    Tipo de dados: Booliano

    Padrão: verdadeiro
    segment.wrap_up_configuration.default_code.code Rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code.description Descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code.external Sinalizador que indica se o código de encerramento é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O código de encerramento é de um sistema externo.
    • Falso: O código de encerramento é interno.

    Tipo de dados: Booliano
    segment.wrap_up_configuration.default_code.sys_id Sys_id do código de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Código de encerramento da interação [interaction_wrap_up_code]
    segment.wrap_up_configuration.default_code.translated_code Uma tradução do rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code.translated_description Uma tradução da descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.enable_codes Sinalizador que indica se o agente deve selecionar um código de encerramento.
    Valores válidos:
    • Verdadeiro: O agente deve selecionar um código de encerramento.
    • Falso: O agente não é necessário para selecionar um código de encerramento.

    Tipo de dados: Booliano

    Padrão: falso
    êxito Sinalizador que indica se a solicitação de API foi processada com sucesso.
    Valores válidos:
    • Verdadeiro: A solicitação de API foi bem-sucedida.
    • Falso: Falha na solicitação de API.

    Tipo de dados: Booliano
    sys_id Sys_id do segmento de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Segmento de encerramento da interação [interaction_wrap_up_segment]

    Solicitação de curl

    Este exemplo abre um segmento de encerramento para uma interação.

    curl "https://instance.service-now.com/api/now/v1/wrapup/segment/create" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
  \"agent_sys_id\": \"123412345678567890ab90abcdefcdef\",
  \"interaction_sys_id\": \"213412345678567890ab90abcdefcdef\",
  \"external\": \"true\",
  \"segmented\": \"true\",
  \"segment_table\": \"sn_openframe_phone_log\",
  \"segment_id\": \"dgajbcef12345678defdbxef123435678\",
  \"external_segment_id\": \"PL_402548\",
  \"configuration\": {
    \"enable_codes\": true,
    \"allowed_codes\": [
      {
        \"code\": \"Billing Issue\",
        \"translation\": {
          \"language\": \"de\",
          \"code\": \"Abrechnungsproblem\"
        }
      },
      {
        \"code\": \"Store Issue\",
        \"translation\": {
          \"language\": \"de\",
          \"code\": \"Einkaufsproblem\"
        }
      }
    ],
    \"default_code\": \"Billing Issue\",
    \"duration\": \"30\"
  },
  \"opened_on\": \"2024-09-16 17:52:01\"
}" \
--user 'username':'password'

    Corpo da resposta.

    {
  "success": true,
  "message": "Open wrap-up segment successfully created.",
  "sys_id": "98769876543254321fed1fedcba0cba0",
  "segment": {
    "agent": "123412345678567890ab90abcdefcdef",
    "segment_table": "sn_openframe_phone_log",
    "segment_id": "dgajbcef12345678defdbxef123435678",
    "external": true,
    "interaction": "213412345678567890ab90abcdefcdef",
    "state": "open",
    "wrap_up_configuration": {
      "enable_codes": true,
      "allowed_codes": [
        {
          "code": "Billing Issue",
          "description": "",
          "active": true,
          "external": true,
          "sys_id": "49c27b679f201210c89656effa0a1cd7",
          "translated_code": "Abrechnungsproblem",
          "translated_description": ""
        },
        {
          "code": "Store Issue",
          "description": "",
          "active": true,
          "external": true,
          "sys_id": "54327b679f201210c89656effa0a1cd7",
          "translated_code": " Einkaufsproblem",
          "translated_description": ""
        }
      ],
      "default_code": {
        "code": "Billing Issue",
        "description": "",
        "active": true,
        "external": true,
        "sys_id": "49c27b679f201210c89656effa0a1cd7",
        "translated_code": "Abrechnungsproblem",
        "translated_description": ""
      }
    },
    "segmented": true,
    "sys_id": "98769876543254321fed1fedcba0cba0",
    "opened_on": "2024-09-16 17:52:01"
  }
}

    Encerramento - COLOQUE /now/wrapup/segment/update

    Atualiza e fecha um segmento de encerramento para uma interação.

    Formato de URL

    URL com controle de versão: /api/now//wrapup/segment/update

    URL padrão: /api/now/wrapup/segment/update

    Parâmetros de solicitação compatíveis

    Tabela 31. Parâmetros de caminho
    Nome Descrição
    api_version Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente.

    Tipo de dados: Cadeia de caracteres
    Tabela 32. Parâmetros de consulta
    Nome Descrição
    agent_sys_id Sys_id do agente atribuído à interação. Necessário junto com interaction_sys_idse nenhum deles segment_sys_idnor external_segment_idfornecidos.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    external_segment_id Identificador que representa o segmento de interação no sistema externo. Usado para identificar o segmento de encerramento a ser atualizado segment_sys_idnão foi fornecido.
    interaction_sys_id Sys_id da interação. Necessário junto com agent_sys_idse nenhum deles segment_sys_idnor external_segment_idfornecidos.

    Tipo de dados: Cadeia de caracteres

    Tabela: Interação [interaction]
    segment_sys_id Sys_id do segmento de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Segmento de encerramento da interação [interaction_wrap_up_segment]
    Tabela 33. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    confirmed_on A data e a hora de término do período de encerramento de acordo com o sistema externo.

    Tipo de dados: Cadeia de caracteres
    anotações Anotações adicionais adicionadas ao encerramento pelo agente.

    Tipo de dados: Cadeia de caracteres
    wrap_up_code Rótulo do código de encerramento selecionado pelo agente. Se o agente não selecionar um código, o código padrão configurado será usado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Código de encerramento da interação [interaction_wrap_up_code]

    Campo: Código

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 34. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tipo de conteúdo Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tabela 35. Cabeçalhos de resposta
    Cabeçalho Descrição
    Nenhum(a)

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 36. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    400 Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
    401 Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Nome Descrição
    mensagem Mensagem que descreve o resultado da solicitação de API.

    Tipo de dados: Cadeia de caracteres
    segmento Objeto que contém dados sobre a interação e o segmento de encerramento.

    Tipo de dados: Objeto

    "segment": {
  "agent": "String",
  "awaiting_confirmation": Boolean,
  "code": {Object},
  "confirmed_on": "String",
  "external": Boolean,
  "interaction": "String",
  "notes": "String",
  "opened_on": "String",
  "segmented": Boolean,
  "segment_id": "String",
  "segment_table": "String",
  "state": "String",
  "submitted_on": "String",
  "sys_id": "String",
  "wrap_up_configuration": {Object} 
}
    segment.agent Sys_id do agente atribuído à interação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    segment.waiting_confirmation Sinalizador que indica se o segmento de encerramento enviado pelo agente está aguardando confirmação de que foi processado pelo sistema CCaaS externo.
    Valores válidos:
    • Verdadeiro: O segmento de encerramento está aguardando confirmação.
    • Falso: O segmento de encerramento foi processado pelo sistema externo.

    Tipo de dados: Booliano
    segment.code Objeto que contém o código de encerramento selecionado pelo agente.

    Tipo de dados: Objeto

    "code": {
  "active": Boolean,
  "code": "String",
  "description": "String",
  "external": Boolean,
  "sys_id": "String",
  "translated_code": "String",
  "translated_description": "String"
}
    segment.code.active Sinalizador que indica se o código de encerramento está ativo.
    Valores válidos:
    • Verdadeiro: O código de encerramento está ativo.
    • Falso: O código de encerramento não está ativo.

    Tipo de dados: Booliano

    Padrão: verdadeiro
    segment.code.code Rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.code.description Descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.code.external Sinalizador que indica se o código de encerramento é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O código de encerramento é de um sistema externo.
    • Falso: O código de encerramento é interno.

    Tipo de dados: Booliano
    segment.code.sys_id Sys_id do código de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Código de encerramento da interação [interaction_wrap_up_code]
    segment.code.translated_code Uma tradução do rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.code.translated_description Uma tradução da descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.confirmed_on Data e hora em que o segmento de encerramento enviado é processado no sistema CCaaS externo.

    Tipo de dados: Cadeia de caracteres
    segment.external Sinalizador que indica se o segmento de interação é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O segmento de interação é de um sistema externo.
    • Falso: O segmento de interação é interno.

    Tipo de dados: Booliano

    Padrão: falso
    segment.interaction Sys_id da interação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Interação [interaction]
    segment.notes Anotações adicionais adicionadas ao encerramento pelo agente.

    Tipo de dados: Cadeia de caracteres
    segment.opened_on A data e a hora de início do período de encerramento de acordo com o sistema externo.

    Tipo de dados: Cadeia de caracteres
    segment.segmented Sinalizador que indica se o encerramento está segmentado.
    Valores válidos:
    • Verdadeiro: O encerramento é segmentado em várias partes.
    • Falso: O encerramento é um segmento completo.

    Tipo de dados: Booliano

    Padrão: falso
    segment.segment_id Sys_id do segmento de interação.

    Tipo de dados: Cadeia de caracteres
    segment.segment_table Nome da tabela que contém o segmento de interação.

    Tipo de dados: Cadeia de caracteres
    segment.state Estado do segmento de interação. Os segmentos de interação que este endpoint atualiza com sucesso estão no estado Encerrado.

    Tipo de dados: Cadeia de caracteres
    segment.submited_on Data e hora em que o agente enviou o segmento de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.sys_id Sys_id do segmento de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Segmento de encerramento da interação [interaction_wrap_up_segment]
    segment.wrap_up_configuration Objeto que contém detalhes sobre a configuração de encerramento usada para o segmento de encerramento.

    Tipo de dados: Objeto

    "wrap_up_configuration": {  
  "allowed_codes": [Array],
  "default_code": {Object},
  "enable_codes": Boolean
}
    segment.wrap_up_configuration.allowed_codes Matriz de objetos, cada um representando um código de encerramento que o agente tem permissão para usar.

    Tipo de dados: Matriz

    "allowed_codes": [
  {
    "active": Boolean, 
    "code": "String",
    "description": "String",
    "external": Boolean,
    "sys_id": "String",
    "translated_code": "String",
    "translated_description": "String"
  }
]
    segment.wrap_up_configuration.allowed_codes.active Sinalizador que indica se o código de encerramento está ativo.
    Valores válidos:
    • Verdadeiro: O código de encerramento está ativo.
    • Falso: O código de encerramento não está ativo.

    Tipo de dados: Booliano

    Padrão: verdadeiro
    segment.wrap_up_configuration.allowed_codes.code Rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.allowed_codes.description Descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.allowed_codes.external Sinalizador que indica se o código de encerramento é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O código de encerramento é de um sistema externo.
    • Falso: O código de encerramento é interno.

    Tipo de dados: Booliano
    segment.wrap_up_configuration.allowed_codes.sys_id Sys_id do código de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Código de encerramento da interação [interaction_wrap_up_code]
    segment.wrap_up_configuration.allowed_codes.translated_code Uma tradução do rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.allowed_codes.translated_description Uma tradução da descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code Objeto que contém o código de encerramento a ser usado como padrão.

    Tipo de dados: Objeto

    "default_code": {
  "active": Boolean,
  "code": "String",
  "description": "String",
  "external": Boolean,
  "sys_id": "String",
  "translated_code": "String",
  "translated_description": "String"
}
    segment.wrap_up_configuration.default_code.active Sinalizador que indica se o código de encerramento está ativo.
    Valores válidos:
    • Verdadeiro: O código de encerramento está ativo.
    • Falso: O código de encerramento não está ativo.

    Tipo de dados: Booliano

    Padrão: verdadeiro
    segment.wrap_up_configuration.default_code.code Rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code.description Descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code.external Sinalizador que indica se o código de encerramento é de um sistema externo.
    Valores válidos:
    • Verdadeiro: O código de encerramento é de um sistema externo.
    • Falso: O código de encerramento é interno.

    Tipo de dados: Booliano
    segment.wrap_up_configuration.default_code.sys_id Sys_id do código de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Código de encerramento da interação [interaction_wrap_up_code]
    segment.wrap_up_configuration.default_code.translated_code Uma tradução do rótulo do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.default_code.translated_description Uma tradução da descrição do código de encerramento.

    Tipo de dados: Cadeia de caracteres
    segment.wrap_up_configuration.enable_codes Sinalizador que indica se o agente deve selecionar um código de encerramento.
    Valores válidos:
    • Verdadeiro: O agente deve selecionar um código de encerramento.
    • Falso: O agente não é necessário para selecionar um código de encerramento.

    Tipo de dados: Booliano

    Padrão: falso
    êxito Sinalizador que indica se a solicitação de API foi processada com sucesso.
    Valores válidos:
    • Verdadeiro: A solicitação de API foi bem-sucedida.
    • Falso: Falha na solicitação de API.

    Tipo de dados: Booliano
    sys_id Sys_id do segmento de encerramento.

    Tipo de dados: Cadeia de caracteres

    Tabela: Segmento de encerramento da interação [interaction_wrap_up_segment]

    Solicitação de curl

    Este exemplo atualiza e fecha um segmento de encerramento para uma interação.

    curl "https://instance.service-now.com/api/now/v1/wrapup/segment/update?segment_sys_id=98769876543254321fed1fedcba0cba0&agent_sys_id=123412345678567890ab90abcdefcdef&interaction_sys_id=213412345678567890ab90abcdefcde" \
--request PUT \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
  \"wrap_up_code\": \"Billing Issue\",
  \"notes\": \"Customer's credit card expired. Had to switch to another one.\",
  \"confirmed_on\": \"2024-09-16 18:52:01\"
}" \
--user 'username':'password'

    Corpo da resposta.

    {
  "success": true,
  "message": "Wrap-up segment updated successfully.",
  "sys_id": "98769876543254321fed1fedcba0cba0",
  "segment": {
    "agent": "123412345678567890ab90abcdefcdef",
    "segment_table": "sn_openframe_phone_log",
    "segment_id": "dgajbcef12345678defdbxef123435678",
    "external": true,
    "interaction": "213412345678567890ab90abcdefcdef",
    "state": "closed",
    "wrap_up_configuration": {
      "enable_codes": true,
      "allowed_codes": [
        {
          "code": "Billing Issue",
          "description": "",
          "active": true,
          "external": true,
          "sys_id": "49c27b679f201210c89656effa0a1cd7",
          "translated_code": "Abrechnungsproblem",
          "translated_description": ""
        },
        {
          "code": "Store Issue",
          "description": "",
          "active": true,
          "external": true,
          "sys_id": "54327b679f201210c89656effa0a1cd7",
          "translated_code": " Einkaufsproblem",
          "translated_description": ""
        }
      ],
      "default_code": {
        "code": "Billing Issue",
        "description": "",
        "active": true,
        "external": true,
        "sys_id": "49c27b679f201210c89656effa0a1cd7",
        "translated_code": "Abrechnungsproblem",
        "translated_description": ""
      }
    },
    "code": {
      "code": "Billing Issue",
      "description": "",
      "active": true,
      "external": true,
      "sys_id": "49c27b679f201210c89656effa0a1cd7",
      "translated_code": "Abrechnungsproblem",
      "translated_description": ""
    },
    "notes": "Customer's credit card expired. Had to switch to another one.",
    "segmented": true,
    "sys_id": "dgajbcef12345678defdbxef123435678",
    "opened_on": "2024-09-16 17:52:01",
    "submitted_on": "2024-09-16 18:51:59",
    "confirmed_on": "2024-09-16 18:52:01",
    "awaiting_confirmation": false
  }
}