Variáveis pré-definidas

As informações desta página de ajuda se aplicam tanto a Studio quanto a Desktop Studio.

As variáveis predefinidas são variáveis do sistema que já estão definidas. Você pode usá-las nos seus scripts sem ter que criá-las. É possível substituir o valor esperado para variáveis predefinidas, mas isso não é recomendado. Somente substitua estes se a ajuda online ou um representante de conta instruir você a fazer isso.

As variáveis predefinidas são adicionadas automaticamente aos Scripts. Algumas vêm de scripts de sistema que são executados nos bastidores antes de uma interação ser roteada para seus Scripts. Elas também são chamadas de variáveis de sistema. outras variáveis predefinidas vêm das Ações que você adiciona aos seus Scripts. Você pode usar a ferramenta de rastreamento para visualizar as variáveis em um script. Ao clicar em cada ação na saída de rastreamento, a guia Variáveis mostra as ações no script até aquele ponto.

Exibir Variáveis predefinidas em um script

Você pode visualizar as variáveis em um script usando a ferramenta de rastreamento. Se você rastrear um script durante uma interação, poderá ver as variáveis que são passadas para ele.Essas variáveis vêm de Scripts de sistema e de outras fontes, como o provedor de serviço de telefone. Você pode rastrear um script com uma interação simulada, mas só pode ver as variáveis passadas para ele a partir de scripts do sistema. Esta seção descreve o rastreamento de um script de telefone de entrada simulado. Você também pode exibir as variáveis predefinidas em um script executando um rastreamento em outras interações.

  1. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecioneOmnichannel Routing > Studio Três setas unidas na base. Uma aponta para cima, outra para cima e para a direita, e outra para cima e para a esquerda. .
  2. Na página Scripts, localize e dê um duplo clique para abrir o script com o qual deseja trabalhar ou crie um novo. O script é aberto em uma nova guia.
  3. Clique em Trace > Iniciar com rastreio.
  4. Selecione um telefone de entrada ACD Competência.
  5. Selecione Simular Chamada de entrada.
  6. Insira o Número de telefone que deseja que o script discar. Esse deve ser o número de um Telefone que você pode atender durante o testando. Essa linha representa o contato que está ligando para sua organização.
  7. Enter o DNIS para este canal. Este é o número que o contato discaria para entrar em contato com sua organização. Você pode usar o número de telefone de outro telefone ao qual tenha acesso para este número. Esta linha representa a parte do agenteClosed Sua conexão de áudio com NiCE CXone para chamadas e mensagens de voz..
  8. Insira um ANI. O ANI é o número de telefone listado como o id do chamador de uma chamada telefônica recebida. Ele pode ser o mesmo número usado no campo Número de telefone.
  9. Clique em Iniciar rastreio.
  10. Atenda à chamada quando o seu telefone tocar e execute as ações necessárias para testar o seu script. Por exemplo, se estiver testando o Rvi, talvez você queira repetir essas etapas quantas vezes for necessário para testar cada opção de menu.
  11. Na janela de Saída de Rastreamento, clique na ação Begin. A aba Variáveis exibe todas as variáveis passadas para o script a partir de Scripts do sistema.

  12. Duplo clique em uma variável para ver o nome da variável e seu valor. Isso é útil para variáveis com valores longos que não cabem na coluna Value.

    Se desejar ver variáveis adicionais adicionadas ao script conforme uma interação avança, clique em outras ações na seção principal da janela Trace Output.

Variáveis predefinidas comuns

A tabela a seguir contém algumas das variáveis predefinidas mais comuns. Nem todo script conterá todas as variáveis da lista. As variáveis predefinidas disponíveis em um script dependem do tipo DE mídia do script e das ações usadas nele. Além disso, algumas variáveis vêm do provedor de serviços. Essas variáveis podem variar dependendo do provedor.

Antes de usar qualquer uma das variáveis desta seção, verifique se elas estão presentes no script com o qual você está trabalhando usando a ferramenta de rastreamento. Usar variáveis predefinidas em um script quando essa variável não é passada para o script ou adicionada por uma ação pode resultar em scripts que não funcionam como pretendido.

Quando possível, verifique as variáveis em seu script usando uma interação em tempo real, e não uma interação simulada. As interações simuladas podem conter variáveis que uma interação em tempo real não contém. De forma semelhante, uma interação em tempo real pode conter variáveis que uma simulação não contém.

Nome da variável Descrição
__agentContactID A identificação de sessão para a sessão do aplicativo do agente.
__agentId O id do agente que atende uma interação. Esta variável não contém nenhum valor até que um agente atenda a interação.
ANI

O número de telefone do chamador no formato de Numeração norte americano. Este é o formato padrão para números de telefone na América do Norte. A variável e164ANI contém o mesmo número, mas no formato internacional.

Este valor vem de uma operadora de telefone. Os valores possíveis incluem Restrito e Anônimo.

busno

O número da sua unidade de negóciosClosed Agrupamento organizacional de alto nível usado para gerenciar o suporte técnico, o faturamento e as configurações globais do seu sistema NiCE CXone.. Este é o identificador exclusivo do seu sistema NiCE CXone.

Se sua organização tiver mais que uma unidade de negócios, você pode usar esse valor para fazer determinações lógicas em seu script. Por exemplo, você pode verificar o busno antes de atribuir uma ACD competênciaClosed Usada para automatizar a distribuição de interações com base nas competências, nas habilidades e no conhecimento dos agentes. para garantir que está atribuindo uma competência que existe na unidade de negócios.

contactId O identificador exclusivo para cada contato. O contactId torna possível encontrar e relatar um contato específico. Um novo contactId é criado se um script secundário for gerado.
de Xi’an The name of the city where the call originates.

Para interações de entrada, este valor vem do fornecedor de serviços do contato. Para interações de saída, este valor vem do seu fornecedor de serviços.

País

Nome do país designado pelo código do país (consulte o próximo item) na sequência numérica do número de telefone de uma chamada de entrada ou de saída. A plataforma de Telecomunicação NiCE CXone gera isso automaticamente com base nos valores da International Telecommunication Union (ITU) e os transmite nos metadados da chamada metadadosClosed Dados que fornecem informações sobre outros dados..

Para interações de entrada, este valor vem do fornecedor de serviços do contato. Para interações de saída, este valor vem do seu fornecedor de serviços.

countryCode

União Internacional de telecomunicações (UIT) que designa o país de origem de uma chamada de entrada, ou o país de destino de uma chamada de saída. Esse código aparece no início de qualquer string de número de telefone e é passado nos metadados da chamada. Por exemplo, o código ITU para os Estados Unidos é +1. Para ver o código do país de qualquer país específico, faça uma busca na Internet por código de país <país>. O formato deste pode variar dependendo da origem da chamada.

Para interações de entrada, este valor vem do fornecedor de serviços do contato. Para interações de saída, este valor vem do seu fornecedor de serviços.

DNIS O número que o chamador discou no formato de Numeração norte americano. Este é o formato padrão para números de telefone na América do Norte. A variável e164DNIS contém o mesmo número, mas no formato internacional.

e164ANI

e164DNIS

O ANIClosed Também conhecido como id do chamador. número de telefone listado de uma chamada de voz recebida. e o DNISClosed O número discado em chamadas de voz de entrada ou de saída. formatados de acordo com os padrões E.164 de formatação de telefonia. O E.164 é um padrão internacional para formatação de números de telefone de fora dos Estados Unidos.
de O endereço DE e-mail do remetente.
__httpstatuscode O código de status HTTP retornado pelo servidor que a ação API REST chama.
__httpstatusdescription A descrição de status HTTP retornada pelo servidor que a ação REST API chama.
isReskill Indica no ID de contato atual que mudou de competência. Os valores são 1 (true) ou 0 (false).
__lastStateChange A marcação de tempo da última vez que um contato mudou de estado. Por exemplo, quando um contato muda do estado Pré-fila para na fila, esta variável é preenchida com a marcação de tempo de quando esta mudança ocorreu.
masterId

O identificador exclusivo que permite que todos os Scripts originados do mesmo pai sejam identificáveis. É usado quando um script gera ou é executado a partir de outro. Para o script principal, contactId e masterId serão os mesmos. Para qualquer script secundário, contactId será um novo valor exclusivo e masterId terá o mesmo valor que o script principal contactId.

Por exemplo, quando você muda a competência para uma interação, a interação alterada masterId é mesma que a contactId da interação original. Se a interação tiver a competência alterada pela segunda vez, a recém-alterada masterId da interação será a mesma que a contactId do script secundário.

__mediaServerName O nome DO servidor de mídia. Essa variável é útil para a solução de problemas relacionados ao servidor ao trabalhar com o Suporte Técnico da NiCE CXone. Os problemas incluem coisas como latência remota ou Problemas de telefonia.
__POC O id exclusivo do ponto de contatoClosed O ponto de entrada que um contato de entrada usa para iniciar uma interação, como um número de telefone ou endereço de e-mail.. Ele corresponde ao ID no aplicativo NiCE CXone ACD.
__SIPInvite Contém informação de cabeçalho para o contato. Se transferir uma chamada de uma unidade de negóciosClosed Agrupamento organizacional de alto nível usado para gerenciar o suporte técnico, o faturamento e as configurações globais do seu sistema NiCE CXone. para outra, esta variável conterá informações sobre a chamada original. Por exemplo, você pode acessar o contactID da chamada da unidade de negócios original.
__Skill

O identificador exclusivo para a ACD competênciaClosed Usada para automatizar a distribuição de interações com base nas competências, nas habilidades e no conhecimento dos agentes. específica. A variável __Skill torna possível encontrar e relatar uma competência específica. Esse valor pode ser alterado com a ação Reqagent.

__SkillName The name of the ACD skill. It accompanies __Skill and can change with the Reqagent action.

estado O estado nos Estados Unidos onde o chamador mora. Este valor vem do fornecedor de serviços do contato.
__targetScript O script que o script do sistema está iniciando.
Testar Não tente definir ou usar essa variável fora de uma Snippet ação. Isso pode resultar em consequências graves. Está reservada para depuração de código em uma Snippet ação.
to O endereço DE e-mail de destino.

Variáveis predefinidas do Uptivity

s
Nome da variável Descrição
_customFilter

O valor desta variável é usado como filtrar Gate ACD no Uptivity.

_user1 - _user 8

O valor dessas variáveis é usado para preencher os campos User 1 a User 8 no Uptivity.

User9

Embora User9 não seja tecnicamente uma variável, ele obtém seu valor da conta de usuário do agente, especificamente do valor nas propriedades Custom 1, e popula o campo User 9 no Uptivity.

User10 Embora User10 não seja tecnicamente uma variável, ele obtém seu valor da conta de usuário do agente, especificamente o valor nas propriedades Custom 2, e preenche o campo User 10 no Uptivity.
_surveyDNIS

Este valor é um id exclusivo criado pelo usuário, atribuído quando você cria uma pesquisa do Uptivity e usado para determinar qual pesquisa executar durante o retorno de chamadaClosed Mantém a posição do cliente na fila de espera e liga automaticamente para o cliente quando ele chega ao início da fila de espera..

_surveyCallbackDNIS

Este valor é o número que será usado no retorno de chamada da pesquisa. Esta variável é para uso somente com uma pesquisa Uptivity.

_surveyCallbackANI

Este valor é o id do chamador que será exibido durante o retorno de chamada usado para a pesquisa. Esta variável destina-se ao uso somente com uma pesquisa Uptivity.