Diálogos

As caixas de diálogo (chamadas de módulos de tarefas no TeamsJS v1.x) permitem que você crie experiências pop-up modais no aplicativo Teams. Na janela pop-up, você pode:

  • Execute seu próprio código HTML ou JavaScript personalizado.
  • Mostrar um <iframe>widget baseado em , como pesquisas, vídeo do YouTube ou vídeo do Microsoft Stream.
  • Exiba um Cartão Adaptável.

Os diálogos são úteis para iniciar e concluir tarefas ou exibir informações avançadas, como vídeos ou painéis do Power Business Intelligence (BI). Uma experiência de pop-up geralmente é mais natural para os usuários que iniciam e concluem tarefas em comparação com uma guia ou uma experiência de bot baseada em conversa.

Os diálogos se baseiam nas guias do Microsoft Teams. Eles são essencialmente uma guia dentro de uma janela pop-up. Eles usam a mesma biblioteca de cliente JavaScript do Microsoft Teams (TeamsJS), portanto, se você criou uma guia, já está familiarizado com a criação de uma caixa de diálogo.

Você pode invocar caixas de diálogo de três maneiras:

  • Canal ou guias pessoais: usando a biblioteca TeamsJS, você pode invocar caixas de diálogo de botões, links ou menus em sua guia. Para obter mais informações, consulte Usando caixas de diálogo em guias.
  • Bots: Usando botões em cartões enviados do seu bot. Isso é útil quando você não exige que todos em um canal vejam o que você está fazendo com um bot. Por exemplo, ao fazer com que os usuários respondam a uma votação em um canal, não é útil ver um registro dessa votação sendo criada. Para obter mais informações, consulte Usando caixas de diálogo de bots do Teams.
  • Fora do Teams a partir de um link profundo: Você também pode criar URLs para invocar uma caixa de diálogo de qualquer lugar. Para obter mais informações, consulte sintaxe de vínculo profundo da caixa de diálogo.

Componentes de uma caixa de diálogo

Veja como é a aparência de uma caixa de diálogo quando invocada de um bot:

Exemplo de caixa de diálogo

Uma caixa de diálogo inclui o seguinte, como mostrado na imagem anterior:

  1. O ícone do colorseu aplicativo.

  2. O nome do shortseu aplicativo.

  3. O título da caixa de diálogo especificado na title propriedade do objeto TaskInfo.

  4. O botão fechar ou cancelar da caixa de diálogo. Se o usuário selecionar esse botão, seu aplicativo receberá um err evento. Para obter mais informações, consulte o exemplo para enviar o resultado de uma caixa de diálogo.

    Observação

    Não é possível detectar o err evento quando uma caixa de diálogo é invocada de um bot.

  5. O retângulo azul é onde sua página da Web aparece se você estiver carregando sua própria página da Web usando a url propriedade do objeto TaskInfo. Para obter mais informações, consulte Invocar e ignorar diálogos.

  6. Se você estiver exibindo um Cartão Adaptável usando a card propriedade do objeto TaskInfo, o preenchimento será adicionado para você.

  7. Os botões do Cartão Adaptável são renderizados depois que você seleciona Inscrever-se. Ao usar sua própria página, crie seus próprios botões. Por design, o estilo de botão primário (sólido) é aplicado à última ação raiz em um Cartão Adaptável. Para todas as outras ações, o estilo de botão padrão será aplicado.

Usando caixas de diálogo no Bot Framework

Você pode integrar caixas de diálogo em Microsoft Bot Framework Webchat para melhorar a experiência do usuário. No entanto, com o foco principal nas interações de chat, o Webchat não dá suporte à abertura de diálogos. Para criar eventos ou componentes personalizados no Webchat, use o Bot Framework Webchat. Para obter mais informações, consulte a documentação do Bot Framework.

Próxima etapa

Invocar e ignorar diálogos

Confira também

  • Last updated on