Compras no aplicativo

Artigo
06/30/2022
2 minutos para o fim da leitura

O Microsoft Teams fornece APIs que você pode usar para implementar as compras no aplicativo para atualizar de aplicativos gratuitos para aplicativos pagos do Teams. A compra no aplicativo permite converter usuários de planos gratuitos para pagos diretamente de seu aplicativo.

Implementar compras no aplicativo

Para oferecer uma experiência de compra no aplicativo aos usuários do seu aplicativo, verifique o seguinte:

O aplicativo é construído na biblioteca do SDK do cliente do Teams.
O aplicativo está habilitado com uma oferta SaaS transacionável.
O aplicativo está habilitado com permissões RSC.
O aplicativo é invocado com a openPurchaseExperience API.

A experiência de compra no aplicativo pode ser habilitada atualizando o arquivo manifest.json ou habilitando Mostrar ofertas de compra no aplicativo na seção Permissões do Portal do desenvolvedor.

Atualizar manifesto

Para habilitar a experiência de compra no aplicativo, atualize o arquivo manifest.json do aplicativo Teams adicionando as permissões RSC. Ele permite que os usuários do seu aplicativo atualizem para uma versão paga do seu aplicativo e comecem a usar novas funcionalidades. A atualização para o manifesto do aplicativo é a seguinte:


"authorization": {
    "permissions": {
        "resourceSpecific": [
            {
                "name": "InAppPurchase.Allow.User",
                "type": "Delegated"
            }
        ]
    }
}

API de experiência de compra

Para acionar a compra no aplicativo para o aplicativo, invoque a API openPurchaseExperience do seu aplicativo da web.

Veja a seguir um exemplo de como chamar a API do aplicativo:

<body> 
<div> 
<div class="sectionTitle">openPurchaseExperience</div> 
<button onclick="openPurchaseExperience()">openPurchaseExperience</button> 
</div> 
</body> 
<script> 
   function openPurchaseExperience() {
      microsoftTeams.initialize();
      let callbackcalled = false;
      microsoftTeams.monetization.openPurchaseExperience((e) => {
      console.log("callback is being called");
      callbackcalled = true;  
      if (!!e && typeof e !== "string") {
            e = JSON.stringify(e);
            alert(e);
        }
        return;
      });
      console.log("after callback: ",callbackcalled);
    } 
</script>

Experiência de compra no aplicativo do usuário final

O exemplo a seguir mostra os usuários comprarem planos de assinatura para um aplicativo fictício do Teams chamado Tarefas da Contoso para Teams:

Na Repositório do Teams, localize e selecione o aplicativo.
Na caixa de diálogo de detalhes do aplicativo, selecione Comprar uma assinatura ou Adicionar para mim.
Adicionar para mim oferece uma versão de avaliação gratuita do aplicativo e, posteriormente, Atualizá-lo para uma versão paga.
Na caixa de diálogo Escolher um plano de assinatura, escolha o plano e selecione Checkout.
Conclua a transação e selecione Configurar agora para configurar sua assinatura.

Próxima etapa

Teste de visualização para aplicativos monetizados