Enviar mensagens proativas
Uma mensagem proativa é uma mensagem enviada por um bot em resposta a comandos simples enviados no chat de um usuário. A resposta da mensagem pode estar em um dos seguintes formatos:
- Mensagem de boas-vindas
- Mensagens agendadas
- Notificações
Este guia passo a passo ajuda você a enviar uma mensagem proativa de um bot. Você verá a seguinte saída:
Pré-requisitos
Verifique se você instala as seguintes ferramentas para criar e implantar seus aplicativos.
| Instalar | Para usar | |
|---|---|---|
| Microsoft Visual Studio Code | JavaScript ou TypeScript, ambientes de build. Use a versão mais recente. | |
| Kit de Ferramentas do Microsoft Teams | Visual Studio Code extensão que cria um scaffolding de projeto para seu aplicativo. Use a versão mais recente. | |
| Node.js | Ambiente de runtime do JavaScript de back-end. Para obter mais informações, consulte Node.js tabela de compatibilidade de versão para o tipo de projeto. | |
| Microsoft Teams | Equipes para colaborar com todos com quem você trabalha por meio de aplicativos para chat, reuniões, chamadas e tudo em um só lugar. | |
| Microsoft Edge (recomendado) ou Google Chrome | Um navegador com ferramentas de desenvolvedor. | |
| Conta de desenvolvedor do Microsoft 365 | Acesso à conta do Teams com as permissões apropriadas para instalar um aplicativo. |
Preparar o ambiente de desenvolvimento
Depois de instalar as ferramentas necessárias, configure o ambiente de desenvolvimento.
Instalar o Kit de Ferramentas do Teams
O Microsoft Teams Toolkit ajuda a simplificar o processo de desenvolvimento com ferramentas para provisionar e implantar recursos de nuvem para seu aplicativo e publicar na Teams Store.
Você pode usar o Teams Toolkit com Visual Studio Code ou uma interface de linha de comando chamada CLI do TeamsFx.
Abra Visual Studio Code e selecione Extensões (Ctrl+Shift+X ou Exibir>Extensões).
Na caixa de pesquisa, insira o Kit de Ferramentas do Teams.
Selecione Instalar.
O ícone Kit de
Ferramentas do Teams é exibido na Barra de Atividades do Visual Studio Code.
Você também pode instalar o Teams Toolkit no Visual Studio Code Marketplace.
Configurar seu locatário de desenvolvimento do Teams
Um locatário é um espaço ou um contêiner para sua organização no Teams, onde você conversa, compartilha arquivos e executa reuniões. Esse espaço também é onde você carrega e testa seu aplicativo. Vamos verificar se você está pronto para desenvolver com o locatário.
Verifique se há a opção carregar um aplicativo
Depois de criar seu aplicativo personalizado, você deve carregar seu aplicativo no Teams com a opção Carregar um aplicativo personalizado . Entre em sua conta do Microsoft 365 para marcar se essa opção estiver habilitada.
As etapas a seguir ajudam você a verificar se você pode carregar aplicativos no Teams:
No cliente do Teams, selecione o ícone Aplicativos .
Selecione Gerenciar seus aplicativos.
Selecione Carregar um aplicativo.
Procure a opção para Carregar um aplicativo personalizado. Se a opção estiver visível, você poderá carregar aplicativos personalizados.
Observação
Se você não encontrar a opção de carregar um aplicativo personalizado, entre em contato com o administrador do Teams.
Criar um locatário de desenvolvedor gratuito do Teams (opcional)
Se você não tiver uma conta de desenvolvedor do Teams, ingresse no programa de desenvolvedor do Microsoft 365.
Selecione Ingressar Agora e siga as instruções na tela.
Na tela de boas-vindas, selecione Configurar assinatura do E5.
Configurar a conta de administrador. Depois de concluir, a seguinte tela será exibida:
Entre no Teams usando a conta de administrador que você acabou de configurar. Verifique se você tem a opção Carregar um aplicativo personalizado no Teams.
Criar bot de mensagem proativa
Para criar um bot de mensagens proativo usando Visual Studio Code, siga estas etapas:
Abra o Visual Studio Code.
Selecione o ícone Kit de
Ferramentas do Teams na Barra de Atividades Visual Studio Code.No painel esquerdo, selecione Exibir Exemplos.
Na lista de exemplos, selecione Mensagens Proativas. Um exemplo predefinido pronto para depuração é aberto.
Selecione Criar.
Selecione Pasta padrão para armazenar sua pasta raiz do projeto no local padrão.
Se você quiser alterar o local padrão, execute as seguintes etapas:
Selecione Procurar.
Selecione o local para o workspace do projeto.
Selecione Selecionar Pasta.
O bot de mensagem proativo é criado em alguns segundos e exibe a caixa de diálogo proativa do bot de mensagens bem-sucedida no canto inferior direito com a opção de depurar:
:::Selecione Ícone Executar e Depurar
no canto superior esquerdo.Selecione Depuração (Edge) ou Depuração (Chrome) na lista suspensa.
Quando a depuração for bem-sucedida, você será solicitado a carregar o bot de mensagens proativo para o Teams em seu computador local.
Na lista suspensa ao lado de Adicionar, selecione Adicionar a uma equipe ou Adicionar a um chat ou Adicionar a uma reunião.
Insira o nome de um chat ou equipe no campo de pesquisa e selecione Configurar um bot.
O aplicativo de bot de mensagem proativa é carregado no cliente do Teams e a mensagem a seguir é exibida em resposta à mensagem enviada.
Copie e cole a URL ou navegue até a URL no navegador. Uma mensagem de olá proativa é disparada e compartilhada no chat.
Vá para o Teams. Você receberá uma mensagem de olá proativa do bot.
Faça um tour pelo código-fonte
O Teams Toolkit fornece componentes para a criação de um aplicativo. Depois de criar o projeto, você pode exibir as pastas e arquivos do projeto na área EXPLORER de Visual Studio Code.
A nova pasta de projeto contém o seguinte conteúdo:
| Pasta/Arquivo | Conteúdos |
|---|---|
.vscode/ |
Visual Studio Code arquivos para depuração. |
appManifest/ |
Modelos para o manifesto do aplicativo (anteriormente chamado de manifesto do aplicativo teams). |
env/ |
Pares de nome/valor são armazenados em arquivos de ambiente e usados por teamsapp.yml para personalizar as regras de provisionamento e implantação. |
manifest.json |
O manifesto do aplicativo para publicação por meio do Portal do Desenvolvedor para Teams é armazenado em Properties/manifest.json. |
teamsapp.yml |
O arquivo principal do projeto descreve a configuração do aplicativo e define o conjunto de ações a serem executadas em cada estágio do ciclo de vida. |
teamsapp.local.yml |
Isso substitui teamsapp.yml as ações que permitem a execução local e a depuração. |
Implantar seu bot de mensagens proativa
Você aprendeu a criar e executar o aplicativo Teams com recursos proativos de bot de mensagens. Vamos implantar o primeiro aplicativo com recursos proativos de bot de mensagens no Azure usando o Teams Toolkit.
Entre em sua conta do Azure
Use sua conta para acessar o Microsoft portal do Azure e provisionar novos recursos de nuvem para dar suporte ao seu aplicativo.
Abra o Visual Studio Code.
Abra a pasta de projeto em que você criou o aplicativo de bot de mensagens proativa.
Selecione o ícone Kit de
Ferramentas do Teams na Barra de Atividades Visual Studio Code.Selecione Entrar no Azure usando suas credenciais.
Dica
Se você tiver a extensão da CONTA do AZURE instalada e estiver usando a mesma conta, poderá ignorar esta etapa.
Seu navegador da Web padrão é aberto para permitir que você entre na conta.
Feche o navegador quando solicitado e retorne ao Visual Studio Code.
A seção ACCOUNTS da barra lateral mostra as duas contas separadamente. Ele também lista o número de assinaturas utilizáveis do Azure disponíveis para você. Verifique se você tem pelo menos uma assinatura utilizável do Azure disponível. Caso contrário, saia e use uma conta diferente.
Implantar seu aplicativo no Azure.
A implantação consiste em duas etapas. Primeiro, os recursos de nuvem necessários são criados (também conhecidos como provisionamento). Em seguida, o código do aplicativo é copiado para os recursos de nuvem criados. Para este tutorial, você implantará o aplicativo bot.
Qual é a diferença entre Provisionar e Implantar?
A provisionamento cria recursos no Azure e no Microsoft 365 para seu aplicativo, mas nenhum código (HTML, CSS e JavaScript) é copiado para os recursos. Implantar copia o código do aplicativo para os recursos criados durante o provisionamento. É comum implantar várias vezes sem provisionar novos recursos. Como o provisionamento pode levar algum tempo para ser concluído, ele é separado da implantação.
Selecione o ícone Kit de
Ferramentas do Teams na Barra de Atividades Visual Studio Code.Selecione Provisionar em CICLO DE VIDA.
Selecione uma das assinaturas existentes.
Selecione um grupo de recursos existente ou crie um novo grupo de recursos. Para obter mais informações, confira criar grupo de recursos.
Observação
Uma caixa de diálogo aparece mencionando que os custos podem ser incorridos ao executar recursos no Azure.
Selecione Provisionar.
O processo de provisionamento cria recursos na nuvem do Azure. Você pode monitorar o progresso nas caixas de diálogo que aparecem no canto inferior direito. Após alguns minutos, a seguinte caixa de diálogo será exibida:
Selecione Implantar em CICLO DE VIDA.
Selecione Implantar.
A implantação leva algum tempo. Você pode monitorar o progresso nas caixas de diálogo que aparecem no canto inferior direito. Após alguns minutos, a caixa de diálogo a seguir será exibida.
Abra o painel de depuração (Ctrl+Shift+D / ⌘⇧-D ou Exibir>Execução) de Visual Studio Code.
Selecione Iniciar Remoto (Edge) na lista suspensa de configuração de inicialização.
Quando a depuração for bem-sucedida, você será solicitado a carregar o aplicativo de bot de mensagens proativa para o Teams.
Na lista suspensa ao lado de Adicionar, selecione Adicionar a uma equipe ou Adicionar a um chat ou Adicionar a uma reunião.
Insira o nome de um chat ou equipe no campo de pesquisa e selecione Configurar um bot.
O aplicativo de bot de mensagem proativa é carregado no cliente do Teams e a mensagem a seguir é exibida em resposta à mensagem enviada.
Copie e cole a URL ou navegue até a URL no navegador. Uma mensagem de olá proativa é disparada e compartilhada no chat.
Vá para o Teams. Você receberá uma mensagem de olá proativa do bot.
Desafio completo
Você veio com algo assim?
Parabéns!
Você concluiu o cenário.
- Você pode enviar notificações diariamente ou solicitar comentários dos usuários periodicamente.
- Você pode lidar com limites de limitação para evitar várias notificações.
Tem algum problema com essa seção? Se tiver, envie seus comentários para que possamos melhorar esta seção.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de