Criar um bot de notificação interativo

Para uma notificação interativa, um bot envia mensagens num canal do Teams, chat de grupo ou chat pessoal. Pode acionar um bot de notificação interativo com um pedido HTTP, como cartões ou textos. Para notificações proativas de aplicações de separador, utilize notificações do feed de atividades.

Captura de ecrã a mostrar o bot de notificação conceptual no cliente do Teams

Neste tutorial, saiba mais sobre uma aplicação de bot de notificação interativa de uma das seguintes formas.

  • GitHub Codespaces: a instância de codespace permite-lhe experimentar uma aplicação do Teams instantaneamente. Abre o Visual Studio Code (VS Code) onde a extensão do Teams Toolkit, o código fonte da aplicação e todas as dependências são pré-empacotadas automaticamente.
  • Guia passo a passo: permite-lhe configurar o seu ambiente de desenvolvimento e criar uma aplicação do Teams desde o início.

Antes de criar o seu espaço de código, certifique-se de que tem os seguintes pré-requisitos:

Dica

O GitHub Codespaces oferece um plano gratuito com uma quantidade fixa de utilização por mês. Se precisar de libertar mais espaço, aceda a github.com/codespaces e elimine o espaço de código de que já não precisa.

Para criar um bot de notificação interativo do Teams com o GitHub Codespaces, siga estes passos:

  1. Selecione o botão seguinte para abrir o GitHub Codespaces.

    Abrir o separador hello-world no GitHub Codespaces

    Se ainda não o tiver feito, poderá ser-lhe pedido para iniciar sessão na conta do GitHub.

  2. Selecione Criar novo espaço de código.

    Captura de ecrã a mostrar a página do GitHub para criar um espaço de código para o bot.

    É apresentada a página Configurar o seu espaço de código .

    Captura de ecrã a mostrar o espaço de código a criar o seu bot de notificação.

    O Teams Toolkit prepara automaticamente um projeto de bot de notificação interativo e abre-o no VS Code no browser. O ícone do Toolkit do Teams é apresentado na barra de atividade do VS Code.

  3. Selecione Iniciar sessão no Microsoft 365 e Iniciar sessão no Azure para iniciar sessão com a sua conta do Microsoft 365.

    Captura de ecrã a mostrar a janela do Teams Toolkit no browser para iniciar sessão.

    Observação

    Quando cria a sua aplicação, o GitHub Codespaces carrega-a para o cliente do Teams num novo separador. Se o seu browser bloquear separadores ou janelas de pop-up, terá de permitir a abertura de pop-ups para a sua aplicação.

  4. Selecione Pré-visualizar a sua Aplicação teams (F5).

    Captura de ecrã a mostrar a janela do Teams Toolkit no browser com o seu bot de notificação.

    O GitHub Codespaces cria a sua aplicação de bot de notificação interativa, carrega-a para o cliente do Teams e abre-a num separador do browser separado.

  5. Assim que a caixa de diálogo da aplicação for apresentada, selecione Adicionar para instalar o seu bot de notificação interativo no Teams.

    Captura de ecrã a mostrar o bot de notificação carregado no cliente do Teams.

  6. Abra um novo terminal no seu espaço de código e execute o seguinte comando para acionar um evento para enviar uma notificação interativa para o bot:

    curl -X POST http://localhost:3978/api/notification
    

    Dica

    Em tempo real, os eventos são acionados por uma origem externa, como uma API de terceiros que faz com que o bot de notificação envie uma notificação interativa ao utilizador. Para emular um acionador de evento, pode enviar um evento manualmente através de comandos curl no terminal.

    A aplicação de bot de notificação envia uma notificação interativa como um Cartão Ajustável para o seu cliente do Teams:

    Captura de ecrã a mostrar o bot de notificação carregado no cliente do Teams.

    Criou com êxito um bot de notificação interativo e carregou-o no cliente do Teams.

Se quiser criar uma extensão de mensagem, aceda a:

Se quiser criar uma aplicação de separador básica, aceda a: