Instalando a integração do Moodle com o Microsoft TeamsInstalling the Moodle integration with Microsoft Teams

Moodle, o sistema de gerenciamento de aprendizagem (LMS) mais popular e de código-fonte aberto do mundo agora está integrado ao Microsoft Teams!Moodle, the most popular and open-source Learning Management System (LMS) in the world, is now integrated with Microsoft Teams! Essa integração ajuda educadores e professores a colaborar em cursos do Moodle, fazer perguntas sobre suas notas e notas e manter-se atualizado com as notificações--diretamente dentro do teams!This integration helps educators and teachers collaborate around Moodle courses, ask questions about their grades and assignments and stay updated with notifications -- right within Teams!

Para ajudar os administradores de ti a definir facilmente essa integração, atualizamos nosso plugin de Moodle de código-fonte aberto com os seguintes recursos:To help IT admins easily set this integration up, we have updated our open-source Moodle Plugin with the following capabilities:

  • Registro automático do servidor do Moodle com o Azure AD.Auto-registration of your Moodle server with Azure AD.
  • Implantação com um único clique do bot do assistente do Moodle para o Azure.One-click deployment of your Moodle Assistant bot to Azure.
  • Provisionamento automático de equipes e sincronização automática de registradores de equipe para todos ou selecione cursos do Moodle.Auto-provisioning of teams and auto-synchronization of team enrollments for all or select Moodle courses.
  • Instalação automática da guia Moodle e do bot Assistant do Moodle em cada equipe sincronizada.Auto-installation of the Moodle tab and the Moodle Assistant bot into each synchronized team. (Disponível em breve)(Coming soon)
  • Publicação com um clique do aplicativo Moodle na sua loja de aplicativos particulares do Microsoft Teams.One-click publishing of the Moodle app into your private Teams App Store. (Disponível em breve)(Coming soon)

Para saber mais sobre a funcionalidade fornecida por essa integração, acesse aqui.To learn more about the functionality this integration provides, go here.

Pré-requisitosPrerequisites

Para instalar e configurar este aplicativo, você precisará:In order to install and configure this application you'll need:

  1. Credenciais de administrador do MoodleMoodle administrator credentials
  2. Credenciais de administrador do Azure ADAzure AD administrator credentials
  3. Uma assinatura do Azure, você pode criar novos recursos noAn Azure subscription you can create new resources in

Etapa 1: instalar o plugin MoodleStep 1: Install the Moodle Plugin

A integração do Moodle no Microsoft Teams é habilitada pelo plug-inde Open Source Moodle definido.The Moodle integration in Microsoft Teams is powered by the open source Moodle plugin set. Para instalar o plug-in no servidor do Moodle:To install the plugin in your Moodle server:

  1. Primeiro, baixe o plugin Moodle definido e salve-o em seu computador local.First, download the Moodle plugin set and save it to your local computer. Você precisará usar a versão 3,5 ou mais recente.You'll need to use version 3.5 or newer.
  2. Faça logon no seu servidor Moodle como administrador e selecione Administração de site no painel de navegação à esquerda.Login to your Moodle server as an administrator, and select Site administration from the left navigation panel.
  3. Selecione a guia plug-ins e clique em instalar plug-ins.Select the Plugins tab, and then click Install plugins.
  4. Na seção instalar plug-in do arquivo zip , clique no botão escolher um arquivo .Under the Install plugin from ZIP file section click the Choose a file button.
  5. Selecione as opções carregar um arquivo da navegação à esquerda, navegue até o arquivo que você baixou e clique em carregar este arquivo.Select the Upload a file options from the left navigation, browse for the file you downloaded above and click Upload this file.
  6. Selecione a opção de Administração do site no painel de navegação à esquerda novamente para retornar ao seu painel de administração.Select the Site administration option from the left navigation panel again to return to your admin dashboard. Role para baixo até os plugins locais e clique no link integração do Microsoft Office 365 .Scroll down to the Local plugins and click the Microsoft Office 365 Integration link. Mantenha esta página de configuração aberta em uma guia separada do navegador, pois você a usará durante todo o restante deste processo.Keep this configuration page open in a separate browser tab as you'll be using it throughout the rest of this process.

Você pode encontrar mais informações sobre como instalar plug-ins Moodle na documentação do Moodle.You can find more information on how to install Moodle plugins in the Moodle documentation.

Observação importante: Mantenha a página de configuração do plugin do Microsoft 365 ou do Office 365 Moodle aberta em uma guia separada do navegador, pois você retornará a este conjunto de páginas durante todo o processo.Important Note: Keep your Microsoft 365 or Office 365 Moodle Plugin configuration page open in a separate browser tab as you will be returning to this set of pages throughout this process.

Ainda não tem um site do Moodle?Don't have a Moodle site already? Convém conferir o nosso Moodle no repositório do Azure, onde você pode implantar rapidamente uma instância do Moodle no Azure e personalizá-la de acordo com as suas necessidades.You might want to check out our Moodle on Azure repo where you can quickly deploy a Moodle instance on Azure and customize it to your needs.

Etapa 2: configurar a conexão entre o plug-in do Microsoft 365 ou do Office 365 e o Azure Active DirectoryStep 2: Configure the connection between the Microsoft 365 or Office 365 plugin and Azure Active Directory

Em seguida, você precisará registrar o Moodle como um aplicativo no Azure Active Directory.Next you'll need to register Moodle as an application in your Azure Active Directory. Fornecemos um script do PowerShell para ajudá-lo a concluir esse processo.We've provided a PowerShell script to help you complete this process. O script do PowerShell provisiona um novo aplicativo Azure AD para a sua organização do Microsoft 365 ou do Office 365, que será usado pelo plugin Moodle.The PowerShell Script provisions a new Azure AD application for your Microsoft 365 or Office 365 organization, which will be used by the Moodle Plugin. O script provisionará o aplicativo para o seu locatário do Microsoft 365 ou do Office 365, configurará todas as URLs e permissões de resposta necessárias para o aplicativo provisionado e retornará a AppID e a chave.The script will provision the app for your Microsoft 365 or Office 365 tenant, set up all the required Reply URLs and Permissions for the provisioned app and return the AppID and Key. Você pode usar a IDApl e a chave geradas na página de configuração do plugin do Moodle para configurar seu servidor Moodle com o Azure AD.You can use the generated AppID and Key in your Moodle Plugin Setup Page to configure your Moodle server with Azure AD. Se você quiser ver as etapas manuais detalhadas que o script do PowerShell está automatizando, você pode encontrá-las na documentação completa do plug-in.If you want to see the detailed manual steps that the PowerShell script is automating, you can find them in the full documentation for the plugin.

Guia Moodle para o fluxo de informações do Microsoft TeamsMoodle tab for Microsoft Teams information flow

Illustration of Moodle tab for Microsoft Teams information flow
  1. Na página Microsoft 365 ou o plugin de integração do Office 365, selecione a guia Configurar .From the Microsoft 365 or Office 365 Integration plugin page, select the Setup tab.
  2. Clique no botão baixar script do PowerShell e salve-o em seu computador local.Click the Download PowerShell Script button and save it to your local computer.
  3. Você precisará preparar o script do PowerShell a partir do arquivo ZIP.You'll need to prepare the PowerShell script from the ZIP file. Para fazer isso:To do so:
    • Baixe e extraia o Moodle-AzureAD-Powershell.zip arquivo.Download and extract the Moodle-AzureAD-Powershell.zip file.
    • Abra a pasta extraída.Open the extracted folder.
    • Clique com o botão direito do mouse no Moodle-AzureAD-Script.ps1 arquivo e selecione Propriedades.Right-click on the Moodle-AzureAD-Script.ps1 file and select Properties.
    • Na guia geral da janela Propriedades, marque a caixa de seleção Unblock ao lado do atributo segurança na parte inferior.Under the General tab of the Properties window, check the Unblock box next to the Security attribute at the bottom.
    • Clique em OK.Click OK.
    • Copie o caminho do diretório da pasta extraída.Copy the directory path of the extracted folder.
  4. Em seguida, execute o PowerShell como administrador:Next you'll run PowerShell as an administrator:
    • Clique em Iniciar.Click Start.
    • Digite PowerShell.Type PowerShell.
    • Clique com o botão direito do mouse em Windows PowerShell.Right-click Windows PowerShell.
    • Clique em "executar como administrador".Click "Run as Administrator".
  5. Navegue até o diretório não compactado digitando cd ...\...\Moodle-AzureAD-Powershell onde ...\... é o caminho para o diretório.Navigate to the unzipped directory by typing cd ...\...\Moodle-AzureAD-Powershell where ...\... is the path to the directory.
  6. Executar o script do PowerShell por:Execute the PowerShell script by:
    • Enter Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser .Enter Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.
    • Enter .\Moodle-AzureAD-Script.ps1 .Enter .\Moodle-AzureAD-Script.ps1.
    • Conecte-se à sua conta de administrador do Microsoft 365 ou do Office 365 na janela pop-up.Log in to your Microsoft 365 or Office 365 Administrator account in the pop-up window.
    • Digite o nome do aplicativo Azure AD (por exemplo,Enter the name of the Azure AD Application (Ex. Plugin Moodle/Moodle).Moodle/Moodle plugin).
    • Digite a URL do seu Moodle Server.Enter the URL of your Moodle server.
    • Copie a ID do aplicativo e a chave do aplicativo gerada pelo script e salve-as.Copy the Application ID and Application Key generated by the script and save them.
  7. Em seguida, você precisará adicionar a ID e a chave ao plugin Moodle.Next you'll need to add the Id and Key to the Moodle Plugin. Retorne à página de administração do plugin (administração do site > plug-ins > Microsoft 365 Integration).Return to the plugin administration page (Site administration > Plugins > Microsoft 365 Integration).
  8. Na guia configuração , adicione a ID do aplicativo e a chave do aplicativo que você copiou anteriormente e clique em salvar alterações.On the Setup tab add the Application Id and Application Key you copied previously, then click Save changes.
  9. Depois que a página for atualizada, você verá uma nova seção escolher método de conexão.Once the page refreshes you should now see a new section Choose connection method. Clique na caixa de seleção rotulada como padrão e clique em salvar alterações novamente.Click the checkbox labeled Default and then click Save changes again.
  10. Após a atualização da página, você verá outro consentimento de administrador de seção nova & informações adicionais.Once the page refreshes you will see another new section Admin consent & additional information.
    • Clique no link fornecer consentimento do administrador , insira suas credenciais de administrador global do Microsoft 365 ou do Office 365 e aceite para conceder as permissões.Click the Provide Admin Consent link, enter your Microsoft 365 or Office 365 Global Administrator credentials, then Accept to grant the permissions.
    • Ao lado do campo locatário do Azure ad , clique no botão detectar .Next to the Azure AD Tenant field click the Detect button.
    • Ao lado da URL do onedrive for Business , clique no botão detectar .Next to the OneDrive for Business URL click the Detect button.
    • Depois que os campos forem preenchidos, clique no botão salvar alterações novamente.Once the fields populate, click the Save changes button again.
  11. Clique no botão Atualizar para verificar a instalação e, em seguida, salve as alterações.Click the Update button to verify the installation, then Save changes.
  12. Em seguida, você precisará sincronizar os usuários entre o servidor do Moodle e o Active Directory do Azure.Next you'll need to synchronize users between your Moodle server and Azure Active Directory. Dependendo do seu ambiente, você pode selecionar opções diferentes durante esse estágio.Depending on your environment, you may select different options during this stage. Observe que a configuração definida aqui será executada com cada Moodle de cron (normalmente uma vez por dia) para manter tudo sincronizado. Para começar:Note that the configuration you set here will run with each Moodle cron run (typically once a day) to keep everything in sync. To get started:
    • Alternar para a guia Configurações de sincronizaçãoSwitch to the Sync Settings tab
    • Na seção sincronizar usuários com o Azure ad , marque as caixas de seleção que se aplicam ao seu ambiente.In the Sync users with Azure AD section, select the checkboxes that apply to your environment. Normalmente, você deve selecionar pelo menos:Typically you would select at least:
      • Criar contas no Moodle para usuários no Azure ADCreate accounts in Moodle for users in Azure AD
      • Atualizar todas as contas no Moodle para usuários no Azure ADUpdate all accounts in Moodle for users in Azure AD
    • Na seção restrição de criação de usuário , você pode configurar um filtro para limitar os usuários do Azure AD que serão sincronizados com o Moodle.In the User Creation Restriction section you can setup a filter to limit the Azure AD users that will by synced to Moodle.
    • A seção mapeamento de campos de usuário permitirá que você personalize o mapeamento de campos de perfil de usuário do Azure ad para Moodle.The User Field Mapping section will allow you to customize the Azure AD to Moodle User Profile field mapping.
    • Na seção sincronização do Microsoft Teams , você pode optar por criar automaticamente grupos (ou seja, Teams) para alguns ou todos os cursos existentes do Moodle.In the Teams Sync section you can choose to automatically create Groups (i.e. Teams) for some, or all, of your existing Moodle courses.
  13. Para validar os trabalhos cron (e executá-los manualmente, se você quiser para a primeira execução), clique no link da página de gerenciamento de tarefas agendadas na seção sincronizar usuários com o Azure ad .To validate the cron jobs (and run them manually if you wish to for the first run) click the Scheduled tasks management page link in the Sync users with Azure AD section. Isso o levará até a página tarefas agendadas .This will take you to the Scheduled Tasks page.
    • Role a tela para baixo e localize os usuários de sincronização de trabalho com o trabalho do Azure ad e clique em executar agora.Scroll down and find the job Sync users with Azure AD job and click Run now.
    • Se você optou por criar grupos com base em cursos existentes, também pode executar o trabalho criar grupos de usuários no Office 365 .If you chose to create Groups based on existing courses, you can also run the Create user groups in Office 365 job.
  14. Retorne à página de administração do plugin (administração do site > plug-ins > Microsoft 365 Integration) e selecione a página configurações do teams .Return to the plugin administration page (Site administration > Plugins > Microsoft 365 Integration) and select the Teams Settings page. Você precisará definir algumas configurações de segurança para habilitar a integração do aplicativo Teams.You'll need to configure some security settings to enable the Teams app integration.
    • Para habilitar o OpenID Connect, clique no link gerenciar autenticação e, em seguida, clique no ícone de olho na linha do OpenID Connect se estiver acinzentado.To enable OpenID Connect, click the Manage Authentication link, and click the eye icon on the OpenId Connect line if it is greyed out.
    • Em seguida, você precisará habilitar a inserção de quadros.Next you'll need to enable frame embedding. Clique no link segurança http e, em seguida, clique na caixa de seleção ao lado de permitir inserção de quadros.Click the HTTP Security link, then click the checkbox next to Allow frame embedding.
    • A próxima etapa é habilitar os serviços Web, que habilitarão os recursos de API Moodle.The next step is to enable web services which will enable the Moodle API features. Clique no link recursos avançados e certifique-se de que a caixa de seleção ao lado de habilitar serviços Web esteja marcada.Click the Advanced Features link, then make sure the checkbox next to Enable web services is checked.
    • Por fim, você precisará habilitar os serviços externos para o Microsoft 365 ou o Office 365.Finally you'll need to enabled the external services for Microsoft 365 or Office 365. Clique no link de serviços externos e, em seguida:Click the External services link then:
      • Clique em Editar na linha Moodle Office 365 WebServices .Click Edit on the Moodle Office 365 Webservices row.
      • Marque a caixa de seleção ao lado de ativadoe clique em salvar alteraçõesMark the checkbox next to Enabled, then click Save Changes
    • Em seguida, você precisará editar suas permissões de usuário autenticadas para permitir que elas criem tokens de serviço Web.Next you'll need to edit your authenticated user permissions to allow them to create web service tokens. Clique no link "usuário autenticado da função de edição" .Click the Editing role 'Authenticated user' link. Role a tela para baixo e localize a funcionalidade criar um token de serviço Web e marque a caixa de seleção permitir .Scroll down and find the Create a web service token capability and mark the Allow checkbox.

Etapa 3: implantar o bot do assistente Moodle para o AzureStep 3: Deploy the Moodle Assistant Bot to Azure

O bot do assistente de Moodle grátis para o Microsoft Teams ajuda professores e alunos a responder perguntas sobre seus cursos, tarefas, notas e outras informações no Moodle.The free Moodle Assistant Bot for Microsoft Teams helps teachers and students answer questions about their courses, assignments, grades and other information in Moodle. O bot também envia notificações Moodle para alunos e professores diretamente dentro do teams.The bot also sends Moodle notifications to students and teachers right within Teams. Este bot é um projeto de código-fonte aberto mantido pela Microsoft e está disponível no GitHub.This bot is an open source project maintained by Microsoft, and is available on GitHub.

Observação

Nesta seção, você implantará recursos para a sua assinatura do Azure, e todos os recursos serão configurados usando o nível gratuito .In this section you will deploy resources to your Azure subscription, and all resources will be configured using the free tier. Dependendo do uso do bot, talvez seja necessário dimensionar esses recursos.Depending on the usage of your bot, you may need to scale these resources. Se você quiser apenas usar a guia Moodle sem o bot, pule para a etapa 4.If you want to just use the Moodle tab without the bot, skip to step 4.

Fluxo de informações do bot MoodleMoodle bot information flow

llustration of Moodle bot for Microsoft Teams information flow

Para instalar o bot, primeiro você precisa registrá-lo na plataforma de identidade da Microsoft.To install the bot, you'll first need to register it on the Microsoft Identity Platform. Isso permite que seu bot seja autenticado em seus pontos de extremidade da Microsoft.This allows your Bot to authenticate against your Microsoft endpoints. Para registrar seu bot:To register your bot:

  1. Retorne à página de administração do plugin (administração do site > plug-ins > Microsoft 365 Integration) e selecione a guia configurações do teams .Return to the plugin administration page (Site administration > Plugins > Microsoft 365 Integration) and select the Teams Settings tab.
  2. Clique no link do portal de registro de aplicativos Microsoft e faça logon com sua ID da Microsoft.Click the Microsoft Application Registration Portal link and login with your Microsoft Id.
  3. Insira um nome para o aplicativo (por exemplo,Enter a name for you app (Eg. MoodleBot) e clique no botão criar .MoodleBot) and click the Create button.
  4. Copie a ID do aplicativo e cole-a no campo ID do aplicativo bot na página configurações da equipe .Copy the Application Id and paste it into the Bot Application ID field on the Team Settings page.
  5. Clique no botão gerar nova senha .Click the Generate New Password button. Copie a senha gerada e cole-a no campo senha do aplicativo bot na página configurações da equipe .Copy the generated password and and paste it into the Bot Application Password field on the Team Settings page.
  6. Role até a parte inferior do formulário e clique em salvar alterações.Scroll to the bottom of the form and click Save Changes.

Agora que você gerou a ID do aplicativo e a senha, é hora de implantar seu bot para o Azure.Now that you've generated your Application Id and Password, it's time to deploy your bot to Azure. Clique no botão implantar no Azure e preencha o formulário com as informações necessárias (a ID do aplicativo bot, a senha do aplicativo bot e o segredo Moodle estão na página configurações da equipe e as informações do Azure estão na página de configuração ).Click on the Deploy to Azure button and fill out the form with the necessary information (the Bot Application Id, Bot Application Password and the Moodle Secret are on the Team Settings page, and the Azure information is on the Setup page). Depois de preencher o formulário, clique na caixa de seleção para concordar com os termos e condições e clique no botão comprar (todos os recursos do Azure são implantados no nível gratuito).Once you've got the form filled out, click the check box to agree to the terms and conditions then click the Purchase button (all Azure resources are deployed to the free tier).

Depois que os recursos terminarem de implantar para o Azure, você precisará configurar o plugin Moodle com o ponto de extremidade de mensagem.Once the resources are finished deploying to Azure, you'll need to configure the Moodle plugin with it's messaging endpoint. Primeiro, você precisará obter o ponto de extremidade do bot no Azure.First, you'll need to get the endpoint from your Bot in Azure. Para fazer isso:To do that:

  1. Se você ainda não tiver feito isso, faça logon no portal do Azure.If you aren't already, log into the Azure portal.
  2. No painel esquerdo, selecione grupos de recursos.In the left pane select Resource groups.
  3. Na lista, selecione o grupo de recursos que você acabou de usar (ou criado) durante a implantação do bot.From the list select the resource group you just used (or created) while deploying your Bot.
  4. Selecione o recurso bot do webapp na lista de recursos do grupo.Select the WebApp Bot resource from the list of resources in the group.
  5. Copie o ponto de extremidade da mensagem na seção visão geral .Copy the Messaging Endpoint from the Overview section.
  6. No Moodle, abra a página configurações da equipe do seu plugin do Moodle.In Moodle, open the Team Settings page of your Moodle Plugin.
  7. No campo ponto de extremidade do bot , Cole a URL que você acabou de copiar e altere as mensagens do Word para o webhook.In the Bot Endpoint field paste the URL you just copied and change the word messages to webhook. Agora a URL deve ser parecida comhttps://botname.azurewebsites.net/api/webhookThe URL should now look like https://botname.azurewebsites.net/api/webhook
  8. Clique em salvar alteraçõesClick Save Changes
  9. Depois que as alterações tiverem sido salvas, volte para a guia configurações da equipe , clique no botão baixar arquivo de manifesto e salve o pacote de manifesto em seu computador (você o usará na próxima seção).Once your changes have saved, go back to the Team Settings tab, click the Download manifest file button and save the manifest package to your computer (you'll use it in the next section).

Etapa 4: implantar seu aplicativo Microsoft TeamsStep 4: Deploy your Microsoft Teams app

Agora que você tem o seu bot implantado para o Azure e configurado para falar com seu servidor Moodle, é hora de implantar seu aplicativo Microsoft Teams.Now that you have your Bot deployed to Azure and configured to talk to your Moodle server, it's time to deploy your Microsoft Teams app. Para isso, você carregará o arquivo de manifesto baixado da página Configurações da equipe de plugin do Moodle na etapa anterior.To do this you'll load the manifest file you downloaded from the Moodle Plugin Team Settings page in the previous step.

Antes de instalar o aplicativo, você precisará verificar se os aplicativos externos e o Sideload de aplicativos estão habilitados.Before you can install the app you'll need to make sure external apps and sideloading of apps is enabled. Para fazer isso, você pode seguir estas etapas.To do so you can follow these steps. Depois de garantir que os aplicativos externos estejam habilitados, você pode seguir as etapas abaixo para implantar seu aplicativo.Once you've ensured that external apps are enabled, you can follow the steps below to deploy your app.

  1. Abra o Microsoft Teams.Open Microsoft Teams.
  2. Clique no ícone da loja no canto inferior esquerdo da barra de navegação.Click the Store icon on the lower-left of the navigation bar.
  3. Clique no link carregar um aplicativo personalizado na lista de opções.Click the Upload a custom app link from the list of options. Observação: Se você estiver conectado como um administrador global, terá a opção de carregar o aplicativo na loja de aplicativos da sua organização, caso contrário, só poderá carregar o aplicativo para as equipes das quais você fizer parte ("Sideload").Note: If you're logged in as a global administer you'll have the option of uploading the app to your organization's app store, otherwise you'll only be able to load the app for Teams you're a part of ("sideloading").
  4. Selecione o manifest.zip pacote que você baixou anteriormente e clique em salvar.Select the manifest.zip package you downloaded previously and click Save. Se você ainda não fez o download do pacote de manifesto, é possível fazer isso na guia configurações da equipe da página de configuração do plugin no Moodle.If you haven't yet downloaded the manifest package, you can do so from the Team Settings tab of the plugin configuration page in Moodle.

Agora que você tem o aplicativo instalado, é possível adicionar a guia a qualquer canal ao qual você tenha acesso.Now that you have the app installed you can add the tab to any channel that you have access to. Para fazer isso, navegue até o canal, clique no + símbolo e selecione seu aplicativo na lista.To do so navigate to the channel, click the + symbol and select your app from the list. Siga as instruções para concluir a adição da guia curso Moodle a um canal.Follow the prompts to finish adding your Moodle course tab to a channel.

Isso é tudo!That's it! Você e sua equipe agora podem começar a trabalhar com seus cursos do Moodle diretamente do Microsoft Teams.You and your team, can now start working with your Moodle courses directly from Microsoft Teams.

Para compartilhar qualquer comentário ou solicitação de recursos conosco, acesse nossa página de voz de usuários.To share any feature requests or feedback with us, please visit our User Voice page.