API de gestão de interações

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 6 min. de leitura

    • A API Interaction Management fornece endpoints para criar interações.

    Esta classe requer o plug-in de registro em log, roteamento e enfileiramento de interações (com.glide.interaction).

    Interação - POST /now/interaction

    Insere ou atualiza um registro na tabela de interação.

    Formato de URL

    URL com controle de versões: /api/now/{api_version}/interaction

    URL padrão: /api/now/interaction

    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 acessada. 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 2. Parâmetros de consulta
    Nome Descrição
    Nenhum
    Tabela 3. Parâmetros do corpo da solicitação (XML ou JSON)
    Elemento Descrição
    canal Obrigatório. Sys_id do conector de interação para o qual você deseja criar uma interação.

    Tipo de dados: cadeia de caracteres
    contexto Um mapa ou um par tabela/sys_id. Por padrão, as interações têm um registro na tabela interaction_json_blob que armazena dados de contexto como um objeto JSON. Você pode apontar uma interação para um registro diferente para contexto. Use context ou context_table/context_id para definir o contexto de uma interação.

    Tipo de dados: cadeia de caracteres
    context_id ID de documento de um registro que você deseja usar para armazenar contexto. O padrão é um novo registro na tabela insteraction_json_blob. Se você definir o ID de contexto, também precisará definir a tabela.

    Tipo de dados: cadeia de caracteres
    context_table Tabela de contexto que você deseja usar para armazenar o contexto de interação para. O padrão é interaction_json_blob. Se você definir a tabela de contexto, também precisará definir o ID de contexto.

    Tipo de dados: cadeia de caracteres
    channel_metadata Mapa ou um par tabela/sys_id. Os metadados do canal contêm informações que um conector pode usar para se comunicar por meio do canal associado.

    Tipo de dados: cadeia de caracteres
    channel_metadata_id ID de documento de um registro que você deseja usar para armazenar metadados do canal. O padrão é um novo registro na tabela live_group_profile. Se você definir o ID de metadados do canal, também precisará definir a tabela.

    Tipo de dados: cadeia de caracteres
    canal_metadados_tabela Tabela que você deseja usar para armazenar metadados do canal. O padrão é a tabela live_group_profile. Se você definir a tabela de metadados do canal, também precisará definir o ID de metadados do canal.

    Tipo de dados: cadeia de caracteres
    fila Sys_id da fila que você deseja associar à interação.

    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 4. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml.

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

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

    Códigos de status

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

    Tabela 6. Códigos de status
    Código de status Descrição
    201 Indica que a consulta foi executada com sucesso.
    400 Indica que um ou mais parâmetros obrigatórios estavam ausentes na solicitação.
    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)

    Elemento Descrição
    assigned_to O sys_id do usuário ao qual a interação está atribuída.

    Tipo de dados: cadeia de caracteres
    channelMetadataDocument O sys_id do documento de metadados do canal associado à interação.

    Tipo de dados: cadeia de caracteres
    channelMetadataTable O nome da tabela de metadados do canal associada à interação.

    Tipo de dados: cadeia de caracteres
    channel_metadata Quaisquer metadados de canal incluídos para a interação.

    Tipo de dados: cadeia de caracteres
    closed_by O sys_id do usuário que encerrou a interação.

    Tipo de dados: cadeia de caracteres
    contextDocument O sys_id do documento de contexto associado à interação.

    Tipo de dados: cadeia de caracteres
    contextTable O nome da tabela associada à interação.

    Tipo de dados: cadeia de caracteres
    número O número da nova interação.

    Tipo de dados: cadeia de caracteres
    opened_for O sys_id do usuário para o qual a interação foi aberta.

    Tipo de dados: cadeia de caracteres
    fila O sys_id da fila para a qual você cria a interação.

    Tipo de dados: cadeia de caracteres
    state O estado em que a interação está. Se você atribuir uma fila, o estado mudará automaticamente para Em fila, caso contrário, o padrão será Novo.

    Tipo de dados: cadeia de caracteres
    sys_id O sys_id da interação.

    Tipo de dados: cadeia de caracteres

    Exemplo de solicitação cURL

    curl "http://instance.servicenow.com/api/now/interaction" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{\"channel\":\"28a59893873103002ae97e2526cb0b5d\",\"queue\":\"f3a50867b30303002186a72256a8dcb7\"}" \
--user "username":"password"
    {
  "result": {
    "channel": "28a59893873103002ae97e2526cb0b5d",
    "context": {
      "present": true
    },
    "queue": "f3a50867b30303002186a72256a8dcb7",
    "state": "queued",
    "number": "IMS0000075",
    "contextDocument": "1863a6f0d9471300964f387107a8a36d",
    "contextTable": "interaction_json_blob",
    "channelMetadataDocument": "9463a6f0d9471300964f387107a8a36c",
    "channelMetadataTable": "live_group_profile",
    "channel_metadata": {
      "present": true
    },
    "sys_id": "dc63a6f0d9471300964f387107a8a36b",
    "assigned_to": "",
    "closed_by": "",
    "opened_for": ""
  }
}

    Interação - POST /now/interaction/{interaction_id}/close

    Altera o estado de uma interação para encerrado ou encerrado completo.

    Formato de URL

    URL com controle de versões: /api/now/{api_version}interaction/{interaction_id}/close

    URL padrão: /api/now/interaction/{interaction_id}/close

    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 acessada. 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
    interaction_id Sys_id da interação que você deseja fechar.

    Tipo de dados: cadeia de caracteres
    Tabela 8. Parâmetros de consulta
    Nome Descrição
    Nenhum
    Tabela 9. Parâmetros do corpo da solicitação (XML ou JSON)
    Nome Descrição
    Nenhum

    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/json ou application/xml.

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

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

    Códigos de status

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

    Tabela 12. Códigos de status
    Código de status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    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)

    Elemento Descrição
    assigned_to O sys_id do usuário ao qual a interação está atribuída.

    Tipo de dados: cadeia de caracteres
    channelMetadataDocument O sys_id do documento de metadados do canal associado à interação.

    Tipo de dados: cadeia de caracteres
    channelMetadataTable O nome da tabela de metadados do canal associada à interação.

    Tipo de dados: cadeia de caracteres
    channel_metadata Quaisquer metadados de canal incluídos para a interação.

    Tipo de dados: cadeia de caracteres
    closed_by O sys_id do usuário que encerrou a interação.

    Tipo de dados: cadeia de caracteres
    contextDocument O sys_id do documento de contexto associado à interação.

    Tipo de dados: cadeia de caracteres
    contextTable O nome da tabela associada à interação.

    Tipo de dados: cadeia de caracteres
    número O número da nova interação.

    Tipo de dados: cadeia de caracteres
    opened_for O sys_id do usuário para o qual a interação foi aberta.

    Tipo de dados: cadeia de caracteres
    fila O sys_id da fila para a qual você cria a interação.

    Tipo de dados: cadeia de caracteres
    state O estado em que a interação está. Se você atribuir uma fila, o estado mudará automaticamente para Em fila, caso contrário, o padrão será Novo.

    Tipo de dados: cadeia de caracteres
    sys_id O sys_id da interação.

    Tipo de dados: cadeia de caracteres

    Exemplo de solicitação cURL

    curl "http://instance.servicenow.com/api/now/interaction/b243cde4208f1700964f959e0488dee8/close" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--user "username":"password"

    {
  "result": {
    "channel": "28a59893873103002ae97e2526cb0b5d",
    "context": {
      "present": true
    },
    "queue": "f3a50867b30303002186a72256a8dcb7",
    "state": "closed_complete",
    "number": "IMS0000060",
    "contextDocument": "3a43cde4208f1700964f959e0488dee7",
    "contextTable": "interaction_json_blob",
    "channelMetadataDocument": "fa43cde4208f1700964f959e0488dee8",
    "channelMetadataTable": "live_group_profile",
    "channel_metadata": {
      "present": true
    },
    "sys_id": "b243cde4208f1700964f959e0488dee8",
    "assigned_to": "",
    "closed_by": "6816f79cc0a8016401c5a33be04be441",
    "opened_for": "46d44a23a9fe19810012d100cca80666"
  }
}