Personalizando o widget Script no aplicativo zoom

O widget Script pode ser adicionado e editado pelos administradores do contact center. Este widget Script permite que você crie um fluxo enviando as ações desejadas para o próprio widget, eliminando a necessidade de depender da interface do usuário ao criar um fluxo. Por padrão, os widgets Script ocultam chaves, segredos e outras credenciais associadas a eles.

Importante:

• O Zoom Contact Center anunciou que lançará um novo mecanismo de script em 17 de setembro de 2022, que apresenta um novo sintaxe para scripts. Não haverá impacto nos scripts existentes como resultado dessa mudança. Existem, no entanto, algumas regras que devem ser seguidas ao desenvolver novo widgets de script. Este artigo inclui exemplos de novo sintaxe de script na seção Nova versão.

• As configurações de exemplo a seguir ajudarão você a entender melhor como utilizar o widget Script.

Pré-requisitos para personalizar o widget Script

• Propriedade ou privilégios administrativos da conta

• Se você é titular de uma conta Business, Education ou Pro

• É necessária uma licença para o Zoom Contact Center

• Crie fluxos de voz, vídeo, web, no aplicativo ou SMS com base em sua preferência

• É necessário um conhecimento avançado de Javascript

Como adicionar ou editar o widget Script

1. O portal da Web do Zoom pode ser acessado fazendo login.

2. Clique em Contact Center Management no menu de navegação e, em seguida, clique em Flows na lista suspensa.

3. O nome de exibição de um fluxo pode ser editado clicando nele.

4. O script pode ser arrastado para o local preferido no fluxo clicando e arrastando o widget no painel de widgets do lado esquerdo.

5. Você precisará selecionar o widget chamado Script.

6. O widget pode ser renomeado para torná-lo mais compreensível para o usuário final. Clique em Renomear para fazer o seu mudar.

7. Adicionar um novo script a um widget pode ser feito clicando no botão Adicionar Script e especificando as seguintes opções:

8. Clique no botão Adicionar.

9. Se você estiver usando JavaScript, digite o código abaixo.

10. O painel Input Parameters pode ser usado para inserir parâmetros para o script no formato JSON no lado direito da tela. Isso é usado para testar o script localmente. Os pares chave/valor precisam ser incluídos de acordo com o código JavaScript, portanto, certifique-se de incluí-los. O parâmetro de entrada que você precisará fornecer deve conter todos os pares chave/valor que você espera ver ao testar seu código localmente.

11. Clique no botão Executar.
    Na seção Resultados, você poderá ver os resultados.

12. Feche a janela clicando nela.

13. Para salvar o script, clique no botão Salvar.

14. Clique nas seguintes opções na guia Configurações (opcional):

15. Você pode personalizar suas configurações de saída clicando no saídas aba.

    • Sucesso: Caso o script tenha sido executado com sucesso, selecione o widget de destino.

    • Falhar: Quando o script falhar ao executar, selecione o widget que deve ser o destino

Observação: Veja exemplos de configurações do widget de script para entender melhor como ele funciona.

Mapeamento de variável de script

É possível mapear um valor de variável de script para uma variável de fluxo após configurar o widget Script e executá-lo.

• No script var_set(), todas as variáveis ​​são definidas em uma variável de fluxo denominada widget que é então associada ao script var_set(). É possível considerar esta variável como uma variável local.

• Há uma variável de fluxo chamada value sob o nome do widget que contém o valor retornado pelo script quando o widget é invocado.

• Global as variáveis ​​personalizadas devem ser definidas para todas as variáveis ​​definidas por global_var_set para serem usadas em variáveis ​​globais. É possível referenciar o nome completo da variável global no widget Script, bem como modificá-la usando global_var_set no widget Script.

Exemplo de mapeamento de script

Para obter mais informações sobre números de conta, consulte o exemplo abaixo.

Como programar roteiros

1. Seu código deve conter todas as dependências necessárias. Você pode ver o código de exemplo abaixo em linhas 2 a 4.

2. Para que o mecanismo de código consiga extrair sua função JS, passe sua função para module.exports. Async só deve ser usado quando await for necessário em sua função. A função não precisa ser chamada do painel de código, então não há necessidade de chamá-la lá.
   Observação: Um interruptor automático é ativado para habilitar o modo estrito.

Exemplo de programação de script

Nova versão

async function main () {
  // your code starts here
}

Note: 
#### Supported built-in functions: (no need to import again)

## Variable Get/Set:
var_get()(string); var_set(string, string); global_var_set(string, string)

## Http Requests:
req.get(url(, config)); req.delete(url(, config)); req.head(url(, config)); req.options(url(, config))
req.post(url(, data(, config))); req.put(url(, data(, config))); req.patch(url(, data(, config)))

## Logging
log.debug(string), log.info(string), log.warn(string), log.error(string)

Versão antiga

// Using Lambda

const log = require('./utils/log');
const req = require('axios'); // this is needed only if you plan to use Axios in your function
var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');

module.exports = async () => {

// add your script logic. See two examples above.

return
}

Observação: O widget Javascript Script atualmente fornece acesso apenas ao módulo externo Axios, que é o único disponível no momento.

Como usar o registro

Usando a seguinte função, você poderá importar a dependência:

const log = require(‘./utils/log’);

Observação: Existe um novo versão do mecanismo de script que já inclui isso, portanto, você não precisa importá-lo novamente, pois é integrado

Exemplo de registro

As seguintes funções podem ser usadas para implementar o registro em seu aplicativo:

log.debug(“depurando ativado”) log.error(“erro detectado”) log.info(“informações: sim”) log.warn(“AVISO: “)

Como implementar solicitações HTTP

As solicitações HTTP podem ser implementadas usando o Axios usando a biblioteca de solicitações HTTP. Você pode encontrar mais informações sobre o Axios Support no site da empresa.

Usando a seguinte função, você poderá importar a dependência:

const req = require('axios');

Observação:

• Você não precisa importá-lo novamente porque isso já está embutido no novo versão do mecanismo de script.

• O widget HTTP Call é um widget padrão que permite fazer solicitações HTTP com a ajuda de funções JavaScript sem ter que escrever nenhum JavaScript. Para casos de uso mais avançados, você também pode usar o módulo Axios em conjunto com um script que executa solicitações HTTP.

Como obter variáveis ​​dentro do widget Script

1. Seu fluxo deve incluir um widget de script que você pode adicionar e configurar.

2. A importação de dependência variável precisa ser adicionada ao arquivo JavaScript.

   Exemplo:

var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set}
      = require('./utils/variable');

Observação: Você não precisa importá-lo novamente porque isso já está embutido no novo versão do mecanismo de script.

1. Para descobrir qual é o valor de uma variável, você pode noseta função var_get. Tanto as variáveis ​​locais do widget quanto as variáveis ​​globais podem ser acessadas usando a função var_get. Além das variáveis ​​de sistema definidas globalmente, você deve definir suas próprias variáveis ​​globais antes de poder usá-las.
   Exemplo:

var_get()("global_system.Consumer.firstName")

Observação: Vaivariáveis ​​dentro dos fluxos são limitadas em escopo ao envolvimento ativo, embora as variáveis ​​globais sejam definidas globalmente no sistema. A o valor da variável global é spdefinido especificamente fou um compromisso específico quando é definido/alterado dentro de um fluxo. O valor da variável global atualizado setby outro engajamento não estará disponível para outros consumidores simultaneamente ou posteriormente no mesmo fluxo.

Como definir variáveis ​​locais no widget Script

1. Adicione o widget Script ao seu fluxo e configure-o. O widget Script deve ser renomeado como Script1 neste exemplo.

2. A dependência variável deve ser importada para um arquivo JavaScript. A importação de dependência precisa ser adicionada.
   Exemplo:

var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');

Observação:Não há necessidade de importar isso novamente, pois é construído em o novo versão do mecanismo de script.

1. Defina o valor de uma variável local usando a função var_set. As variáveis ​​locais são nomeadas usando seus nomes completos e seus valores são identificados por seus valores.

   Exemplo:

var_set("account_number", “99999")

Dentro deste fluxo, Script1.account_number pode ser acessado como o valor desta variável

Como definir variáveis ​​globais no widget Script

1. O widget de script deve ser adicionado e configurado em seu fluxo.

2. A importação de dependência variável precisa ser adicionada a um arquivo JavaScript.
   Exemplo:

var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');

Observação: você não precisa importá-lo novamente, pois ele está embutido no novo versão do mecanismo de script

1. Defina o valor de uma variável global usando a função global_var_set. O nome completo de uma variável global é o primeiro parâmetro e o valor é o segundo.
   Exemplo:

global_var_set("global_system.Consumer.firstName", "Your Name")

Observação: os fluxos são limitados em escopo, enquanto as variáveis ​​globais podem ser definidas globalmente no sistema.