Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Integración con Zoom
<a name="zoom-integration"></a>

Con el conector de acción de Zoom, puede acceder a la plataforma Zoom directamente en Amazon Quick mediante lenguaje natural. Puede crear y gestionar reuniones, acceder a las grabaciones y los resúmenes de las reuniones, ver los detalles de los seminarios web y buscar contactos sin salir de Amazon Quick.

Amazon Quick admite varios métodos de autenticación para Zoom. Elija el método que mejor se adapte a los requisitos de seguridad de su organización.
+ Aplicación **OAuth predeterminada: utiliza una aplicación** OAuth AWS gestionada por usted. No se necesitan credenciales adicionales. Los usuarios se autentican directamente con su cuenta de Zoom.
+ Aplicación **OAuth personalizada: utiliza una aplicación** OAuth gestionada por el cliente registrada en Zoom App Marketplace. Esta opción le da a su organización un control total sobre la configuración de OAuth.

Para obtener más información sobre los métodos de autenticación que admite Amazon Quick, consulte[Métodos de autenticación](quick-action-auth.md).

## Antes de empezar
<a name="zoom-integration-prerequisites"></a>

Asegúrese de disponer de lo siguiente antes de configurar la integración.
+ Una cuenta de Zoom activa con acceso a las reuniones, las grabaciones y los seminarios web que desee utilizar.
+ Para la aplicación **OAuth personalizada: acceda al Zoom App** [Marketplace](https://marketplace.zoom.us/) en el sitio web de Zoom para crear una aplicación.
+ Para conocer los requisitos de suscripción a Amazon Quick, consulte[Configurar integraciones en la consola](integration-console-setup-process.md).

## Configuración de Zoom
<a name="zoom-source-setup"></a>

Si utiliza la autenticación de la **aplicación OAuth predeterminada**, omita esta sección y continúe con. [Configuración del conector en Amazon Quick](#zoom-quicksuite-setup)

Para la autenticación personalizada de aplicaciones OAuth, complete los siguientes pasos en Zoom App Marketplace antes de configurar Amazon Quick.

### Cree una aplicación Zoom (aplicación OAuth personalizada)
<a name="zoom-register-oauth"></a>

Cree una aplicación en Zoom App Marketplace para obtener las credenciales de cliente que necesita para Amazon Quick. Para obtener más información, consulte [OAuth](https://developers.zoom.us/docs/integrations/oauth/) en el sitio web para desarrolladores de Zoom.

1. Inicie sesión en [Zoom App Marketplace](https://marketplace.zoom.us/) en el sitio web de Zoom y vaya al portal de creación de aplicaciones.

1. Cree una nueva aplicación . Elija **General** para OAuth basada en el usuario u **Server-to-Server OAuth** para la autenticación de servicio a servicio.

1. En la pestaña **Información básica**, en Credenciales de **aplicación, registre los siguientes valores**. Los necesitas cuando configuras Amazon Quick.
   + **ID de cliente**
   + **Secreto del cliente**

1. En la sección **Información de OAuth**, para el **URI de redireccionamiento autorizado**, añade la URL de devolución de llamada rápida de Amazon: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

1. Selecciona la pestaña **Ámbitos** y selecciona **\+ Añadir ámbitos** para seleccionar los permisos que requiere tu integración. Para conocer los ámbitos recomendados, consulte. [Alcances recomendados](#zoom-oauth-scopes)

### Alcances recomendados
<a name="zoom-oauth-scopes"></a>

Al conectarse a Zoom, se solicitan los siguientes ámbitos. **Al crear una aplicación de Zoom personalizada, agregue estos ámbitos en la pestaña Ámbitos.**


**Ámbitos recomendados por Zoom**  

| Alcance | Description (Descripción) | 
| --- | --- | 
| meeting:read:list\_meetings | Enumera las reuniones. | 
| meeting:read:meeting | Lee los detalles de la reunión. | 
| meeting:read:summary | Lee los resúmenes de las reuniones. | 
| meeting:read:list\_past\_participants | Enumera los participantes de reuniones anteriores. | 
| meeting:read:list\_past\_instances | Enumera las instancias de reuniones anteriores. | 
| meeting:write:meeting | Crea reuniones. | 
| meeting:update:meeting | Actualiza las reuniones. | 
| meeting:delete:meeting | Elimina las reuniones. | 
| meeting:write:registrant | Añade los inscritos a las reuniones. | 
| cloud\_recording:read:list\_user\_recordings | Muestra las grabaciones de los usuarios. | 
| cloud\_recording:read:list\_recording\_files | Enumera los archivos de grabación. | 
| cloud\_recording:delete:meeting\_recording | Elimina las grabaciones de las reuniones. | 
| webinar:read:webinar | Lee los detalles del seminario web. | 
| webinar:read:list\_webinars | Enumera los seminarios web. | 
| webinar:read:list\_past\_participants | Enumera los participantes anteriores del seminario web. | 
| webinar:read:list\_registrants | Enumera los inscritos en el seminario web. | 
| webinar:write:registrant | Añade los inscritos en el seminario web. | 
| user:read:user | Lee la información del usuario. | 
| user:read:settings | Lee la configuración del usuario. | 
| user:read:list\_collaboration\_devices | Enumera los dispositivos de colaboración. | 
| contact:read:list\_contacts | Muestra los contactos. | 

**nota**  
También se solicitan ámbitos adicionales para las funciones de pizarra blanca y mercado. Los ámbitos enumerados anteriormente abarcan las acciones de la reunión principal, la grabación, el seminario web, los usuarios y los contactos.

## Configuración del conector en Amazon Quick
<a name="zoom-quicksuite-setup"></a>

### Conectarse desde la pestaña Disponible
<a name="zoom-quick-connect"></a>

Si quieres usar la autenticación de la aplicación OAuth predeterminada, puedes conectarte directamente desde la pestaña **Disponible** sin necesidad de realizar ninguna configuración adicional.

1. En la consola Amazon Quick, selecciona **Connectors**.

1. En la pestaña **Disponible**, busca **Zoom** y selecciona **Conectar**.

1. Complete el flujo de inicio de sesión de Zoom y conceda los permisos solicitados.

Para configurar un conector con la aplicación OAuth personalizada, usa la pestaña **Crear para tu equipo**, tal y como se describe a continuación.

### Crea desde la pestaña Crear para tu equipo
<a name="zoom-full-setup"></a>

Tras completar cualquier configuración de Zoom requerida, cree el conector en Amazon Quick.

1. En la consola Amazon Quick, selecciona **Connectors**.

1. Selecciona la pestaña **Crear para tu equipo**.

1. Busca y elige **Zoom**.
**nota**  
Si ya existe un conector de Zoom, aparece un cuadro de diálogo con los conectores existentes. Para usar un conector existente, elíjalo. Para crear uno nuevo, elija **No, crear nuevo**.

1. Introduzca un **nombre** para el conector. Si lo desea, elija **\+ Añadir descripción** para añadir una descripción.

1. En **Tipo de conexión**, elija **Red pública**.

1. Para **la configuración de OAuth**, elija uno de los siguientes métodos de autenticación y configure los campos obligatorios.

   1. Para la aplicación **OAuth predeterminada**:

      No se necesitan credenciales adicionales. Elija **Siguiente** para continuar.

   1. Para la **aplicación OAuth personalizada**, configura los siguientes campos:
      + **URL base** (opcional): la URL base de la API de Zoom. Ejemplo: `https://api.zoom.us`
      + **ID de cliente**: el ID de cliente de su aplicación Zoom.
      + **Secreto** de cliente: el secreto de cliente de su aplicación Zoom.
      + **URL del token**: el punto final del token. Ejemplo: `https://zoom.us/oauth/token`
      + **URL de autorización**: el punto final de autorización. Ejemplo: `https://zoom.us/oauth/authorize`
      + **URL de redireccionamiento**: Pre-filled con la URL de devolución de llamada rápida de Amazon.

1. Elija **Siguiente**.

1. Si seleccionaste la aplicación **OAuth predeterminada o la aplicación** **OAuth personalizada, se abrirá una ventana de autorización** de Zoom. **Revise los permisos solicitados y seleccione Permitir.**

1. **En la página de revisión, revise las acciones disponibles para el conector.** Elija **Siguiente**.

1. En la página de **publicación**, elija quién puede acceder al conector. Puedes habilitar el acceso para todos los miembros de tu organización o buscar equipos o grupos específicos.

1. Elija **Publicar**.

## Acciones disponibles
<a name="zoom-integration-actions"></a>

Tras configurar el conector, estarán disponibles las siguientes acciones.


**Amplíe las acciones disponibles**  

| Categoría | Action | Description (Descripción) | 
| --- | --- | --- | 
| Reuniones | Lista de reuniones | Muestra las reuniones de un usuario. | 
| Reuniones | Obtenga una reunión | Recupera los detalles de una reunión específica. | 
| Reuniones | Crear reunión | Crea una nueva reunión. | 
| Reuniones | Actualizar reunión | Actualiza una reunión existente. | 
| Reuniones | Obtenga el resumen de la reunión | Recupera el AI-generated resumen de una reunión. | 
| Reuniones | Enumere las plantillas de resumen de reuniones | Enumera las plantillas de resumen de reuniones disponibles. | 
| Reuniones | Obtenga los participantes de reuniones anteriores | Recupera a los participantes de una reunión anterior. | 
| Reuniones | Enumere las instancias de reuniones anteriores | Enumera las instancias de una reunión periódica. | 
| Reuniones | Cree el registrante de la reunión | Agrega un inscrito a una reunión. | 
| Grabaciones | Enumere las grabaciones | Muestra todas las grabaciones de un usuario. | 
| Grabaciones | Obtenga las grabaciones de las reuniones | Recupera las grabaciones de una reunión específica. | 
| Grabaciones | Enumere los archivos archivados | Muestra los archivos de grabación archivados. | 
| Seminarios web | Lista de seminarios web | Enumera los seminarios web de un usuario. | 
| Seminarios web | Obtenga un seminario web | Recupera los detalles de un seminario web específico. | 
| Seminarios web | Listar los participantes del seminario web | Muestra los participantes de un seminario web. | 
| Contactos | Busque los contactos de la empresa | Busca contactos en el directorio de la empresa. | 
| dispositivos | Lista de dispositivos | Enumera los dispositivos Zoom. | 
| Informes | Obtenga un informe de uso diario | Recupera un informe de uso diario. | 
| Users | Obtenga un usuario | Recupera información sobre el usuario autenticado. | 

**nota**  
Las acciones que puede utilizar dependen de los permisos configurados para su cuenta de Zoom y de los datos a los que pueda acceder el usuario autenticado.

## Administración y solución de problemas
<a name="zoom-integration-troubleshooting"></a>

Para editar, compartir o eliminar el conector, consulte[Administrar las integraciones existentes](integration-workflows.md#managing-existing-integrations).

### Problemas de autenticación
<a name="zoom-troubleshooting-auth"></a>
+ **Sign-in falla (aplicación OAuth predeterminada o aplicación OAuth personalizada)**: compruebe que su cuenta de Zoom esté activa y que pueda iniciar sesión directamente en [zoom.us](https://zoom.us) desde el sitio web de Zoom. En el caso de la aplicación OAuth personalizada, confirme que el URI de redireccionamiento de su aplicación de Zoom coincide con la URL de devolución de llamada rápida de Amazon.
+ **Credenciales de cliente no válidas (aplicación OAuth personalizada)**: compruebe que el ID de cliente y el secreto del cliente coincidan con los valores de su aplicación de Zoom. Puede ver sus credenciales en la configuración de la aplicación en Zoom App Marketplace.
+ **Permisos insuficientes**: compruebe que los ámbitos configurados para su aplicación de Zoom incluyen los permisos necesarios para las acciones que desee utilizar. Consulte [Alcances recomendados](#zoom-oauth-scopes).