Ao clicar em um link para instalar um agente do Copilot Studio no Microsoft Teams, a instalação pode falhar sem uma mensagem de erro clara. Isso geralmente acontece devido a uma incompatibilidade entre as configurações de implantação do agente e as permissões do ambiente Teams do usuário. O link pode apontar para um agente específico do locatário ao qual sua conta não tem acesso, ou o agente pode estar configurado para um canal de implantação diferente. Este artigo explica as causas raiz dessa falha de instalação e fornece correções passo a passo para resolvê-la.
Principais conclusões: corrigindo a instalação do agente do Copilot Studio pelo link do Teams
- Copilot Studio > Configurações > Canais > Microsoft Teams: Verifique se o agente foi publicado no canal do Teams e se o link foi gerado a partir da versão publicada.
- Central de administração do Microsoft 365 > Aplicativos do Teams > Políticas de configuração: Garanta que a instalação de aplicativos de terceiros esteja permitida e que o agente não esteja bloqueado por uma política de permissão de aplicativo.
- Cliente do Teams > Aplicativos > Gerenciar seus aplicativos: Verifique se o agente aparece no catálogo de aplicativos da organização ou se requer aprovação do administrador para instalação.
Por que a instalação do agente do Copilot Studio falha a partir de um link do Teams
O link de instalação de um agente do Copilot Studio é gerado a partir das configurações de publicação do agente no Copilot Studio. Quando o link falha, a causa raiz mais comum é que o agente não foi publicado no canal do Teams ou foi publicado em um canal diferente, como um site personalizado ou Power Apps. O link é um deep link que aponta para o ID do aplicativo do agente no catálogo de aplicativos do Microsoft Teams. Se o agente estiver ausente desse catálogo, o Teams não consegue resolver o link e a caixa de diálogo de instalação não aparece ou exibe um erro.
Outra causa frequente é uma incompatibilidade de permissões. O agente pode estar configurado para um grupo de segurança específico ou habilitado apenas para um subconjunto de usuários no locatário. Quando um usuário fora desse grupo clica no link, o Teams verifica as licenças e associações de grupo do usuário antes de permitir a instalação. Se o usuário não atender aos critérios, a instalação é bloqueada silenciosamente.
As políticas de permissão de aplicativos do Teams definidas pelo administrador do Microsoft 365 também podem impedir a instalação. Mesmo que o agente esteja devidamente publicado, se o administrador bloqueou aplicativos de terceiros ou categorias específicas de aplicativos, o usuário não pode instalar o agente a partir de nenhum link. Esta é uma política de todo o locatário que substitui as configurações individuais do agente.
Etapas para corrigir a instalação do agente do Copilot Studio a partir de um link do Teams
Método 1: Verifique se o agente foi publicado no canal do Teams
- Abra o Copilot Studio
Faça login com uma conta do Microsoft 365 que tenha a função de Environment Maker ou System Customizer para o ambiente do agente. - Vá para Configurações do agente
No painel de navegação esquerdo, clique em Configurações e depois selecione Canais. - Verifique o status do canal do Teams
Localize o canal Microsoft Teams na lista. Se o status for Não configurado, clique em Configurar e siga as instruções para ativá-lo. Se estiver Configurado, prossiga para a próxima etapa. - Publique o agente
Volte à página principal do agente e clique em Publicar. Selecione Publicar conteúdo mais recente para enviar a versão mais recente para todos os canais habilitados, incluindo o Teams. - Regere o link de instalação
Após a publicação, retorne a Configurações > Canais > Microsoft Teams. Clique no botão Copiar link para gerar um novo link de instalação. Envie este novo link para o usuário.
Método 2: Verifique as permissões do usuário e atribuições de licença
- Abra a central de administração do Microsoft 365
Acesse admin.microsoft.com e faça login com uma conta de administrador. - Navegue até Usuários > Usuários ativos
Encontre o usuário que não consegue instalar o agente e clique no nome dele. - Verifique a licença do usuário
No painel de detalhes do usuário, clique na guia Licenças e aplicativos. Confirme se o usuário possui uma licença válida para o Microsoft Teams e para o Copilot para Microsoft 365, se o agente exigir. Atribua a licença se estiver faltando. - Verifique as configurações do grupo de segurança do agente
No Copilot Studio, vá para Configurações > Segurança. Se o agente estiver restrito a um grupo de segurança específico, certifique-se de que o usuário seja membro desse grupo no Microsoft Entra ID. - Teste com uma conta de administrador
Peça ao usuário para tentar o link de instalação novamente. Se ainda falhar, peça a um administrador para clicar no mesmo link. Se o administrador conseguir instalar, o problema é de permissões ou licenciamento específico do usuário.
Método 3: Revise as políticas de permissão de aplicativos do Teams
- Abra a central de administração do Teams
Acesse admin.teams.microsoft.com e faça login com uma conta de administrador do Teams. - Vá para Aplicativos do Teams > Políticas de configuração
Clique em Políticas de configuração no painel de navegação esquerdo. Selecione a política que se aplica ao usuário afetado, geralmente a política Global (padrão da organização). - Permita a instalação de aplicativos de terceiros
Certifique-se de que Permitir aplicativos de terceiros esteja definido como Ativado. Se estiver Desativado, altere para Ativado e clique em Salvar. - Verifique as políticas de permissão de aplicativos
Vá para Aplicativos do Teams > Políticas de permissão. Selecione a política aplicada ao usuário. Em Aplicativos da Microsoft, certifique-se de que o aplicativo do agente não esteja bloqueado. Você pode pesquisar o agente pelo nome na lista de aplicativos bloqueados. Se aparecer, remova-o. - Permita upload de aplicativos personalizados
Na mesma política de permissão, defina Permitir upload de aplicativos personalizados como Ativado. Essa configuração é necessária para agentes publicados no Copilot Studio, pois eles são tratados como aplicativos personalizados. - Aguarde a propagação da política
As alterações de política podem levar até 24 horas para serem aplicadas a todos os usuários. Peça ao usuário para aguardar 2 horas e tentar o link de instalação novamente.
Se o link de instalação ainda falhar após a correção principal
O link abre uma página em branco ou mostra um erro
Isso geralmente significa que o ID do aplicativo do agente não está registrado no catálogo de aplicativos do Teams. No Copilot Studio, vá para Configurações > Canais > Microsoft Teams e clique em Desinstalar para remover a configuração do canal. Em seguida, clique em Configurar novamente para registrar o agente. Após a reconfiguração, publique o agente e gere um novo link.
Os usuários veem uma mensagem de que o aplicativo foi bloqueado pelo administrador
O agente provavelmente está bloqueado por uma lista global de permissão/bloqueio na central de administração do Teams. Vá para Central de administração do Teams > Aplicativos do Teams > Gerenciar aplicativos. Pesquise o agente pelo nome. Se o status for Bloqueado, clique nele e selecione Permitir. Em seguida, informe aos usuários para tentarem o link novamente após 30 minutos.
O link de instalação funciona para alguns usuários, mas não para outros
Isso indica um problema de licenciamento ou grupo de segurança. Verifique se todos os usuários afetados possuem as licenças necessárias do Microsoft 365 e são membros dos grupos de segurança corretos no Microsoft Entra ID. Se o agente estiver configurado para um grupo de segurança específico, adicione os usuários ausentes a esse grupo. As alterações na associação ao grupo podem levar até 15 minutos para serem propagadas para o Teams.
Métodos de instalação do agente do Copilot Studio: link do Teams vs upload direto
| Item | Instalação via link do Teams | Upload direto na central de administração do Teams |
|---|---|---|
| Pré-requisitos | Agente publicado no canal do Teams no Copilot Studio | Arquivo de manifesto do agente baixado do Copilot Studio |
| Interação do usuário | Usuário clica em um deep link e confirma a instalação | Administrador faz upload do manifesto no catálogo de aplicativos do locatário |
| Verificações de permissão | Licença do usuário, grupo de segurança e políticas do Teams | Apenas permissões de administrador necessárias para upload |
| Tratamento de erros | Falha silenciosa se as políticas bloquearem o aplicativo | Mensagem de erro explícita se o manifesto for inválido |
| Melhor para | Instalação de autoatendimento por usuários finais | Implantação controlada por administradores de TI |
Após aplicar as etapas acima, você pode instalar agentes do Copilot Studio a partir de links do Teams sem erros. Se o problema persistir, verifique se o canal do Teams do agente está configurado e publicado, confira as licenças do usuário e a associação ao grupo de segurança e revise as políticas de permissão de aplicativos do Teams. Como dica avançada, você pode usar a análise de aplicativos da central de administração do Teams para ver por que a instalação de um usuário específico falhou, verificando os eventos de instalação do aplicativo em Central de administração do Teams > Aplicativos do Teams > Gerenciar aplicativos > [Nome do agente] > Uso.