Atividade Entrada fluxo de trabalho

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura

    • A atividade entrada cria um menu de telefone, apresentando uma lista de opções em uma chamada do Notify.

    Variáveis de entrada

    As variáveis de entrada determinam o comportamento inicial da atividade.

    Tabela 1. Variáveis de entrada
    Variável Descrição
    Número de algarismos Especifique o número máximo de dígitos que o chamador pode inserir. Um chamador pode inserir menos dígitos do que o máximo e pressionar a tecla Concluir para concluir a entrada.
    Tecla Finalizar Especifique a tecla que um chamador pode pressionar no telefone quando terminar de selecionar uma opção de menu.
    Tempo de espera (em segundos) Especifique a quantidade de tempo de espera antes de fechar o menu automaticamente quando o chamador não selecionar uma opção de menu.
    Avançado Marque esta caixa de seleção para usar um script para criar o menu do telefone, em vez de usar as condições de atividade.
    Script Defina o script para criar o menu do telefone. O script deve especificar uma variável answer como um objeto JavaScript com o seguinte formato:
     answer = {
  “1": {
      “play”: “https://some_url.com/options/one.mp3“,
      “myCustomData”: “some data here”
  },
  “2”: {
      “play”: “https://some_url.com/options/two.mp3”,
      “myCustomData”: “some other data here”
  },
“3”: {
      “speak”: “type 3 to speak to a representative”,
      “language”: “en-US”,
      “myCustomData”: “some more data here”
  }
};

    O script pode especificar uma cadeia de caracteres de texto para fala e um código de idioma usando o atributo speak ou o URL da música a ser reproduzida usando o atributo play. Você também pode adicionar atributos opcionais para armazenar informações relacionadas, como myCustomData no exemplo acima.

    Nota:
    O objeto de script continua a oferecer suporte ao atributo say para compatibilidade com versões anteriores.

    Condições

    As condições determinam a transição aparece após esta atividade.

    A atividade entrada não especifica nenhuma condição por padrão. Você deve definir condições para criar o menu do telefone. Cada condição é uma opção no menu do telefone. O Notify lê o texto de cada condição Nome para o solicitante, até 100 caracteres por condição.

    Você pode especificar um idioma para cada condição prefixando a mensagem com o código do idioma, no formato xx-XX:<Message>. Por exemplo, adicione fr-CA: para francês canadense. Os idiomas disponíveis são armazenados na tabela Idioma Notify [notify_language].

    A condição pela qual a atividade faz a transição depende dos dígitos inseridos pelo solicitante. Defina o valor da Condição como parseInt(workflow.scratchpad.digits) ==<expected digits> . Por exemplo, para fazer a transição por meio de uma condição quando o chamador pressiona o número 3, defina a Condição como parseInt(workflow.scratchpad.digits) == 3.

    Você pode adicionar uma condição de erro a esta atividade. As transições de atividade por meio da condição de erro se o script avançado retornar um valor inválido ou se o texto para dizer para uma condição estiver vazio.

    Entradas do Bloco de anotações

    A atividade usa o bloco de anotações do fluxo de trabalho para gravar valores persistentes.

    Tabela 2. Valores gravados no bloco de anotações
    Entrada Descrição
    workflow.scratchpad.digits Os dígitos inseridos pelo solicitante, como uma cadeia de caracteres.
    workflow.scratchpad.menu<activity name> A variável answer inteira, se estiver usando a opção de script avançado. Você pode acessar este menu a partir de outras atividades depois que esta atividade for executada com sucesso.
    Por exemplo, se o nome da atividade for escolhas, você poderá acessar valores no menu usando
    var previousActivity = "choices";
var choicesMenu = workflow.scratchpad.menu[previousActivity];
var menuItem = choicesMenu[workflow.scratchpad.digits];  // Selects the menu item based on the caller's input.
var selectedValue = menuItem.myCustomData; //get the custom data for the selected menu item.