Configurar o Spoke do Zoom

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura

    • Integre sua conta Zoom à sua instância ServiceNow para que você possa usar o spoke do Zoom para executar várias ações em sua conta do Zoom. Você também pode criar uma aplicação OAuth personalizada na conta Zoom para que ela possa autenticar solicitações de sua instância.

    Antes de Iniciar

    • Solicitar uma assinatura de Integration Hub.
    • Ative o Spoke do Zoom .

    Função necessária: administrador

    Criação de um aplicativo conectado no Zoom

    Crie um aplicativo conectado em sua conta Zoom para estabelecer um nível de autenticação OAuth 2.0 entre as Zoom APIs e o Spoke do Zoom no Now Platform. Depois de criar o aplicativo conectado, você pode adicionar escopos que permitem executar diferentes ações do Spoke do Zoom.

    Antes de Iniciar

    1. Criar uma conta Zoom
    2. Função necessária: administrador do Zoom

    Por Que e Quando Desempenhar Esta Tarefa

    A criação do aplicativo conectado é uma atividade única.

    Procedimento

    1. Faça login no mercado do Zoom.
    2. Navegar até Desenvolver > Criar app.
    3. No cartão OAuth, clique em Criar.
    4. Na caixa Nome do app, insira um nome de app personalizado.
    5. Clique em Aplicação no nível da conta.
    6. Use o botão de alternância para desabilitar Deseja publicar este app no Zoom App Marketplace? opção.
    7. Clique em Criar.
    8. Na tela Credenciais da aplicação, execute as seguintes ações:
      1. Para copiar o ID do cliente gerado automaticamente, no campo ID do cliente, clique em Copiar.
        O ID do cliente é o ID do Spoke do Zoom que o app OAuth valida antes de conceder acesso às Zoom APIs. Armazene o ID em um local seguro.
      2. Para copiar o segredo do cliente, no campo Segredo do cliente, clique em Copiar.
        Use o segredo do cliente para obter novos tokens. Armazene o segredo em um local seguro.
      3. Opcional: Para gerar novamente o segredo do cliente, no campo Segredo do cliente, clique em Gerar novamente.
      4. No campo Redirecionar URL para OAuth, insira o nome da instância ServiceNow neste formato: https://<ServiceNow-Instance-Name> .service-now.com/oauth_redirect.do .
      5. Na Lista de permissões do OAuth, adicione um URL de redirecionamento de instância ServiceNow neste formato: https://<ServiceNow-Instance-Name> .service-now.com/oauth_redirect.do .
        Um token é gerado. Este token é usado pelo aplicativo OAuth para conceder aos spokes do Zoom acesso às APIs do Zoom.
      6. Opcional: Para adicionar outro URL à lista de permissões, clique em Adicionar nova lista.
      O exemplo a seguir mostra a tela que você usa para gerar as credenciais para o aplicativo OAuth.
      Figura 1. Configuração de credenciais OAuth para spokes do Zoom
      Configuração de credenciais OAuth para spokes do Zoom.
      Nota:
      Para saber a diferença entre a URL de Redirecionamento para OAuth e a URL mencionada na lista de permissões do OAuth, consulte Fórum de desenvolvedores do Zoom.
    9. Clique em Escopos, conforme mostrado no exemplo a seguir.
      Figura 2. Opção de escopo na tela do app conectado
      Opção de escopo na tela do app conectado.
    10. Na tela Adicionar escopos, clique em Adicionar escopos.
    11. Clique no nome do escopo e selecione os escopos, conforme mostrado na figura a seguir.
      Os exemplos a seguir mostram como adicionar diferentes escopos que permitem que o spoke do Zoom execute várias ações.
      Figura 3. Adicionar os escopos das reuniões do Zoom
      Adicione os escopos para reuniões do Zoom.
      Figura 4. Adicionar um escopo de gravação para reuniões do Zoom
      Adicione um escopo de gravação para reuniões do Zoom.
      Figura 5. Adicionar escopos para exibir e gerenciar informações da conta do Zoom do usuário
      Adicione um escopo para exibir e gerenciar informações da conta do Zoom do usuário.
      Nota:
      Figura 6. Adicionar escopos para um bate-papo do Zoom
      Adicione escopos para um bate-papo do Zoom.
      As ações nos escopos selecionados se tornam disponíveis para o Spoke do Zoom.
    12. Clique em Concluído.

    Adicionar conexão do Zoom na instância ServiceNow

    Use as informações geradas durante a configuração da conta do Zoom para registrar Spoke do Zoom como um provedor OAuth e permitir que a instância solicite tokens OAuth 2.0. Adicione a conexão do Zoom em Workflow Studio para executar ações no Zoom.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Em sua instância ServiceNow, navegue até Automação de Processo > Flow Designer.
      O Flow Designer é iniciado em uma nova guia.
    2. Clique na guia Conexões.
    3. Localize o alias de conexão do Zoom e clique em Exibir detalhes.
      • Para configurar a conexão padrão e o registro de alias de credencial que é enviado junto com o spoke do Zoom, clique em Exibir detalhes.
      • Para gerenciar mais de um registro de conexão de spoke do Zoom, você deve criar um novo registro de alias secundário clicando em Adicionar conexão. Para obter mais informações sobre como usar várias conexões, consulte Suporte a várias conexões.
      Se você estiver configurando o spoke pela primeira vez, clique em Configurar. Caso contrário, clique em Editar.
    4. No formulário, preencha estes valores.
      Campo Descrição
      Nome da conexão Nome para identificar o registro de conexão.
      URL de Conexão URL base para se conectar à sua instância do Zoom. Insira https://api.zoom.us.
      Nome da entidade OAuth Nome para identificar o registro da aplicação.
      ID do cliente OAuth ID do cliente criado durante o registro do aplicativo.
      Segredo do cliente OAuth Segredo do cliente criado durante o registro do aplicativo.
      URL de redirecionamento do OAuth Endpoint de retorno de chamada do OAuth. Insira https://<instance-name> .service-now.com/oauth_redirect.do .

      Gerar token OAuth.

    5. Clique em Configurar e obter token do OAuth.
      Uma mensagem de confirmação é exibida informando que o token está disponível.Confirmação de que o token de atualização está disponível.