Loading...
Loading...
Loading...
Previous suggested step: Listings on AppFoundry
Next suggested step: AppFoundry security and data privacy
The ISV applications are third-party integrations with Genesys Cloud’s billing system. Once the ISV application adheres to all standards and is set up within the Genesys Parts Catalog, the ISV application is quoted separately from the AppFoundry Partner. The Genesys Sales and Genesys Resellers quote the ISV applications within the Genesys Quoting tool.
The ISV applications are an addition to Genesys Cloud subscriptions, where usage fees are billed with the customer’s subscription. The ISV applications are not installable or usable until the customer’s subscription is fully activated. With the AppFoundry Partner’s consent, the ISV application is offered to both the direct and indirect Genesys Cloud customers as a purchase, free trial, or both on AppFoundry.
The ISV applications offer the following different types of benefits to the AppFoundry Partners and Genesys Cloud customers:
The ISV Application AppFoundry partners on AppFoundry can allow subscription amendments (purchases and/or free trials) to a Genesys Cloud customer subscription with zero quantity commitment. To enable subscription amendment, the AppFoundry Partners must provide the following:
Genesys Cloud Embeddable Framework (GEF) applications require pre-purchase installation instructions to facilitate installation requirements within the target CRM. Some ISV client applications require setup before purchase.
Example pre-purchase installation instructions for a Genesys Cloud Embeddable Framework application are as follows:
Pre-requisites:
Pre-purchase instructions (external link)
All ISV applications require post-purchase installation instructions to facilitate a seamless purchase-to-installation experience. Before making an application available for purchase or a free trial on AppFoundry, submit the following instructions to the AppFoundry Team:
Example post-purchase or get-it-now installation instructions are as follows:
Prerequisite: Access {AppFoundry Partner Client App}
Example post-purchase installation instructions are as follows:
Prerequisites: Access {AppFoundry Partner Client App} and provide access to {AppFoundry Partner GEF App Name}
The AppFoundry partners enjoy the following benefits within Genesys Cloud, including unique product(s), permission(s), license(s), public deployment of embeddable framework implementation, branded installation card, and billing automation. Once the ISV application is approved, Genesys Cloud product management provides the following:
Each component enables enablement, billing, and/or installation automation for your ISV application.
The types of billing are as follows:
The two types of usage parts available for the ISV application AppFoundry partners are as follows:
The two types of metered parts available for the ISV application AppFoundry partners are as follows:
The mimic part available for the ISV application AppFoundry partners is as follows:
For simplicity, Genesys parts follow strict guidelines for automation from customer purchase and consumption to customer invoicing. To avoid complications and delays, the ISV AppFoundry partners must follow the following guidelines:
Genesys Cloud supports offerings that require or offer multiple parts.
A few examples of these types of offerings are as follows:
To ensure technical feasibility, effective timing of changes, and reduced risk to all parties, the AppFoundry product and parts team reviews and approves the changes to the pricing models. All pricing model changes require two or more of the following:
To discuss pricing model changes, open a Deal Service Request (DSR). To open a DSR, perform the following:
It takes 30–90 days to process, review, and move all requested pricing model changes into production.
All AppFoundry premium application vendors set the unit price and discount structure of their offerings. To change the unit price per Genesys Parts Catalog Items (SKUs), open a DSR. The request is processed within five to seven business days or sooner.
The AppFoundry partners have the following options for direct and indirect Genesys customers to purchase their applications when selling through Genesys:
Mostly, Genesys and Genesys AppFoundry offers are sold via the sales-assisted model. This model offers the following options not available on AppFoundry to Genesys sellers and resellers:
Both direct and indirect customers can take advantage of purchasing any ISV application enabled for online purchasing, including free trials. All purchases completed on AppFoundry are zero-quantity commitments, essentially month-to-month subscriptions. Items procured on AppFoundry are cancelable at any time without contractual penalty. Free trials are zero-quantity commitments with a non-billable period as stated on the purchase screen. Most ISV applications and Genesys add-ons have a one-month free trial period.
ISV Application AppFoundry partners must opt in to make their offerings available on AppFoundry for purchase or a free trial. Free trials refer to purchases of an ISV application with one month of usage unbilled. Free trials do not require any quantity commitment. You can cancel the free trials at any time in Genesys Cloud (Account Settings > Subscription) at no cost. For more information about the free trial, see free trial demonstration.
Direct Genesys Cloud customers can start a free trial of an ISV application at any point during their monthly billing cycle. The start date and end date of a free trial do not occur on the customer’s monthly billing cycle date. During the free trial period, there are no usage charges. If the customer does not cancel the subscription, AppFoundry automatically prorates the customer’s usage after the trial period completes in the second month. Proration occurs on the monthly usage price per unit (named or concurrent user).
An example proration of a free trial on a Genesys Cloud subscription is as follows:
{
"premiumApplication": "12.99",
"trialStartDate": "2019-7-19",
"trialEndDate": "2019-08-18",
"billingCycleStartDate": "2019-7-14",
"billingCycleEndDate": "2019-8-13"
}
For example, consider the date from August 19 to September 13. The second month’s usage is 25 days out of a possible 31 days. The monthly user price is prorated to ((25/31) * $12.99) = $10.48 per licensed user consumed. The usage from the third month and beyond is billed at the standard $12.99 per licensed user consumed.
AppFoundry partners can check the status of a customer’s subscription for a free trial status by a simple public API request as follows:
GET v2/billing/premiumapplistings/{appId}
Response (abbreviated)
{
"appId": "appId",
"customerName": "ABC Internal Testing Company AppFoundry Customers",
"currency": "USD",
"offerings": [
{
"partNumber": "GENERIC",
"partName": "GENERIC",
"description": "GENERIC",
"monthToMonthPrice": "17.9900",
"annualMonthToMonthPrice": "15.9900",
"annualPrepayPrice": "14.9900",
"type": "usage"
}
],
"isPartnerSale": false,
"customerBillingCycleDay": "24",
"freeTrialLength": 1,
"freeTrialLengthUnit": "month",
"subscriptionType": "PREPAY",
"isConcurrentPureCloud": false,
"isAppOnSubscription": true
}
The key fields to inspect are isAppOnSubscription == true and previousFreeTrialDate. The key fields are to be set. If previousFreeTrialDate is not set, then the customer has a sales-assisted subscription.
As mentioned earlier, a free trial is a subscription that constitutes a zero-quantity commitment to an ISV application. As a zero-quantity subscription line item, customers can cancel the subscription at any time without hassle in the Genesys Cloud (Account Settings > Subscription page). During the trial period, customers are unbilled if they cancel the free trial. Standard cancellation rules and processes apply for subscriptions with a commitment quantity.
AppFoundry is available 24/7 for self-service ISV application free trials or purchase initiation. Upon successful subscription amendment, including an ISV application, the ISV application vendor gets a notification email. A successful subscription amendment includes the following:
Genesys AppFoundry partners can raise a partner support request for any questions related to the AppFoundry partnership within the Partner Portal.
A few examples of requests are as follows:
To raise a case request or process, perform the following:
Before submitting your ISV application, review and include the following:
The AppFoundry team reviews the following items for ISV approval during the approval meeting:
The AppFoundry team provides the following items to the ISV application AppFoundry partners:
The checklist for Genesys Cloud embeddable framework submission is as follows:
After completing the checklist, submit your framework.js file to appfoundry@genesys.com. You can either include a link to the accessible source code repository or rename the extension to .txt and attach the file in the email.
Your application review fails due to the following:
A few best practices to be followed are as follows:
These best practices provide you with more control over the code deployment in the host application and keep up with API changes and new feature additions while remaining backward compatible with the deployed framework.js file.
Deployments are done at any time after the file is submitted for review. You must account for the deployment in your host application code, aided by keeping your framework file as lightweight as possible.
After the application’s initial review, update the redirect URLs in your OAuth client. For more information about deployment, see Deployment.
As Genesys values your functionality and brand, Genesys provides the style guide and resources to assist you in integrating your application into Genesys Cloud more smoothly.
The various types of templates available are as follows:
Template 1
Template 2
Template 3
Get user feedback about articles.
