Todos os produtos
Search
Central de documentação

Quick BI:Adicionar contas do Lark como usuários da organização

Última atualização: Jun 27, 2026

Administradores da organização podem adicionar uma ou mais contas do Lark a uma organização do Quick BI por vez.

Pré-requisitos

Conclua a autorização da API do Lark. Para obter mais informações, consulte Autorização da API do Lark.

Informações básicas

O Quick BI define os seguintes tipos de usuário e funções no nível da organização:

  • Tipos de usuário

    No nível da organização, existem três tipos de usuário:

    • developer: Inclui equipe de TI corporativa, analistas de dados e pessoal de operações de dados.

    • analyst: Usuário de negócios que analisa dados sem precisar de habilidades técnicas avançadas.

      Analistas examinam dados criando ativos como painéis e planilhas.

    • viewer: Usuário que apenas visualiza relatórios, como executivos ou funcionários operacionais. Os viewers acessam painéis, planilhas e portais de BI por URLs ou assinaturas.

  • Funções de usuário

    • Funções da organização

      O Quick BI oferece três funções predefinidas para a organização e permite criar funções personalizadas.

      • organization administrator: Gerencia informações, status e membros da organização. Também pode atribuir essa função a outros usuários.

        Recomendamos atribuir essa função a 1-3 pessoas, geralmente um gerente de projetos (PM) ou administradores da plataforma de BI.

      • permission administrator: Gerencia permissões de recursos dentro da organização. Recomendamos atribuir essa função a 1-3 pessoas, normalmente administradores da plataforma de BI.

      • standard user: Usuário que não é administrador da organização nem administrador de permissões.

      • custom organization role: Crie funções personalizadas conforme as necessidades do seu negócio. Para mais detalhes, consulte Gerenciamento de funções.

    • Funções do workspace

      O Quick BI disponibiliza quatro funções predefinidas para workspaces e suporta funções personalizadas.

      • workspace administrator: Possui permissões de criação (edição), uso e visualização em todos os módulos. Esta é a função com mais privilégios em um workspace. Administradores do workspace também gerenciam permissões e ativos dos demais membros.

      • workspace developer: Tem permissões de criação (edição), uso e visualização em todos os módulos.

      • workspace analyst: Dispõe de permissões de criação (edição) e visualização para portais de BI, painéis, painéis de tela grande, planilhas, análise ad hoc, recuperação de dados self-service e módulos de preparação de dados. Essa função também tem permissão de visualização para entrada de dados e fontes de dados, além de uso e visualização para datasets.

      • workspace viewer: Possui permissão de visualização em todos os módulos.

      • custom workspace role: Crie funções personalizadas de acordo com suas necessidades de negócio. Para mais informações, consulte Gerenciamento de funções.

Limitações

  • Apenas um administrador da organização pode adicionar contas de sistemas externos como usuários da organização.

  • Esse recurso está disponível somente para usuários do Quick BI Pro Edition.

Adicionar contas do Lark

  1. Faça login no console do Quick BI.

  2. Na página inicial do Quick BI, acesse a página User Management.

    image

  3. No canto superior direito da aba Member Management, selecione Add User > Sync from Office Software.

    image

  4. Na caixa de diálogo Sync Organizational Structure, defina Account Type como Lark Account e ajuste as demais configurações conforme necessário.

    image

    • Account Type: Selecione Lark.

    • Account Source: Escolha a organização do Lark à qual as contas pertencem. Caso tenha conectado apenas uma empresa em Office Software > Lark API Authorization, ela será selecionada automaticamente. Se houver várias empresas conectadas, clique no ícone image e escolha a organização desejada na lista suspensa.

    • Add Members: Marque os membros que deseja sincronizar e clique em Update to the right.

    • User type: Escolha entre Developer, Analyst ou Viewer.

    • User role: Defina como organization administrator, permission administrator, regular user ou custom user role. Somente os tipos de usuário developer e analyst podem receber a função de administrador da organização ou de administrador de permissões.

    • Available agents: Se sua organização adquiriu capacidades de agente para o Q-bot inteligente, é possível atribuir assentos de agente aos usuários sincronizados.

      Clique em Select Agent. A lista exibe todos os agentes disponíveis na organização e suas cotas restantes. Selecione o agente a ser atribuído e clique em OK.image

      Nota
      • Se o User Type de um usuário for viewer, ele não poderá usar o Q-bot inteligente para criar agentes.

      • Certifique-se de que:

        • A cota restante de agentes seja suficiente para esta tarefa de sincronização.

        • A função da organização atribuída aos usuários possua as permissões necessárias para utilizar o agente. Caso contrário, os usuários não conseguirão usar as funcionalidades do agente mesmo com um assento atribuído. Para mais detalhes sobre permissões das funções da organização, consulte Funções da organização.

      • Para saber mais sobre a aquisição de capacidades de agente, consulte Preços do Quick BI - site internacional.

  5. Clique em Start Sync.

    Nota
    • Se a estrutura organizacional tiver sido alterada, recomendamos atualizar a estrutura antes de iniciar a sincronização.

    • Quando um usuário do Lark pertence a múltiplas empresas, o Quick BI reconhece automaticamente a conta e a adiciona como um único usuário. As informações do usuário baseiam-se na empresa da sincronização mais recente.

  6. Clique em Sync Records no canto superior direito para consultar o histórico de sincronizações.

    image

Atualizar estrutura

Utilize o recurso Update Structure sempre que houver mudanças na estrutura organizacional. Alterações de nome não afetam a sincronização.

  • Quando o nome de um usuário mudar, uma tag Name Changed aparecerá após o nome.image Nesse caso, clique no ícone image para excluir o usuário, se necessário.

  • Se o nome de um departamento for alterado, a tag Name Changed surgirá após o nome do departamento. Clique então no ícone image e confirme com OK na caixa de diálogo para excluir o departamento.

    image

    Nota

    Após a exclusão do departamento, todas as permissões de criação de conteúdo dos grupos de usuários correspondentes serão invalidadas.

  • Caso um usuário não faça mais parte da organização, a tag To be deleted será exibida após o nome.

    image

    Clique no ícone image para excluir o usuário ou utilize Update Structure para resolver a pendência.

    image

  • Para limpar a estrutura organizacional atual, clique no botão Clear e depois em OK na caixa de confirmação.

    image

    Nota

    Depois de limpar a estrutura, as permissões de criação de conteúdo associadas aos grupos de usuários correspondentes deixarão de valer.

Perguntas frequentes

Problema 1: Usuários não aparecem após a sincronização

Causa: O escopo de visibilidade do aplicativo não inclui o usuário.

Solução: Acesse o console de administração do Lark. Na seção Workbench > App Management, pesquise por Quick BI e configure o escopo de visibilidade do aplicativo:

  1. Nas configurações de App Permissions > Contacts, selecione Same as availability scope.

  2. Configure o App Visibility Scope. Selecione todos os membros ou adicione membros específicos ao escopo.