Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Intégration de Zoom
Grâce au connecteur d'action Zoom, vous pouvez accéder à la plateforme Zoom directement dans Amazon Quick via le langage naturel. Vous pouvez créer et gérer des réunions, accéder aux enregistrements et aux résumés des réunions, consulter les détails des webinaires et rechercher des contacts sans quitter Amazon Quick.
Amazon Quick prend en charge plusieurs méthodes d'authentification pour Zoom. Choisissez la méthode qui répond le mieux aux exigences de sécurité de votre entreprise.
+ Application **OAuth par défaut — Utilise une application** OAuth AWS gérée par OAuth. Aucune information d'identification supplémentaire n'est requise. Les utilisateurs s'authentifient directement avec leur compte Zoom.
+ Application **OAuth personnalisée : utilise une application** OAuth gérée par le client enregistrée sur le Zoom App Marketplace. Cette option donne à votre organisation le contrôle total de la configuration OAuth.
Pour plus d'informations sur les méthodes d'authentification prises en charge par Amazon Quick, consultez[Méthodes d’authentification](quick-action-auth.md).
## Avant de commencer
Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.
+ Un compte Zoom actif avec accès aux réunions, aux enregistrements et aux webinaires que vous souhaitez utiliser.
+ Pour l'application **OAuth personnalisée : accédez au Zoom App** [Marketplace](https://marketplace.zoom.us/) sur le site Web de Zoom pour créer une application.
+ Pour connaître les exigences relatives à l'abonnement Amazon Quick, consultez[Configuration des intégrations dans la console](integration-console-setup-process.md).
## Configuration du zoom
Si vous utilisez l'authentification **par défaut de l'application OAuth**, ignorez cette section et passez à. [Configuration du connecteur dans Amazon Quick](#zoom-quicksuite-setup)
Pour l'authentification personnalisée de l'application OAuth, effectuez les étapes suivantes dans le Zoom App Marketplace avant de configurer Amazon Quick.
### Création d'une application Zoom (application OAuth personnalisée)
Créez une application dans le Zoom App Marketplace pour obtenir les informations d'identification client dont vous avez besoin pour Amazon Quick. Pour plus d'informations, consultez [OAuth sur le site Web](https://developers.zoom.us/docs/integrations/oauth/) de Zoom Developer.
1. Connectez-vous au [Zoom App Marketplace](https://marketplace.zoom.us/) sur le site Web de Zoom et accédez au portail de création d'applications.
1. Créez une nouvelle application . Choisissez **Général pour l'**authentification OAuth basée sur l'utilisateur ou **Server-to-Server OAuth** pour l'authentification de service à service.
1. Dans l'onglet **Informations de base**, sous Informations **d'identification de l'application**, enregistrez les valeurs suivantes. Vous en avez besoin lorsque vous configurez Amazon Quick.
+ **Identifiant du client**
+ **Secret client**
1. Dans la section **Informations OAuth**, pour l'**URI de redirection autorisée**, ajoutez l'URL de rappel Amazon Quick : `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Choisissez l'onglet **Étendue**, puis choisissez **\+ Ajouter des étendues** pour sélectionner les autorisations requises par votre intégration. Pour les portées recommandées, voir[Éscopes recommandés](#zoom-oauth-scopes).
### Éscopes recommandés
Les étendues suivantes sont demandées lorsque vous vous connectez à Zoom. Lorsque vous créez une application Zoom personnalisée, ajoutez ces portées dans l'onglet **Étendue.**
**Zoomer sur les portées recommandées**
| Scope | Description |
| --- | --- |
| meeting:read:list\_meetings | Répertorie les réunions. |
| meeting:read:meeting | Lit les détails de la réunion. |
| meeting:read:summary | Lit les résumés des réunions. |
| meeting:read:list\_past\_participants | Répertorie les anciens participants aux réunions. |
| meeting:read:list\_past\_instances | Répertorie les instances de réunion passées. |
| meeting:write:meeting | Crée des réunions. |
| meeting:update:meeting | Met à jour les réunions. |
| meeting:delete:meeting | Supprime les réunions. |
| meeting:write:registrant | Ajoute les personnes inscrites aux réunions. |
| cloud\_recording:read:list\_user\_recordings | Répertorie les enregistrements des utilisateurs. |
| cloud\_recording:read:list\_recording\_files | Répertorie les fichiers d'enregistrement. |
| cloud\_recording:delete:meeting\_recording | Supprime les enregistrements de réunions. |
| webinar:read:webinar | Lit les détails du webinaire. |
| webinar:read:list\_webinars | Répertorie les webinaires. |
| webinar:read:list\_past\_participants | Répertorie les anciens participants au webinaire. |
| webinar:read:list\_registrants | Répertorie les personnes inscrites aux webinaires. |
| webinar:write:registrant | Ajoute les personnes inscrites au webinaire. |
| user:read:user | Lit les informations de l'utilisateur. |
| user:read:settings | Lit les paramètres utilisateur. |
| user:read:list\_collaboration\_devices | Répertorie les appareils de collaboration. |
| contact:read:list\_contacts | Répertorie les contacts. |
**Note**
Des étendues supplémentaires pour les fonctionnalités du tableau blanc et du marché sont également demandées. Les champs d'application répertoriés ci-dessus couvrent les principales actions relatives à la réunion, à l'enregistrement, au webinaire, aux utilisateurs et aux contacts.
## Configuration du connecteur dans Amazon Quick
### Se connecter depuis l'onglet Disponible
Si vous souhaitez utiliser l'authentification par défaut de l'application OAuth, vous pouvez vous connecter directement depuis l'onglet **Disponible** sans configuration supplémentaire.
1. Dans la console Amazon Quick, choisissez **Connectors**.
1. Dans l'onglet **Disponible**, recherchez **Zoom** et choisissez **Connect**.
1. Terminez le flux de connexion Zoom et accordez les autorisations demandées.
Pour configurer un connecteur avec l'application OAuth personnalisée à la place, utilisez l'onglet **Créer pour votre équipe**, comme décrit ci-dessous.
### Créez à partir de l'onglet Créer pour votre équipe
Une fois que vous avez terminé toute configuration de Zoom requise, créez le connecteur dans Amazon Quick.
1. Dans la console Amazon Quick, choisissez **Connectors**.
1. Choisissez l'onglet **Créer pour votre équipe**.
1. Recherchez et choisissez **Zoom**.
**Note**
Si un connecteur Zoom existe déjà, une boîte de dialogue contenant vos connecteurs existants s'affiche. Pour utiliser un connecteur existant, choisissez-le. Pour en créer un nouveau, choisissez **Non, créer un nouveau**.
1. Entrez un **nom** pour votre connecteur. Choisissez éventuellement **\+ Ajouter une description** pour ajouter une description.
1. Pour **Type de connexion**, sélectionnez **Réseau public**.
1. Pour **la configuration OAuth**, choisissez l'une des méthodes d'authentification suivantes et configurez les champs obligatoires.
1. Pour l'**application OAuth par défaut** :
Aucune information d'identification supplémentaire n'est requise. Choisissez **Next (Suivant)** pour continuer.
1. Pour l'**application OAuth personnalisée**, configurez les champs suivants :
+ **URL de base** (facultatif) — URL de base de l'API Zoom. Exemple : `https://api.zoom.us`
+ **ID client** : ID client de votre application Zoom.
+ **Secret du client** : secret du client de votre application Zoom.
+ **URL du jeton** : point de terminaison du jeton. Exemple : `https://zoom.us/oauth/token`
+ **URL d'autorisation** : point de terminaison d'autorisation. Exemple : `https://zoom.us/oauth/authorize`
+ **URL de redirection** : Pre-filled avec l'URL de rappel Amazon Quick.
1. Choisissez **Suivant**.
1. Si vous avez choisi l'application **OAuth par défaut ou l'application** **OAuth personnalisée, une fenêtre d'autorisation** Zoom s'ouvre. Passez en revue les autorisations demandées et choisissez **Autoriser**.
1. Sur la page **Révision**, passez en revue les actions disponibles pour le connecteur. Choisissez **Suivant**.
1. Sur la page **Publier**, choisissez qui peut accéder au connecteur. Vous pouvez autoriser l'accès à tous les membres de votre organisation ou rechercher des équipes ou des groupes spécifiques.
1. Choisissez **Publier**.
## Actions disponibles
Après avoir configuré le connecteur, les actions suivantes sont disponibles.
**Actions de zoom disponibles**
| Catégorie | Action | Description |
| --- | --- | --- |
| Meetings | Réunions de liste | Répertorie les réunions d'un utilisateur. |
| Meetings | Obtenir une réunion | Récupère les détails d'une réunion spécifique. |
| Meetings | Créer une réunion | Crée une nouvelle réunion. |
| Meetings | Réunion de mise à jour | Met à jour une réunion existante. |
| Meetings | Obtenir le résumé de la réunion | Récupère le AI-generated résumé d'une réunion. |
| Meetings | Modèles de résumé de réunion de liste | Répertorie les modèles de résumé de réunion disponibles. |
| Meetings | Obtenir les anciens participants à la réunion | Récupère les participants d'une réunion précédente. |
| Meetings | Répertorier les instances de réunions passées | Répertorie les instances d'une réunion périodique. |
| Meetings | Créer un inscrit à une réunion | Ajoute un inscrit à une réunion. |
| Enregistrements | Lister les enregistrements | Répertorie tous les enregistrements d'un utilisateur. |
| Enregistrements | Obtenez des enregistrements de réunions | Récupère les enregistrements d'une réunion spécifique. |
| Enregistrements | Lister les fichiers archivés | Répertorie les fichiers d'enregistrement archivés. |
| Webinaires | Liste des webinaires | Répertorie les webinaires destinés à un utilisateur. |
| Webinaires | Accéder au webinaire | Récupère les détails d'un webinaire spécifique. |
| Webinaires | Liste des participants au webinaire | Répertorie les participants à un webinaire. |
| Contacts | Rechercher les contacts de l'entreprise | Recherche des contacts dans le répertoire de l'entreprise. |
| Devices | Lister les appareils | Répertorie les appareils Zoom. |
| Rapports | Obtenir un rapport d'utilisation quotidien | Récupère un rapport d'utilisation quotidien. |
| Utilisateurs | Obtenir un utilisateur | Récupère les informations relatives à l'utilisateur authentifié. |
**Note**
Les actions que vous pouvez utiliser dépendent des autorisations configurées pour votre compte Zoom et des données accessibles à l'utilisateur authentifié.
## Gestion et résolution des problèmes
Pour modifier, partager ou supprimer votre connecteur, consultez[Gestion des intégrations existantes](integration-workflows.md#managing-existing-integrations).
### Problèmes d’authentification
+ **Sign-in échoue (application OAuth par défaut ou application OAuth personnalisée)** : vérifiez que votre compte Zoom est actif et que vous pouvez vous connecter directement à [zoom.us](https://zoom.us) sur le site Web de Zoom. Pour l'application OAuth personnalisée, vérifiez que l'URI de redirection de votre application Zoom correspond à l'URL de rappel Amazon Quick.
+ **Informations d'identification client non valides (application OAuth personnalisée)** : vérifiez que l'ID client et le secret du client correspondent aux valeurs de votre application Zoom. Vous pouvez consulter vos informations d'identification dans les paramètres de l'application sur le Zoom App Marketplace.
+ **Autorisations insuffisantes** : vérifiez que les étendues configurées pour votre application Zoom incluent les autorisations requises pour les actions que vous souhaitez utiliser. Consultez [Éscopes recommandés](#zoom-oauth-scopes).