Falhas na Publicação do Microsoft Copilot Studio para o Microsoft Teams: Correção

Você criou um copiloto personalizado no Microsoft Copilot Studio e tentou publicá-lo no Microsoft Teams. O processo de publicação falha com uma mensagem de erro, ou o copiloto nunca aparece no catálogo de aplicativos do Teams. Essa falha geralmente acontece devido a lacunas de permissão, configuração incorreta do canal ou ausência de uma atribuição de política de aplicativo do Teams. Este artigo explica as causas raiz das falhas de publicação no Teams e fornece correções passo a passo para colocar seu copiloto em funcionamento no Teams.

Por que a Publicação de um Copiloto no Teams Falha

Quando você publica um copiloto do Copilot Studio no Teams, o sistema cria um pacote de aplicativo do Teams e o envia para o catálogo de aplicativos do Teams. Três causas raiz comuns bloqueiam esse processo.

Primeiro, a conta de usuário que realiza a ação de publicação não possui as permissões necessárias. A conta deve ser um autor do Copilot Studio com a função de Environment Maker no Microsoft Power Platform. A conta também precisa da função de Administrador do Teams no Microsoft Entra ID para enviar aplicativos ao catálogo de aplicativos do Teams.

Segundo, o canal do Teams no Copilot Studio não está habilitado ou está mal configurado. Sem um canal ativo, o pipeline de publicação não consegue gerar o arquivo de manifesto do aplicativo que o Teams exige.

Terceiro, o aplicativo está bloqueado por uma política de permissão de aplicativo do Teams ou por uma política global de configuração de aplicativo. Mesmo que a publicação seja bem-sucedida no lado do Copilot Studio, o aplicativo não aparecerá para os usuários se a política o negar.

Mensagens de Erro Comuns

Os usuários veem erros como “Falha na publicação. Verifique a configuração do seu canal”, “Você não tem permissão para publicar neste canal” ou “Upload de aplicativo bloqueado pela política do locatário”. Cada erro aponta para uma das três causas raiz acima.

Passos para Corrigir a Publicação do Copilot Studio no Teams

Siga estes passos em ordem. Após cada passo, tente publicar novamente antes de passar para o próximo.

1. Verifique suas permissões de usuário
   Entre no centro de administração do Microsoft 365 com uma conta que tenha a função de Administrador Global. Vá para Usuários > Usuários ativos e selecione sua conta. Em Funções, confirme que a conta tem a função de Administrador do Teams atribuída. Se não, adicione-a. Em seguida, entre no centro de administração do Power Platform e confirme que sua conta tem a função de Environment Maker para o ambiente que contém seu copiloto. Sem ambas as funções, a publicação no Teams falhará.
2. Habilite o canal do Teams no Copilot Studio
   Abra seu copiloto no Copilot Studio. Na navegação à esquerda, selecione Configurações. Selecione Canais. Encontre Microsoft Teams na lista. Se a alternância estiver desligada, ligue-a. Se a alternância estiver ligada, mas o canal mostrar um erro, selecione Gerenciar e depois Adicionar para reinicializar a configuração do canal. Aguarde 30 segundos e teste o canal selecionando Testar no Teams. Uma mensagem de sucesso confirma que o canal está pronto.
3. Publique o copiloto
   No Copilot Studio, selecione Publicar na barra de ferramentas superior. Selecione Publicar novamente para confirmar. Aguarde a conclusão do processo de publicação. Se você vir uma mensagem de sucesso, mas o aplicativo não aparecer no Teams, prossiga para o próximo passo.
4. Permita o aplicativo no centro de administração do Teams
   Entre no centro de administração do Microsoft Teams. Vá para Aplicativos do Teams > Gerenciar aplicativos. Pesquise seu copiloto pelo nome. Se o status do aplicativo for Bloqueado, selecione o nome do aplicativo. Na página de detalhes do aplicativo, defina o Status como Permitido. Selecione Publicar para disponibilizá-lo a todos os usuários. Se o aplicativo não estiver listado, selecione Fazer upload de novo aplicativo e faça upload do pacote do aplicativo do Copilot Studio. Você pode baixar o pacote indo em Copilot Studio > Configurações > Canais > Microsoft Teams > Baixar pacote do aplicativo.
5. Adicione o aplicativo a uma política de configuração
   No centro de administração do Teams, vá para Aplicativos do Teams > Políticas de configuração. Selecione Global (padrão da organização). Em Aplicativos instalados, selecione Adicionar aplicativos. Encontre seu aplicativo copiloto e selecione Adicionar. Selecione Salvar. Essa alteração de política pode levar até 24 horas para ser aplicada, mas geralmente entra em vigor em 2 horas. Os usuários devem sair e entrar novamente no Teams para ver o aplicativo.

Se a Publicação Ainda Falhar Após a Correção Principal

Algumas falhas exigem solução de problemas adicional além dos passos principais. As seções abaixo cobrem os casos mais comuns.

Copiloto Publica, mas Não Aparece na Barra Lateral do Teams

Se a publicação for bem-sucedida, mas os usuários não conseguirem encontrar o copiloto na barra lateral esquerda do Teams, provavelmente o aplicativo não está fixado. No centro de administração do Teams, vá para Políticas de configuração e selecione a política atribuída aos seus usuários. Em Aplicativos fixados, selecione Adicionar aplicativos. Encontre seu copiloto e adicione-o. Em seguida, reordene os aplicativos fixados para posicionar o copiloto onde desejar. Salve a política e instrua os usuários a reiniciar o Teams.

Erro: “Você não tem permissão para publicar neste canal”

Esse erro aparece quando a conta não possui a função de Administrador do Teams no Microsoft Entra ID. Mesmo que você seja um autor do Copilot Studio, publicar no Teams exige a função de Administrador do Teams. Vá para o centro de administração do Microsoft 365, selecione sua conta e adicione a função de Administrador do Teams. Aguarde 15 minutos para a função se propagar e tente publicar novamente.

Erro: “Upload de aplicativo bloqueado pela política do locatário”

Os administradores do Teams podem bloquear uploads de aplicativos personalizados. No centro de administração do Teams, vá para Aplicativos do Teams > Políticas de permissão. Selecione a política aplicada aos seus usuários. Em Aplicativos da Microsoft, defina Permitir upload de aplicativos personalizados como Ativado. Selecione Salvar. Em seguida, vá para Aplicativos do Teams > Políticas de configuração e confirme que a mesma configuração não está bloqueada no nível da política de configuração.

Publicação do Copilot Studio no Teams vs. Publicação na Web: Principais Diferenças

Item	Publicar no Teams	Publicar na Web
Público-alvo	Usuários dentro do seu locatário do Microsoft 365	Qualquer pessoa com a URL pública
Autenticação	Logon único do Azure AD	Nenhuma ou autenticação manual
Ação administrativa necessária	Política de permissão de aplicativo e política de configuração	Nenhuma
Configuração do canal	Canal do Teams deve estar habilitado	Canal do site de demonstração deve estar habilitado
Descoberta pelo usuário	Aplicativo aparece no catálogo de aplicativos do Teams	Usuário deve visitar a URL pública
Conformidade de dados	Herda as configurações de conformidade do Teams	Sem controles de conformidade em nível de locatário

Publicar no Teams oferece mais segurança e gerenciamento de usuários. Publicar na web é mais rápido, mas não impõe políticas do locatário.

Agora você pode publicar um copiloto do Copilot Studio no Microsoft Teams e resolver as três causas de falha mais comuns. Comece verificando as permissões da sua conta e habilitando o canal do Teams. Se o aplicativo não aparecer após a publicação, verifique as políticas do centro de administração do Teams. Para gerenciamento avançado, use as políticas de configuração do centro de administração do Teams para fixar o copiloto na barra lateral de todos os usuários. Isso garante que seu copiloto personalizado alcance cada membro da equipe sem instalação manual.