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, consulte[Métodos de autenticação](quick-action-auth.md).
## 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](https://marketplace.zoom.us/) no site da Zoom para criar um aplicativo.
+ Para obter os requisitos de assinatura do Amazon Quick, consulte[Configurar integrações no console](integration-console-setup-process.md).
## 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](#zoom-quicksuite-setup)
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](https://developers.zoom.us/docs/integrations/oauth/) no site do Zoom Developer.
1. Faça login no [Zoom App Marketplace](https://marketplace.zoom.us/) no site da Zoom e acesse o portal de criação de aplicativos.
1. 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.
1. 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**
1. 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`
1. Escolha a guia **Escopos** e escolha **\+ Adicionar escopos** para selecionar as permissões que sua integração exige. Para obter os escopos recomendados, consulte[Escopos recomendados](#zoom-oauth-scopes).
### 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**.
1. Na guia **Disponível**, localize **Zoom** e escolha **Conectar**.
1. 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**.
1. Escolha a guia **Criar para sua equipe**.
1. 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**.
1. Insira um **nome** para seu conector. Opcionalmente, escolha **\+ Adicionar descrição** para adicionar uma descrição.
1. Em **Tipo de conexão**, escolha **Rede pública**.
1. 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.
1. 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.
1. Escolha **Próximo**.
1. 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**.
1. Na página **Revisar**, revise as ações disponíveis para o conector. Escolha **Próximo**.
1. 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.
1. 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, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations).
### 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](https://zoom.us). 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](#zoom-oauth-scopes).