Como realizar a integração com o Zoom

Owned by Felipe Cerutti
Last updated: set. 12, 2024 by Régio Moulin
6 min read

1. Acesse o site do https://marketplace.zoom.us/

2. Clique em Sign In para efetuar o acesso em sua conta.

 

3. Preencha com os dados de login e prossiga.

 

4. Clique em Develop.

 

  1. Clique em Build App.

 

6. Clique em Agree

 

7. Selecione o Tipo de Aplicativo: General App

 

8. Clique em Create.

 

9. Selecione a configuração de produção. Clique em Production.

 

  1. Em uma outra aba do seu navegador, acesse o painel de gestão da Hotscool como administrador: https://app.hotscool.com/admin/dashboard

  2. Clique em Configurações.

 

  1. Clique em Integrações.

 

  1. Na integração do Zoom, clique em Ativar caso esteja desativado (o botão ficará verde).

 

  1. Retorne a aba anterior onde está criando o APP do zoom (https://marketplace.zoom.us/)

  2. Copie as credencias do APP: Client ID

  1. Cole no campo ID do Cliente no painel de gestão de Integração

 

  1. Retorne a página do Zoom e agora clique em copy no campo Client secret

  1. Cole no campo Chave API do painel de gestão da Hotscool

 

  1. Clique em Salvar

 

  1. Em OAuth Information, no campo OAuth Redirect URL adicione: https://app.hotscool.com/admin/zoom/redireciona/

 

  1. Logo abixo, em OAuth Allow Lists, adicione a seguinte URL: https://app.hotscool.com/

  1. Clique em Continue.

  1. Em Access, clique em Continue. (Voltaremos depois para configurarmos essa parte).

  1. Em Surface, vamos selecionar a opção Meetings.

 

  1. Clique em Continue.

  1. Na seção Embed, selecione a opção Meeting SDK.

  1. Clique em Continue.

  1. Na seção Scopes, clique no botão Add Scopes.

 

  1. Clique no campo busca.

 

  1. Adicione o escopo: meeting:read:list_meetings e selecione o checkbox correspondente.

 

  1. Após marcar o checkbox, clique em Done.

 

  1. Repita a operação para os escopos a seguir:

  • meeting:read:list_meetings

  • meeting:read:meeting

  • meeting:write:meeting

  • meeting:update:meeting

  • meeting:delete:meeting

  • cloud_recording:read:recording

 

  1. Depois de adicionar todos os escopos listados acima, adicione uma breve descrição sobre seu APP no campo Scope Description. Por exemplo: Permissões necessárias para integração com a Hotscool.

 

 

  1. Clique em Continue.

  1. Na seção App Listing, você poderá alterar o nome do APP que está criando em App Name. E no campo Short Description adicione uma breve descrição. Por exemplo: App de Integração.

 

  1. No campo a seguir em Long Description, adicione uma descrição sobre o APP que está criando (campo obrigatório). Por exemplo: APP para integração com a plataforma Hotscool.

  1. Mais abaixo, no campo Company Name, insira um nome. Por exemplo: Nome da sua empresa.

  2. A seguir, no campo Developer Contact Information, adicione um nome e email do responsável pela integração.

 

  1. Em Categorize Your App, forneça as informações necessárias que descrevem melhor seu APP.

  1. Clique em Continue.

 

  1. Na seção seguinte, apenas clique em Continue.

  1. Na seção seguinte, clique em Continue novamente.

  1. Clique em Continue novamente.

  1. Clique em Continue novamente.

  1. Caso tenha preenchido corretamente as informações anteriores, você verá uma tela parecida com a de baixo.

 

 

  1. Caso tenha tido sucesso, siga as etapas abaixo. Caso contrário, revise todas as etapas anteriores. Se ainda tiver dificuldades, acione nosso suporte@hotscool.com.

 

  1. Volte na seção Access, copie o Secret Token gerado pelo Zoom. (Observação: para clientes que estejam utilizando o plano grátis do zoom, pule essa parte).

  1. Agora, retorne até o painel de gestão da Hotscool, e cole o "Secret Token" copiado no campo abaixo:

 

  1. Clique em Salvar.

 

  1. Após salvar, copie a URL de Notificação fornecida pelo painel da Hotscool.

 

  1. Retornando ao site do Zoom, na seção Access, selecione a opção "Event Subscription". Adicione um nome ao evento de notificação que está sendo criado. Cole a URL de notificação no campo "Event notification endpint URL" e depois clique em "Validate" para validar a URL. (Obs.: os eventos de notificação só estão disponíveis para contas do zoom "Pro" ou maior).

 

  1. Com a URL de notificação validada, clique em "+ Add Events"

 

 

  1. Na tela a seguir, selecione o tipo de evento "Recording" e marque a opção "All Recordings have completed" e clique em "Done"

 

  1. Clique em Continue para as alterações tenha efeito.

 

  1. Agora retorne a plataforma da Hotscool e acesse o menu Zoom. Você será redireciona para uma página onde irá autorizar a Hotscool utilizar sua aplicação.

  1. Ao autorizar, você será redirecionado de volta para a plataforma da hotscool.

  2. Pronto! Sua integração com o Zoom foi realizada com sucesso. Caso haja alguma dúvida, entre em contato com nosso suporte@hotscool.com.