1. Accédez à l'application Oracle Digital Assistant for Zoom dans Zoom App Marketplace.
2. Si vous n'êtes pas connecté à Zoom, cliquez sur Se connecter à Ajouter.
3. Cliquez sur Autoriser pour installer Oracle Digital Assistant pour Zoom.

1. Dans Digital Assistant, cliquez sur Canaux dans le menu de gauche, puis sélectionnez Utilisateurs.

2. Cliquez sur + Canal pour ouvrir la boîte de dialogue Créer un canal.

3. Nommez votre canal.

4. Choisissez Application de zoom comme type de canal.

5. Dans le champ Domaines autorisés, entrez tous les domaines autorisés à partir desquels les utilisateurs peuvent se connecter.

   Ce champ contrôle les domaines qui peuvent se connecter au canal de l'application Zoom. Dans la plupart des cas, vous voudrez probablement saisir le caractère générique astérisque (*) pour indiquer tous les domaines.

6. Cliquez sur Créer.

7. Cliquez sur et sélectionnez l'assistant numérique ou la brique à associer au canal.

8. Dans la liste déroulante Acheminer vers, sélectionnez l'assistant numérique ou la brique à associer au canal.

9. Activez la commande Canal activé.

10. Gardez la page ouverte pour pouvoir utiliser les valeurs de clé secrète et d'ID de canal à l'étape suivante.

Une fois l'application Zoom installée et le canal créé, vous devez créer une connexion entre Zoom et le canal de l'application Zoom pour pouvoir utiliser l'assistant numérique dans l'interface Zoom.

Pour créer une connexion, procédez comme suit :

1. Dans votre client Zoom, cliquez sur l'onglet Connecter la brique.
2. Entrez un nom. Nous vous recommandons qu'il corresponde à celui de votre instance Oracle Digital Assistant.
3. Saisissez le nom d'hôte de votre instance Oracle Digital Assistant.

   Il s'agit de la partie de l'URL de l'assistant numérique qui est fournie après https:// et avant /botsui

4. Saisissez l'ID du canal d'application Zoom que vous venez de créer.
5. Entrez la clé secrète du canal d'application Zoom.
6. (Facultatif) Si vous souhaitez que la connexion ne soit visible que par vous, cochez la case Connecter en privé.

   Si cette option n'est pas sélectionnée, cette connexion sera visible par tous les utilisateurs du même compte Zoom que vous.

7. Appuyez sur Connect.

   Une fois la connexion établie, un widget de discussion pour l'assistant numérique doit apparaître dans l'interface Zoom.

8. Testez l'assistant numérique en entrant du texte dans le widget de discussion.

Si l'assistant numérique fonctionne comme prévu, votre connexion est prête et vous pouvez fermer le widget de discussion.

Lorsque vous avez fini d'interagir avec l'assistant numérique, cliquez sur le X dans le coin supérieur droit pour quitter.

Une fois que vous avez créé une connexion à un assistant numérique via un canal d'application Zoom, vous pouvez ouvrir l'assistant numérique à partir de votre client Zoom à tout moment :

1. Dans votre client Zoom, cliquez sur l'onglet Plus récent.

   Cet onglet n'est visible que si vous avez des connexions enregistrées.

2. Pour rechercher une connexion existante, commencez à saisir le nom de la connexion dans la barre de recherche.
3. Une fois que vous avez trouvé la connexion que vous recherchez, cliquez dessus.

   Un widget de discussion pour l'assistant numérique s'ouvre.

Si vous devez désinstaller l'application Oracle Digital Assistant for Zoom, procédez comme suit :

1. Connexion à votre compte Zoom
2. Accédez à la page Zoom App Marketplace.
3. Cliquez sur Gérer > Applications ajoutées et recherchez l'entrée Oracle Digital Assistant.
4. Cliquez sur le bouton Enlever de l'entrée Oracle Digital Assistant pour Zoom.

L'environnement de l'application Zoom fourni par Zoom est très similaire à celui d'un navigateur Web, avec des différences clés :

• Vous ne pouvez pas accéder au microphone. Cela signifie que lorsque vous interagissez avec votre brique via le canal d'application Zoom, vous pouvez uniquement taper.
• Il n'existe pas d'API permettant d'accéder à l'emplacement de l'utilisateur. Si votre brique nécessite l'obtention de l'emplacement d'un utilisateur, vous pouvez lui demander de le fournir manuellement.

Lorsqu'une brique est connectée via un canal d'application Zoom, vous pouvez obtenir des informations de profil utilisateur à partir de Zoom pour chaque entrée utilisateur dans la conversation. Voici les expressions que vous pouvez utiliser pour obtenir les informations de profil utilisateur :

• ${profile.user.value.id} : ID de l'utilisateur Zoom en cours.
• ${profile.user.value.first_name} : prénom de l'utilisateur en cours.
• ${profile.user.value.last_name} : nom de famille de l'utilisateur en cours.
• ${profile.user.value.email} : adresse électronique de l'utilisateur en cours.

Pour plus d'informations sur les attributs utilisateur disponibles via ces expressions, reportez-vous à https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#tag/Users.

Zoom dispose également de variables qui vous permettent d'obtenir des informations sur la réunion elle-même. Pour y accéder, la réunion doit être créée dans le compte de l'utilisateur actuel. Voici les expressions que vous pouvez utiliser pour accéder à ces informations :

• ${profile.meeting.value.id} : ID de la réunion Zoom. Lorsque la réunion est récurrente, cette valeur est la même pour chaque occurrence de la réunion.
• ${profile.meeting.value.uuid} : ID de l'occurrence d'une réunion Zoom. Cette valeur est toujours unique, même entre les occurrences de la même réunion.
• ${profile.meeting.value.created_at} : date et heure auxquelles la réunion a été planifiée. Si cette réunion a été lancée sans être planifiée, sa valeur sera identique à ${profile.meeting.value.started_at}.
• ${profile.meeting.value.started_at} : date et heure de début de la réunion.
• ${profile.meeting.value.host_id} : ID de l'hôte de la réunion.
• ${profile.meeting.value.host_email} : adresse électronique de l'hôte de la réunion.
• ${profile.meeting.value.topic} : brève description de la réunion.
• ${profile.meeting.value.agenda} : description longue de la réunion.
• ${profile.meeting.value.recurrence} : si la réunion est récurrente, cette expression accède à un objet qui détaille le début de la réunion, le nombre de fois où elle se répète, le moment où elle cesse de se répéter (le cas échéant), le type de récurrence (mensuelle, hebdomadaire, quotidienne, etc.) et le moment où elle se répète (par exemple, le jour où elle se répète s'il s'agit d'une réunion hebdomadaire ou mensuelle).
• ${profile.meeting.value.type} : nombre entier indiquant le type de réunion. (1 est une réunion instantanée, 2 est une réunion planifiée, 3 est une réunion récurrente sans heure fixe et 8 est une réunion récurrente avec heure fixe.)

Si l'utilisateur actuel est le propriétaire de la réunion, vous pouvez obtenir les informations suivantes sur les participants. Ces informations sont activement conservées au fur et à mesure que les participants se joignent et partent, de sorte que chaque variation aura les informations les plus à jour sur les participants à ce moment-là :

• ${profile.meeting.participants} : tableau contenant les participants actuels de la réunion. Chaque objet de tableau contient les objets suivants :
  • participantUUID : ID du participant (unique à chaque réunion)
  • screenName : nom de l'écran du particpant.
  • role : rôle du participant (par exemple, hôte, co-hôte, participant).
  • active : booléen indiquant si le participant est actuellement en réunion.

Pour plus d'informations sur les variables de profil de réunion, reportez-vous à https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#tag/Meetings.

Si vous rencontrez des problèmes lors de l'installation de l'application Oracle Digital Assistant for Zoom ou si vous rencontrez des problèmes lors de la connexion à un assistant numérique lors d'une réunion Zoom, suivez d'abord les instructions fournies dans les messages d'erreur affichés.

Si vous continuez à rencontrer des problèmes, contactez l'administrateur du compte Zoom de votre équipe et/ou l'administrateur de l'instance Oracle Digital Assistant de votre équipe.

Pour toute question ou problème qui ne peut pas être résolu, contactez My Oracle Support.