Configurar compras via aplicação

As compras via aplicação são opções de atualização onde os utilizadores podem atualizar de planos gratuitos para pagos na sua aplicação. O Microsoft Teams fornece APIs para implementar compras via aplicação. A opção de compra na aplicação só é aplicável se a aplicação estiver ativada com uma oferta SaaS transacionável.

Os utilizadores podem comprar novas subscrições pagas através de compras via aplicação. No entanto, não podem comprar licenças adicionais ou diferentes com subscrições pagas existentes. Para alterar os planos, os utilizadores têm primeiro de cancelar a subscrição atual antes de adquirirem um novo plano através da compra na aplicação.

Observação

As compras via aplicação são suportadas apenas em contextos de aplicações pessoais.

Implementar compras no aplicativo

Para facilitar uma experiência de compra na aplicação para os utilizadores da sua aplicação, certifique-se de que são cumpridos os seguintes pré-requisitos:

• A aplicação é criada com a biblioteca de cliente JavaScript (TeamsJS) do Microsoft Teams.

• A aplicação está ativada com uma oferta SaaS transacionável.

• A aplicação está ativada com permissões RSC.

• A aplicação é invocada com openPurchaseExperience a API.

Ativar a compra na aplicação

Pode ativar a experiência de compra na aplicação através de uma das seguintes formas:

Atualizar a partir do Portal do Programador

1. No Portal do Programador do Teams, aceda a Permissões.
2. Ativar Mostrar ofertas de compra via aplicação.

Atualizar manifesto

Para ativar a experiência de compra na aplicação, atualize o ficheiro da aplicação manifest.json Teams ao adicionar as permissões RSC. Permite que os utilizadores da sua aplicação atualizem para uma versão paga da sua aplicação e acedam a novas funcionalidades. Atualize o manifesto da aplicação conforme indicado no seguinte fragmento de código:

    
    "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. O fragmento de código seguinte é um exemplo de chamada à API a partir da aplicação Teams criada com o TeamsJS:

TeamsJS V2

<div>
<div class="sectionTitle">openPurchaseExperience</div>
<button onclick="openPurchaseExperience()">openPurchaseExperience</button>
</div>
</body>
<script>
    function openPurchaseExperience() {
      micorosftTeams.app.initialize();
      var planInfo = {
          planId: "<Plan id>", // Plan Id of the published SAAS Offer
          term: "<Plan Term>" // Term of the plan.
      }
      monetization.openPurchaseExperience(planInfo);
    }
</script>

TeamsJS v1

<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");
            console.log(e);
            if (!!e && typeof e !== "string") {
                  alert(JSON.stringify(e));
              }
              return;
            });
      console.log("after callback: ",callbackcalled);
    }
</script>

Confira também

• Monetize seu aplicativo
• Manifesto do aplicativo