Using variables in your app gallery profiles

RingCentral's App Gallery is special in that it is leveraged by a wide ranging set of carriers and partners who whitelabel RingCentral's cloud platform to power their own. To help developers make the most of this huge advantage our marketplace has over others in the industry, we allow developers and marketers to customize their app profiles for each of the partners, and the markets these partners operate within.

This customization is made possible with variables that can be accessed and manipulated using a templating language powered by Handlebars. At the core of this language are the variables present inherent in every page when the page is published.

Available partner variables

App Gallery profiles can be customized on a per-partner basis by embedding a simple templating language in any text field of your App Gallery profile. At the center of this language and what you can customize centers on the template variables present when RingCentral published your profile to each of our partners' app galleries. These variables are:

These variables can be output directly by enclosing any of them in "handlebars" like so:

{{partner.full_name}}

These variables can be utilized within conditional statements as well, like so:

{{#if (eq partner.full_name "AT&T Office@Hand")}}
This text only appears on the Office@Hand App Gallery profile.
{{/if}}

We currently support the following conditional operators:

• eq or equal to
• ne or not equal to

Variables can also be manipulated using handlebar helpers. The helper below for example will change the partner's name to all uppercase.

{{uppercase partner.full_name}}

Here are list of helpers:

• lowercase
• uppercase
• replace
• replaceAll

Recipes

Create a SEO optimized profile name

We recommend that the profile name of all apps be qualified to each partner they apply to. For example, the Salesforce integration produced by RingCentral has a profile name of "{{ partner.full_name }} for Salesforce" as shown below:

When this profile is published across our partner ecosystem, the profile's title for each page reflects the partner the integration is built for:

• RingCentral for Salesforce, see example
• Avaya Cloud Office for Salesforce, see example
• Vodafone Business for Salesforce, see example
• and so forth

Create download URLs with utm tracking codes

These variables can also be used to better help you understand where traffic to your website is coming from. If for example you use utm tracking codes you can create links that track which partners visitors to your website come from.

For example, the text below when placed in your app's "Access method" field will construct a link with campaign code equal to the partner's short name.

https://www.mycompany.com/signup.html?urm_source=ringcentral&utm_campaign={{partner.short_name}}

Login URLs customized with partner's branding

Perhaps you would like to link to a login page that contains the partner's branding. RingCentral's universal login page can be passed a partner's ID to surface branding appropriate to that partner.

• RingCentral's login page
• Unify Office's login page
• AT&T's login page

Those URL's are constructed like so:

https://login.ringcentral.com/?brandId={{partner.id}}

Simple string replacement

You can perform string replacement using two different helpers.

{{replace partner.full_name '@' 'at'}}

Replace all spaces with hyphens:

{{replaceAll partner.full_name ' ' '-'}}