View a markdown version of this page

Intégration de Zoom - Amazon Quick
Avant de commencerConfiguration du zoomConfiguration du connecteur dans Amazon QuickActions disponiblesGestion et résolution des problèmes

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, consultezMéthodes d’authentification.

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 sur le site Web de Zoom pour créer une application.

  • Pour connaître les exigences relatives à l'abonnement Amazon Quick, consultezConfiguration des intégrations dans la console.

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

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 de Zoom Developer.

  1. Connectez-vous au Zoom App Marketplace sur le site Web de Zoom et accédez au portail de création d'applications.

  2. 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.

  3. 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

  4. 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

  5. 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.

É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.

  2. Dans l'onglet Disponible, recherchez Zoom et choisissez Connect.

  3. 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.

  2. Choisissez l'onglet Créer pour votre équipe.

  3. 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.

  4. Entrez un nom pour votre connecteur. Choisissez éventuellement + Ajouter une description pour ajouter une description.

  5. Pour Type de connexion, sélectionnez Réseau public.

  6. 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.

    2. 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.

  7. Choisissez Suivant.

  8. 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.

  9. Sur la page Révision, passez en revue les actions disponibles pour le connecteur. Choisissez Suivant.

  10. 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.

  11. 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, consultezGestion des intégrations existantes.

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 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.