View a markdown version of this page

Integração com Zoom - Amazon Quick
Antes de começarConfigurando o ZoomConfigurando o conector no Amazon QuickAções disponíveisGerenciamento e solução de problemas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Integração com Zoom

Com o conector de ação do Zoom, você pode acessar a plataforma Zoom diretamente no Amazon Quick por meio de linguagem natural. Você pode criar e gerenciar reuniões, acessar gravações e resumos de reuniões, visualizar detalhes do webinar e pesquisar contatos sem sair do Amazon Quick.

O Amazon Quick oferece suporte a vários métodos de autenticação para o Zoom. Escolha o método mais adequado aos requisitos de segurança da sua organização.

  • Aplicativo OAuth padrão — usa um aplicativo OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Os usuários se autenticam diretamente com sua conta Zoom.

  • Aplicativo OAuth personalizado — usa um aplicativo OAuth gerenciado pelo cliente registrado no Zoom App Marketplace. Essa opção dá à sua organização controle total sobre a configuração do OAuth.

Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulteMétodos de autenticação.

Antes de começar

Certifique-se de ter o seguinte antes de configurar a integração.

  • Uma conta Zoom ativa com acesso às reuniões, gravações e webinars que você deseja usar.

  • Para um aplicativo OAuth personalizado: acesso ao Zoom App Marketplace no site da Zoom para criar um aplicativo.

  • Para obter os requisitos de assinatura do Amazon Quick, consulteConfigurar integrações no console.

Configurando o Zoom

Se você estiver usando a autenticação padrão do aplicativo OAuth, pule esta seção e continue até. Configurando o conector no Amazon Quick

Para a autenticação personalizada do aplicativo OAuth, conclua as etapas a seguir no Zoom App Marketplace antes de configurar o Amazon Quick.

Crie um aplicativo Zoom (aplicativo OAuth personalizado)

Crie um aplicativo no Zoom App Marketplace para obter as credenciais de cliente necessárias para o Amazon Quick. Para obter mais informações, consulte OAuth no site do Zoom Developer.

  1. Faça login no Zoom App Marketplace no site da Zoom e acesse o portal de criação de aplicativos.

  2. Para criar um nova aplicação . Escolha Geral para OAuth baseado em usuário ou Server-to-Server OAuth para autenticação de serviço a serviço.

  3. Na guia Informações básicas, em Credenciais do aplicativo, registre os seguintes valores. Você precisa deles ao configurar o Amazon Quick.

    • ID do cliente

    • Segredo do cliente

  4. Na seção Informações do OAuth, para URI de redirecionamento autorizado, adicione o URL de retorno de chamada do Amazon Quick: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  5. Escolha a guia Escopos e escolha + Adicionar escopos para selecionar as permissões que sua integração exige. Para obter os escopos recomendados, consulteEscopos recomendados.

Escopos recomendados

Os escopos a seguir são solicitados quando você se conecta ao Zoom. Ao criar um aplicativo Zoom personalizado, adicione esses escopos na guia Escopos.

Escopos recomendados pelo Zoom
Escopo Description
meeting:read:list_meetings Lista as reuniões.
meeting:read:meeting Lê os detalhes da reunião.
meeting:read:summary Lê os resumos das reuniões.
meeting:read:list_past_participants Lista os participantes anteriores da reunião.
meeting:read:list_past_instances Lista instâncias de reuniões anteriores.
meeting:write:meeting Cria reuniões.
meeting:update:meeting Atualiza reuniões.
meeting:delete:meeting Exclui reuniões.
meeting:write:registrant Adiciona inscritos na reunião.
cloud_recording:read:list_user_recordings Lista as gravações do usuário.
cloud_recording:read:list_recording_files Lista os arquivos de gravação.
cloud_recording:delete:meeting_recording Exclui as gravações da reunião.
webinar:read:webinar Lê os detalhes do webinar.
webinar:read:list_webinars Lista os webinars.
webinar:read:list_past_participants Lista os participantes anteriores do webinar.
webinar:read:list_registrants Lista os inscritos no webinar.
webinar:write:registrant Adiciona inscritos no webinar.
user:read:user Lê as informações do usuário.
user:read:settings Lê as configurações do usuário.
user:read:list_collaboration_devices Lista os dispositivos de colaboração.
contact:read:list_contacts Lista contatos.
nota

Escopos adicionais para recursos de quadro branco e mercado também são solicitados. Os escopos listados acima abrangem as principais ações de reunião, gravação, webinar, usuário e contato.

Configurando o conector no Amazon Quick

Conecte-se a partir da guia Disponível

Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia Disponível sem configuração adicional.

  1. No console do Amazon Quick, escolha Conectores.

  2. Na guia Disponível, localize Zoom e escolha Conectar.

  3. Conclua o fluxo de login do Zoom e conceda as permissões solicitadas.

Em vez disso, para configurar um conector com o aplicativo OAuth personalizado, use a guia Criar para sua equipe, conforme descrito abaixo.

Crie na guia Criar para sua equipe

Depois de concluir qualquer configuração necessária do Zoom, crie o conector no Amazon Quick.

  1. No console do Amazon Quick, escolha Conectores.

  2. Escolha a guia Criar para sua equipe.

  3. Encontre e escolha Zoom.

    nota

    Se um conector Zoom já existir, uma caixa de diálogo será exibida com seus conectores existentes. Para usar um conector existente, escolha-o. Para criar um novo, escolha Não, criar novo.

  4. Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.

  5. Em Tipo de conexão, escolha Rede pública.

  6. Para Configuração do OAuth, escolha um dos seguintes métodos de autenticação e configure os campos obrigatórios.

    1. Para o aplicativo OAuth padrão:

      Nenhuma credencial adicional é necessária. Escolha Próximo para continuar.

    2. Para o aplicativo OAuth personalizado, configure os seguintes campos:

      • URL base (opcional) — A URL base da API Zoom. Exemplo: https://api.zoom.us

      • ID do cliente — O ID do cliente do seu aplicativo Zoom.

      • Segredo do cliente — O segredo do cliente do seu aplicativo Zoom.

      • URL do token — O endpoint do token. Exemplo: https://zoom.us/oauth/token

      • URL de autorização — O endpoint de autorização. Exemplo: https://zoom.us/oauth/authorize

      • URL de redirecionamento — Pre-filled com o URL de retorno de chamada do Amazon Quick.

  7. Escolha Próximo.

  8. Se você escolher o aplicativo OAuth padrão ou o aplicativo OAuth personalizado, uma janela de autorização do Zoom será aberta. Revise as permissões solicitadas e escolha Permitir.

  9. Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.

  10. Na página Publicar, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.

  11. Selecione Publish.

Ações disponíveis

Depois de configurar o conector, as ações a seguir estarão disponíveis.

Ações disponíveis de zoom
Categoria Ação Description
Reuniões Listar reuniões Lista as reuniões de um usuário.
Reuniões Obtenha uma reunião Recupera detalhes de uma reunião específica.
Reuniões Criar reunião Cria uma nova reunião.
Reuniões Atualizar reunião Atualiza uma reunião existente.
Reuniões Obtenha o resumo da reunião Recupera o AI-generated resumo de uma reunião.
Reuniões Listar modelos de resumo de reuniões Lista os modelos de resumo da reunião disponíveis.
Reuniões Obtenha participantes anteriores da reunião Recupera participantes de uma reunião anterior.
Reuniões Listar instâncias de reuniões anteriores Lista instâncias de uma reunião recorrente.
Reuniões Criar registrador de reunião Adiciona um inscrito a uma reunião.
Gravações Listar gravações Lista todas as gravações de um usuário.
Gravações Obtenha gravações de reuniões Recupera gravações de uma reunião específica.
Gravações Listar arquivos arquivados Lista os arquivos de gravação arquivados.
Webinars Listar webinars Lista webinars para um usuário.
Webinars Obtenha o webinar Recupera detalhes de um webinar específico.
Webinars Listar participantes do webinar Lista os participantes de um webinar.
Contatos Pesquisar contatos da empresa Pesquisa contatos no diretório da empresa.
Dispositivos Listar dispositivos Lista os dispositivos Zoom.
Relatórios Obtenha o relatório de uso diário Recupera um relatório de uso diário.
Usuários Obter usuário Recupera informações sobre o usuário autenticado.
nota

As ações que você pode usar dependem das permissões configuradas para sua conta Zoom e dos dados acessíveis ao usuário autenticado.

Gerenciamento e solução de problemas

Para editar, compartilhar ou excluir seu conector, consulteGerenciando integrações existentes.

Problemas de autenticação

  • Sign-in falha (aplicativo OAuth padrão ou aplicativo OAuth personalizado) — Verifique se sua conta Zoom está ativa e se você pode entrar diretamente no zoom.us no site da Zoom. Para o aplicativo OAuth personalizado, confirme se o URI de redirecionamento em seu aplicativo Zoom corresponde ao URL de retorno de chamada do Amazon Quick.

  • Credenciais de cliente inválidas (aplicativo OAuth personalizado) — Verifique se o ID do cliente e o segredo do cliente correspondem aos valores em seu aplicativo Zoom. Você pode ver suas credenciais nas configurações do aplicativo no Zoom App Marketplace.

  • Permissões insuficientes — Verifique se os escopos configurados para seu aplicativo Zoom incluem as permissões necessárias para as ações que você deseja usar. Consulte Escopos recomendados.