Conecte sua conta do Zoom ao Okou para gerenciar reuniões e trabalhar com informações de reuniões por chat. Este guia aborda o conector Zoom gerenciado pelo usuário. Zoom Admin e Zoom AI são conectores separados.
Antes de começar
- Entre no Okou e tenha uma conta do Zoom que você esteja autorizado a conectar.
- O administrador da sua conta do Zoom pode precisar aprovar o aplicativo ou suas permissões.
- A aprovação do Zoom para distribuição externa está pendente. Até que ela seja aprovada, a disponibilidade é limitada pelas regras de compartilhamento de apps do Zoom; encontrar o conector no Okou não contorna essas regras.
- Gravações na nuvem exigem um plano do Zoom elegível, gravação na nuvem habilitada e uma gravação concluída. As transcrições já devem ter sido geradas pelo Zoom. Os recursos de webinar exigem a licença relevante do Zoom e acesso.
- Use uma conta de teste e reuniões de teste ao avaliar mudanças ou a exclusão de reuniões. Não use reuniões de clientes para testes.
Adicionar o app
- Abra Conectores do Okou.
- Em Discover, digite Zoom em Find connectors.
- Escolha Connect Zoom no cartão Zoom em Meetings and scheduling. Não escolha Zoom Admin nem Zoom AI para este guia.
- Uma janela de autorização do Zoom se abre. Entre com a conta do Zoom cujas reuniões você quer que o Okou acesse.
- Revise o nome do aplicativo e as permissões solicitadas. Escolha Allow para continuar, ou Decline para cancelar. As permissões de acesso compartilhado são opcionais; deixe-as desativadas, a menos que sua tarefa precise delas.
- Volte ao Okou e confirme que a conta aparece como conectada. My Okou: revise a conta conectada e as permissões nomeadas. Legacy Agents: selecione também o agente que pode usar o Zoom. Escolha uma duração de acesso oferecida pela solicitação.
- Abra seu próprio chat no My Okou, ou um chat com o agente selecionado no Legacy Agents. Peça List my upcoming Zoom meetings para verificar a conexão. Uma lista de reuniões vazia é um resultado válido para uma conta nova.
Conectar sua conta e conceder acesso ao Okou são etapas separadas. O Legacy Agents também usa autorização do Agent. A conexão de Zoom de outro membro da equipe não dá a você acesso à conta dessa pessoa.
Usar o Zoom no chat
O Okou chama o Zoom para a tarefa que você solicitar, dentro do acesso ao Zoom da conta conectada e das permissões do Okou concedidas a você (incluindo autorização do agente no Legacy Agents). Especifique claramente a reunião, o fuso horário e a ação pretendida.
| Recurso | Solicitação de exemplo | Pré-requisitos e resultado |
|---|---|---|
| Listar reuniões | Liste minhas próximas reuniões do Zoom. | Uma conta do Zoom autorizada. Retorna os tópicos das reuniões, horários, IDs e links de entrada disponíveis. |
| Ver uma reunião | Mostre os detalhes da reunião do Zoom [meeting ID]. | Acesso a essa reunião. Retorna as informações disponíveis da reunião. |
| Agendar uma reunião | Crie uma reunião do Zoom de 30 minutos chamada Review test amanhã às 10:00 em Asia/Shanghai. Não convide ninguém. | Permissão para criar reuniões. Retorna um ID da reunião, horário e link de entrada. |
| Atualizar uma reunião | Mova minha reunião do Zoom [meeting ID] para 11:00 em Asia/Shanghai e defina a duração como 45 minutos. | Uma reunião que você tem permissão para gerenciar. Atualiza os campos especificados. |
| Excluir uma reunião | Exclua somente a reunião de teste do Zoom [meeting ID]. | Uma reunião que você pode excluir. A exclusão cancela a reunião especificada; verifique o ID antes de solicitá-la. |
| Encerrar uma reunião ao vivo | Encerre minha reunião de teste do Zoom [meeting ID]. | Uma reunião ao vivo que você hospeda e pode encerrar. Encerra essa reunião ao vivo para os participantes. |
| Detalhes de uma reunião passada | Mostre os detalhes da minha reunião de teste concluída do Zoom [meeting UUID]. | Uma reunião concluída e acesso aos dados dela. Instâncias históricas usam o UUID da reunião do Zoom. |
| Participantes de uma reunião passada | Liste os participantes da minha reunião de teste concluída do Zoom [meeting UUID]. | Acesso aos dados de participantes da reunião concluída. A disponibilidade depende das permissões da conta do Zoom e da retenção. |
| Encontrar gravações | Encontre minhas gravações na nuvem do Zoom de [date] a [date]. | Acesso às gravações na nuvem e gravações nesse período. Use períodos de no máximo 30 dias por solicitação. |
| Ver arquivos de gravação | Mostre os arquivos de gravação disponíveis para a reunião do Zoom [meeting ID]. | Uma gravação na nuvem concluída e acessível. Retorna os arquivos que o Zoom disponibiliza. |
| Ler uma transcrição disponível | Leia a transcrição existente da minha gravação de teste do Zoom [meeting ID]. | Um arquivo de transcrição já gerado pelo Zoom e permissão para acessá-lo. Isso não habilita a gravação nem cria uma transcrição ausente. |
| Listar webinars | Liste os webinars aos quais tenho acesso. | Uma conta do Zoom habilitada para webinars e as permissões apropriadas. |
| Ver um webinar | Mostre os detalhes do webinar do Zoom [webinar ID]. | Acesso a esse webinar. O conector lê informações do webinar; não cria nem modifica webinars. |
Permissões e dados
A integração gerenciada pelo usuário solicita permissões de perfil, reunião, participantes anteriores, gravação na nuvem e webinar para os recursos descritos acima. O acesso ao perfil identifica a conta que você conecta. As permissões de alteração de reunião dão suporte ao agendamento, atualização, exclusão e encerramento de reuniões; as permissões de gravação e webinar dão suporte à leitura de informações e arquivos acessíveis.
O Okou armazena credenciais OAuth criptografadas na plataforma e atualiza os tokens de acesso no lado do servidor. As credenciais são injetadas nas solicitações do conector na borda de rede, em vez de serem fornecidas ao código do agente como variáveis de ambiente. A integração não precisa da sua senha do Zoom em um chat do Okou.
Informações de reuniões, informações de participantes ou conteúdo de gravações/transcrições recuperados para uma tarefa podem aparecer no seu chat do Okou e em documentos ou outros artefatos que você pedir ao Okou para criar. Não trate desconectar a conta como exclusão de resultados de chat ou artefatos salvos anteriormente. Consulte a Política de Privacidade para coleta, uso, retenção, exclusão e seus direitos sobre os dados, e Permissões para autorização da conta e controles de permissão.
Remover o app
Para interromper o uso futuro e remover a conexão do Okou:
- Abra Connectors no Okou e selecione Connected.
- Encontre Zoom e abra Manage Zoom accounts.
- Selecione a conta que você quer remover e escolha Disconnect. Revise a conta afetada e confirme.
- Verifique se a conta não está mais listada como conectada. Tarefas futuras precisam de outra conta conectada ou de uma nova autorização.
Revogue também a autorização do provedor no Zoom:
- Entre no Zoom App Marketplace usando a mesma conta do Zoom.
- Abra My library ou Manage > Added Apps, dependendo da interface do Marketplace.
- Encontre este aplicativo do Okou, abra os controles de remoção e escolha Remove. Confirme a remoção.
No Legacy Agents, remover a autorização de um agente apenas remove o acesso desse agente; isso não desconecta sua conta do Zoom para todos os outros agentes autorizados. Desconectar ou desinstalar este app não exclui reuniões ou gravações do Zoom. Use os próprios controles do Zoom se você também quiser excluir esses recursos.
Para solicitar a exclusão de dados derivados do Zoom retidos no Okou, entre em contato com [email protected] a partir do e-mail associado à sua conta do Okou. Identifique a conta e os chats ou artefatos em questão; nunca inclua senhas ou tokens de acesso. As solicitações são tratadas de acordo com a Política de Privacidade, incluindo quaisquer obrigações legais de retenção aplicáveis.
Solução de problemas
- O Zoom recusa a instalação ou diz que o app está indisponível: verifique a aprovação do app e a elegibilidade de compartilhamento com o administrador da sua conta do Zoom. A distribuição externa não está disponível até que o Zoom a aprove.
- A autorização foi recusada ou a janela foi fechada: volte para Connectors, atualize a página se o botão de conexão continuar ocupado e inicie uma nova autorização. Uma tentativa cancelada não estabelece conexão.
- Conectado, mas o Okou pede permissão: autorize o agent pretendido e a ação específica solicitada. A conexão sozinha não concede acesso a todos os agents.
- Conta errada: selecione a conta correta do Zoom durante a autorização. Gerencie ou desconecte a conta no Okou antes de reconectar, se necessário.
- Reconexão necessária: reconecte nas configurações da conta. Os tokens podem ter expirado ou a autorização pode ter sido revogada. Não cole tokens no chat.
- Sem reuniões, gravações ou webinars: verifique a conta conectada, o intervalo de datas, a propriedade da reunião, a licença do Zoom e se o recurso existe. Resultados vazios não são prova de falha de conexão.
- Transcrição ou gravação ausente: aguarde o processamento do Zoom e verifique se a gravação/transcrição estava habilitada no Zoom. O Okou não pode recuperar um arquivo que o Zoom não produziu ou não disponibilizou.
- Limite de taxa ou erro do provedor: aguarde o intervalo indicado pelo Zoom. Verifique o resultado da operação original antes de repetir a criação ou alteração de uma reunião, para evitar duplicatas.
Para obter ajuda, use a página de suporte ou envie um e-mail para [email protected] com a ação, o horário aproximado, a mensagem de erro e o ID da reunião de teste relevante. Não inclua credenciais nem conteúdo privado da reunião.
