Como integrar o BigBlueButton com o Moodle LMS (passo a passo)

Resposta curta: No Moodle 4.0 ou posterior, normalmente não é necessário instalar um plugin de atividade BigBlueButton separadamente. Habilite a atividade integrada, caso esteja desabilitada no seu site, insira o URL do servidor BigBlueButton e a chave secreta compartilhada nas configurações do site e, em seguida, adicione uma atividade BigBlueButton a um curso e teste-a com um professor e um aluno matriculado. Você precisa de um serviço BigBlueButton em funcionamento e das credenciais do provedor ou administrador do servidor; instalar a atividade do Moodle por si só não cria um servidor de videoconferência.

Este guia aborda a integração padrão de atividades do Moodle, não uma implementação LTI separada. Os rótulos e caminhos de menu abaixo podem variar ligeiramente entre versões ou temas do Moodle. Os painéis da interface são referências visuais às configurações e ao fluxo de trabalho, não capturas de tela de uma instalação do Moodle em funcionamento.

Preciso instalar outro plugin do Moodle?

Geralmente, não. O Moodle integrou o BigBlueButton como um plugin principal no Moodle 4.0. Nas versões 4.0 a 5.2 do Moodle, um administrador pode precisar habilitá-lo em Administração do site > Plugins > Gerenciar atividades e aceitar o contrato de processamento de dados. A documentação do Moodle 5.3 indica que a atividade é habilitada por padrão em novas instalações, mas o administrador ainda precisa inserir a URL do servidor e a chave secreta compartilhada; até então, o seletor de atividades pode exibir o BigBlueButton como indisponível. Se o seu site for anterior à versão 4.0 do Moodle, verifique a versão do plugin que corresponde à sua versão do Moodle antes de instalar uma cópia separada. Não instale um módulo de atividade duplicado em um site mais recente. Consulte as notas de atualização do Moodle para o BigBlueButton para obter o histórico do plugin principal e a documentação do BigBlueButton no Moodle 5.3 para o comportamento atual da atividade.

O que devo ter pronto antes da configuração?

• Um serviço BigBlueButton: pode ser um servidor operado pela sua organização ou um serviço hospedado que permita a integração com o Moodle.
• O URL do servidor e o segredo compartilhado: solicite-os ao seu provedor ou administrador do servidor. Se você administra um servidor BigBlueButton auto-hospedado compatível, o administrador pode executar o comando sudo bbb-conf --secretnesse servidor. O comando exibe o URL e o segredo da API.
• Acesso administrativo ao Moodle: somente um administrador do site pode alterar as credenciais do servidor em todo o site; um professor do curso pode adicionar a atividade depois que ela for ativada.
• Curso de teste e contas de teste: utilize uma conta de professor ou moderador e uma conta de aluno matriculado no curso.

A URL é o endereço do servidor BigBlueButton fornecido para integração da API, geralmente terminando em ` /bigbluebutton/. Copie o valor do provedor exatamente, incluindo https://o caminho e a barra final, em vez de adicionar um /apicaminho estimado. O segredo compartilhado assina as solicitações de API de servidor para servidor. Mantenha-o em sigilo: as diretrizes de segurança da API do BigBlueButton recomendam não expor o segredo em JavaScript do lado do navegador ou em conteúdo público do curso. Se você usar credenciais de serviço hospedado, esse provedor poderá aplicar seus próprios limites de participantes, gravações ou sessões.

Como faço para conectar o Moodle ao servidor BigBlueButton?

1. Verifique a versão do Moodle e habilite a atividade.

Inicie sessão como administrador do site e confirme a versão do Moodle nas notificações do site ou na página de informações do sistema. Se a atividade BigBlueButton estiver desativada, ative-a na página de gestão de atividades. No Moodle 4.0–5.2, as notas de atualização do Moodle indicam que a atividade principal pode estar desativada por padrão e que o administrador deve aceitar o contrato de processamento de dados para ativá-la. Num novo site Moodle 5.3, ela deverá estar listada como ativada, mas a falta de credenciais pode impedir que ela apareça no seletor. A localização no menu pode variar; utilize a pesquisa "BigBlueButton" na administração do site se os rótulos não corresponderem ao seu tema.

2. Insira o URL do servidor e a chave secreta compartilhada.

Abra as configurações do BigBlueButton na Administração do Site, geralmente em Plugins ou Plugins > Módulos de atividade . Encontre as configurações gerais para URL do servidor BigBlueButton e Senha compartilhada do BigBlueButton . Cole os valores fornecidos pelo seu provedor de serviços ou administrador do servidor e salve as alterações. A documentação do Moodle 5.3 descreve como inserir essas credenciais na página de configurações do BigBlueButton; o caminho exato pode variar em versões anteriores.

Para um serviço autohospedado, compare os valores do Moodle com a URL e o segredo informados no servidor BigBlueButton. Não regenere ou altere o segredo do servidor como uma medida paliativa de solução de problemas: todos os front-ends que utilizam esse servidor devem ser atualizados com o novo valor. O segredo não é uma senha de aluno e não deve ser incluído na mensagem de boas-vindas de uma atividade. A BigBlueButton explica como o segredo compartilhado valida as chamadas de API em seu guia de personalização do servidor BigBlueButton e na documentação de segurança da API BigBlueButton .

3. Adicione uma atividade de teste a um curso.

Abra um curso no qual você tenha permissão de edição e ative o Modo de Edição. Na seção Destino, escolha Adicionar uma atividade ou recurso e selecione BigBlueButton . Se ele não estiver presente, retorne às verificações no nível do site na etapa 1, em vez de tentar adicionar um plugin diferente. Use uma sessão temporária claramente identificada, como "Teste de Conexão BBB", para que os alunos não a confundam com uma aula agendada.

4. Defina os detalhes e o horário da reunião.

Dê à atividade um nome fácil de reconhecer e adicione uma breve descrição explicando o propósito da sala. Uma mensagem de boas-vindas é opcional. Decida se deseja habilitar a opção " Aguardar moderador" : quando habilitada, os alunos aguardam até que um usuário com a função de moderador entre. Se a aula tiver um horário específico de início ou término, defina o cronograma e verifique o fuso horário do curso. Evite abrir uma atividade de teste para convidados, a menos que sua instituição permita esse acesso intencionalmente; o acesso normal para usuários matriculados é mais fácil de controlar durante a configuração.

Utilize inicialmente as funções de participante padrão. Caso o instrutor precise moderar a sala, verifique se a conta possui a função apropriada no curso do Moodle antes de realizar o teste. Links de convidado e acesso externo possuem condições específicas do site e podem estar indisponíveis quando o site do Moodle exigir que os usuários façam login.

Como posso verificar se a integração funciona para os alunos?

5. Salve a atividade e confirme se ela aparece no curso.

Salve a atividade e retorne à página do curso. Confirme se o nome e o horário agendado estão corretos. Se a atividade estiver oculta, fora do período de disponibilidade ou restrita por um grupo ou condição de acesso, os alunos podem não visualizá-la mesmo que a conexão com o servidor esteja funcionando. Verifique a visibilidade da atividade e a matrícula no curso antes de diagnosticar o servidor BigBlueButton.

6. Entre como professor e verifique o acesso ao áudio.

Abra a atividade de teste como professor ou moderador. Quando a sala solicitar a conexão de áudio, escolha "Microfone" para testar a fala e a compreensão auditiva, ou "Somente ouvir" se estiver verificando a reprodução sem microfone. Permita que o navegador acesse o microfone quando solicitado. Uma negação de permissão do navegador é diferente de um erro de credenciais do Moodle: se a sala abrir, mas o áudio falhar, verifique primeiro as permissões do site no navegador e o dispositivo de áudio selecionado.

7. Cadastre-se novamente com uma conta de aluno matriculado.

Use um segundo perfil de navegador ou um dispositivo diferente para entrar como aluno matriculado e abrir a mesma atividade. Confirme se o aluno consegue entrar imediatamente ou se observa o comportamento esperado de aguardar a aprovação do moderador. Verifique se o participante aparece na sala e se um breve teste de chat ou áudio funciona. Este teste verifica mais do que uma inicialização feita por um administrador, pois a visibilidade do aluno, a matrícula no curso, as restrições de grupo e as configurações do moderador podem afetar o resultado.

8. Verifique as gravações somente se sua configuração for compatível.

A gravação é opcional e depende do servidor, das configurações da atividade, das permissões e do plano de serviço. Se a gravação estiver ativada, faça uma breve gravação de teste, encerre a reunião corretamente e verifique se o link da gravação fica disponível para as funções do Moodle desejadas. A gravação pode não aparecer imediatamente; a documentação de atualização do Moodle observa que as tarefas de metadados de gravação podem ser executadas de forma assíncrona e que o cron do Moodle deve estar em funcionamento para o processamento relacionado à gravação no cenário de atualização documentado. Para verificar o funcionamento atual do cron, consulte o status das tarefas agendadas do Moodle e a política de gravação do seu provedor antes de concluir que a integração em si está com problemas.

E se o Moodle não conseguir conectar ou os alunos não conseguirem entrar?

Se o Moodle reportar que não consegue acessar a sala, comece verificando o URL, a chave secreta compartilhada e a acessibilidade do servidor. A página de solução de problemas do Moodle, em sua versão antiga, documenta esses itens como causas comuns; utilize-a como um checklist de diagnóstico, usando as credenciais reais do seu provedor atual em vez de copiar os valores de servidores de teste antigos. Para um servidor autogerenciado, o administrador do BigBlueButton também pode verificar o serviço no servidor. Evite incluir a chave secreta compartilhada em capturas de tela, posts de suporte e logs públicos.

Lista de verificação final de configuração

• A versão do Moodle e o estado do módulo de atividade são conhecidos.
• O endpoint correto do BigBlueButton e o segredo compartilhado são salvos nas configurações do site.
• A atividade aparece no curso e fica visível para o aluno que está realizando o teste.
• Um professor e um aluno matriculado podem participar com as funções pretendidas.
• O áudio funciona no navegador para pelo menos um participante.
• A reprodução de gravações é testada separadamente apenas se fizer parte do serviço.

Uma integração bem-sucedida significa que o Moodle consegue criar e iniciar uma sessão para os usuários corretos do curso — e não apenas que uma atividade do BigBlueButton existe no seletor. Se o início da sessão para o professor funcionar, mas para alunos, mídias ou gravações falhar, solucione os problemas de permissões ou camadas de serviço separadamente, em vez de reinstalar repetidamente a atividade principal do Moodle.