App Review process
The goal of the LiveChat Marketplace is to provide trusted space for high quality LiveChat apps, plugins, and integrations.
With over 32,000 businesses using LiveChat daily, we want to make sure that what we offer in the Marketplace, provides our customers with tangible value and enriches their LiveChat experience. For that reason, all apps in the LiveChat Marketplace must meet our criteria for quality and content.
The decision to feature your app on the LiveChat Marketplace depends mainly on technical requirements, but not only. We also assess how your app contributes to the LiveChat ecosystem and community. This document covers most cases, however, some exceptions may be allowed at the reviewer’s discretion.
As a developer, you need to know how we go about reviewing apps and how to make your app go through the process with success.
Each app is thoroughly checked before releasing it to the LiveChat Marketplace. It involves a team of three or more specialists. Since we aim to offer top-quality products, we've prepared the list of responsibilites for developers and app owners. We highly encourage you to familiarize yourself with all the aspects.
First things first, we don’t accept apps that offend other people. That includes: violence, threats, bullying, harassment, sexually explicit content, discrimination based on nationality, race, ethnic origin, gender identity, sexual orientation, age, disability, or religion. Any other forms of attack or discrimination, which are not present on the list, will be also forbidden.
The reviewer makes the final decision on whether an app violates the ethical norms.
To learn about terms and regulations, see Developers Terms.
Before you submit the app, test it meticulousy to ensure it’s usable and bug-free. Make sure it looks and performs well on desktop, tablet, and smartphone for the best cross-platform experience.
Keep your code human-readable, clean, and optimized. Respect the generally accepted standards. Remember about the cleanup - remove all unused assets, references, etc.
App details and Listing details are sections in Developer Console you should never forget about. It's where you can make your integration shine, exposing its features and benefits. Filling out this section is crucial for the promotion of your app on the LiveChat Marketplace. This is why you cannot skip it - it's always mandatory.
The most important fields are:
Make your app name descriptive, yet snappy and easy to remember. Keep the name below 30 characters, otherwise it will be truncated. The name should be properly capitalized and use only English characters. Don't include app description in the title - there's plenty of space for that in other fields.
If you want to use the word "LiveChat" in your app name, the only acceptable way to do this is "App Name for LiveChat". "LiveChat App Name" will be rejected.
Let's use an example from the App ideas section in Developer Console.
Acceptable name: Agent Alert for LiveChat
Not acceptable name: LiveChat Agent Alert
Or, you could simply go with Agent Alert.
Based on the app descriptions you provide, potential users we'll be able to find your app and decide if it matches their needs. You need to include short and long descriptions. They should be accurate and up to date. The recommended length is one sentence for a short description and not more than 10 sentences for the long one.
Both descriptions must be written in English, but if you offer the app in another language, feel free to add a translated version as well.
Apart from descriptions, remember to add at least one feature and one benefit.
Most of us are visualizers. We're tempted by images, videos, or animations. That's why you should include 3 - 5 screenshots presenting the most important features of your app. And not just some screenshots. Give them extra care, it will pay off.
The screenshots should be crisp and clear, accurately picturing the functionalities of your app. The maximum file size can’t exceed 1 MB.
A good icon helps your app stand out. Design something original, unique. Something that represents your app or even your entire brand. Make the logo crisp and readable. The icons should have full-bleed background, and their size should be at least 240 x 240 px.
Using the LiveChat logo, its derivatives or fragments in your icon is not allowed.
In our example, Agent Alert, we used the icon generator available in Developer Console. However, it's always better if a logo conveys more meaning regarding the app it represents.
As soon as your app is ready, prepare a guide for it. Remember, you know your product backwards and forwards, but your customers don't. Make sure their first experience of your application isn't frustrating or discouraging. A good first impression may tip the balance in your favor when the trial period ends.
If your application has some sort of settings, the best way to present them from the UX perspective is in Settings > Integrations & apps in the LiveChat Agent Application. This is where users intuitively look for the settings of the integrations they have installed.
In order for your app settings to appear in the Settings section of the Agent App, you need to:
- Add a new widget with the App Settings placement.
- Enter the URL of your app settings in the Widget source URL field. We'll display in the Agent Application in an iframe.
Before you submit the app for review, ensure you meet the following requirements:
You've added at least one Building block.
You accept the Marketplace Terms.
You can provide a valid reason for using specific authorization scopes in your app (if asked by us).
You can provide us with the testing instructions for the app.
You've got your demo testing environment ready.
You can provide the main use case of the app.
You're capable of providing support during and after the App Review process, both for the reviewer and app users.
Make sure that users know how to get started with the app, how to use it, and are never left on their own.
If your application requires from users some more advanced configuration, provide a link to a guide or manual. It should be written in English and contain all necessary instructions. Keep in mind that not all customers are tech savvies, so consider combining text and visuals materials in the instruction.
Always keep the contact details in your profile up to date, and check your email regularly.
Developers have constant access to the current status of the app in Developer Console > App > Monitor > Overview.
Developing - Your app is in development. As a developer, you're able to work on the app and make change it.
Submitted - The app has been submitted for review. You can no longer change the app unless you decide to cancel the submission.
Accepted - The app has been accepted. You can now publish the app on the LiveChat Marketplace.
Published - The app has been published to the Marketplace. You can cancel the publication and we will take down your app from the LiveChat Marketplace. If you want to change your app, you need to fork it, and then submit it a new version for the App Review process once again.
We are constantly improving the App Review process so that the cooperation is smooth for both parts. For that purpose, we have prepared a few guidelines and rules to make things go easier.
Once we find 3 bugs or issues in your app, we discontinue the review and reject the app. We will share with you the reason of rejection via email.
Every app should have a tutorial that covers its basic usage and explains all its features. As an example, see how the ChatBot integration is described.
We recommend using our Design System to keep apps consistent with the LiveChat look & feel.See Design System
Before you submit the app for review, make sure you tackled the following issues:
1. Testing the give consent step
It's easy to forget about testing the give consent step. Since you're the app owner, the app never asks you for access.
prompt=consent parameter to test how this step looks from the user's perspective.
2. Providing testing credentials
Usually, you need to provide us with some credentials so we can test your app. If your app integrates LiveChat with different software, provide us with credentials for the latter. To speed up the review process, remember to include the credentials when you submit the app.
3. Following the LiveChat Design System
It's best if your app follows the LiveChat look & feel. To ensure it does, make use of the visual guidelines specified in our Design System. It opens the door to possible promotion on our Marketplace, for example via campaigns. It's particularly important for integrations located in the message box or in the Details section. We allow for adopting your brand's design, but it should be in harmony with ours. If the style of your app is too incompatible, we might refuse to promote the app on the LiveChat Marketplace or reject the app submission completely.
4. Testing your integration on LiveChat mobile
Make sure to test your integration on the LiveChat mobile app. If your integration makes use of Accounts SDK for authorization, ensure the SDK version is 2.0.1 or higher. Otherwise, your integration won't work with the LiveChat mobile app. In that case, consider migrating to the latest version of Accounts SDK.
If you found a bug or a typo, you can let us know directly on GitHub. In case of any questions or feedback, don't hesitate to contact us at firstname.lastname@example.org. We'll be more than glad to hear from you!