Todos os produtos
Search

Este produto

    Quick BI:Configuração do aplicativo Teams

    Central de documentação

    Quick BI:Configuração do aplicativo Teams

    Última atualização: Jun 27, 2026

    O Quick BI oferece integração com o Microsoft Teams. Antes de conectar o Teams ao Quick BI, configure um aplicativo no Teams.

    Limitações

    Você precisa ter permissões de desenvolvimento no Teams Developer Portal.

    Procedimento

    Configure um aplicativo do Teams e obtenha o ID de locatário, o ID do aplicativo e as credenciais do cliente seguindo estas etapas:

    Etapa 1: Configurar no Entra ID

    1. Acesse o portal do Azure em um navegador da web.

    2. Selecione o ícone App registrations.

      image

      image

    3. Crie um novo aplicativo.image.png

      A página Register an application será exibida.image.png

      Campo

      Descrição

      Instruções

      Display name

      Nome do seu aplicativo.

      Obrigatório.

      Supported account types

      Tipos de conta que podem usar o aplicativo.

      Obrigatório.

      Mantenha a seleção padrão (primeira opção), que permite acesso apenas para contas da organização atual.

      Redirect URI

      URI para onde o usuário é redirecionado após autenticação bem-sucedida.

      Obrigatório.

      • Formato: https://{host}/login/teams/callback.

      • Observação:

        • Somente o protocolo HTTPS é suportado.

        • Substitua {host} pelo nome de domínio real do seu Quick BI.

      image.png

      Nota

      Não é necessário insira uma redirect URI para ative o logon único (SSO) em um aplicativo de guia.

    4. Clique em Register. A página de visão geral do aplicativo será aberta, exibindo o ID do aplicativo e outros detalhes de configuração.image.pngimage

    5. Gere um segredo do cliente.image.png Anote as informações a seguir para uso posterior:

      • Directory (tenant) ID

      • Application (client) ID

      • Client secret

      image

    6. Na página Expose an API, configure o escopo do token de acesso.

      1. No painel à esquerda, selecione Manage > Expose an API.

        Configure os seguintes itens:

        1. Application ID URI

        2. Scopes defined by this API

        3. Authorized client applications

        image.png

      2. Defina o Application ID URI.

        1. Clique em Set ao lado do campo Application ID URI.

        2. O campo Application ID URI vem preenchido automaticamente com o ID do aplicativo (GUID) no formato api://{AppID}.

        3. O Application ID URI deve seguir este formato: api://{nome de domínio do serviço Quick BI, que corresponde ao domínio do aplicativo de guia}/{AppID: ID do aplicativo gerado durante o registro}. Exemplo: api://quickbi-demo-2.aliyun.com/beef226-**--**baed49e5 image.pngimage

        4. Selecione Save. Uma mensagem de confirmação aparecerá e a página exibirá o Application ID URI atualizado.image.png

        5. Anote o Application ID URI. Essa informação será necessária para atualize o manifesto do aplicativo no Teams Developer Portal.

      3. Configure os escopos da API.image

        1. Insira um nome para o escopo. Este campo é obrigatório.

        2. Selecione quem pode consentir com este escopo. A opção padrão é Admins only.

        3. Preencha o campo Admin consent display name. Campo obrigatório.

        4. Forneça uma Admin consent description. Preenchimento obrigatório.

        5. Informe o User consent display name.

        6. Descreva o consentimento do usuário.

        7. Defina o State como Enabled.

        8. Clique em Add a scope.

        Uma mensagem confirmará a adição do escopo.image.png O novo escopo passará a constar na página.image.png

      4. Configure os aplicativos clientes autorizados.

        Na página Expose an API, localize a seção Authorized client applications e clique em + Add a client application.image.png A página Add a client application será exibida.

        Insira o ID de cliente do Microsoft 365 correspondente ao aplicativo que deseja autorizar.image.png

        Referência: Ativar SSO para um aplicativo de guia

        No campo Client ID, utilize o valor abaixo:

        **Teams desktop e mobile: 1fec8e78-bce4-4aaf-ab1b-5451cc387264**

        image Em Authorized scopes, marque a caixa de seleção referente ao escopo criado.

        Clique em Add application.

        Após a mensagem de confirmação, o ID do cliente aparecerá na lista de aplicativos autorizados.image.pngimage

    7. Ajuste a versão do token de acesso no Manifest.image.png

      Nota

      Caso tenha selecionado "Personal Microsoft accounts only", "Accounts in any organizational directory (Any Microsoft Entra directory - Multitenant)" ou contas pessoais da Microsoft (como Skype e Xbox) durante o registro, altere o valor da propriedade accessTokenAcceptedVersion para 2.

    8. Defina as API permissions.

      Selecione as permissões delegadas necessárias e conceda o consentimento de administrador.image.pngimage.pngimage.png(Opcional) Se o token de acesso analisado não contiver valores esperados em determinados campos, adicione-os na configuração do token.image.png As permissões de API exigidas são:

      Nome da API/Permissão

      Obrigatório

      Finalidade

      email

      Sim

      Verificação de login

      openid

      Sim

      profile

      Sim

      User.Read

      Sim

      Organization.Read.All

      Sim

      Sincronizar contatos e obter informações de equipes e membros.

      User.Read.All

      Sim

      Team.ReadBasic.All

      Sim

      TeamMember.Read.All

      Sim

    Etapa 2: Configurar no Teams Developer Portal

    1. No portal do Azure, copie o Application (client) ID na página de visão geral do seu aplicativo.

      image

    2. Utilize esse ID para vincular o registro do aplicativo ao seu app do Teams.imageimage

    Etapa 3: Publicar o aplicativo no centro de administração do Teams

    1. Crie um novo aplicativo.

      1. Faça login no Teams Developer Portal em https://dev.teams.microsoft.com/home.image.pngimage.png

      2. Em Basic information, preencha os dados solicitados para o aplicativo.image.png

        Categoria

        Campo

        Obrigatório

        Descrição

        Imagem

        App names

        Short name - até 30 caracteres

        Sim

        Nome do aplicativo.

        image.png

        Full name - até 100 caracteres (opcional)

        Sim

        App ID

        Não

        Não utilizado atualmente.

        Descriptions

        • Short description

        • Long description

        Sim

        Descrições do aplicativo.

        image

        Developer information

        • Developer or company name

        Obrigatório

        Nome do desenvolvedor ou da empresa.

        • Website (deve ser uma URL HTTPS válida)

        Obrigatório

        URL do site do desenvolvedor.

        App URLs

        • Privacy policy

        Obrigatório

        URL da declaração de política de privacidade do aplicativo.

        image

        • Terms of use

        Obrigatório

        URL dos termos de uso do aplicativo.

        Application (client) ID*

        • ApplicationID

        Obrigatório

        • Application (client) ID do aplicativo registrado no Azure Active Directory.

      3. Na seção Branding, configure os ícones do aplicativo.image.png

      4. Em App features, configure o Personal app e o Group and channel app.image.png

        1. Configure uma guia pessoal.

          Defina a Content URL e a Website URL como https://{your-host}/home. Substitua {your-host} pelo seu nome de domínio específico.

          1. Scope: Selecione personal.

          2. Context: Escolha personalTab.

          3. Estabeleça as configurações de logon único (SSO) no Teams.

            No Application ID URI, defina o endereço de login no formato: api://{your-host}/{application ID}image.png

      5. Configure o App Content.

        Marque a caixa Full-screen mode para permitir que o aplicativo seja execute em tela cheia no Teams.image.png

      6. Em App validation, valide seu aplicativo. Após a aprovação, publique-o.image.pngimage.png

      7. Clique em Publish to org para publicar o aplicativo na sua organização. Depois de aprovado, ele ficará visível na Loja do Teams da organização.image.pngimage.png

    2. Aprove o aplicativo.

      Acesse o centro de administração do Microsoft Teams.

      Na seção Manage apps, pesquise pelo aplicativo do Teams publicado. O status inicial será Blocked.image.png Selecione o aplicativo para abrir seus detalhes e clique em Publish para disponibilizá-lo à organização.image.png

      Nota

      • Users and groups: Defina o escopo de visibilidade do aplicativo.image.png

      • Permissions: Verifique as informações de permissão do aplicativo.image.png

      image.png

    3. Adicione o aplicativo no cliente Teams.

      No Teams, clique em Apps e escolha Built for your org. O aplicativo publicado estará listado nessa área.

      Nota

      • Atraso na publicação: O aplicativo pode levar algumas horas para aparecer no cliente Teams após a publicação.

      • Cache do cliente: Caso o aplicativo não esteja visível, tente sair e entrar novamente no cliente Teams para atualize o cache.

      image.png

    Etapa 4: Configurar a integração com o Quick BI

    No portal do Azure, localize o ID do locatário, o ID do aplicativo e as credenciais do cliente do seu aplicativo. Essas informações são indispensáveis para Ativar o Micro-aplicativo do Teams.

    1. Faça login no portal do Azure.

    2. Selecione o novo aplicativo para visualize seus detalhes.image

    3. Obtenha os seguintes dados:

      • Directory (tenant) ID

        image

      • Application (client) ID

        image

      • Client credentials (segredo do cliente)

        image