Application Zoom
Vous pouvez configurer un assistant numérique pour qu'il fonctionne dans les conférences vidéo des réunions Zoom.
- Vous accédez à votre assistant numérique au moyen de l'application Oracle Digital Assistant pour Zoom, que vous pouvez installer sur le marché des applications de Zoom.
- Les utilisateurs peuvent ensuite clavarder avec votre assistant numérique au sein de cette application lors d'une réunion Zoom en cours.
Ci-dessous figurent les étapes de création d'un canal d'application Zoom pour Digital Assistant.
Étape 1 : Installer l'application Digital Assistant de Zoom
- Allez à l'application Oracle Digital Assistant pour Zoom dans le marché des applications Zoom.
- Si vous n'êtes pas connecté au zoom, cliquez sur Connexion à ajouter.
- Cliquez sur Autoriser pour installer Oracle Digital Assistant pour Zoom.
Étape 2 : Créer un canal dans Digital Assistant
-
Dans Digital Assistant, cliquez sur Channels (Canaux) dans le menu de gauche, puis sélectionnez Users (Utilisateurs).
-
Cliquez sur + Channel (Canal) pour ouvrir la boîte de dialogue Create Channel (Créer un canal).
-
Donnez un nom à votre canal.
-
Sélectionnez Zoom App comme type de canal.
- 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 entrer le caractère générique de l'astérisque (
*
) pour indiquer tous les domaines. -
Cliquez sur Create (Créer).
-
Cliquez sur
et sélectionnez l'assistant numérique ou la compétence à associer au canal.
-
Dans la liste déroulante Route To (Acheminer vers), sélectionnez l'assistant numérique ou la compétence que vous voulez associer au canal.
- Activez le commutateur Channel Enabled (Canal activé).
-
Gardez la page ouverte afin que vous puissiez utiliser les valeurs Clé secrète et ID canal à l'étape suivante.
Étape 3 : Créer 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 de l'application Zoom pour pouvoir utiliser l'assistant numérique dans l'interface Zoom.
Pour créer une connexion :
- Dans le client Zoom, cliquez sur l'onglet Connecter la compétence.
- Entrez un nom. Nous recommandons qu'il corresponde à celui de votre instance Oracle Digital Assistant.
- Entrez le nom d'hôte de votre instance d'Oracle Digital Assistant.
Il s'agit de la partie de l'URL de Digital Assistant qui apparaît après
https://
et avant/botsui
- Entrez l'ID canal du canal de l'application Zoom que vous venez de créer.
- Entrez la clé secrète du canal de l'application Zoom.
- (Facultatif) Si vous voulez 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 toute personne sous le même compte Zoom que vous.
- Appuyez sur Connexion.
Une fois la connexion établie, un widget de clavardage 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 clavardage.
Si l'assistant numérique fonctionne comme prévu, votre connexion est prête et vous pouvez fermer le widget de clavardage.
Lorsque vous avez terminé d'interagir avec l'assistant numérique, cliquez sur le X dans le coin supérieur droit pour quitter.
Ouvrir la connexion à votre assistant numérique
Une fois que vous avez créé une connexion à un assistant numérique au moyen d'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 vous avez une ou plusieurs connexions enregistrées.
- Pour rechercher une connexion existante, commencez à taper 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 clavardage pour l'assistant numérique s'ouvrira.
Désinstaller l'assistant numérique pour l'application Zoom
Si vous devez désinstaller l'application Oracle Digital Assistant pour Zoom, procédez comme suit :
- Connexion à votre compte Zoom
- Naviguez jusqu'au marché des applications Zoom.
- Cliquez sur Gérer > Applications ajoutées et recherchez l'entrée Oracle Digital Assistant.
- Cliquez sur le bouton Supprimer de l'entrée Oracle Digital Assistant pour Zoom.
Limites de canal d'application Zoom
L'environnement d'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 compétence via le canal de l'application Zoom, vous ne pouvez que taper.
- Il n'y a pas d'API pour accéder à l'emplacement de l'utilisateur. Si votre compétence nécessite 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 compétence est connectée au moyen d'un canal d'application Zoom, vous pouvez obtenir des informations de profil d'utilisateur à partir de Zoom pour chaque élément d'entrée d'utilisateur dans la conversation. Voici les expressions que vous pouvez utiliser pour obtenir des informations sur le profil d'utilisateur :
${profile.user.value.id}
: ID utilisateur Zoom de l'utilisateur courant.${profile.user.value.first_name}
: Prénom de l'utilisateur courant.${profile.user.value.last_name}
: Nom de famille de l'utilisateur courant.${profile.user.value.email}
: Adresse de courriel de l'utilisateur courant.
Pour plus d'informations sur les attributs d'utilisateur disponibles au moyen de ces expressions, voir https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#tag/Users.
Zoom a é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 courant. 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 périodique, 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é programmée. Si cette réunion a été lancée sans être programmé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 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 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 qui indique le type de réunion. (1 est une réunion instantanée, 2 est une réunion programmé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 courant est le responsable 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 s'y joignent et partent, de sorte que chaque énoncé aura les informations les plus à jour sur les participants à ce moment :
${profile.meeting.participants}
: Tableau qui contient les participants actuels de la réunion. Chaque objet tableau contient les objets suivants :participantUUID
: ID du participant (unique à chaque réunion)screenName
: Nom de l'écran du pantalon.role
: Rôle du participant (par exemple, hôte, co-hôte, participant).active
: Valeur booléenne indiquant si le participant participe ou non à la réunion.
Pour plus d'informations sur les variables de profil de réunion, voir https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#tag/Meetings.
Dépannage
Si vous rencontrez des problèmes lors de l'installation de l'application Oracle Digital Assistant pour Zoom ou si vous avez des problèmes de 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 les problèmes persistent, communiquez avec l'administrateur du compte Zoom de votre équipe ou avec l'administrateur de l'instance Oracle Digital Assistant de votre équipe.
Pour toute question ou problème qui ne peut pas être résolu, communiquez avec My Oracle Support.