API do agente do AWA

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

    • . Agente AWA (Advanced Work Assignment) A API fornece endpoints para gerenciar a presença do agente, a disponibilidade do canal e a carga de trabalho.

    Esta API requer Atribuição avançada de trabalho plug-in (com.glide.awa) e a função awa_integration_user. Para obter mais informações, consulte Atribuição de trabalho avançada .

    AWA Agente - OBTER /now/awa/agents/

    Retorna o estado de presença do agente atual e a disponibilidade do canal.

    Formato de URL

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

    URL padrão: /api/now/awa/agents/

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    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
    user_id Sys_id do item de trabalho.
    O item de trabalho deve atender aos seguintes critérios:
    • O item de trabalho deve ser atribuído ao agente especificado.
    • O item de trabalho deve estar em Aceitação pendente estado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item de trabalho do AWA [awa_work_item]
    Tabela 2. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 3. Solicitar parâmetros do corpo (XML ou JSON)
    Cabeçalho Descrição
    presence.channels.available Sinalizador que indica se o canal está disponível.
    Valores possíveis:
    • Verdadeiro: O canal está disponível.
    • Falso: O canal não está disponível.

    Tipo de dados: Booliano
    presence.channels.sys_id Sys_id do canal.

    Tipo de dados: Cadeia de caracteres

    Tabela: Canais de serviço [awa_service_channel]
    presence.sys_id Sys_id do estado de presença.

    Tipo de dados: Cadeia de caracteres

    Tabela: Estados de presença [awa_presence_state]

    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
    Tipo de conteúdo Formato de dados do corpo da solicitação. 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.
    403 Proibido.
    Possíveis motivos:
    • O usuário não tem a função awa_integration_user.
    • O valor da propriedade glide.awa.enabled não é verdadeiro . Esta propriedade será listada na tabela Propriedade do sistema [sys_property] se o plug-in Advanced Work Assignment (com.glide.awa) estiver instalado. Para obter mais informações, consulte Componentes instalados com Advanced Work Assignment .
    404 Não encontrado. O item solicitado não foi encontrado.
    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)

    Tabela 7. Parâmetros do corpo da resposta (JSON ou XML)
    Parâmetro Descrição
    erro Detalhes que descrevem um erro encontrado durante o processo de solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes do erro encontrado durante o processo de solicitação.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem do erro encontrado durante o processo de solicitação. Cada mensagem de erro tem uma descrição correspondente no detailpropriedade.
    Valores possíveis:
    • Registro não encontrado : As informações fornecidas no corpo da solicitação são imprecisas ou não existem.
    • Usuário não autenticado : O usuário não tem a função awa_integration_user.

    Tipo de dados: Cadeia de caracteres
    presença Informações sobre o estado de presença atual e o canal de um agente.

    Tipo de dados: Objeto

    "presence": {
  "available": Boolean,
  "channels": [Array],
  "name": "String",
  "sys_id": "String"
}
    presença.disponível Sinalizador que indica se o agente está disponível.
    Valores possíveis:
    • Verdadeiro: O agente está disponível.
    • Falso: O agente não está disponível.

    Tipo de dados: Booliano
    presence.channels Lista de objetos que descrevem os canais de comunicação disponíveis com o agente.

    Tipo de dados: Matriz de objetos

    "channels": [
  {
    "available": Boolean,
    "name": "String",
    "sys_id": "String"
  }
]
    presence.channels.available Sinalizador que indica se o canal está disponível.
    Valores possíveis:
    • Verdadeiro: O canal está disponível.
    • Falso: O canal não está disponível.

    Tipo de dados: Booliano
    presence.channels.name Nome do canal, como Bate-papo ou Telefone.

    Tipo de dados: Cadeia de caracteres
    presence.channels.restrict_update Sinalizador que indica se o usuário pode restringir atualizações, ou seja, selecione o canal para disponibilidade.
    Valores possíveis:
    • Verdadeiro: O usuário pode selecionar este canal para disponibilidade.
    • Falso: O usuário não pode selecionar este canal para disponibilidade.

    Tipo de dados: Booliano
    presence.channels.service_channel_type Tipo de canal de serviço, como bate-papo. Os valores possíveis variam dependendo dos plug-ins instalados.

    Tipo de dados: Cadeia de caracteres
    presence.channels.sys_id Sys_id do canal.

    Tipo de dados: Cadeia de caracteres

    Tabela: Canais de serviço [awa_service_channel]
    presence.name Nome do estado de presença do agente.
    Valores possíveis:
    • Disponível
    • Indisponível

    Tipo de dados: Cadeia de caracteres
    presence.restrict_update Sinalizador que indica se o usuário pode restringir atualizações.
    Valores possíveis:
    • Verdadeiro: O usuário pode restringir atualizações.
    • Falso: O usuário não pode restringir atualizações.

    Tipo de dados: Booliano
    presence.sys_id Sys_id do estado de presença.

    Tipo de dados: Cadeia de caracteres

    Tabela: Estados de presença [awa_presence_state]
    status Status de uma solicitação malsucedida. Esta propriedade só será incluída na resposta se houver um erro.

    Valor válido: falha

    Tipo de dados: Cadeia de caracteres
    sys_id Sys_id do agente.

    Tipo de dados: Cadeia de caracteres
    workItem

    workItem: Informações sobre o item de trabalho associado ao evento.

    Tipo de dados: Cadeia de caracteres
    WorkItem.document workItem.document: Lista de documentos associados à tarefa de item de trabalho.

    Tipo de dados: Cadeia de caracteres
    WorkItem.document.sys_id workItem.document.sys_idSys_id do documento atribuído à tarefa do item de trabalho.

    Tipo de dados: Cadeia de caracteres
    WorkItem.document.table workItem.document.tableNome da tabela de documentos atribuída à tarefa.

    Tipo de dados: Cadeia de caracteres
    WorkItem.previousWorkItem workItem.previousWorkItemSys_id do item de trabalho anterior para o mesmo ID de documento. Para os itens de trabalho não transferidos, este valor está vazio.

    Tipo de dados: Cadeia de caracteres
    workItem.serviceChannel workItem.serviceChannel: Lista de canais de serviço associados à tarefa de item de trabalho.

    Tipo de dados: Cadeia de caracteres
    workItem.serviceChannel.name workItem.serviceChannel.nameNome do canal de serviço, como Bate-papo ou Telefone.

    Tipo de dados: Cadeia de caracteres
    workItem.serviceChannel.sys_id workItem.serviceChannel.sys_idSys_id do canal de serviço.

    Tipo de dados: Cadeia de caracteres
    WorkItem.size workItem.sizeCapacidade do agente usada quando este item de trabalho é atribuído ao agente.

    Tipo de dados: Cadeia de caracteres
    WorkItem.sys_id workItem.sys_idSys_id do item de trabalho que foi aceito ou oferecido.

    Tipo de dados: Cadeia de caracteres
    WorkItem.isQueueTransferido workItem.isQueueTransferredSinalizador que indica se o item de trabalho é transferido na fila. Defina como verdadeiro se o item de trabalho for transferido para fila, falso se não for. Para obter mais informações sobre transferências de fila, consulte Transfer a chat to another queue.

    Tipo de dados: Booliano
    workitem.isAutoAccepted workItem.isAutoAcceptedSinalizador que indica se o item de trabalho foi aceito automaticamente pelo sistema. Defina como verdadeiro se o item de trabalho tiver sido aceito automaticamente.

    Tipo de dados: Booliano

    Solicitação de cURL de amostra

    curl -X GET \
https://instance.servicenow.com/api/now/awa/agents/46d44a23a9fe19810012d100cca80666 \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-u 'username':'password'\
    {
  "result": {
    "presence": {
      "name": "Available",
      "sys_id": "0b10223c57a313005baaaa65ef94f970",
      "available": true,
      "channels": [
        {
          "name": "Chat",
          "available": true,
          "sys_id": "27f675e3739713004a905ee515f6a7c3"
        }
      ]
    },
    "sys_id": "46d44a23a9fe19810012d100cca80666"
  }
}

    AWA Agente - OBTENHA /now/awa/agents/user_id/capabilities

    Retorna as capacidades de canal de um agente, a capacidade universal e a carga de trabalho atual para ver se o agente pode lidar com um caso.

    Use AWA Agente - PUT /now/awa/agents/user_id/capabilities método para modificar o canal e as capacidades universais de um agente.

    Consulte também:

    Formato de URL

    URL com controle de versão: /api/now//api/awa/agents/user_id/capabilities

    URL padrão: /api/now/awa/agents/user_id/capabilities

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 8. 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
    user_id Sys_id do agente listado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    Tabela 9. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 10. 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 11. 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 12. 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 13. 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.
    403 Proibido.
    Possíveis motivos:
    • O usuário não tem a função awa_integration_user.
    • O valor da propriedade glide.awa.enabled não é verdadeiro . Esta propriedade será listada na tabela Propriedade do sistema [sys_property] se o plug-in Advanced Work Assignment (com.glide.awa) estiver instalado. Para obter mais informações, consulte Componentes instalados com Advanced Work Assignment .
    404 Não encontrado. O item solicitado não foi encontrado.
    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
    canais Lista de objetos que descrevem os canais de comunicação disponíveis com o agente. 
    "channels": [
  {
    "channel_sys_id": "String",
    "current_workload": Number,
    "max_capacity": Number
  }
]

    Tipo de dados: Matriz
    channels.channel_sys_id Sys_id do canal.

    Tipo de dados: Cadeia de caracteres

    Tabela: Canais de serviço [awa_service_channel]
    channels.current_workload Número de itens de trabalho em um canal de serviço específico atualmente atribuído ao agente.

    Tipo de dados: Número
    channels.max_capacity Carga de trabalho máxima em um canal de serviço específico ao qual o agente pode ser atribuído ativamente de cada vez.

    Tipo de dados: Cadeia de caracteres
    erro Detalhes que descrevem um erro encontrado durante o processo de solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes do erro encontrado durante o processo de solicitação.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem do erro encontrado durante o processo de solicitação.A descrição é fornecida em error.detailpropriedade.

    Tipo de dados: Cadeia de caracteres
    status Status de uma solicitação malsucedida. Esta propriedade só será incluída na resposta se houver um erro.

    Valor válido: falha

    Tipo de dados: Cadeia de caracteres
    universal_capacity Capacidade máxima do agente em todos os canais de serviço. Se a carga de trabalho atual de um agente for igual à capacidade universal máxima, itens de trabalho adicionais não serão atribuídos ao agente.

    Esta propriedade retornará somente se existir um registro de capacidade universal para este agente.

    Tipo de dados: Número
    universal_workload Número de itens de trabalho em todos os canais de serviço atualmente atribuídos ao agente especificado.

    Esta propriedade retornará somente se existir um registro de capacidade universal para o agente.

    Tipo de dados: Número

    Solicitação de cURL de amostra

    O exemplo a seguir mostra como obter os valores de capacidade e carga de trabalho de um usuário.

    curl "https://instance.service-now.com/api/now/awa/agents/46d44a23a9fe19810012d100cca80666/capacities" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Uma resposta bem-sucedida inclui valores de capacidade e carga de trabalho para cada canal.

    {
  "result": {
    "universal_workload": 2,
    "channels": [
      {
        "channel_sys_id": "27f675e3739713004a905ee515f6a7c3",
        "current_workload": 2,
        "max_capacity": 4
      }
    ],
    "universal_capacity": 10
  }
}

    AWA Agente - OBTENHA /now/awa/agents//presence_states

    Retorna os estados de presença de um agente e indica se o agente está disponível ou em outro estado de presença.

    Formato de URL

    URL com controle de versão: /api/now//api/awa/agents//user_id/presence_states

    URL padrão: /api/now/awa/agents//presence_states

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 14. 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
    user_id Sys_id do agente listado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    Tabela 15. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 16. 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 17. 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 18. 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 19. 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.
    403 Proibido.
    Possíveis motivos:
    • O usuário não tem a função awa_integration_user.
    • O valor da propriedade glide.awa.enabled não é verdadeiro . Esta propriedade será listada na tabela Propriedade do sistema [sys_property] se o plug-in Advanced Work Assignment (com.glide.awa) estiver instalado. Para obter mais informações, consulte Componentes instalados com Advanced Work Assignment .
    404 Não encontrado. O item solicitado não foi encontrado.
    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
    erro Detalhes que descrevem um erro encontrado durante o processo de solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes do erro encontrado durante o processo de solicitação.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem do erro encontrado durante o processo de solicitação.A descrição é fornecida em error.detailpropriedade.

    Tipo de dados: Cadeia de caracteres
    <presence state> Lista de definições de estado de presença do agente como objetos. Cada objeto descreve o estado e inclui os canais do agente.

    Tipo de dados: Matriz

    {
  "available": Boolean,
  "channels": [Array],
  "disable_inactivity_check": Boolean,
  "name": "String",
  "show_channels": Boolean,
  "sys_id": "String"
}
    <presence state>.disponível Sinalizador que indica se o agente está disponível.
    Valores possíveis:
    • Verdadeiro: O agente está disponível.
    • Falso: O agente não está disponível.

    Tipo de dados: Booliano
    <presence state>.channels Lista de objetos que descrevem os canais de comunicação disponíveis com o agente.

    Tipo de dados: Matriz

    "channels": [
 {
  "available": Boolean,
  "name": "String",
  "restrict_update": Boolean,
  "service_channel_type": "String",
  "sys_id": "String"
 }
]
    canais.<presence state>.disponível Sinalizador que indica se o canal está disponível.
    Valores possíveis:
    • Verdadeiro: O canal está disponível.
    • Falso: O canal não está disponível.

    Tipo de dados: Booliano
    <presence state>.channels.name Nome do canal, como Bate-papo ou Telefone.

    Tipo de dados: Cadeia de caracteres
    <presence state>.channels.sys_id Sys_id do canal.

    Tipo de dados: Cadeia de caracteres

    Tabela: Canais de serviço [awa_service_channel]
    <presence state>.disable_inactivity_check Sinalizador que indica se deve verificar a inatividade deste estado de presença.
    Valores válidos:
    • Verdadeiro: A verificação de inatividade do estado de presença está desabilitada.
    • Falso: A verificação de inatividade do estado de presença está habilitada.

    Tipo de dados: Booliano

    Padrão: falso

    Para obter informações sobre como modificar essa configuração, consulte Configurar estados de presença do agente .
    <presence state>.name Nome do estado de presença do agente.Os estados de presença instalados por padrão são Disponível , Fora e Off-line .

    Tipo de dados: Cadeia de caracteres
    pedido.<presence state> Ordem na qual esse estado é exibido na caixa de entrada do agente.

    Tipo de dados: Número
    <presence state>.show_channels Sinalizador que indica se o agente tem permissão para mudar o estado de presença, por exemplo, de Disponível para Ausente.
    Valores válidos:
    • Verdadeiro: O usuário tem permissão para mudar a presença.
    • Falso: O usuário está impedido de mudar a presença.

    Tipo de dados: Booliano
    sys_id.sys_id <presence state> Sys_id do estado de presença.

    Tipo de dados: Cadeia de caracteres

    Tabela: Estados de presença [awa_presence_state]
    status Status de uma solicitação malsucedida. Esta propriedade só será incluída na resposta se houver um erro.

    Valor válido: falha

    Tipo de dados: Cadeia de caracteres

    Solicitação de cURL de amostra

    O exemplo a seguir mostra como obter os estados de presença de um agente especificado.

    curl "https://instance.service-now.com/api/now/awa/agents/46d44a23a9fe19810012d100cca80666/presence_states" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    O corpo da resposta lista os possíveis estados de presença do agente e indica que o agente está disponível.

    {
  "result": [
    {
      "name": "Available",
      "order": 0,
      "show_channels": false,
      "sys_id": "0b10223c57a313005baaaa65ef94f970",
      "available": true,
      "channels": [
        {
          "name": "Chat",
          "available": true,
          "sys_id": "27f675e3739713004a905ee515f6a7c3",
          "restrict_update": false,
          "service_channel_type": "chat"
        }
      ],
      "disable_inactivity_check": false
    },
    {
      "name": "Away",
      "order": 1000,
      "show_channels": false,
      "sys_id": "41f9b8dfb31313005baa6e5f26a8dcac",
      "available": false,
      "channels": [],
      "disable_inactivity_check": false
    },
    {
      "name": "Offline",
      "order": 2000,
      "show_channels": false,
      "sys_id": "9cd83267575313005baaaa65ef94f98b",
      "available": false,
      "channels": [],
      "disable_inactivity_check": false
    }
  ]
}

    AWA /Now/awa/agents/

    Define o estado da presença de um agente especificado e, se fornecido, define a disponibilidade do canal do agente para esse estado.

    Formato de URL

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

    URL padrão: /api/now/awa/agents/

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 20. 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
    user_id Sys_id do agente.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    Tabela 21. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 22. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    presence.channels Lista de objetos que definem quais canais estão disponíveis para o agente.
    Tipo de dados: Matriz de objetos
    "channels": [
  { 
    "available": Boolean,
    "sys_id": "String"
  }
]
    presence.channels.available Sinalizador que indica se o canal está disponível.
    Valores possíveis:
    • Verdadeiro: O canal está disponível.
    • Falso: O canal não está disponível.
    Nota:
    Esta configuração deve ser especificada para incluir canais no corpo da resposta.

    Tipo de dados: Booliano

    Padrão: falso
    presence.channels.sys_id Sys_id do canal.

    Tipo de dados: Cadeia de caracteres

    Tabela: Canais de serviço [awa_service_channel]
    presence.sys_id Sys_id do estado de presença.

    Tipo de dados: Cadeia de caracteres

    Tabela: Estados de presença [awa_presence_state]

    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 23. 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 24. 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 25. 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.
    403 Proibido.
    Possíveis motivos:
    • O usuário não tem a função awa_integration_user.
    • O valor da propriedade glide.awa.enabled não é verdadeiro . Esta propriedade será listada na tabela Propriedade do sistema [sys_property] se o plug-in Advanced Work Assignment (com.glide.awa) estiver instalado. Para obter mais informações, consulte Componentes instalados com Advanced Work Assignment .
    404 Não encontrado. O item solicitado não foi encontrado.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.
    Tabela 26. Parâmetros do corpo da resposta (JSON ou XML)
    Parâmetro Descrição
    erro Detalhes que descrevem um erro encontrado durante o processo de solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes do erro encontrado durante o processo de solicitação.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem do erro encontrado durante o processo de solicitação. Cada mensagem de erro tem uma descrição correspondente no detailpropriedade.
    Valores possíveis:
    • Registro não encontrado : As informações fornecidas no corpo da solicitação são imprecisas ou não existem.
    • Usuário não autenticado : O usuário não tem a função awa_integration_user.

    Tipo de dados: Cadeia de caracteres
    presença Informações sobre o estado de presença atual e o canal de um agente.

    Tipo de dados: Objeto

    "presence": {
  "available": Boolean,
  "channels": [Array],
  "name": "String",
  "sys_id": "String"
}
    presença.disponível Sinalizador que indica se o agente está disponível.
    Valores possíveis:
    • Verdadeiro: O agente está disponível.
    • Falso: O agente não está disponível.

    Tipo de dados: Booliano
    presence.channels Lista de objetos que descrevem os canais de comunicação disponíveis com o agente.

    Tipo de dados: Matriz de objetos

    "channels": [
  {
    "available": Boolean,
    "name": "String",
    "sys_id": "String"
  }
]
    presence.channels.available Sinalizador que indica se o canal está disponível.
    Valores possíveis:
    • Verdadeiro: O canal está disponível.
    • Falso: O canal não está disponível.

    Tipo de dados: Booliano
    presence.channels.name Nome do canal, como Bate-papo ou Telefone.

    Tipo de dados: Cadeia de caracteres
    presence.channels.restrict_update Sinalizador que indica se o usuário pode restringir atualizações, ou seja, selecione o canal para disponibilidade.
    Valores possíveis:
    • Verdadeiro: O usuário pode selecionar este canal para disponibilidade.
    • Falso: O usuário não pode selecionar este canal para disponibilidade.

    Tipo de dados: Booliano
    presence.channels.service_channel_type Tipo de canal de serviço, como bate-papo. Os valores possíveis variam dependendo dos plug-ins instalados.

    Tipo de dados: Cadeia de caracteres
    presence.channels.sys_id Sys_id do canal.

    Tipo de dados: Cadeia de caracteres

    Tabela: Canais de serviço [awa_service_channel]
    presence.name Nome do estado de presença do agente.
    Valores possíveis:
    • Disponível
    • Indisponível

    Tipo de dados: Cadeia de caracteres
    presence.restrict_update Sinalizador que indica se o usuário pode restringir atualizações.
    Valores possíveis:
    • Verdadeiro: O usuário pode restringir atualizações.
    • Falso: O usuário não pode restringir atualizações.

    Tipo de dados: Booliano
    presence.sys_id Sys_id do estado de presença.

    Tipo de dados: Cadeia de caracteres

    Tabela: Estados de presença [awa_presence_state]
    status Status de uma solicitação malsucedida. Esta propriedade só será incluída na resposta se houver um erro.

    Valor válido: falha

    Tipo de dados: Cadeia de caracteres
    sys_id Sys_id do agente.

    Tipo de dados: Cadeia de caracteres
    workItem

    workItem: Informações sobre o item de trabalho associado ao evento.

    Tipo de dados: Cadeia de caracteres
    WorkItem.document workItem.document: Lista de documentos associados à tarefa de item de trabalho.

    Tipo de dados: Cadeia de caracteres
    WorkItem.document.sys_id workItem.document.sys_idSys_id do documento atribuído à tarefa do item de trabalho.

    Tipo de dados: Cadeia de caracteres
    WorkItem.document.table workItem.document.tableNome da tabela de documentos atribuída à tarefa.

    Tipo de dados: Cadeia de caracteres
    WorkItem.previousWorkItem workItem.previousWorkItemSys_id do item de trabalho anterior para o mesmo ID de documento. Para os itens de trabalho não transferidos, este valor está vazio.

    Tipo de dados: Cadeia de caracteres
    workItem.serviceChannel workItem.serviceChannel: Lista de canais de serviço associados à tarefa de item de trabalho.

    Tipo de dados: Cadeia de caracteres
    workItem.serviceChannel.name workItem.serviceChannel.nameNome do canal de serviço, como Bate-papo ou Telefone.

    Tipo de dados: Cadeia de caracteres
    workItem.serviceChannel.sys_id workItem.serviceChannel.sys_idSys_id do canal de serviço.

    Tipo de dados: Cadeia de caracteres
    WorkItem.size workItem.sizeCapacidade do agente usada quando este item de trabalho é atribuído ao agente.

    Tipo de dados: Cadeia de caracteres
    WorkItem.sys_id workItem.sys_idSys_id do item de trabalho que foi aceito ou oferecido.

    Tipo de dados: Cadeia de caracteres
    WorkItem.isQueueTransferido workItem.isQueueTransferredSinalizador que indica se o item de trabalho é transferido na fila. Defina como verdadeiro se o item de trabalho for transferido para fila, falso se não for. Para obter mais informações sobre transferências de fila, consulte Transfer a chat to another queue.

    Tipo de dados: Booliano
    workitem.isAutoAccepted workItem.isAutoAcceptedSinalizador que indica se o item de trabalho foi aceito automaticamente pelo sistema. Defina como verdadeiro se o item de trabalho tiver sido aceito automaticamente.

    Tipo de dados: Booliano

    		 
    curl -X PUT \
 https://instance.servicenow.com/api/now/awa/agents/46d44a23a9fe19810012d100cca80666 \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-u 'username':'password'\
-d '{"presence": {\
  "sys_id": "0b10223c57a313005baaaa65ef94f970",\
  "channels": [{ \
  "sys_id": "0bbdedbb3b892300a2bac9bb34efc445",\
  "available": true
}] 
}}
    {
  "result": {
    "presence": {
      "name": "Available",
      "sys_id": "0b10223c57a313005baaaa65ef94f970",
      "available": true,
      "channels": [
        {
          "name": "Chat",
          "available": true,
          "sys_id": "27f675e3739713004a905ee515f6a7c3"
        }
      ]
    },
    "sys_id": "46d44a23a9fe19810012d100cca80666"
  }
}

    AWA Agente - PUT /now/awa/agents/user_id/capabilities

    Habilita a atualização da capacidade máxima (carga de trabalho) de um agente para capacidades de canal e capacidade universal.

    Use AWA Agente - OBTENHA /now/awa/agents/user_id/capabilities método para recuperar o canal atual e as capacidades universais de um agente.

    Consulte também:

    Formato de URL

    URL com controle de versão: /api/now//api/awa/agents/user_id/capabilities

    URL padrão: /api/now/awa/agents/user_id/capabilities

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 27. 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
    user_id Sys_id do agente listado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    Tabela 28. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 29. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    canais Obrigatório se estiver atualizando o valor máximo de um ou mais canais para o agente especificado. Objeto JSON que contém um ou mais pares de chave-valor mapeando o canal para sua capacidade máxima para cada canal atribuído ao agente.

    Tipo de dados: Objeto

    O par está no seguinte formato:
    • Chave (sys_id do canal) - Sys_id do canal.

      Tipo de dados: Cadeia de caracteres

    • Valor (capacidade máxima) - Carga de trabalho máxima em um canal de serviço específico ao qual o agente pode ser atribuído ativamente de cada vez.

      Tipo de dados: Número

    channels: {"<channel_sys_id>": <max_capacity>}
    universal_capacity Obrigatório se a capacidade universal estiver sendo atualizada. Capacidade máxima do agente em todos os canais de serviço. Se a carga de trabalho atual de um agente for igual à capacidade universal máxima, itens de trabalho adicionais não serão atribuídos ao agente.

    Tipo de dados: Número

    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 30. 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 31. 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 32. 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.
    404 Não encontrado. O item solicitado não foi encontrado.

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

    Nome Descrição
    canais Lista de objetos que descrevem os canais de comunicação disponíveis com o agente. 
    "channels": [
  {
    "channel_sys_id": "String",
    "max_capacity": Number
  }
]

    Tipo de dados: Matriz
    channels.channel_sys_id Sys_id do canal.

    Tipo de dados: Cadeia de caracteres

    Tabela: Canais de serviço [awa_service_channel]
    channels.max_capacity Carga de trabalho máxima em um canal de serviço específico ao qual o agente pode ser atribuído ativamente de cada vez.

    Tipo de dados: Cadeia de caracteres
    erro Detalhes que descrevem um erro encontrado durante o processo de solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes do erro encontrado durante o processo de solicitação.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem do erro encontrado durante o processo de solicitação.A descrição é fornecida em error.detailpropriedade.

    Tipo de dados: Cadeia de caracteres
    status Status de uma solicitação malsucedida. Esta propriedade só será incluída na resposta se houver um erro.

    Valor válido: falha

    Tipo de dados: Cadeia de caracteres
    universal_capacity Capacidade máxima do agente em todos os canais de serviço. Se a carga de trabalho atual de um agente for igual à capacidade universal máxima, itens de trabalho adicionais não serão atribuídos ao agente.

    Esta propriedade retornará somente se existir um registro de capacidade universal para este agente.

    Tipo de dados: Número

    Solicitação de cURL de amostra

    O exemplo a seguir mostra como mudar a capacidade universal do agente e a capacidade máxima de um canal especificado.

    curl "https://instance.service-now.com/api/now/awa/agents/46d44a23a9fe19810012d100cca80666/capacities" \
--request PUT \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
 \"channels\": { \"27f675e3739713004a905ee515f6a7c3\": 6 },
 \"universal_capacity\" : 12
}" \
--user 'username':'password'

    Uma resposta bem-sucedida inclui os valores de capacidade atualizados.

    {
  "result": {
    "channels": [
      {
        "channel_sys_id": "27f675e3739713004a905ee515f6a7c3",
        "max_capacity": 6
      }
    ],
    "universal_capacity": 12
  }
}