Como configurar a etapa Seleção?

Escolha única e múltipla

“Seleção” oferece opções ao visitante. “Tipo de seleção”:

• “Única”: o visitante escolhe uma opção. Com uma lista fixa, cada opção pode levar à sua própria etapa: escolha-a na lista “Etapa de destino” abaixo da opção ou conecte a alça da opção na tela.
• “Múltipla”: várias opções podem ser marcadas e a etapa tem uma única saída. Ao mudar para múltipla uma etapa de escolha única cujas opções levam a etapas diferentes, aparece a pergunta “Remover os destinos das opções?”.

O valor escolhido é gravado na variável indicada em “Nome da variável”: o rótulo da opção no idioma principal do agente. Mesmo que o visitante veja a opção em outro idioma, a variável recebe o rótulo no idioma principal. “system” é reservado e não pode ser usado como nome de variável.

Se o visitante escolher uma opção sem destino, o fluxo termina; o editor avisa que a opção não tem destino.

Origens das opções

Há quatro tipos de “Origem das opções”:

• “Lista fixa”: você digita as opções com “Adicionar opção”.
• “De uma ferramenta”: as opções são buscadas, quando a etapa abre, em um endpoint definido na página Ferramentas; com seleção única, aparecem como cards pesquisáveis. Escolha a ferramenta em “Fonte de dados” e informe valores fixos ou variáveis de etapas anteriores em “Campos da ferramenta”. “Buscar dados de exemplo” chama a ferramenta uma vez e encontra a lista na resposta; depois escolha onde está a lista com “Lista” e o nome do card com “Campo de título”. O “Campo de subtítulo” (por exemplo, a cidade ou o preço) só existe na seleção única.
• “Ação anterior”: uma lista retornada por uma etapa de integração executada antes no agente (por exemplo, os cartões de uma lista do Trello). O nome do item escolhido é salvo na variável, e seus campos como {variable}_id, {variable}_url etc.
• “De uma variável”: uma lista gravada por uma etapa anterior. Informe a variável da lista em “Variável de lista” (por exemplo, o resultado de uma etapa Editar lista).

As “Opções de reserva” só existem na seleção múltipla: aparecem se a ferramenta falhar ou não retornar nada. Na seleção única, se a ferramenta não responder, o visitante vê um erro e um botão para tentar de novo.

Para buscar dados do seu próprio sistema, defina primeiro uma ferramenta na página “Ferramentas”; veja Ferramentas.

Mostrar as opções como abas

Se a etapa inicial for uma Seleção única com lista fixa, a caixa “Mostrar como abas” aparece; mas ela só funciona com exatamente duas opções. Quando ativada, as opções viram abas fixas no topo da página em vez de uma pergunta única; cada aba tem sua própria sessão independente e não é reiniciada ao alternar. Para cada opção, “Mostrar o campo de teclado/microfone nesta aba” ativa ou desativa o campo de entrada.