Incluir uma oferta de SaaS com seu aplicativo Teams

Planejar a oferta de SaaS

Para obter diretrizes abrangentes, consulte como planejar uma oferta de SaaS para o marketplace comercial da Microsoft.

Ao planejar como monetizar seu aplicativo do Teams, aqui estão algumas coisas a considerar:

• Decida o modelo de assinatura. Uma oferta SsaaS transacional pode incluir vários planos de assinatura. Os planos de assinatura pública disponíveis para qualquer pessoa são mais comuns, mas você também pode querer direcionar clientes específicos com ofertas apenas para eles. Para obter mais informações, consulte planos privados no marketplace comercial da Microsoft.
• Leia sobre a opção de listagem Vender através da Microsoft para a sua oferta SaaS, que é necessária se quiser que os utilizadores comprem planos de subscrição para a sua aplicação diretamente através da Loja Teams.
• Saiba como o início de sessão único (SSO) do Microsoft Entra ajuda os seus clientes a comprar e gerir subscrições. (O SSO do Microsoft Entra é necessário para aplicações do Teams com ofertas SaaS.)
• Entenda que você é responsável pelo gerenciamento e pagamento da infraestrutura necessária para dar suporte ao uso da oferta de SaaS dos seus clientes.
• Planeje para dispositivos móveis. Para evitar violar políticas de terceiros da Loja Teams, a sua aplicação não pode incluir ligações que permitam aos utilizadores comprar planos de subscrição em dispositivos móveis. No entanto, você ainda pode indicar se seu aplicativo tem recursos que exigem um plano de assinatura. Para obter mais informações, consulte as políticas de certificação do mercado comercial relacionadas.

Integrar-se às APIs de atendimento de Saas

A integração com as APIs de atendimento de SaaS é necessária para monetizar seu aplicativo do Teams. Essas APIs ajudam você a gerenciar o ciclo de vida de um plano de assinatura após ele ser comprado por um usuário.

Para obter instruções completas e referência à API, consulte a documentação das APIs de atendimento de SaaS. Em geral, você implementará as etapas a seguir usando as APIs após uma assinatura for comprada:

1. Receba um token de identificação de compra por meio da URL para sua página inicial.

2. Use o token para recuperar detalhes da assinatura.

3. Notifique o marketplace comercial de que a assinatura está ativada.

Práticas recomendadas para implementar o gerenciamento de assinaturas

• Com as ofertas de SaaS transacionáveis para aplicativos do Teams, os planos de assinatura (licenças) devem ser atribuídos a usuários individuais, em vez de grupos ou a uma organização inteira.
• Quando os usuários receberem um plano de assinatura, notifique-os por meio de um bot Teams ou email. Na mensagem, inclua informações sobre como adicionar o aplicativo ao Teams e começar.
• Suporte a ideia de vários administradores. Em outras palavras, vários usuários na mesma organização podem comprar e gerenciar suas próprias assinaturas.

Criar uma página de aterrissagem para gerenciamento de assinaturas

Quando alguém concluir a compra de um plano de subscrição para a sua aplicação na Loja Teams, o marketplace comercial direciona-o para a sua página de destino, onde pode gerir a subscrição (por exemplo, atribuir uma licença a um utilizador específico na organização).

Para obter instruções completas, criar a página de aterrissagem para sua oferta de SaaS.

Práticas recomendadas para páginas de aterrissagem

Considere as seguintes abordagens ao criar uma página de aterrissagem para o aplicativo do Teams que você está monetizando. Veja uma página de destino de exemplo na experiência de compra do Utilizador final.

• Os utilizadores têm de conseguir iniciar sessão na sua página de destino com as mesmas credenciais do Microsoft Entra que utilizaram para comprar a subscrição. Para obter mais informações, veja Microsoft Entra ID e ofertas SaaS transacionáveis no marketplace comercial.
• Permitir que os usuários tomem as seguintes ações em sua página de aterrissagem. Não se esqueça de considerar o que é apropriado para a função e as permissões de um usuário. Por exemplo, você pode permitir que apenas administradores da assinatura pesquisem usuários):
  • Pesquisar usuários em sua organização usando email ou outra forma de identidade.
  • Consultar usuários aos que podem atribuir licenças em uma lista.
  • Atribuir licenças a um ou vários usuários ao mesmo tempo.
  • Atribuir e gerenciar diferentes tipos de licenças (se disponível).
  • Validar se uma licença já estiver atribuída a outro usuário.
  • Cancelar a assinatura.
• Forneça uma introdução sobre como usar seu aplicativo.
• Adicione maneiras de obter suporte, como perguntas frequentes, base de dados de conhecimento ou email de contato.
• Forneça um link que facilita o acesso do assinante à página de aterrissagem. Por exemplo, inclua esse link na guia Sobre do seu aplicativo.

Criar sua oferta de SaaS

Depois de integrar as APIs de atendimento de Saas e criar sua página de aterrissagem onde os usuários podem gerenciar suas assinaturas, é hora de criar, testar e publicar oficialmente sua oferta de SaaS transacionável.

Criar a oferta

Consulte criar uma oferta de SaaS para obter instruções completas sobre como fazer isso na Central de Parceiros. As etapas a seguir descrevem o que fazer em alto nível.

1. Crie uma conta na Central de Parceiros se você não tiver uma.

2. Configure os planos de assinatura, detalhes de preços e muito mais para sua oferta de SaaS transacionável. Em particular, certifique-se de concluir as seguintes etapas:

   • Em Detalhes da instalação, selecione a opção Sim para especificar que você está vendendo a oferta por meio da Microsoft.

   • Em integração do Microsoft 365, adicione o link AppSource à listagem do aplicativo. Esta etapa garante que as pessoas possam comprar seus planos de assinatura no AppSource, além do Teams.

3. Armazene seu editor e ofereça IDs. (Você precisa deles mais tarde para vincular a oferta ao seu aplicativo no Portal do Desenvolvedor.)

4. Publique sua oferta no marketplace comercial.

Testar a oferta

Recomendamos que você verifique a experiência de compra de ponta a ponta antes de publicar a sua oferta de SaaS. Você pode verificar criando uma oferta separada apenas para teste. Para obter informações completas, consulte Visão geral da oferta de teste, crie uma oferta de teste e visualize sua oferta.

Do ponto de Teams, esses testes devem verificar se o número de licenças e atribuições corresponderá ao que está no centro de administração Teams quando os usuários:

• Ativarem e configurarem o plano de assinatura na página inicial.
• Atribuírem, removerem ou reatribuírem licenças a si mesmos ou a outras pessoas.
• Cancelarem ou renovarem sua assinatura.

Publicar a oferta

Depois de concluir o teste, publique sua oferta ao vivo.

Configurar seu aplicativo para a oferta de SaaS

Publicou a sua oferta SaaS, mas ainda tem de a associar à sua aplicação Teams para que os utilizadores vejam os seus planos de subscrição na Loja Teams.

1. Vá para o Portal do Desenvolvedor e selecione Aplicativos.

2. Na página Aplicativos, selecione o aplicativo ao que você está vinculando a oferta SaaS.

3. Vá até a página Planos e preços e especifique seu editor e IDs de oferta. (Você pode encontrar essas IDs na Central de Parceiros se não as tiver prontamente disponíveis.)

4. Selecione Exibir para visualizar os planos de assinatura da oferta de SaaS.

5. Se tudo estiver correto, selecione Salvar.

   A propriedade subscriptionOffer é adicionada ao manifesto do aplicativo.

      "subscriptionOffer": {
        "offerId": "publisherId.offerId"  
        }
   

Publicar seu aplicativo

Criou a sua oferta SaaS e associou-a à sua aplicação Teams. Agora está na altura de publicar a sua aplicação na Loja Teams. Para obter instruções completas, consulte Publicar a sua aplicação na Loja Teams.

Depois de publicados, os utilizadores veem uma opção Comprar uma subscrição na caixa de diálogo de detalhes da aplicação quando tentam adicionar a sua aplicação ao Teams.

Remover uma oferta de SaaS do seu aplicativo

Se desassociar uma oferta SaaS incluída na sua listagem da Loja Teams, tem de voltar a publicar a sua aplicação para ver a alteração na Loja Teams.

1. Vá para o Portal do Desenvolvedor e selecione Aplicativos.
2. Na página Aplicativos, selecione o aplicativo de onde você está removendo a oferta.
3. Vá para a página Planos e preços e selecione Reverter.
4. Depois de a oferta estar desassociada, faça o seguinte para atualizar a listagem da Sua Loja Teams:
   1. Selecione Distribuir > Publicar na loja do Teams.
   2. Selecione Abrir a Central de Parceiros para iniciar o processo de publicação do aplicativo sem a oferta.

Exemplo de código

Confira também

• Diretrizes de validação para aplicativos vinculados à oferta de SaaS
• Marketplace comercial da Microsoft