Adicionar um chatbot ao Microsoft Teams

Importante

As capacidades e os recursos do Power Virtual Agents agora fazem parte do Microsoft Copilot Studio após investimentos significativos em IA generativa e integrações aprimoradas no Microsoft Copilot.

Alguns artigos e capturas de tela podem fazer referência ao Power Virtual Agents enquanto atualizamos a documentação e o conteúdo do treinamento.

Agora que publicou o bot, você pode disponibilizá-lo para usuários no Microsoft Teams para que você, seus colegas de equipe e a organização em geral possam interagir com ele. Você precisa publicar o bot pelo menos uma vez antes que os usuários possam interagir com o bot no Microsoft Teams.

Você pode:

• Personalizar a aparência do bot no Microsoft Teams
• Instalar o bot para você no Microsoft Teams
• Compartilhar o link de instalação do bot com outros usuários
• Mostrar o bot na loja de aplicativos do Microsoft Teams.
  • Mostre o bot aos usuários compartilhados, adicionando-o à seção Desenvolvido pelos seus colegas da loja de aplicativos do Microsoft Teams.
  • Compartilhe o bot com a organização enviando o bot para aprovação do administrador a fim de ser apresentado na seção Desenvolvido pela sua organização da loja de aplicativos do Microsoft Teams.
• Adicione o bot a um canal de equipe.
• Baixe o manifesto do aplicativo Teams pré-gerado para distribuí-lo em seu locatário do Microsoft Teams.

Quando você adiciona o bot ao Microsoft Teams, alguns de seus dados, como o conteúdo do bot e o conteúdo do chat do usuário final, são compartilhados com o Microsoft Teams. Seus dados podem ser enviados para fora da conformidade da sua conformidade da organização e limites geográficos ou regionais. Para obter mais informações, consulte a política de privacidade do aplicativo do Microsoft Teams.

Pré-requisitos

• Compartilhe com os usuários para que possam instalar e conversar com o bot no Microsoft Teams.
• Sua organização precisa permitir que os aplicativos do Microsoft Power Platform sejam adicionados ao Microsoft Teams antes que você ou outros usuários possam instalar o bot diretamente no Teams ou encontrá-lo na seção Desenvolvido pelos seus colegas na loja de aplicativos do Teams. Trabalhe com seu administrador para Gerenciar os aplicativos do Microsoft Power Platform no Microsoft Teams se ele foi desabilitado para sua organização.
• Os bots aprovados para a seção Criado por sua organização (após o envio a um administrador) são gerenciados separadamente por administradores na Página de gerenciamento de aplicativos do centro de administração do Microsoft Teams.
• Antes de instalar o bot para você mesmo ou compartilhar o bot com outras pessoas, você deverá publicá-lo pelo menos uma vez.

Conectar seu bot ao canal do Microsoft Teams

Depois de publicar seu bot pelo menos uma vez, você poderá conectá-lo ao canal do Microsoft Teams para permitir que os usuários conversem com o bot no Microsoft Teams.

Nota

Recomendamos que você ative as configurações de segurança para bots criados para o Microsoft Teams ou uso interno por funcionários para que você possa garantir que o bot não seja acessível a pessoas de fora da sua organização.

Conecte-se ao Microsoft Teams:

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Ativar Teams.

   

   Nota

   Se você não vir essa opção, então talvez o canal do Microsoft Teams já esteja ativado.

Personalizar a aparência do bot no Microsoft Teams

Fornecer a descrição e a aparência corretas para o bot antes de disponibilizá-lo para outros usuários é importante, pois os instrui sobre a finalidade do bot e sua marca, quando aplicável.

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Editar detalhes para alterar o ícone, a cor e as descrições do bot. Eles serão mostrados na loja de aplicativos do Microsoft Teams e na guia Sobre do aplicativo depois que o usuário instalar o bot. Analisar as recomendações em formatos de ícone do Microsoft Teams.

   

   Importante

   As atualizações dos detalhes do bot não se aplicam a usuários que já instalaram o bot a partir de um link compartilhado ou da seção Desenvolvido pelos seus colegas. Eles precisarão reinstalar o bot para receber as atualizações.

   Atualizações nos detalhes do bot não se aplicam a bots que foram aprovados por um administrador. Você precisará reenviar o bot para aprovação para que os detalhes mais recentes sejam atualizados para os usuários.

4. Selecione Mais para adicionar outras informações:

   • Nome do desenvolvedor

   • Site

   • Declaração de Privacidade

   • Termos de uso

     Você deve fornecer essas informações para manter seu usuário informado sobre o bot. Consulte o tópico Política de privacidade e termos de uso para obter mais detalhes e exemplos.

5. Selecione Salvar para voltar à tela onde você pode disponibilizar seu bot no Teams. Você verá que suas atualizações na cor, ícone e descrição são mostradas.

Nota

A personalização do ícone nesta seção só se aplica ao avatar do bot para bots que são aprovados pelo administrador e não se aplica a usuários que instalam o bot com um link de instalação direto ou na seção Desenvolvido pelos seus colegas da loja de aplicativos do Microsoft Teams. Você pode personalizar o avatar do bot em Personalizar a aparência do bot.

Instalar um bot como um aplicativo no Microsoft Teams

Depois de publicar um bot, você pode adicioná-lo à sua própria versão do Microsoft Teams diretamente do aplicativo do Microsoft Copilot Studio.

Importante

O novo conteúdo em um bot recém-publicado não aparecerá nas conversas em andamento. Após 30 minutos de tempo ocioso, o bot será atualizado.

Você pode digitar Start over em uma conversa existente para iniciar uma nova conversa imediatamente e ver as atualizações mais recentes do bot.

É necessário adicionar o bot à sua própria versão do Teams antes de compartilhá-lo com outras pessoas.

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Abrir bot para que o prompt de instalação seja iniciado no Microsoft Teams. Selecione Adicionar para adicioná-lo como um aplicativo no Teams. Isso só instala o bot para você.

   

Compartilhar um link para que outras pessoas possam instalar o bot

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecionar Opções de disponibilidade e selecione Link de cópia

   Importante

   Apenas os usuários que podem acessar o bot podem usar o link de instalação para instalar o bot. Você pode compartilhar o bot para dar aos usuários acesso ao chat com o bot.

   

4. Compartilhe o link copiado com os usuários para que eles possam instalar o bot no Microsoft Teams.

Mostrar o bot na loja de aplicativos do Microsoft Teams

Depois de publicar o bot, você pode mostrá-lo na loja de aplicativos do Microsoft Teams para que os usuários possam encontrá-lo e instalá-lo.

Mostrar aos usuários compartilhados

Você pode compartilhar o bot, adicionando-o à seção Desenvolvido pela sua organização>Desenvolvido pelos seus colegas da loja de aplicativos do Microsoft Teams. Apenas os usuários compartilhados encontrarão o bot lá.

Importante

Apenas usuários compartilhados podem localizar e instalar o bot na seção Desenvolvido pelos seus colegas na loja de aplicativos do Microsoft Teams. O bot não será mostrado para todos na organização, mesmo se estiver configurado para permitir que todos usem o bot. Para mostrar o bot para a organização, envie o bot para a aprovação de um administrador para mostrá-lo na seção Desenvolvido pela sua organização da loja de aplicativos do Microsoft Teams.

O bot só poderá ser mostrado na seção Desenvolvido pelos seus colegas da app store do Microsoft Teams quando o número total de usuários compartilhados não exceder a política de descoberta da app store do Teams do locatário. Para mostrar o bot além do limite da política de sua organização, faça parceria com seu administrador para mostrar o bot à organização.

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Opções de disponibilidade.

4. Selecione Mostrar aos meus colegas de equipe e usuários compartilhados e analise quem tem acesso ao bot.

   

5. Confirme se a caixa de seleção Visível em Desenvolvido pelos seus colegas está marcada e selecione Compartilhar.

   

6. Isso adicionará automaticamente o bot à seção Desenvolvido pelos seus colegas e mostrará um rótulo verde Adicionado ao Teams na página de opções de disponibilidade.

   

Nota

Se seu aplicativo não aparecer na seção Criado por seus colegas, seu aplicativo do Teams pode estar armazenando informações em cache.

Tente sair e entrar novamente (se estiver usando o aplicativo da área de trabalho) ou atualizar seu navegador (se estiver usando o aplicativo Web do Teams).

Remover o bot da seção Criado por seus colegas

Você pode remover o bot da seção Criado por seus colegas. Isso não afeta os usuários que já instalaram o bot.

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Opções de disponibilidade.

4. Selecione Mostrar aos meus colegas de equipe e usuários compartilhados e remova a seleção da caixa de seleção Visível em Desenvolvido pelos seus colegas.

   

5. Selecione Compartilhar. Agora, o bot não aparecerá mais na seção Desenvolvido pelos seus colegas da loja de aplicativos do Microsoft Teams.

Mostrar à organização

Você pode compartilhar o bot com a organização enviando o bot para aprovação do administrador a fim de ser apresentado na seção Desenvolvido pela sua organização>Desenvolvido pelos seus colegas. Esta é uma ótima maneira de distribuir amplamente o bot, fazendo parceria com o administrador para distribuir o bot a todos na organização ou a um subconjunto de usuários.

Os administradores também podem pré-instalar e fixar o bot para usuários na organização para que possam acessá-lo diretamente na barra de aplicativos no Microsoft Teams.

Antes de enviar o bot para sua organização, certifique-se de que:

• Seu bot está pronto para lançamento e em conformidade com os padrões, as regras e as políticas da empresa.
• Você coordena com outros gerenciadores de bot: uma vez que o bot foi enviado, ele não pode ser reenviado por um usuário diferente até que o envio anterior seja aprovado ou rejeitado por um administrador.
• Você removeu o bot, se aplicável, da seção Criado por seus colegas. Enviar seu bot para aprovação do administrador pode resultar em seu bot aparecer em dois lugares. Veja as instruções em como remover seu bot para obter detalhes.

Nota

Depois que um bot é aprovado por um administrador, a disponibilidade do bot na seção Criado pela sua organização será totalmente gerenciada pelo seu administrador. Apenas um administrador pode remover o bot da seção Criado pela sua organização.

Enviar para a seção Criado pela sua organização

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Opções de disponibilidade.

4. Confirme se o bot não é mostrado para colegas de equipe ou usuários compartilhados. Remova se informa Adicionado ao Teams.

5. Selecione Mostrar a todos na minha organização.

   

6. Analise os requisitos para envio e selecione Enviar para aprovação do administrador.

   Nota

   Analise o conteúdo e ele estará pronto para ser analisado por um administrador. Você precisará enviar novas solicitações ao administrador para atualizar o ícone e as descrições dos bots que foram aprovados anteriormente.

   Depois de aprovado, todos os usuários novos e existentes do bot no Teams receberão a atualização.

   Isso se aplica apenas aos detalhes do bot. Você pode continuar a fazer atualizações de conteúdo para o seu bot, publicando o conteúdo mais recente sem a necessidade de reenviá-lo ao administrador.

7. Um prompt de confirmação final aparecerá. Selecione Sim para continuar. O bot será enviado ao seu administrador para que ele o aprove e você verá uma nota indicando o status do seu envio.

   

   Nota

   Depois de enviar o bot para aprovação do administrador, você não deverá alterar a configuração de acesso do bot para que ele não seja disponibilizado para todos em sua organização.

   Isso fará com que os usuários da organização não consigam conversar com o bot depois de instalá-lo da seção Criado pela sua organização na app store do Microsoft Teams.

   Trabalhe com o administrador na política de aplicativos do Microsoft Teams sobre quem pode encontrar e instalar o bot.

8. Você precisará aguardar a aprovação do administrador. Você pode verificar o status mais recente selecionando Atualizar ou abrindo a janela Disponibilizar o bot para outros usuários da página Publicar.

9. Depois que seu administrador aprovar o bot, o status será atualizado para Aprovado. Você pode abrir o bot diretamente e compartilhar o link da versão aprovada com outros usuários.

10. Opcionalmente, faça parceria com o administrador para pré-fixar ou instalar o aplicativo para usuários na política de aplicativo do Microsoft Teams para que eles possam encontrar o bot diretamente barra de aplicativos esquerda do Microsoft Teams.

Nota

Se seu aplicativo não aparecer na seção Criado pela sua organização, mesmo se estiver marcado como Aprovado, seu aplicativo do Teams pode estar armazenando informações em cache.

Tente sair e entrar novamente (se estiver usando o aplicativo de desktop) ou atualizando o navegador (se estiver usando o aplicativo Web do Teams).

Adicionar um bot a uma equipe

No Microsoft Teams, você pode adicionar bots a equipes. Quando você adiciona os bots, os membros da equipe podem @mention o bot em qualquer canal da equipe e todos os colegas de equipe verão a resposta do bot. Esse recurso é útil para cenários em que:

• Seu bot oferece suporte à colaboração, como o compartilhamento das informações mais recentes do relatório de vendas com o restante da equipe de vendas.
• Você deseja permitir que todos os membros da equipe interajam com o bot em um canal de equipe ou por meio de chat privado sem precisar instalar manualmente o bot.

Permitir que os usuários adicionem bot a uma equipe

Essa opção permite que os usuários adicionem o bot a qualquer equipe da qual façam parte ao adicionar o bot no Microsoft Teams.

Depois de habilitar essa opção, qualquer usuário que instale o bot da loja de aplicativos do Teams ou por meio do link de instalação verá a opção de adicionar o bot a uma equipe no Microsoft Teams. Os membros da equipe também podem remover o bot de uma equipe.

Importante

O bot será configurado para permitir que todos na organização conversem com ele. Isso garante que todos os membros da equipe tenham permissão para conversar com o bot nos canais da equipe. É altamente recomendável não alterar a configuração de segurança do bot depois de habilitar esse recurso para evitar que os usuários vejam erros de permissão ao interagir com o bot nos canais da equipe.

Para permitir que os usuários adicionem um bot a uma equipe:

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Editar detalhes.

4. Selecione Permitir que os usuários adicionem este bot a uma equipe.

   

5. Selecione Salvar.

O Microsoft Teams armazena informações em cache para que possa demorar um pouco até que os usuários vejam a opção de adicionar o bot a uma equipe. Os usuários podem atualizar o navegador ou entrar e sair do cliente de desktop do Microsoft Teams para refletir as alterações imediatamente.

Se você já enviou o bot para aprovação do administrador, precisará reenviar depois da ativação dessa opção. O administrador precisa aprovar essas alterações antes que os usuários possam adicionar o bot às suas equipes da loja de aplicativos do Microsoft Teams na seção "Desenvolvido pela sua organização".

Não permitir que usuários adicionem bot a uma equipe

Desabilitar essa opção impedirá que os usuários adicionem um bot a uma nova equipe, mas não o removerá das equipes às quais já foi adicionado. Esses bots precisarão ser manualmente removidos da equipe.

Para impedir que os usuários adicionem um bot a uma equipe:

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Editar detalhes.

4. Desmarque a caixa de seleção Permitir que os usuários adicionem este bot a uma equipe.

   

5. Selecione Salvar.

Configurar o comportamento de saudação privada

As saudações privadas de um bot são úteis quando você deseja que os membros da equipe tenham conversas individuais com o bot sem precisar instalá-lo manualmente.

Observação

A configuração de saudação privada não é compatível com bots que usam a tela de criação unificada atualizada.

Quando ativado, seu bot iniciará automaticamente uma conversa com os membros da equipe. Para personalizar a mensagem de saudação do bot, modifique o tópico do sistema de saudação.

Considere a relevância do bot para os membros da equipe. Certifique-se de que a saudação do bot os ajude a entender o que fazer com ele, descreva suas limitações e, o mais importante, os deixe à vontade para interagir com ele.

Para configurar quando um bot envia uma saudação privada:

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Configurações.

   

4. Configure as opções de saudação privada.

   

5. Selecione Salvar.

Baixe o manifesto do aplicativo do Teams do bot (avançado)

Você pode baixar o manifesto do aplicativo do Teams do bot para fazer alterações detalhadas diretamente no manifesto e compartilhar com seu administrador ou usuários no locatário. Você também pode carregar diretamente o manifesto do aplicativo no Microsoft Teams se a política da sua organização permitir que você carregue aplicativos personalizados.

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Opções de disponibilidade.

4. Selecione Baixar .zip.

   

5. O manifesto será gerado como um arquivo .zip e será salvo de acordo com as configurações de salvamento do seu navegador.

Desconectar seu bot do Teams

Você pode colocar seu bot offline para que os usuários não possam mais conversar com o bot no Teams. Isso significa que o bot não responderá a ninguém que tentar conversar com ele e interromperá qualquer um que estiver usando o bot. Você deverá considerar cuidadosamente a necessidade de desconectar seu bot antes de fazer isso.

Bots não aparecem mais na seção Desenvolvido pelos seus colegas da loja de aplicativos do Microsoft Teams e não podem ser instalados a partir do link compartilhado. Os bots adicionados por usuários no Microsoft Teams continuarão a existir até que o usuário desinstale o bot.

Para bots que são aprovados por um administrador, os bots continuarão a ser exibidos na seção Desenvolvido pela sua organização da loja de aplicativos do Microsoft Teams. Você precisará entrar em contato com seu administrador para remover o bot

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Desconectar do Teams.

   

4. Analise as informações sobre como desconectar seu bot e selecione Desconectar para continuar.

Você sempre pode reconectar o bot após desconectá-lo, selecionando Ativar o Teams na janela Disponibilizar o bot para outros usuários na página Publicar.

Limitações conhecidas

• A configuração de saudação privada não é compatível para bots que usam a tela de criação unificada atualizada.
• Atualmente, apenas os escopos Pessoal e Equipe são compatíveis com o Microsoft Teams. Chat de grupo não é compatível.
• O ícone para configurar o avatar do bot na página de detalhes não será mostrado para os bots que forem aprovados por um administrador. Os bots aprovados por um administrador usarão o ícone do aplicativo com avatar de bot.
• O Teams tem limitação de fluxo para bots. Dependendo das suas necessidades de negócios, convém manter o conteúdo do bot conciso para os bots adicionados ao Microsoft Teams.
• Atualmente, se seu bot for compatível com autenticação de usuário final, o usuário não poderá sair explicitamente. Se você publicar seu bot no Painel do vendedor, ocorrerá uma falha na certificação do Microsoft Teams AppSource. Isso não se aplica ao uso pessoal ou no locatário do bot. Saiba mais em Publicar seu aplicativo do Microsoft Teams e Política de validação do AppSource.
• Desconectar seu bot do Teams pode demorar alguns minutos antes que ele se torne inacessível para usuários no Microsoft Teams.