Usar Conexões

Em Integration Hub, as conexões definem detalhes de autenticação e solicitações de API. Depois de criar e configurar uma conexão, você pode usá-la em NiCE CXone.

Executar Solicitações de Integration Hub

Você pode executar uma solicitação a partir da conexão Integration Hub na qual ela está definida. Somente solicitações manuais podem ser executadas a partir de Integration Hub.

  1. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecioneConnections Hub > Integrações > Integration Hub.

  2. Clique na conexão com a qual deseja trabalhar em Minhas Conexões, no lado esquerdo da página.

  3. Na guia Solicitações, clique em Testar próximo à Solicitação que você deseja executar. Uma página é exibida e mostra a resposta do serviço da web conectado.

  4. Selecione e copie o conteúdo da resposta da página se quiser mantê-lo.

  5. Clique em Cancelar quando terminar de revisar a resposta.

Usar autenticação em um script

Permissões necessárias: ACD > Studio > Studio Scripts Editar, Launch Connections Hub

As conexões podem armazenar detalhes de autenticação. Você pode usá-las em seu script em qualquer lugar que precisar delas. Elas podem ser usadas por si só ou junto com uma solicitação.

  1. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecioneStudio.

  2. Abra o script ao qual você deseja adicionar a solicitação.

  3. Adicione uma ação ConnectAuth ao script.

  4. No connectName propriedade de ConnectAuth, Enter o nome da conexão que você deseja usar. Se você não souber o nome da conexão:

    1. Clique em abrir editor Icon of a window. em ConnectAuth para abrir Integration Hub.
    2. Em Minhas Conexões, clique na marca de seleção An icon of a check mark. ao lado da conexão que você deseja usar.
    3. Clique em Sim para atribuí-la à ação.

    Em vez de usar o nome de uma conexão específica na propriedade connectName, você pode usar a substituição de variável. Crie uma variável para armazenar o nome da conexão e, em seguida, use a lógica do script para passar o nome para ConnectAuth.

  5. Salve suas alterações.

Usar uma Solicitação manual em um script

Permissões necessárias: ACD > Studio > Studio Scripts Editar, iniciar Connections Hub

Você pode usar uma solicitação manual em seu script em qualquer lugar em que seja necessário fazer a Chamada de API. A solicitação deve ser definida em uma conexão Integration Hub.

O script pode precisar de mais edições para processar a resposta retornada pelo recurso ao qual a solicitação se conecta. Além disso, a ConnectRequest ação pode exigir configuração adicional.

  1. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecioneStudio.

  2. Abra o script no qual você deseja usar a solicitação.

  3. Adicione uma ConnectRequest ação ao script.

  4. Nas propriedades connectName e requestName, enter os nomes da conexão e da solicitação que você deseja usar. Se não souber os nomes:

    1. Clique em abrir editor Icon of a window. em ConnectRequest para abrir Integration Hub.

    2. Em Minhas Conexões, clique na marca de verificação An icon of a check mark. próximo à conexão que você deseja usar.

    3. Clique em Sim para atribuí-la à ação.

    4. Selecione a conexão que você acabou de atribuir a ConnectRequest.

    5. Na guia Solicitações, clique na caixa da Solicitação que você deseja atribuir a essa ação e clique em OK.

    Em vez de usar o nome de uma conexão e uma solicitação específicas nas propriedades connectName e requestName, você pode usar a substituição de variável. Crie variáveis para armazenar os nomes e, em seguida, use a lógica do script para passar os nomes para ConnectRequest.

  5. Para usar uma variável da conexão vinculada no script, coloque o nome da variável entre colchetes duplos, assim:[[variableName]].

Use a Studio ou Solicitação Híbrida em um script

Permissões necessárias: ACD > Studio > Studio Scripts Editar, iniciar Connections Hub

Para usar uma solicitação Studio, você primeiro a adiciona a uma conexão Integration Hub e, depois, a um script, usando a ConnectRequest ação. Para usar uma solicitação híbrida, crie uma solicitação manual em vez de uma Studio e, depois, conecte-a ao seu script da mesma forma que faria com uma solicitação Studio.

Os detalhes da solicitação podem ser alterados por entradas de Studio, portanto esses detalhes geralmente são criados em uma ação SNIPPET para que possam ser passados para a ação ConnectRequest.

O script pode precisar de mais edição para processar a resposta retornada pelo recurso ao qual a solicitação se conecta. Além disso, a ação ConnectRequest ou a Snippet ação pode exigir configuração adicional.

  1. Crie uma solicitação de Studio ou uma solicitação manual em Integration Hub e crie um objeto de solicitação em seu script, caso ainda não tenha feito isso.

  2. No Studio, abra o script que contém a solicitação que você deseja usar.
  3. Adicione uma ConnectRequest ação ao script após a ação Snippet que contém o objeto de solicitação e conecte-as.
  4. No propriedade de ConnectRequest connectName, insira os nomes da conexão que deseja usar. Se não souber o nome:

    1. Duplo clique em ConnectRequest para abrir Integration Hub.

    2. Em Minhas Conexões, clique na marca de seleção Um ícone de marca de seleção. próxima à conexão que você deseja usar.

    3. Clique em Sim para atribuí-la à ação.

    4. Selecione a conexão que você acabou de atribuir a ConnectRequest.

    5. Na guia Solicitações, clique na caixa da Solicitação que você deseja atribuir a essa ação e clique em OK.

    Em vez de usar o nome de uma conexão e solicitação específicas nas propriedades connectName, você pode usar substituição de variável. Crie uma variável para armazenar o nome e, em seguida, use a lógica do script para passar o nome para ConnectRequest.

  5. Selecione a ação ConnectRequest e configure o campo RequestPayload com o nome da variável que contém a solicitação JSON. Você definiu essa variável no Snippet.
  6. Para usar uma variável da conexão vinculada no script, coloque o nome da variável entre colchetes duplos, como neste exemplo:[[variableName]].

  7. Se sua conexão exigir autorização, adicione e configure a ação ConnectAuth em seu script.