Aplicativo Zoom
Você pode configurar um assistente digital para trabalhar em videoconferências do 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 nesse 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 Digital Assistant 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 de Zoom. Na maioria dos casos, você provavelmente desejará inserir o curinga de asterisco (
*
) 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 canal Zoom e o canal Zoom App para poder usar o assistente digital na interface Zoom.
Para criar uma nova conexão:
- No seu 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 de Zoom.
- (Opcional) Se você 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 estabelecida, um widget de chat para o assistente digital deverá aparecer na interface do Zoom.
- Teste o assistente digital digitando 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.
Abra a Conexão com seu Assistente Digital
Depois de criar uma conexão com um assistente digital por meio de um canal do Aplicativo Zoom, você poderá abrir o assistente digital no 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 para o 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 Oracle Digital Assistant for Zoom da entrada Remover.
Zoom nas Limitações do Canal do Aplicativo
O ambiente do Zoom App fornecido pelo Zoom é muito semelhante ao de um navegador da Web, com diferenças importantes:
- Você não pode 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.
Ampliar Atributos do Canal do Aplicativo 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 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 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 do 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 reunião em si. 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 exclusivo, mesmo entre 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 tiver sido 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 anfitrião da reunião.${profile.meeting.value.host_email}
: E-mail do anfitrião 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 se repetir (se aplicável), o tipo de recorrência (mensal, semanal, diário etc.) e quando ela se repete (por exemplo, em que dia ela se repete se for uma reunião semanal ou mensal).${profile.meeting.value.type}
: Um 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 tempo fixo e 8 é uma reunião recorrente com tempo fixo.)
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, portanto, 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 (exclusivo 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á atualmente na reunião ou nã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.
Diagnóstico e Solução de Problemas
Se você tiver problemas ao instalar o aplicativo Oracle Digital Assistant for Zoom ou tiver problemas ao se conectar 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.
Em caso de dúvidas ou problemas que não podem ser resolvidos, entre em contato com o My Oracle Support.