Compartilhar via

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

  • Artigo
  • Aplica-se a:
    Microsoft Teams

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

Para ajudar os administradores de TI a definir facilmente esta integração, atualizámos o nosso Plug-in do Moodle open source com as seguintes capacidades:

  • Registo automático do servidor Moodle com o ID do Microsoft Entra.
  • Implantação em um único clique do seu bot do assistente do Moodle para o Azure.
  • Aprovisionamento automático de equipas e a sincronização automática de inscrições de equipas para todos ou selecione Cursos do Moodle.
  • Autoinstallation of the Moodle tab and the Moodle Assistant bot into each synchronized team. (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 esta integração proporciona, consulte Instalar a integração do Moodle com o Microsoft Teams.

Pré-requisitos

Para instalar e configurar esta aplicação, precisará de:

  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.
  2. Inicie sessão no servidor Moodle como administrador e selecione Administração de sites no painel de navegação esquerdo.
  3. Selecione o separador Plugins e, em seguida, selecione Instalar plug-ins.
  4. Na secção Instalar plug-in do ficheiro ZIP, selecione o botão Escolher um ficheiro .
  5. Selecione a opção Carregar um ficheiro no painel de navegação esquerdo, procure o ficheiro que transferiu acima e selecione Carregar este ficheiro.
  6. Selecione a opção Administração do site no painel de navegação à esquerda novamente, para retornar ao seu painel de administração. Desloque-se para baixo até aos plug-ins locais e selecione a ligação 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 do Microsoft 365 ou do Office 365 Moodle aberta num separador do browser separado, uma vez que irá regressar a este conjunto de páginas ao longo deste 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.

Passo 2: Configurar a ligação entre o plug-in do Microsoft 365 ou do Office 365 e o ID do Microsoft Entra

Em seguida, terá de registar o Moodle como uma aplicação no seu ID do Microsoft Entra. Fornecemos um script do Windows PowerShell para ajudar você a concluir esse processo. O Script do PowerShell aprovisiona uma nova aplicação Microsoft Entra para a sua organização do Microsoft 365 ou Office 365, que será utilizada pelo Plug-in 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. Pode utilizar o AppID e a Chave gerados na Página de Configuração do Plug-in do Moodle para configurar o 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

Ilustração do separador Moodle para 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 Transferir Script do PowerShell e guarde-o no seu 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.
    • Introduza o nome da Aplicação 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, terá de adicionar o ID e a Chave ao Plug-in do Moodle. Regresse à página de administração do plug-in (Plug-ins de administração > de sites > Integração do Microsoft 365).
  8. No separador Configuração, adicione o ID da Aplicação e a Chave da Aplicação que copiou anteriormente e, em seguida, selecione Guardar alterações.
  9. Depois que a página for atualizada, você verá uma nova seção Escolher método de conexão. Selecione a caixa de verificação com o nome Predefinição e, em seguida, selecione Guardar alterações novamente.
  10. Assim que a página for atualizada, verá outra nova secção Consentimento do administrador & informações adicionais.
    • Selecione a ligação Fornecer Consentimento do Administrador , introduza as suas credenciais de Administrador Global do Microsoft 365 ou Office 365 e, em seguida, Aceite para conceder as permissões.
    • Junto ao campo do inquilino do Microsoft Entra , selecione o botão Detetar .
    • Junto ao URL do OneDrive para Empresas , selecione o botão Detetar .
    • Assim que os campos forem preenchidos, selecione novamente o botão Guardar alterações .
  11. Selecione o botão Atualizar para verificar a instalação e, em seguida, Guardar alterações.
  12. Em seguida, terá de sincronizar os utilizadores 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 que definir aqui será executada com cada cron do Moodle executado (normalmente uma vez por dia) para manter tudo sincronizado. Para começar:
    • Alternar para a guia Configurações de sincronização
    • Na secção Sincronizar utilizadores com o Microsoft Entra ID , selecione as caixas de verificação que se aplicam ao seu ambiente. Geralmente, você selecionaria pelo menos:
      • Criar contas no Moodle para utilizadores no Microsoft Entra ID
      • Atualizar todas as contas no Moodle para utilizadores no Microsoft Entra ID
    • Na secção Restrição de Criação de Utilizadores , pode configurar um filtro para limitar os utilizadores do Microsoft Entra que serão sincronizados com o Moodle.
    • A secção Mapeamento de Campos de Utilizador irá permitir-lhe personalizar o mapeamento do campo ID do Microsoft Entra para o Perfil de Utilizador do Moodle.
    • Na secção Sincronização do Teams , pode optar por criar automaticamente Grupos (ou seja, Teams) para alguns ou todos os seus cursos existentes do Moodle.
  13. Para validar as tarefas cron (e executá-las manualmente se quiser para a primeira execução), selecione a ligação da página Gestão de tarefas agendadas na secção Sincronizar utilizadores com o Microsoft Entra ID . Isso levará você para a página de Tarefas agendadas.
    • Desloque-se para baixo e localize a tarefa Sincronizar utilizadores com a tarefa ID do Microsoft Entra 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. Regresse à página de administração do plug-in (Administração > de sites Plug-ins > Microsoft 365 Integration) e selecione a página Definições do Teams . Será necessário definir algumas configurações de segurança para habilitar a integração de aplicativos do Teams.
    • Para ativar o OpenID Connect, clique na ligação Gerir Autenticação e clique no ícone de olho na linha OpenId Connect , se estiver a cinzento.
    • Em seguida, você precisará habilitar a incorporação de quadro. Selecione a ligação Segurança HTTP e, em seguida, selecione a caixa de verificação junto a Permitir incorporação de frames.
    • O próximo passo é ativar os serviços Web, que irão ativar as funcionalidades da API 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, terá de ativar os serviços externos para o Microsoft 365 ou 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 assistente do Moodle gratuito para o Microsoft Teams ajuda professores e estudantes a responder a perguntas sobre os 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.

Nota

Nesta seção, você implantará os recursos da sua assinatura do Azure, e todos os recursos serão configurados usando o nível gratuito. Dependendo do uso de seu bot, talvez seja necessário escalar esses recursos. Se você quiser apenas usar a guia Moodle sem o bot, vá para etapa 4.

Fluxo de informações do bot do Moodle

llustration of Moodle bot for Microsoft Teams information flow

Para instalar o bot, primeiro terá de o registar na plataforma de identidades da Microsoft. Isso permite que o bot autentique seus pontos de extremidade da Microsoft. Para registrar seu bot:

  1. Regresse à página de administração do plug-in (Administração > de sites Plug-ins > Microsoft 365 Integration) e selecione o separador Definições do Teams .
  2. Clique na ligação Portal de Registo de Aplicações da Microsoft e inicie sessão com o seu ID Microsoft.
  3. Introduza um nome para a sua aplicação (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 palavra-passe gerada e cole-a no campo Palavra-passe da Aplicação bot na página Definições da Equipa .
  6. Role até a parte inferior do formulário e clique em Salvar alterações.

Agora que já gerou o ID da Aplicação e a Palavra-passe, está na altura de implementar o bot no Azure. Clique no botão Implementar no Azure e preencha o formulário com as informações necessárias (o ID da Aplicação do Bot, a Palavra-passe da Aplicação do Bot e o Segredo do Moodle estão na página Definições da Equipa 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).

Assim que os recursos terminarem a implementação no Azure, terá de configurar o plug-in do Moodle com o respetivo ponto final 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 tal, irá carregar o ficheiro de manifesto que transferiu a partir da página Definições da Equipa do Plug-in do Moodle no passo anterior.

Antes de poder instalar a aplicação, terá de se certificar de que as aplicações externas e o sideload das aplicações estão ativados. Para tal, pode seguir estes passos. 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 Loja 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 partilhar qualquer pedido de funcionalidade ou feedback connosco, visite o nosso portal de Comentários.

Nota

A Microsoft mudará do UserVoice para a nossa própria solução de feedback do cliente numa base produto a produto durante 2021. Saiba mais.