Instalando a integração do Moodle com o Microsoft Teams

Moodle, o sistema de gerenciamento de aprendizagem de código aberto mais popular do mundo agora está integrado ao Microsoft Teams! Essa integração ajuda professores e alunos a colaborar em torno dos cursos do Moodle, fazer perguntas sobre suas notas e tarefas e se manter atualizado com notificações - diretamente no Teams!

Para ajudar os administradores de TI a definir facilmente essa integração, atualizamos nosso plug-in Moodle de código aberto com os seguintes recursos:

• Registro automático do seu servidor Moodle com o Microsoft Entra ID.
• Implantação em um único clique do seu bot do assistente do Moodle para o Azure.
• Autoprovisionamento de equipes e sincronização automática de matrículas de equipes para todos ou selecionar cursos Moodle.
• Autoinstalação da guia Moodle e do bot Moodle Assistant em cada equipe sincronizada. (Em breve)
• Publicação em um clique do aplicativo Moodle em sua Microsoft Store do Teams particular. (Em breve)

Para saber mais sobre a funcionalidade que essa integração fornece, consulte Instalando a integração do Moodle com o Microsoft Teams.

Pré-requisitos

Para instalar e configurar esse aplicativo, você precisará:

1. Credenciais de administrador do Moodle
2. Credenciais de administrador do Microsoft Entra
3. Uma assinatura do Microsoft Azure AD na qual você possa criar novos recursos

Etapa 1: Instalar o plug-in do Moodle

A integração Moodle no Microsoft Teams é produzida pelo pacote do plug-in do Moodle de código aberto. Para instalar o plug-in no seu servidor do Moodle:

1. Primeiro, baixe o pacote do plug-in do Moodle e salve-o no seu computador local. Será necessário usar a versão 3.5 ou posterior.
   • Instalar o plug-in local_o365 também instalará os plug-ins auth_oidc e boost_o365Teams.
2. Faça login no servidor Moodle como administrador e selecione Administração do site no painel de navegação esquerdo.
3. Selecione a guia Plug-ins e, em seguida, selecione Instalar plug-ins.
4. Na seção Instalar plug-in do arquivo ZIP, selecione o botão Escolher um arquivo .
5. Selecione a opção Carregar um arquivo na navegação à esquerda, procure o arquivo baixado acima e selecione Carregar este arquivo.
6. Selecione a opção Administração do site no painel de navegação à esquerda novamente, para retornar ao seu painel de administração. Role para baixo até os Plug-ins locais e selecione o link Integração do Microsoft Office 365. Mantenha a página de configuração aberta em uma guia separada do navegador, pois ela será usada durante todo o restante deste processo.

Você pode encontrar mais informações sobre como instalar plug-ins do Moodle na documentação do Moodle.

Nota importante: Mantenha a página de configuração do Plug-in Moodle do Microsoft 365 ou do Office 365 aberta em uma guia separada do navegador, pois você retornará a esse conjunto de páginas durante todo o processo.

Ainda não tem um site do Moodle? Talvez você queira conferir o nosso repositório do Moodle no Azure, onde é possível implantar rapidamente uma instância do Moodle no Azure e personalizá-la de acordo com as suas necessidades.

Etapa 2: Configurar a conexão entre o plug-in do Microsoft 365 ou do Office 365 e o Microsoft Entra ID

Em seguida, você precisará registrar o Moodle como um aplicativo em seu Microsoft Entra ID. Fornecemos um script do Windows PowerShell para ajudar você a concluir esse processo. O Script do PowerShell provisiona um novo aplicativo do Microsoft Entra para sua organização do Microsoft 365 ou do Office 365, que será usado pelo Plug-in do Moodle. O script provisionará o aplicativo para seu locatário do Microsoft 365 ou do Office 365, configurará todas as URLs de respostas e de permissões necessárias para o aplicativo provisionado e retornará a AppID e a chave. Você pode usar o AppID e a chave gerados na página de configuração do plug-in Moodle para configurar seu servidor Moodle com o Microsoft Entra ID. Caso pretenda ver as etapas manuais detalhadas para a automação do script do Windows PowerShell, você pode encontrá-las na documentação completa para o plug-in.

Guia Moodle para o fluxo de informações do Microsoft Teams

1. Na página do plug-in de integração do Microsoft 365 ou do Office 365, selecione a guia Configuração.
2. Selecione o botão Baixar Script do PowerShell e salve-o no computador local.
3. Será necessário preparar o script do Windows PowerShell do arquivo ZIP. Para fazer isso:
   • Baixar e extrair o arquivo Moodle-AzureAD-Powershell.zip.
   • Abrir a pasta extraída.
   • Clique com o botão direito no arquivo Moodle-AzureAD-Script.ps1 e selecione Propriedades.
   • Na guia Geral da janela Propriedades, marque a caixa Unblock ao lado do atributo Segurança na parte inferior.
   • Selecione OK.
   • Copie o caminho do diretório da pasta extraída.
4. Iniciar o Windows PowerShell como um administrador:
   • Selecione Iniciar.
   • Digite Windows PowerShell.
   • Clique com o botão direito em Windows PowerShell.
   • Selecione "Executar como administrador".
5. Navegue até o diretório descompactado, digitando cd ...\...\Moodle-AzureAD-Powershell onde ...\... é o caminho para o diretório.
6. Execute o script do Windows PowerShell:
   • Enter Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.
   • Enter .\Moodle-AzureAD-Script.ps1.
   • Entre na sua conta de administrador do Microsoft 365 ou do Office 365 na janela pop-up.
   • Digite o nome do aplicativo Microsoft Entra (por exemplo, plug-in Moodle/Moodle).
   • Insira a URL do seu servidor Moodle.
   • Copie a ID do aplicativo e a Chave do aplicativo gerados pelo script e salve-os.
7. Em seguida, você precisará adicionar o ID e a chave ao plug-in do Moodle. Retorne à página de administração do plug-in (Integração de plug-ins de administração > do site com o > Microsoft 365).
8. Na guia Configuração, adicione a ID do aplicativo e a chave do aplicativo que você copiou anteriormente e selecione Salvar alterações.
9. Depois que a página for atualizada, você verá uma nova seção Escolher método de conexão. Marque a caixa de seleção padrão e selecione Salvar alterações novamente.
10. Depois que a página for atualizada, você verá outra nova seção Administração consentimento & informações adicionais.
    • Selecione o link Fornecer consentimento de Administração, insira suas credenciais de Administrador Global do Microsoft 365 ou do Office 365 e Aceitar para conceder as permissões.
    • Ao lado do campo de locatário do Microsoft Entra, selecione o botão Detectar.
    • Ao lado da URL do OneDrive for Business, selecione o botão Detectar.
    • Quando os campos forem preenchidos, selecione novamente o botão Save changes .
11. Selecione o botão Atualizar para verificar a instalação e, em seguida, Salve as alterações.
12. Em seguida, você precisará sincronizar usuários entre o servidor Moodle e o Microsoft Entra ID. Dependendo do seu ambiente, você pode selecionar opções diferentes durante essa etapa. A configuração definida aqui será executada com cada execução do cron do Moodle (normalmente uma vez por dia) para manter tudo sincronizado. Para começar:
    • Alternar para a guia Configurações de sincronização
    • Na seção Sincronizar usuários com o Microsoft Entra ID, marque as caixas de seleção que se aplicam ao seu ambiente. Geralmente, você selecionaria pelo menos:
      • Criar contas no Moodle para usuários no Microsoft Entra ID
      • Atualizar todas as contas no Moodle para usuários no Microsoft Entra ID
    • Na seção Restrição de criação do usuário, você pode configurar um filtro para limitar os usuários do Microsoft Entra que serão sincronizados com o Moodle.
    • A seção Mapeamento de campo do usuário permitirá que você personalize o mapeamento de campos do Microsoft Entra ID para o perfil do usuário do Moodle.
    • Na seção Sincronização do Teams , você pode optar por criar automaticamente grupos (ou seja, equipes) para alguns ou todos os seus cursos existentes do Moodle.
13. Para validar os cron jobs (e executá-los manualmente, se desejar na primeira execução), selecione o link da página Gerenciamento de tarefas agendadas na seção Sincronizar usuários com o Microsoft Entra ID. Isso levará você para a página de Tarefas agendadas.
    • Role para baixo e encontre o trabalho Sincronizar usuários com o trabalho do Microsoft Entra ID e selecione Executar agora.
    • Se você optar por criar Grupos com base em cursos existentes, também poderá executar o trabalho Criar grupos de usuários no Office 365.
14. Retorne à página de administração de plug-in (Integração de Plug-ins > de administração > do site com Microsoft 365) e selecione a página Configurações do Teams. Será necessário definir algumas configurações de segurança para habilitar a integração de aplicativos do Teams.
    • Para habilitar o OpenID Connect, clique no link Gerenciar autenticação e clique no ícone de olho na linha OpenId Connect se estiver esmaecido.
    • Em seguida, você precisará habilitar a incorporação de quadro. Selecione o link Segurança HTTP e marque a caixa de seleção ao lado de Permitir a inserção de quadros.
    • A próxima etapa é habilitar os serviços da web, que habilitarão os recursos da API do Moodle. Clique no link Recursos avançados e, em seguida, verifique se a caixa de seleção ao lado de Habilitar serviços Web está marcada.
    • Por fim, você precisará habilitar os serviços externos para o Microsoft 365 ou para o Office 365. Clique no link Serviços externos e, então:
      • Clique em Editar na linha Moodle Office 365 Webservices.
      • Marque a caixa de seleção ao lado de Habilitada, em seguida, clique em Salvar alterações
    • Em seguida, você precisará editar suas permissões de usuário autenticado para permitir que eles criem tokens de serviço Web. Clique no link Editando a função 'Usuário autenticado'. Role para baixo e localize a funcionalidade Criar um token de serviço Web e marque a caixa de seleção Permitir.

Etapa 3: implantar o bot assistente do Moodle para o Azure

O bot gratuito do Moodle Assistant para Microsoft Teams ajuda professores e alunos a responder a perguntas sobre seus cursos, tarefas, notas e outras informações no Moodle. O bot também envia notificações do Moodle aos alunos e professores dentro do Teams. Esse bot é um projeto de código aberto mantido pela Microsoft e está disponível no GitHub.

Fluxo de informações do bot do Moodle

Para instalar o bot, primeiro você precisará registrá-lo na plataforma de identidade da Microsoft. Isso permite que o bot autentique seus pontos de extremidade da Microsoft. Para registrar seu bot:

1. Retorne à página de administração do plug-in (Integração de plug-ins > de administração > do site com o Microsoft 365) e selecione a guia Configurações do Teams.
2. Clique no link do Portal de Registro de Aplicativos da Microsoft e faça logon com sua ID da Microsoft.
3. Digite um nome para o seu aplicativo (por exemplo, MoodleBot) e clique no botão Criar .
4. Copie a ID do aplicativo e cole-a no campo Identificação do aplicativo bot na página Configurações da equipe.
5. Clique no botão Gerar nova senha. Copie a senha gerada e cole-a no campo Senha do Aplicativo de Bot na página Configurações da Equipe .
6. Role até a parte inferior do formulário e clique em Salvar alterações.

Agora que você gerou a ID e a senha do aplicativo, é hora de implantar o bot no Azure. Clique no botão Implantar no Azure e preencha o formulário com as informações necessárias (a ID do aplicativo do bot, a senha do aplicativo do bot e o segredo do Moodle estão na página Configurações da equipe e as informações do Azure estão na página Configuração). Depois de preencher o formulário, marque a caixa de seleção para concordar com os termos e condições e, em seguida, clique no botão Compra (todos os recursos do Azure são implantados no nível gratuito).

Depois que os recursos terminarem de implantar no Azure, você precisará configurar o plug-in do Moodle com seu ponto de extremidade de mensagens. Primeiro, você precisará obter o ponto de extremidade do seu bot no Azure. Para fazer isso:

1. Se você ainda não tiver feito isso, entre no portal do Azure.
2. No painel esquerdo, selecione Grupos de recursos.
3. Na lista, selecione o grupo de recursos que você acabou de usar (ou criar) durante a implantação do bot.
4. Selecione o recurso bot do WebApp na lista de recursos do grupo.
5. Copie o Ponto de extremidade de envio de mensagens da seção Visão geral.
6. No Moodle, abra a página Configurações da equipe do seu plug-in do Moodle.
7. No campo Ponto de extremidade do bot, cole a URL que você acabou de copiar e altere a palavra mensagens para webhook. A URL agora deve ter a seguinte aparência https://botname.azurewebsites.net/api/webhook
8. Clique em Salvar alterações
9. Depois de salvar as alterações, volte para a guia Configurações da equipe, clique no botão Baixar arquivo de manifesto e salve o pacote de manifesto no computador (você o usará na próxima seção).

Etapa 4: implantar seu aplicativo Microsoft Teams

Agora que você já instalou o seu bot no Azure e configurou para se comunicar com o servidor Moodle, chegou a hora de implantar o aplicativo Microsoft Teams. Para fazer isso, você carregará o arquivo de manifesto baixado da página Configurações da equipe do plug-in do Moodle na etapa anterior.

Antes de instalar o aplicativo, você precisará verificar se os aplicativos externos e o sideload de aplicativos estão habilitados. Para fazer isso, siga estas etapas. Depois que você tiver certeza de que os aplicativos externos estão habilitados, siga as etapas abaixo para implantar o aplicativo.

1. Abra o Microsoft Teams.
2. Clique no ícone da Store no canto inferior esquerdo da barra de navegação.
3. Clique no link Carregar um aplicativo personalizado na lista de opções. Observação: se você estiver conectado como um administrador global, terá a opção de carregar o aplicativo para a loja de aplicativos da sua organização. Caso contrário, você só poderá carregar o aplicativo para as equipes das quais você faz parte ("sideload").
4. Selecione o manifest.zip pacote baixado anteriormente e clique em Salvar. Caso ainda não tenha baixado o pacote de manifesto, você pode fazer isso na guia Configurações da equipe da página de configuração do plug-in do Moodle.

Agora que você instalou o aplicativo, você pode adicionar a guia a qualquer canal ao qual tenha acesso. Para fazer isso, navegue até o canal, clique no símbolo + e selecione seu aplicativo na lista. Siga as instruções para concluir a adição da guia do curso Moodle a um canal.

Isso é tudo! Você e sua equipe agora podem começar a trabalhar com seus cursos Moodle diretamente do Microsoft Teams.

Para compartilhar conosco quaisquer solicitações de recursos ou comentários, visite nosso portal de Comentários.