Gerar Scripts

Gerar um script permite que você execute um script manualmente. Essa opção também é usada para iniciar um script a partir de outros scripts ou processos externos. Você também pode usá-la para testar um script. Durante o teste, ela pode ser usada junto com rastreamentos de script.

Para testar scripts, você pode gerar scripts de Studio usando a opção trace option.

Para iniciar scripts a partir de outros scripts ou processos:

  • Use a action SPAWN no script de chamada.
  • Use a API POST /scripts/start Um ícone de um quadrado com uma seta apontando do centro para o canto superior direito.. Esta é a solução recomendada para gerar um script a partir de qualquer processo externo.

Unidades de negócios pode executar no máximo 15.000 scripts, a menos que configurado de outra forma. Quando esse limite é atingido, scripts adicionais não podem ser iniciados ou gerados usando qualquer um dos métodos descritos nesta página até que um ou mais scripts parem de ser executados.

Parâmetros de script

Parâmetros de script permitem que dados sejam passados a scripts. Os dados podem vir de outros scripts, incluindo scripts de sistema, ou de fontes externas como CRMsFechado Sistemas de terceiros que gerenciam itens como contatos, informações de vendas, detalhes de suporte e históricos de casos. ou APIs. Eles são passados aos scripts em variáveis pX, de p1 até pN, onde N é o número máximo de parâmetros suportados pelo método de geração. Ao gerar um script usando qualquer uma das opções listadas na seção anterior, você pode especificar os dados que devem ser passados ao script.

Caso queira mudar os nomes das variáveis de parâmetro, você pode configurar a ação Begin no script gerado com novos nomes. Quando o script processa a ação BEGIN, as variáveis pX são convertidas nos novos nomes. Caso não especifique os nomes novos, as variáveis manterão os nomes pX.

Quando dados são passados a um script, você pode vê-los em um trace. Selecione a ação BEGIN para ver as variáveis de parâmetro na lista de variáveis de saída de rastreamento. Se tiver configurado a ação BEGIN com novos nomes de variáveis, selecione a ação que vem após BEGIN no rastreamento de scripts para vê-los. As variáveis de parâmetro só estarão presentes se contiverem um valor.

Parâmetros personalizados:

  • Suportam um máximo de:
    • 32 KB por valor quando gerados usando a ação SPAWN.
    • 32 KB no total para todos os parâmetros, incluindo as barras verticais delimitadoras, quando gerados pela API.
  • Suporta substituição de variável. Insira o nome da variável entre chaves ( { } ).
  • Suporta 1-20 parâmetros ao gerar pela ação SPAWN ou API.
  • Não suporta objetos de dados dinâmicos. Objetos devem ser convertidos em uma string JSON primeiro.

Comparação de ações do Studio

Há três ações Studio que iniciam um novo script a partir do script atual. No entanto, há algumas diferenças entre elas:

  • Runscript: quando aciona outro script, ele não retorna ao primeiro script a partir do segundo script.
  • Runsub: quando aciona um subscript, o script pode retornar ao primeiro script desde que o subscript tenha uma ação . A ação fornece um valor de volta para a ação quando o subscript é concluído.
  • SPAWN: inicia um segundo script que é executado de forma paralela ao primeiro script. Scripts gerados não podem passar dados de volta ao primeiro script a não ser que você inclua uma action no script gerado.

Geração a partir de outro script usando a ação SPAWN.

Caso não precise passar valores de parâmetro ao script secundário, tudo que precisa fazer é adicionar e configurar a ação SPAWN no script primário. Caso precise passar parâmetros, é preciso realizar as seguintes configurações:

  • Faça as seguintes alterações no script primário:
    • Coloque a ação SPAWN no ponto em que quer gerar o script secundário. Configure a propriedade Parâmetros na ação SPAWN com quaisquer valores que precisa passar ao script secundário. Valores são passados em variáveis p1 para p9.
    • Configure other properties da ação SPAWN.

  • Faça as seguintes alterações no script secundário:

    • Configure a propriedade Parâmetros na ação para alterar o nome das variáveis de parâmetro personalizadas. Caso não faça nada, os valores de parâmetros personalizados serão mantidos nas variáveis .
    • Caso precise passar valores de volta ao script primário ou aplicativo de chamada, adicione e configure uma açãoaction .

Gerar um script pela API

Use a API POST /scripts/start Um ícone de um quadrado com uma seta apontando do centro para o canto superior direito. para gerar um script.

Ao usar esta API, é importante lembrar que:

  • Os seguintes parâmetros são obrigatórios:
    • skillId: o valor deve ser um número inteiro quando enviado como JSON, mas não se for enviado como parâmetros de consulta. As competências devem:
        • Estar ativa.
        • Corresponder ao tipo de mídia do script. Por exemplo, os scripts de telefone devem estar correlacionados com as competências de chamada telefônica. Você pode encontrar o tipo de competência na guia Detalhes de uma competência. Scripts com o tipo Generic funcionam com qualquer competência ativa.

    • scriptId ou scriptPath: usar o scriptPath é recomendado. O ID de script muda toda vez que alterações ao script são salvas, portanto ele deve ser atualizado no parâmetro.

  • Você pode incluir até 20 parâmetros.
  • Parâmetros devem ser enviados em uma lista delimitada por barra.
  • A API suporta um máximo de 32 KB para todos os parâmetros, incluindo as barras delimitadoras.
  • Parâmetros não podem incluir caracteres de barra a menos que sejam delimitadores.
  • Se estiver enviando a solicitação como JSON, caracteres reservados devem ser devidamente escapados.
  • Se estiver enviando a solicitação como URL de parâmetros de consulta, os parâmetros devem ser codificados como URL.