Integração Zoom (SDK) no Maestrus - 2023
Olá! Tudo bem?
Nesse tutorial iremos abordar a integração de sua conta Zoom no Maestrus seguindo os parâmetros atuais desse serviço via SDK.
Vamos lá!
1- Acesse https://marketplace.zoom.us.
Caso ainda não tenha uma conta no Zoom, você terá que criá-la clicando em "Sign Up" (A).
Se já possuir uma conta, basta logar em sua conta clicando em "Sign In" (B).
Veja na imagem 1.
IMAGEM 1
2- Uma vez logado em sua conta, clique em "Develop > e depois em "Build App".
Veja na imagem 2.
IMAGEM 2
3- Na próxima tela, você irá clicar na opção "Create" no box "Meeting SDK".
Veja na imagem 3.
IMAGEM 3
4- No modal que será aberto, você irá inserir um nome para sua aplicação (o nome não poderá ter acentuação!) e DESMARQUE A OPÇÃO abaixo do campo onde inseriu o nome de sua aplicação (C). Veja na imagem 4
IMAGEM 4
Feito isso clique em "Create"!
5- Agora na aba "Information" você irá preencher alguns campos obrigatórios como:
--- Short description: aqui você irá inserir uma breve descrição da aplicação.
--- Long description: aqui você irá inserir uma descrição maior sobre sua aplicação.
Veja na imagem 5.
Veja na imagem 5.
IMAGEM 5
--- Company Name: aqui você irá inserir um nome de sua companhia/empresa. Veja na imagem 6.
IMAGEM 6
--- Name: aqui você irá inserir um nome do responsável pelo desenvolvimento de sua empresa.
--- Email address: aqui você irá inserir o email do responsável pelo desenvolvimento de sua empresa.
Veja na imagem 7.
IMAGEM 7
Ao preencher todos os campos citados acima, clique em "Continue".
Veja na imagem 8.
IMAGEM 8
6 - Na aba "Download" apenas clique em "Continue" e não mexa mais em nada!
Veja na imagem 9.
Veja na imagem 9.
IMAGEM 9
7 - Na aba "App credentials" deixe essa página aberta em seu browser e abra outra nova com seu Maestrus.
Uma vez dentro de seu Maestrus, acesse o menu "Ao Vivo > Anfitriões > e clique na opção 'Novo Anfitrião' ".
Veja na imagem 10.
IMAGEM 10
Na tela que irá se abrir, você irá preencher os seguintes campos:
IMAGEM 11
--- Nome do Anfitrião: aqui você irá apelidar o anfitrião do evento a ser realizado.
--- Client ID e Client Secret: para preencher esses campos você deverá retornar a aba "App credentials" em sua conta Zoom, clicar em "Copy" em cada campo correspondente, conforme imagem 12, depois voltar em seu Maestrus e colar cada informação em seu campo correspondente.
Após inserir esses dados NÃO FECHE ESSA TELA DE SEU MAESTRUS AINDA!!! Pois ainda retornaremos nela!
IMAGEM 12
Ainda nessa aba, no campo "Redirect URL for OAuth" você irá inserir uma URL da seguinte forma:
https://meu_maestrus.com/ead/zoom/oauth2/
https://meu_maestrus.com/ead/zoom/oauth2/
ATENÇÃO! A URL "https://meu_maestrus.com" deverá ser substituída pela URL de seu projeto Maestrus!!!
E por fim, no campo "Add allow urls" você irá inserir apenas a URL de seu Maestrus.
E por fim, no campo "Add allow urls" você irá inserir apenas a URL de seu Maestrus.
Veja na imagem 13.
IMAGEM 13
9- Na próxima tela, na aba "Feature", copie o código "Secret Token" e, volte na aba aberta de seu Maestrus e cole esse código no campo correspondente em seu Maestrus conforme imagem 15.
IMAGEM 14
IMAGEM 15
Agora sim, você pode salvar e fechar essa aba em seu Maestrus!
Mas ainda não acabou!
Mas ainda não acabou!
Vamos continuar a configuração em sua conta Zoom.
10- Ainda na aba "Feature" em sua conta Zoom, ative a opção "Event Subscriptions" e depois em "Add Event Subscription" conforme imagem 16.
IMAGEM 16
Na próxima sessão você terá:
--- Subscription name: você irá apelidar o evento Zoom.
--- Subscription name: você irá apelidar o evento Zoom.
--- Event notification endpoint URL: aqui você irá inserir a seguinte URL:
https://meu_maestrus.com/ead/zoom/notificacoes/id-do-anfitriao/
https://meu_maestrus.com/ead/zoom/notificacoes/id-do-anfitriao/
Não se esqueça da "/" no final da URL!
IMAGEM 17
ATENÇÃO! A URL "https://meu_maestrus.com" deverá ser substituída pela URL de seu projeto Maestrus!!!
E para descobrir a ID do anfitrião, basta você voltar em seu Maestrus, acessar o menu Ao Vivo > Anfitriões > e na coluna ID verificar o código. Veja na imagem 18
IMAGEM 18
Ainda nessa parte, clique em "Add Events".
IMAGEM 19
No modal que irá se abrir, marque as opções "Start Meeting" e "End Meeting" e depois em "Done", conforme imagem 20.
IMAGEM 20
E para finalizar essa etapa, clique em "Save" e depois em "Continue".
IMAGEM 21
11 - Na aba "Scopes" clique em "Add Scopes". Conforme imagem 22.
IMAGEM 22
No modal que irá se abrir, MARQUE TODAS AS OPÇÕES conforme imagem abaixo conforme imagem 23.
IMAGEM 23
ATENÇÃO PARA NÃO ESQUECER DE MARCAR NENHUMA DESSAS OPÇÕES
E por fim, clique em "Continue"
IMAGEM 24
Pronto! Sua conta Zoom já está integração com seu Maestrus.
12 - Vamos agora criar nosso evento.
Para isso, vá no menu Ao Vivo > Agendamento > botão 'Novo Evento':
IMAGEM 25
Na próxima tela você irá preencher os seguintes campos:
IMAGEM 28
IMAGEM 28
Título = título do evento.
Identidade de Anfitrião = escolha um anfitrião já cadastrado.
Identidade de Anfitrião = escolha um anfitrião já cadastrado.
Imagem do Evento = escolha uma imagem de capa para seu evento.
Tipo de Evento = escolha o tipo de evento.
Data do evento = escolha a data que ocorrerá seu evento.
Fuso Horário = escolha o fuso horário.
Duração (Horas) = insira a duração (em horas) de seu evento.
Observações = campo para inserir alguma observação
Curso = escolha um curso já criado.*
Esconder o curso da lista de matrículas? **
* você poderá escolher um curso já criado para oferecer seu evento ao vivo.
Mas se desejar, poderá criar um curso, sem conteúdos, para o usuário comprar apenas para esse evento ao vivo. Fazendo isso, você poderá marcar a opção "Esconder o curso da lista de matrículas?"** e essa matricula não será exibida na listagem de matrículas.
Com os campos devidamente preenchidos, clique em "Salvar e Fechar".
Etapa 7 - Então seu evento estará pronto! Veja algumas opções na imagem abaixo:
Mas se desejar, poderá criar um curso, sem conteúdos, para o usuário comprar apenas para esse evento ao vivo. Fazendo isso, você poderá marcar a opção "Esconder o curso da lista de matrículas?"** e essa matricula não será exibida na listagem de matrículas.
Com os campos devidamente preenchidos, clique em "Salvar e Fechar".
Etapa 7 - Então seu evento estará pronto! Veja algumas opções na imagem abaixo:
IMAGEM 26
A - Esse botão ao ser clicado irá dar início ao evento para transmissão aos alunos.
B - Esse botão permite editar as informações do evento criado.
C - Esse botão irá excluir o evento criado.
Após clicar para iniciar seu evento, você será redirecionado para essa tela do Zoom conforme imagem abaixo:
B - Esse botão permite editar as informações do evento criado.
C - Esse botão irá excluir o evento criado.
Após clicar para iniciar seu evento, você será redirecionado para essa tela do Zoom conforme imagem abaixo:
IMAGEM 27
ATENÇÃO PARA ESSA ETAPA!
Marque o checkbox "Allow this app to use my shared access permissions...." e depois clique no botão "Allow".
Vale lembrar que se clicar no botão "Allow" sem marcar o checkbox acima dele, sua evento não irá funcionar e você terá que refazer toda a integração!
Se clicar em "Decline" você também não conseguirá realizar o evento.
Feito isso, você retornará a seu Maestrus e, novamente, clique para iniciar o evento!
Marque o checkbox "Allow this app to use my shared access permissions...." e depois clique no botão "Allow".
Vale lembrar que se clicar no botão "Allow" sem marcar o checkbox acima dele, sua evento não irá funcionar e você terá que refazer toda a integração!
Se clicar em "Decline" você também não conseguirá realizar o evento.
Feito isso, você retornará a seu Maestrus e, novamente, clique para iniciar o evento!
E para ingressar no evento, clique na opção "Entrar no evento como anfitrião" conforme imagem abaixo:
IMAGEM 28
13- Na próxima tela, basta selecionar a opção "Abrir link"
IMAGEM 29
Lhe será aberta 2 telas, conforme imagem abaixo:
IMAGEM 30
Nessa tela ( IMAGEM 30) clique em "Join witch Computer Audio".
Na tela maior, clique no menu "Security" que fica no rodapé da janela:
IMAGEM 31
Na tela maior, clique no menu "Security" que fica no rodapé da janela:
IMAGEM 31
Desmarque a opção "Enable Waiting Room" para que os usuários possam ingressar no evento sem a necessidade do anfitrião ter que liberar um por um.
E caso tenha o desejo de compartilhar sua tela, marque a opção "Share Screen".
O anfitrião ainda terá mais algumas funções bem úteis na gestão dos participantes.
O anfitrião ainda terá mais algumas funções bem úteis na gestão dos participantes.
Para conhecê-las, clique na opção "Participantes" e lhe será aberto uma aba à direita da janela de seu evento, listando todos os usuários participantes.
IMAGEM 32
Passe o mouse sobre o nome do participante e você verá duas opções:
- Mute/Unmute = serve para habilitar/desabilitar o som do participante.
- More = o anfitrião terá mais opções de controle sobre o participante, como chat, colocá-lo em espera (Put in Waiting Room) ou removê-lo do evento (Remove).
O gestor poderá ter informações de acesso referente ao evento realizado.
Para isso, basta ele acessar o menu "Ao Vivo > Agendamentos" e no evento em questão, clicar no ícone de uma 'folha de papel', conforme a imagem 33:
IMAGEM 33
Na próxima tela, você terá o seguinte:
IMAGEM 34
A - total de acessos do evento em questão.
B - quantos usuários acessaram por dispositivos móveis.
C - quantos usuários acessaram por desktops.
D - data do acesso ao evento.
E - identificação do usuário.
F - tipo de dispositivo usado para acessar o evento (desktop ou móvel).
G - sistema operacional utilizado para acessar o evento.
Agora vamos conhecer a visão do aluno!
13- Agora, basta o aluno acessar seu painel com seu respectivo login e senha, e acessar o evento criado clicando no botão "Entrar".
13- Agora, basta o aluno acessar seu painel com seu respectivo login e senha, e acessar o evento criado clicando no botão "Entrar".
IMAGEM 35
Caso o evento ainda não tenha se iniciado, o aluno verá uma mensagem informando que o evento começara em "X" instantes.
Para o anfitrião finalizar o evento, basta na janela do Zoom clicar em "End" (IMAGEM ...) e depois em "End Metting for all" (IMAGEM ....)
IMAGEM 36
IMAGEM 36
IMAGEM 37
Ou poderá retornar em seu Maestrus, e clicar no ícone marcado como na na figura abaixo:
IMAGEM 38
E assim finalizamos nosso tutorial sobre aula ao vivo utilizando o Zoom.
OBSERVAÇÕES:
- contas com planos pagos no Zoom, podem possuir mais de um anfitrião, desde que a licença do seu plano Zoom, permita ter outros anfitriões.
Em seu Maestrus, você poderá habilitar a opção de gestão do módulo de "Ao vivo" para usuários
que não sejam administradores, editando o perfil desse usuário e inserindo e inserindo as seguintes permissões adicionais no campo "Permissões Adicionais de Usuário:
- Ao Vivo - Gerenciar Agendamentos;
- Ao vivo - Gerenciar Eventos Ao vivo.
OBSERVAÇÕES:
- contas com planos pagos no Zoom, podem possuir mais de um anfitrião, desde que a licença do seu plano Zoom, permita ter outros anfitriões.
Em seu Maestrus, você poderá habilitar a opção de gestão do módulo de "Ao vivo" para usuários
que não sejam administradores, editando o perfil desse usuário e inserindo e inserindo as seguintes permissões adicionais no campo "Permissões Adicionais de Usuário:
- Ao Vivo - Gerenciar Agendamentos;
- Ao vivo - Gerenciar Eventos Ao vivo.
IMAGEM 39
- uma conta Zoom sob um plano pago, poderá ter mais de um anfitrião, e esses anfitriões poderão realizar transmissões simultâneas, mas cada anfitrião deverá logar em seu perfil Maestrus e realizaras devidas configurações independentemente.
- um mesmo anfitrião não poderá ter mais de uma transmissão simultânea.
- mesmo tendo ainda um plano básico de apenas 1 anfitrião, você poderá dividir uma transmissão em sala
salas dentro de uma mesma transmissão.
Para conhecer melhor esse processo descrito acima, veja o tutorial https://support.zoom.us/hc/pt-br/articles/206476313-Como-gerenciar-salas-simult%C3%A2neas
-- IMPORTANTE!
Caso seus alunos ao ingressarem em um evento ao vivo em seu Maestrus lhe sejam pedido login no Zoom, você deverá ajustar as seguintes configurações em sua conta Zoom:
1 - na aba "Reuniões" > Sala pessoal > marque a opção "Senha de acesso". Sua URL "Link de convite" deverá ficar conforme imagem abaixo:
-- IMPORTANTE!
Caso seus alunos ao ingressarem em um evento ao vivo em seu Maestrus lhe sejam pedido login no Zoom, você deverá ajustar as seguintes configurações em sua conta Zoom:
1 - na aba "Reuniões" > Sala pessoal > marque a opção "Senha de acesso". Sua URL "Link de convite" deverá ficar conforme imagem abaixo:
IMAGEM 40
2 - em Configurações > aba Reunião > Segurança desmarque a opção "Somente participantes de reuniões e webinars autenticados podem ingressar em reuniões e webinars" conforme imagem abaixo:
IMAGEM 41
Qualquer dúvida, estamos a disposição!
Att
Última atualização: 30/05/2023 17:36:38
