1. Passare all'app Oracle Digital Assistant for Zoom nel Marketplace dell'applicazione Zoom.
2. Se non si è connessi a Zoom, fare clic su Accedi per aggiungere.
3. Fare clic su Autorizza per installare Oracle Digital Assistant per Zoom.

1. In Digital Assistant, fare clic sui canali nel menu a sinistra, quindi scegliere Utenti.

2. Fare clic su + Canale per aprire la finestra di dialogo Crea canale.

3. Dai un nome al tuo canale.

4. Scegliere Applicazione zoom come tipo di canale.

5. Nel campo Domini consentiti immettere i domini consentiti dai quali gli utenti possono connettersi.

   Questo campo controlla quali domini possono connettersi al canale dell'applicazione Zoom. Nella maggior parte dei casi è probabile che si desideri immettere il carattere jolly asterisco (*) per indicare tutti i domini.

6. Fare clic su Crea.

7. Fare clic su e selezionare l'assistente digitale o lo skill che si desidera associare al canale.

8. Nell'elenco a discesa Invia a selezionare l'assistente digitale o lo skill che si desidera associare al canale.

9. Accendere il controllo Channel Enabled.

10. Mantenere aperta la pagina in modo da poter utilizzare i valori Chiave segreta e ID canale nel passo successivo.

Una volta installata l'app Zoom e creato il canale, è necessario creare una connessione tra Zoom e il canale dell'app Zoom per poter utilizzare l'assistente digitale all'interno dell'interfaccia Zoom.

Per creare una nuova connessione:

1. Nel client Zoom fare clic sulla scheda Connetti skill.
2. Immettere un nome. È consigliabile che corrisponda a quella dell'istanza di Oracle Digital Assistant.
3. Immettere il nome host dell'istanza Oracle Digital Assistant.

   Parte dell'URL di Digital Assistant disponibile dopo https:// e prima /botsui

4. Immettere l'ID canale del canale dell'applicazione Zoom appena creato.
5. Immettere la chiave segreta del canale dell'applicazione Zoom.
6. (Facoltativo) Se si desidera che la connessione sia visibile solo all'utente, selezionare la casella di controllo Connetti privatamente.

   Se deselezionata, questa connessione sarà visibile a chiunque si trovi nello stesso account Zoom di te.

7. Premere Connetti.

   Una volta stabilita la connessione, all'interno dell'interfaccia Zoom dovrebbe apparire un widget di chat per l'assistente digitale.

8. Eseguire il test dell'assistente digitale immettendo del testo nel widget chat.

Se l'assistente digitale funziona come previsto, la connessione è pronta per l'uso ed è possibile chiudere il widget chat.

Al termine dell'interazione con l'assistente digitale, fare clic sulla X nell'angolo in alto a destra per uscire.

Dopo aver creato una connessione a un assistente digitale tramite un canale dell'applicazione Zoom, è possibile aprire l'assistente digitale dal client Zoom in qualsiasi momento:

1. Nel client Zoom fare clic sulla scheda Più recenti.

   Questa scheda è visibile solo se si dispone di una o più connessioni salvate.

2. Per cercare una connessione esistente, iniziare a digitare il nome della connessione nella barra di ricerca.
3. Una volta trovata la connessione che si sta cercando, fare clic su di essa.

   Verrà aperto un widget di chat per l'assistente digitale.

Se è necessario disinstallare l'applicazione Oracle Digital Assistant for Zoom, attenersi alla procedura riportata di seguito.

1. Connettersi all'account Zoom
2. Passare a Zoom App Marketplace.
3. Fare clic su Gestisci > Applicazioni aggiunte e cercare la voce Oracle Digital Assistant.
4. Fare clic sul pulsante Rimuovi della voce Oracle Digital Assistant for Zoom.

L'ambiente Zoom App fornito da Zoom è molto simile a quello di un browser Web, con differenze chiave:

• Non è possibile accedere al microfono. Ciò significa che quando interagisci con le tue abilità attraverso il canale Zoom App, puoi solo digitare.
• Non esiste un'API per accedere alla posizione dell'utente. Se la tua abilità richiede di ottenere la posizione di un utente, puoi chiedere loro di fornirla manualmente.

Quando uno skill viene connesso tramite un canale dell'applicazione Zoom, è possibile ottenere informazioni sul profilo utente da Zoom per ogni input utente nella conversazione. Di seguito sono riportate le espressioni che è possibile utilizzare per ottenere le informazioni sul profilo utente.

• ${profile.user.value.id}: ID dell'utente Zoom corrente.
• ${profile.user.value.first_name}: il nome dell'utente corrente.
• ${profile.user.value.last_name}: il nome dell'utente corrente.
• ${profile.user.value.email}: indirizzo e-mail dell'utente corrente.

Per ulteriori informazioni sugli attributi utente disponibili tramite queste espressioni, vedere https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#tag/Users.

Zoom dispone inoltre di variabili che consentono di ottenere informazioni sulla riunione stessa. Per accedervi, la riunione deve essere creata nell'account dell'utente corrente. Di seguito sono riportate le espressioni che è possibile utilizzare per accedere a tali informazioni.

• ${profile.meeting.value.id}: l'ID della riunione Zoom. Quando la riunione è ricorrente, questo valore è uguale per ogni ricorrenza della riunione.
• ${profile.meeting.value.uuid}: l'ID per la ricorrenza di una riunione Zoom. Questo valore è sempre univoco, anche tra le ricorrenze della stessa riunione.
• ${profile.meeting.value.created_at}: la data e l'ora in cui è stata pianificata la riunione. Se la riunione è stata avviata senza essere pianificata, il relativo valore sarà identico a ${profile.meeting.value.started_at}.
• ${profile.meeting.value.started_at}: la data e l'ora di inizio della riunione.
• ${profile.meeting.value.host_id}: ID dell'host della riunione.
• ${profile.meeting.value.host_email}: Email dell'host della riunione.
• ${profile.meeting.value.topic}: breve descrizione della riunione.
• ${profile.meeting.value.agenda}: descrizione lunga della riunione.
• ${profile.meeting.value.recurrence}: se si tratta di una riunione ricorrente, questa espressione accede a un oggetto con i dettagli relativi all'inizio della riunione, al numero di ripetizioni, al momento della ripetizione (se applicabile), al tipo di ricorrenza (mensile, settimanale, giornaliera e così via) e al momento della ricorrenza (ad esempio, il giorno in cui si ripete se si tratta di una riunione settimanale o mensile).
• ${profile.meeting.value.type}: un numero intero che indica il tipo di riunione. (1 è una riunione immediata, 2 è una riunione schedulata, 3 è una riunione ricorrente senza tempo fisso e 8 è una riunione ricorrente con tempo fisso).

Se l'utente corrente è il proprietario della riunione, è possibile ottenere le informazioni riportate di seguito sui partecipanti. Queste informazioni vengono mantenute attivamente mentre i partecipanti si uniscono e se ne vanno, quindi ogni espressione avrà le informazioni più aggiornate sui partecipanti in quel momento:

• ${profile.meeting.participants}: un array che contiene i partecipanti correnti della riunione. Ogni oggetto array contiene gli oggetti riportati di seguito.
  • participantUUID: ID del partecipante (unico in ogni riunione)
  • screenName: il nome dello schermo del particpant.
  • role: il ruolo del partecipante (ad esempio, host, co-host, partecipante).
  • active: un valore booleano che indica se il partecipante è attualmente nella riunione.

Per ulteriori informazioni sulle variabili del profilo riunione, vedere https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#tag/Meetings.

In caso di problemi durante l'installazione dell'applicazione Oracle Digital Assistant for Zoom o di problemi di connessione con un assistente digitale in una riunione Zoom, seguire prima le istruzioni fornite nei messaggi di errore visualizzati.

Se i problemi persistono, contattare l'amministratore dell'account Zoom del team e/o l'amministratore dell'istanza di Oracle Digital Assistant del team.

Per domande o problemi che non possono essere risolti, contatta My Oracle Support.