View a markdown version of this page

Integrazione con Zoom - Amazon Quick

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Integrazione con Zoom

Con il connettore d'azione Zoom, puoi accedere alla piattaforma Zoom direttamente in Amazon Quick tramite linguaggio naturale. Puoi creare e gestire riunioni, accedere alle registrazioni e ai riepiloghi delle riunioni, visualizzare i dettagli dei webinar e cercare contatti senza uscire da Amazon Quick.

Amazon Quick supporta diversi metodi di autenticazione per Zoom. Scegli il metodo più adatto ai requisiti di sicurezza della tua organizzazione.

  • App OAuth predefinita: utilizza un'applicazione OAuth AWS gestita. Non sono necessarie credenziali aggiuntive. Gli utenti si autenticano direttamente con il proprio account Zoom.

  • App OAuth personalizzata: utilizza un'applicazione OAuth gestita dal cliente registrata nello Zoom App Marketplace. Questa opzione offre alla tua organizzazione il pieno controllo sulla configurazione OAuth.

Per ulteriori informazioni sui metodi di autenticazione supportati da Amazon Quick, consultaMetodi di autenticazione.

Prima di iniziare

Assicurati di disporre di quanto segue prima di configurare l'integrazione.

  • Un account Zoom attivo con accesso alle riunioni, alle registrazioni e ai webinar che desideri utilizzare.

  • Per l'app OAuth personalizzata: accedi allo Zoom App Marketplace sul sito web di Zoom per creare un'app.

  • Per i requisiti di abbonamento ad Amazon Quick, consultaConfigura le integrazioni nella console.

Configurazione di Zoom

Se utilizzi l'autenticazione predefinita dell'app OAuth, salta questa sezione e procedi con. Configurazione del connettore in Amazon Quick

Per l'autenticazione personalizzata dell'app OAuth, completa i seguenti passaggi in Zoom App Marketplace prima di configurare Amazon Quick.

Crea un'app Zoom (app OAuth personalizzata)

Crea un'app in Zoom App Marketplace per ottenere le credenziali client di cui hai bisogno per Amazon Quick. Per ulteriori informazioni, consulta OAuth sul sito Web di Zoom Developer.

  1. Accedi a Zoom App Marketplace sul sito web di Zoom e vai al portale per la creazione di app.

  2. Crea una nuova applicazione . Scegli Generale per OAuth basato sull'utente o Server-to-Server OAuth per l'autenticazione da servizio a servizio.

  3. Nella scheda Informazioni di base, in Credenziali dell'app, registra i seguenti valori. Ne hai bisogno quando configuri Amazon Quick.

    • ID cliente

    • Client secret

  4. Nella sezione Informazioni OAuth, per l'URI di reindirizzamento autorizzato, aggiungi l'URL di callback di Amazon Quick: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  5. Scegli la scheda Ambiti e scegli + Aggiungi ambiti per selezionare le autorizzazioni richieste dalla tua integrazione. Per gli ambiti consigliati, consulta. Ambiti consigliati

Ambiti consigliati

I seguenti ambiti sono richiesti quando ti connetti a Zoom. Quando crei un'app Zoom personalizzata, aggiungi questi ambiti nella scheda Ambiti.

Ambiti Zoom consigliati
Scope Description
meeting:read:list_meetings Elenca le riunioni.
meeting:read:meeting Legge i dettagli della riunione.
meeting:read:summary Legge i riepiloghi delle riunioni.
meeting:read:list_past_participants Elenca i partecipanti alle riunioni precedenti.
meeting:read:list_past_instances Elenca le istanze delle riunioni passate.
meeting:write:meeting Crea riunioni.
meeting:update:meeting Aggiorna le riunioni.
meeting:delete:meeting Elimina le riunioni.
meeting:write:registrant Aggiunge i partecipanti alle riunioni.
cloud_recording:read:list_user_recordings Elenca le registrazioni degli utenti.
cloud_recording:read:list_recording_files Elenca i file di registrazione.
cloud_recording:delete:meeting_recording Elimina le registrazioni delle riunioni.
webinar:read:webinar Legge i dettagli del webinar.
webinar:read:list_webinars Elenca i webinar.
webinar:read:list_past_participants Elenca i partecipanti ai webinar passati.
webinar:read:list_registrants Elenca gli iscritti al webinar.
webinar:write:registrant Aggiunge gli iscritti al webinar.
user:read:user Legge le informazioni dell'utente.
user:read:settings Legge le impostazioni dell'utente.
user:read:list_collaboration_devices Elenca i dispositivi di collaborazione.
contact:read:list_contacts Elenca i contatti.
Nota

Sono inoltre richiesti ambiti aggiuntivi per le funzionalità di whiteboard e marketplace. Gli ambiti sopra elencati riguardano le azioni principali relative alla riunione, alla registrazione, al webinar, all'utente e ai contatti.

Configurazione del connettore in Amazon Quick

Connect dalla scheda Available

Se desideri utilizzare l'autenticazione predefinita dell'app OAuth, puoi connetterti direttamente dalla scheda Disponibile senza configurazioni aggiuntive.

  1. Nella console Amazon Quick, scegli Connettori.

  2. Nella scheda Disponibile, trova Zoom e scegli Connect.

  3. Completa il flusso di accesso a Zoom e concedi le autorizzazioni richieste.

Per configurare invece un connettore con l'app OAuth personalizzata, usa la scheda Crea per il tuo team come descritto di seguito.

Crea dalla scheda Crea per il tuo team

Dopo aver completato la configurazione Zoom richiesta, crea il connettore in Amazon Quick.

  1. Nella console Amazon Quick, scegli Connettori.

  2. Scegli la scheda Crea per il tuo team.

  3. Trova e scegli Zoom.

    Nota

    Se esiste già un connettore Zoom, viene visualizzata una finestra di dialogo con i connettori esistenti. Per utilizzare un connettore esistente, selezionalo. Per crearne uno nuovo, scegli No, crea nuovo.

  4. Inserisci un nome per il connettore. Facoltativamente, scegli + Aggiungi descrizione per aggiungere una descrizione.

  5. Per Tipo di connessione, scegli Rete pubblica.

  6. Per la configurazione OAuth, scegli uno dei seguenti metodi di autenticazione e configura i campi richiesti.

    1. Per l'app OAuth predefinita:

      Non sono necessarie credenziali aggiuntive. Seleziona Successivo per continuare.

    2. Per l'app OAuth personalizzata, configura i seguenti campi:

      • URL di base (opzionale): l'URL di base dell'API Zoom. Ad esempio: https://api.zoom.us

      • ID cliente: l'ID cliente dell'app Zoom.

      • Segreto del cliente: il segreto del cliente dell'app Zoom.

      • URL del token: l'endpoint del token. Ad esempio: https://zoom.us/oauth/token

      • URL di autorizzazione: l'endpoint di autorizzazione. Ad esempio: https://zoom.us/oauth/authorize

      • URL di reindirizzamento: Pre-filled con l'URL di callback di Amazon Quick.

  7. Scegli Next (Successivo).

  8. Se scegli l'app OAuth predefinita o l'app OAuth personalizzata, si apre una finestra di autorizzazione Zoom. Controlla le autorizzazioni richieste e scegli Consenti.

  9. Nella pagina Revisione, esamina le azioni disponibili per il connettore. Scegli Next (Successivo).

  10. Nella pagina Pubblica, scegli chi può accedere al connettore. Puoi abilitare l'accesso per tutti i membri dell'organizzazione o cercare team o gruppi specifici.

  11. Seleziona Pubblica.

Operazioni disponibili

Dopo aver configurato il connettore, sono disponibili le seguenti azioni.

Azioni di zoom disponibili
Categoria Azione Description
Riunioni Elenca le riunioni Elenca le riunioni per un utente.
Riunioni Organizza una riunione Recupera i dettagli di una riunione specifica.
Riunioni Crea riunione Crea una nuova riunione.
Riunioni Aggiorna riunione Aggiorna una riunione esistente.
Riunioni Ottieni il riepilogo della riunione Recupera il AI-generated riepilogo di una riunione.
Riunioni Elenco dei modelli di riepilogo delle riunioni Elenca i modelli di riepilogo delle riunioni disponibili.
Riunioni Recupera i partecipanti alla riunione precedente Recupera i partecipanti da una riunione precedente.
Riunioni Elenca le istanze delle riunioni precedenti Elenca le istanze di una riunione ricorrente.
Riunioni Crea un registrante alla riunione Aggiunge un registrante a una riunione.
Registrazioni Elenca le registrazioni Elenca tutte le registrazioni di un utente.
Registrazioni Ottieni le registrazioni delle riunioni Recupera le registrazioni di una riunione specifica.
Registrazioni Elenca i file archiviati Elenca i file di registrazione archiviati.
Webinar Elenca i webinar Elenca i webinar per un utente.
Webinar Ottieni un webinar Recupera i dettagli per un webinar specifico.
Webinar Elenca i partecipanti al webinar Elenca i partecipanti a un webinar.
Contatti Cerca i contatti dell'azienda Cerca i contatti nell'elenco dell'azienda.
dispositivi Elenca dispositivi Elenca i dispositivi Zoom.
Report Ottieni un rapporto sull'utilizzo giornaliero Recupera un rapporto sull'utilizzo giornaliero.
Utenti Ottieni utente Recupera informazioni sull'utente autenticato.
Nota

Le azioni che puoi utilizzare dipendono dalle autorizzazioni configurate per il tuo account Zoom e dai dati accessibili all'utente autenticato.

Gestione e risoluzione dei problemi

Per modificare, condividere o eliminare il connettore, consultaGestione delle integrazioni esistenti.

Problemi di autenticazione

  • Sign-in fallisce (app OAuth predefinita o app OAuth personalizzata): verifica che il tuo account Zoom sia attivo e che tu possa accedere a zoom.us direttamente dal sito web di Zoom. Per l'app OAuth personalizzata, verifica che l'URI di reindirizzamento nell'app Zoom corrisponda all'URL di callback Amazon Quick.

  • Credenziali client non valide (app OAuth personalizzata): verifica che l'ID cliente e il segreto del cliente corrispondano ai valori dell'app Zoom. Puoi visualizzare le tue credenziali dalle impostazioni dell'app in Zoom App Marketplace.

  • Autorizzazioni insufficienti: verifica che gli ambiti configurati per la tua app Zoom includano le autorizzazioni necessarie per le azioni che desideri utilizzare. Per informazioni, consulta Ambiti consigliati.