Getting started
If you are developing an integration that can be useful for all Kommo users, we’ll be glad to publish it on our marketplace. Integrations of this type have to pass our moderation process when publishing. For this kind of integration, technical support is provided through a dedicated communication channel with the Kommo Marketplace team.
If you are developing a marketplace integration, then you should do that under the technical account and it should pass our moderation in order fo us to be able to provide support and save our clients data and rights.
In this article you will also see
The development of a marketplace integration
Send an integration to moderation
Technical account
Developing a marketplace integration will require a new unpaid account, which we call a technical account.
To get one, start by registering a new Kommo account. Then go to
Chats > Mentions & team chats > Chat with support
and send us a message that says, “I need to chat with the integration department to create a technical account”.
Technical accounts are free. All questions related to the development and moderation of public integration should be directed to support from this technical account.
Any administrator of the technical account in which the integration was created will be able to modify it.
Such an account is intended only for developing and testing the widget, and not for running your business.
For each marketplace integration, we provide a separate technical account.
Capabilites
Marketplace integrations must always have a widget which can work with the following capabilities
| Capability | Description |
| Kommo API | The ability to manipulate and generate data in Kommo including account, users, leads, contacts, tasks, etc. |
| JS SDK | Set of functions and objects that facilitate accessing the environment (information about the widget, the authorized user, etc.), as well as for calling some interface elements. |
| Salesbot | A tool for creating custom scenarios to automate operations with a user via messengers. |
| Digital pipeline | A powerfull automation tool that allows you to set up reactions to different events such as incoming emails, calls or messages, lead stage change or website visit |
| Chat API | The ability to create integration with different messengers and enable Kommo users to send and recieve messages through it |
| VoIP API | Set of API and JS methods that are useful to connect telephony services with Kommo. |
The development of a marketplace integration
The first step is to go to Settings, Integrations of the account, in which you will support the integration in the future.
Settings > Integrations > Create Integration > Marketplace
In a technical account, when creating a marketplace integration, you will notice that the integration interfaces are more complex. You will have more ability for versioning, multilingualism, etc.
You can choose your language from the provided languages and expand your integration reach by providing more languages.
After saving the first form, you will have the ability to update the entered information, and you should upload the widget archive.
Then you have to fill in the integration information for all the languages you have chosen.
And when going to the Keys tab in the Widget window, can see all the Authorization code which you can use in the authorization process, Secret key and Integration ID will be used independently from the account in which it will be installed.
You also can see a tab called “My submissions” at the top of the integrations section, in which you can see the marketplace integration you have created.
Send to moderation
If you are creating a marketplace integration; you can see the version part when creating/editing the integration. You can Request review of the integration from here.
Pass the moderation
Widget moderation by the Kommo Marketplace team takes 1-2 working days. The widget should pass the code auditing first, then the functional test.
In return of the code auditing, the Kommo Marketplace team will send you either a notification informing you about passing the code auditing successfully, or a list of the problems specifying why your integration failed to pass the audit.
Here is an example of rejecting the widget
And this is an example of the list of problems sent by the Kommo marketplace team
After passing the code audit, the widget goes to the functional testing. The main task is to prevent breakage of Kommo functionality!
To facilate and speed up the moderation process, you must provide a a correct description of the setup and operation of the integration. If errors occur during the testing process or the functionality does not work, then Kommo Marketplace team will describe all the errors and send them to you.
After passing all moderation points, Kommo intgeration department approves your integration, and then you will be allowed to publish it. By clicking the publish button, the widget will be published in the marketplace.
If you think your integration should be personal, move to the development of a personal integration.
Now, it’s time to see the moderation checklist.