Em determinados pontos de um fluxo, talvez você queira impor a autorização do usuário.

Para isso, faça o seguinte:

1. Nos estados nos quais você deseja impor a autorização, defina a propriedade Exige Autorização como True. Essa propriedade está na guia Geral do inspetor de propriedades do estado.

   Se um usuário que atingir esse estado ainda não tiver autorizado, o estado Autorizar usando OAuth será chamado e, em seguida, o fluxo chamará o estado que exigiu autorização.

2. Crie um componente de autorização e mapeie-o para o evento de transição padrão Autorizar Usuário do fluxo:
   1. Selecione o fluxo e, em seguida, selecione a guia Fluxo do fluxo.
   2. Clique duas vezes no mosaico Eventos do fluxo para expandi-lo.
   3. Passe o mouse sobre o mosaico Autorizar Usuário, clique no botão de reticências (...) que aparece e selecione Adicionar Estado.
   4. Na categoria Segurança do seletor de modelo, selecione um componente, forneça um nome para o estado e clique em Inserir.

      Consulte Modelos de Segurança para obter detalhes de cada um dos modelos disponíveis.

   5. No inspetor de propriedades do componente, configure as propriedades do componente, incluindo suas ações de transição.

Você pode usar o recurso de numeração automática para prefixar botões e listar opções com números em suas respostas.

Quando os usuários não podem usar gestos de toque, eles ainda podem acionar as ações de postback do botão digitando um número. Esse recurso é particularmente útil para canais de texto.

Você configura a numeração automática no nível da habilidade.

Para configurar a numeração automática:

1. Na navegação esquerda da habilidade, selecione .
2. Selecione a guia Configuração.
3. Defina o valor de Ativar Numeração Automática em Ações de Postback em Fluxos de Tarefas.

   Se quiser ativar a numeração automática para todos os canais, defina o valor como verdadeiro.

   Se você quiser ativar a numeração automática apenas para determinados canais, forneça uma expressão para determinar quais canais obterão a numeração automática. Por exemplo, para ativar a numeração automática apenas para canais Twilio, digite:

   ${(system.channelType=='twilio')?then('true','false')}

Você pode garantir que os usuários não fiquem presos em uma etapa de um fluxo de caixas de diálogo configurando esse componente para limitar o número de vezes que ele repete um prompt para o usuário.

A propriedade maxPrompts limita o número de vezes que os componentes de Resposta Comum podem solicitar ao usuário quando eles não conseguem corresponder o valor de entrada com nenhum dos valores definidos para a entidade ou o tipo de entrada referenciado pela propriedade variable. Você pode usar essa propriedade para impedir que sua caixa de diálogo gire em círculos quando os usuários digitarem repetidamente valores inválidos. Você pode definir o número máximo de prompts usando um inteiro . A caixa de diálogo será movida para o próximo estado se o usuário informar um valor válido antes de atingir esse limite. Caso contrário, a caixa de diálogo fará a transição para o estado definido pela ação cancel.

Você pode usar pacotes de recursos para armazenar qualquer string visível ao usuário adicionada ao fluxo de caixas de diálogo.

Você faz referência a chaves de mensagem do pacote de recursos por meio da variável rb. Uma referência a uma mensagem de pacote de recursos simples assume uma das duas formas a seguir:

• ${skill.system.rb.RB_ENTRY_NAME}
• ${rb.RB_ENTRY_NAME}

Para obter mais informações sobre pacotes de recursos, incluindo informações sobre a criação das próprias entradas do pacote de recursos e o uso de formatos de mensagem complexos, consulte Pacotes de Recursos para Habilidades.

Dica:

O preenchimento automático ajuda a selecionar os pacotes de recursos referenciados nas expressões FreeMarker do Apache.

Descrição da ilustração autocomplete-resource-bundle-expression.png

Em fluxos de caixas de diálogo, você também pode criar formulários de entrada de dados.

Às vezes, um formulário de entrada é a maneira mais rápida e menos propensa a erros de coletar informações do usuário. Em vez de submeter os usuários a uma série de perguntas, sua habilidade pode orientar os usuários a fornecer entrada válida enviando formulários que contenham elementos de entrada, como campos de entrada de texto, seletores de data e hora e alternâncias.

Descrição da ilustração editable-form-example.png

Na sua habilidade, você pode definir parâmetros do cliente a serem referenciados em fluxos de caixas de diálogo.

Após a publicação da habilidade, você poderá alterar os valores desses parâmetros (embora não possa alterar outros detalhes deles nem adicioná-los ou excluí-los).

Os parâmetros personalizados são expostos como variáveis skill.system.config para uso na definição do fluxo de caixas diálogo. Por exemplo, um parâmetro personalizado chamado faHostName seria acessado com a seguinte expressão:

${skill.system.config.faHostName}

Se você quiser definir o valor de um parâmetro da habilidade no assistente digital ao qual você adiciona a habilidade, prefacie o nome do parâmetro com da. (inclusive o ponto (.)). Por exemplo, da.faHostName poderia ser usado como nome de um parâmetro para um nome de host.

Usando essa abordagem, você poderá definir parâmetros com os mesmos nomes em várias habilidades, adicionar todas essas habilidades a um assistente digital e, em seguida, definir os valores dos parâmetros compartilhados em um só lugar no assistente digital.

Para acessar um parâmetro de um componente personalizado, defina um parâmetro de entrada no componente personalizado e, em seguida, informe o valor do parâmetro de habilidade para ele.

Você pode importar e exportar fluxos de caixas de diálogo do Modo Visual usando as opções Fluxo de Importação e Exportar Fluxo Selecionado no menu Mais.

Descrição da ilustração More-flow-options.png