Configuración de compras desde la aplicación

Las compras desde la aplicación son opciones de actualización en las que los usuarios pueden actualizar de planes gratuitos a de pago dentro de la aplicación. Microsoft Teams proporciona API para implementar compras desde la aplicación. La opción de compra desde la aplicación solo se aplica si la aplicación está habilitada con una oferta SaaS que se puede realizar en transacciones.

Los usuarios pueden comprar nuevas suscripciones de pago a través de compras desde la aplicación. Sin embargo, no pueden comprar licencias adicionales o diferentes con suscripciones de pago existentes. Para cambiar los planes, los usuarios deben cancelar primero su suscripción actual antes de adquirir un nuevo plan a través de la compra desde la aplicación.

Nota:

Las compras desde la aplicación solo se admiten en contextos de aplicaciones personales.

Implementar compras desde la aplicación

Para facilitar una experiencia de compra desde la aplicación para los usuarios de la aplicación, asegúrese de que se cumplen los siguientes requisitos previos:

• La aplicación se compila mediante la biblioteca cliente JavaScript de Microsoft Teams (TeamsJS).

• La aplicación está habilitada con una oferta SaaS negociable.

• La aplicación está habilitada con permisos de RSC.

• La aplicación se invoca con openPurchaseExperience la API.

Activación de la compra desde la aplicación

Puede activar la experiencia de compra desde la aplicación de una de las siguientes maneras:

Actualización desde el Portal para desarrolladores

1. En el Portal para desarrolladores de Teams, vaya a Permisos.
2. Habilite Mostrar ofertas de compra desde la aplicación.

Actualizar manifiesto

Para habilitar la experiencia de compra desde la aplicación, actualice el archivo de aplicación manifest.json de Teams agregando los permisos de RSC. Permite a los usuarios de la aplicación actualizar a una versión de pago de la aplicación y acceder a nuevas características. Actualice el manifiesto de la aplicación tal como se indica en el siguiente fragmento de código:

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

API de experiencia de compra

Para desencadenar la compra desde la aplicación para la aplicación, invoque la API openPurchaseExperience desde la aplicación web. El siguiente fragmento de código es un ejemplo de llamada a la API desde la aplicación de Teams compilada mediante 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>

Vea también

• Rentabilizar la aplicación
• Manifiesto de la aplicación