Aplicativo Zoom
Você pode configurar um assistente digital para trabalhar nas videoconferências Zoom Meetings.
- Você acessa seu assistente digital por meio do aplicativo Oracle Digital Assistant for Zoom, que pode ser instalado por meio do App Marketplace do Zoom.
- Os usuários podem conversar com seu assistente digital dentro desse aplicativo durante uma reunião contínua do Zoom.
Veja a seguir as etapas para criar um canal do Aplicativo Zoom para o Digital Assistant.
Etapa 1: Instalar o Aplicativo Assistente Digital do Zoom
- Vá para o aplicativo Oracle Digital Assistant for Zoom no Zoom App Marketplace.
- Se você não tiver acessado o Zoom, clique em Acessar para Adicionar.
- Clique em Autorizar para instalar o Oracle Digital Assistant for Zoom.
Etapa 2: Criar um Canal no Digital Assistant
-
No Digital Assistant, clique em Canais no menu esquerdo e escolha Usuários.
-
Clique em + Canal para abrir a caixa de diálogo Criar Canal.
-
Dê um nome ao canal.
-
Escolha Aplicativo Zoom como o tipo de canal.
- No campo Domínios Permitidos, informe quaisquer domínios permitidos dos quais os usuários possam se conectar.
Este campo controla quais domínios podem se conectar ao canal do Aplicativo Zoom. Na maioria dos casos, você provavelmente vai querer inserir o asterisco curinga (
*
) para indicar todos os domínios. -
Clique em Criar.
-
Clique em
e selecione o assistente digital ou a habilidade que deseja associar ao canal.
-
Na lista drop-down Rotear para, selecione a habilidade ou o assistente digital que você deseja associar ao canal.
- Alterne para ativado o controle Canal Ativado.
-
Mantenha a página aberta para que você possa usar os valores Chave Secreta e ID do Canal na próxima etapa.
Etapa 3: Criar uma Conexão com o Canal a partir do Aplicativo no Zoom
Depois que o aplicativo Zoom for instalado e o canal for criado, você precisará criar uma conexão entre o Zoom e o canal do Aplicativo Zoom para poder usar o assistente digital na interface do Zoom.
Para criar uma nova conexão:
- No cliente Zoom, clique na guia Conectar Habilidade.
- Digite um nome. Recomendamos que ele corresponda ao da sua instância do Oracle Digital Assistant.
- Informe o nome do host da sua instância do Oracle Digital Assistant.
Esta é a parte do URL do Digital Assistant que vem depois de
https://
e antes/botsui
- Informe o ID do canal do Aplicativo Zoom que você acabou de criar.
- Informe a chave secreta do canal do Aplicativo Zoom.
- (Opcional) Se quiser que a conexão só fique visível para você, marque a caixa de seleção Conectar Privadamente.
Se desmarcada, essa conexão ficará visível para qualquer pessoa na mesma conta do Zoom que você.
- Pressione Conectar.
Depois que a conexão for feita, um widget de chat do assistente digital deverá aparecer na interface do Zoom.
- Teste o assistente digital informando texto no widget de chat.
Se o assistente digital funcionar conforme esperado, sua conexão estará pronta e você poderá fechar o widget de chat.
Quando terminar de interagir com o assistente digital, clique no X no canto superior direito para sair.
Abrir a Conexão com seu Digital Assistant
Depois de criar uma conexão com um assistente digital por meio de um canal do Aplicativo Zoom, você poderá abrir o assistente digital do seu cliente Zoom a qualquer momento:
- No cliente Zoom, clique na guia Mais Recente.
Esta guia só estará visível se você tiver uma ou mais conexões salvas.
- Para procurar uma conexão existente, comece a digitar o nome da conexão na barra de pesquisa.
- Depois de encontrar a conexão que você está procurando, clique nela.
Um widget de chat para o assistente digital será aberto.
Desinstalar o Assistente Digital do Aplicativo Zoom
Se você precisar desinstalar o aplicativo Oracle Digital Assistant for Zoom, siga estas etapas:
- Acessar sua conta do Zoom
- Navegue até o Zoom App Marketplace.
- Clique em Gerenciar > Aplicativos Adicionados e procure a entrada do Oracle Digital Assistant.
- Clique no botão Remover da entrada do Oracle Digital Assistant for Zoom.
Limitações do Canal do Aplicativo Zoom
O ambiente Zoom App fornecido pelo Zoom é muito semelhante ao de um navegador da Web, com diferenças importantes:
- Não é possível acessar o microfone. Isso significa que, ao interagir com sua habilidade por meio do canal Zoom App, você só pode digitar.
- Não há uma API para acessar a localização do usuário. Se sua habilidade exigir a obtenção da localização de um usuário, você poderá solicitar que ele a forneça manualmente.
Atributos do Canal do Aplicativo Zoom Disponíveis para Habilidade
Quando uma habilidade é conectada por meio de um canal do Aplicativo Zoom, você pode obter informações de perfil do usuário do Zoom para cada parte da entrada do usuário na conversa. Aqui estão as expressões que você pode usar para obter informações de perfil do usuário:
${profile.user.value.id}
: O ID do usuário Zoom do usuário atual.${profile.user.value.first_name}
: O nome do usuário atual.${profile.user.value.last_name}
: O sobrenome do usuário atual.${profile.user.value.email}
: o endereço de e-mail do usuário atual.
Para obter mais informações sobre os atributos de usuário disponíveis por meio dessas expressões, consulte https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#tag/Users.
O Zoom também tem variáveis que permitem obter informações sobre a própria reunião. Para acessá-los, a reunião deve ser criada na conta do usuário atual. Aqui estão as expressões que você pode usar para acessar essas informações:
${profile.meeting.value.id}
: O ID da reunião do Zoom. Quando a reunião é uma reunião recorrente, esse valor é o mesmo para cada ocorrência da reunião.${profile.meeting.value.uuid}
: O ID da ocorrência de uma reunião do Zoom. Esse valor é sempre único, mesmo entre as ocorrências do mesmo encontro.${profile.meeting.value.created_at}
: A data e a hora em que a reunião foi programada. Se esta reunião foi iniciada sem ser programada, seu valor será idêntico a${profile.meeting.value.started_at}
.${profile.meeting.value.started_at}
: A data e a hora em que a reunião foi iniciada.${profile.meeting.value.host_id}
: ID do host da reunião.${profile.meeting.value.host_email}
: E-mail do host da reunião.${profile.meeting.value.topic}
: Breve descrição da reunião.${profile.meeting.value.agenda}
: Descrição longa da reunião.${profile.meeting.value.recurrence}
: Se a reunião for uma reunião recorrente, essa expressão acessará um objeto que detalha quando a reunião começa, quantas vezes ela se repete, quando para de repetir (se aplicável), o tipo de recorrência (mensal, semanal, diária etc.) e quando ela se repete (por exemplo, qual dia ela se repete se for uma reunião semanal ou mensal).${profile.meeting.value.type}
: Um número inteiro que indica o tipo de reunião. (1 é uma reunião instantânea, 2 é uma reunião programada, 3 é uma reunião recorrente sem hora fixa e 8 é uma reunião recorrente com hora fixa.)
Se o usuário atual for o proprietário da reunião, você poderá obter as seguintes informações sobre os participantes. Essas informações são mantidas ativamente à medida que os participantes entram e saem, de modo que cada declaração terá as informações mais atualizadas sobre os participantes naquele momento:
${profile.meeting.participants}
: Um array que contém os participantes atuais da reunião. Cada objeto de matriz contém os seguintes objetos:participantUUID
: O ID do participante (único em cada reunião)screenName
: O nome da tela do particpant.role
: A função do participante (por exemplo, host, co-host, participante).active
: Um booliano que indica se o participante está ou não na reunião.
Para obter mais informações sobre as variáveis de perfil da reunião, consulte https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#tag/Meetings.
Diagnosticando e Solucionando Problemas
Se você tiver problemas ao instalar o aplicativo Oracle Digital Assistant for Zoom ou tiver problemas ao estabelecer conexão com um assistente digital em uma reunião do Zoom, primeiro siga as instruções fornecidas em qualquer mensagem de erro exibida.
Se você continuar a ter problemas, verifique com o administrador da conta Zoom da sua equipe e/ou com o administrador da instância do Oracle Digital Assistant da sua equipe.
Para dúvidas ou problemas que não podem ser resolvidos, entre em contato com o My Oracle Support.