Application Zoom
Vous pouvez configurer un assistant numérique pour qu'il fonctionne dans les vidéoconférences Zoom Meetings.
- Vous accédez à votre assistant numérique via l'application Oracle Digital Assistant for Zoom, que vous pouvez installer via le Marketplace d'application de Zoom.
- Les utilisateurs peuvent ensuite discuter avec votre assistant numérique au sein de cette application lors d'une réunion Zoom en cours.
Voici la procédure de création d'un canal d'application Zoom pour Digital Assistant.
Etape 1 : Installer l'application Digital Assistant de Zoom
- Accédez à l'application Oracle Digital Assistant for Zoom sur le Marketplace de l'application Zoom.
- Si vous n'êtes pas connecté à Zoom, cliquez sur Se connecter à Ajouter.
- Cliquez sur Autoriser pour installer Oracle Digital Assistant for Zoom.
Etape 2 : création d'un canal dans Digital Assistant
-
Dans Digital Assistant, cliquez sur Canaux dans le menu de gauche, puis sélectionnez Utilisateurs.
-
Cliquez sur + Canal pour ouvrir la boîte de dialogue Créer un canal.
-
Nommez votre canal.
-
Choisissez Appli Zoom comme type de canal.
- Dans le champ Domaines autorisés, saisissez tous les domaines autorisés à partir desquels les utilisateurs peuvent se connecter.
Ce champ contrôle les domaines qui peuvent se connecter au canal Zoom App. Dans la plupart des cas, vous voudrez probablement saisir le caractère générique astérisque (
*
) pour indiquer tous les domaines. -
Cliquez sur Créer.
-
Cliquez sur
et sélectionnez l'assistant numérique ou la brique à associer au canal.
-
Dans la liste déroulante Acheminer vers, sélectionnez l'assistant numérique ou la brique à associer au canal.
- Activez la commande Canal activé.
-
Gardez la page ouverte pour pouvoir utiliser les valeurs Clé secrète et ID de canal à l'étape suivante.
Etape 3 : Création d'une connexion au canal à partir de l'application dans Zoom
Une fois l'application Zoom installée et le canal créé, vous devez créer une connexion entre Zoom et le canal Zoom App pour pouvoir utiliser l'assistant numérique dans l'interface Zoom.
Pour créer une connexion, procédez comme suit :
- Dans votre client Zoom, cliquez sur l'onglet Brique de connexion.
- Entrez un nom. Nous recommandons qu'il corresponde à celui de votre instance Oracle Digital Assistant.
- 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
- Saisissez l'ID du canal Zoom App que vous venez de créer.
- Saisissez la clé secrète du canal de l'application Zoom.
- (Facultatif) Si vous souhaitez que la connexion ne soit visible que par vous, cochez la case Connexion privée.
Si cette case n'est pas cochée, cette connexion sera visible par tous les utilisateurs du même compte Zoom que vous.
- Appuyez sur Connect.
Une fois la connexion établie, un widget de discussion pour l'assistant numérique doit apparaître dans l'interface Zoom.
- 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 terminé d'interagir avec l'assistant numérique, cliquez sur la croix (X) en haut à droite pour quitter l'assistant.
Ouverture de la connexion à l'assistant numérique
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 :
- Dans votre client Zoom, cliquez sur l'onglet Le plus récent.
Cet onglet n'est visible que si une ou plusieurs connexions sont enregistrées.
- Pour rechercher une connexion existante, commencez à saisir le nom de la connexion dans la barre de recherche.
- Une fois que vous avez trouvé la connexion que vous recherchez, cliquez dessus.
Un widget de discussion pour l'assistant numérique s'ouvre.
Désinstallation de l'application Digital Assistant for Zoom
Si vous devez désinstaller l'application Oracle Digital Assistant for Zoom, procédez comme suit :
- Se connecter à votre compte Zoom
- Accédez à Zoom App Marketplace.
- Cliquez sur Gérer > Applications ajoutées et recherchez l'entrée Oracle Digital Assistant.
- Cliquez sur le bouton Enlever de l'entrée Oracle Digital Assistant for Zoom.
Limites de canal d'application Zoom
L'environnement Zoom App 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 App Zoom, vous ne pouvez saisir que des caractères.
- Il n'existe pas d'API permettant d'accéder à l'emplacement de l'utilisateur. Si votre brique requiert l'obtention de l'emplacement d'un utilisateur, vous pouvez lui demander de le fournir manuellement.
Attributs de canal d'application Zoom disponibles pour la compétence
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 possède également des 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 une réunion 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 d'une 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}
: courriel de l'hôte de la réunion.${profile.meeting.value.topic}
: brève description de la réunion.${profile.meeting.value.agenda}
: description de la réunion longue.${profile.meeting.value.recurrence}
: si la réunion est une réunion récurrente, cette expression accède à un objet qui détaille quand la réunion commence, combien de fois elle se répète, quand elle cesse de se répéter (le cas échéant), le type de récurrence (mensuelle, hebdomadaire, quotidienne, etc.) et quand elle se répète (par exemple, quel jour 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 correspond à une réunion instantanée, 2 à une réunion planifiée, 3 à une réunion récurrente sans temps fixe et 8 à une réunion récurrente avec temps 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 gérées au fur et à mesure que les participants se joignent et partent, de sorte que chaque variation disposera des 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 d'écran du particpant.role
: rôle du participant (par exemple, hôte, co-hôte, participant).active
: valeur booléenne indiquant si le participant est actuellement à la réunion ou non.
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.
Résolution
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 de connexion avec 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 les questions ou les problèmes qui ne peuvent pas être résolus, contactez My Oracle Support.