diff --git a/docs.json b/docs.json index 52a3a09a..3da6a127 100644 --- a/docs.json +++ b/docs.json @@ -312,6 +312,7 @@ "/integrations/integration-guides/intercom", "integrations/integration-guides/klaviyo", "/integrations/integration-guides/knowledge-base-optimization", + "/integrations/integration-guides/kommo", "/integrations/integration-guides/line", "/integrations/integration-guides/linear", "/integrations/integration-guides/linkedin", diff --git a/integrations/integration-guides/assets/icons/kommo.svg b/integrations/integration-guides/assets/icons/kommo.svg new file mode 100644 index 00000000..c7cb4c66 --- /dev/null +++ b/integrations/integration-guides/assets/icons/kommo.svg @@ -0,0 +1,33 @@ + + + + +Created by potrace 1.16, written by Peter Selinger 2001-2019 + + + + + + diff --git a/integrations/integration-guides/kommo.mdx b/integrations/integration-guides/kommo.mdx new file mode 100644 index 00000000..acdf806b --- /dev/null +++ b/integrations/integration-guides/kommo.mdx @@ -0,0 +1,73 @@ +--- +title: Kommo +description: Connect your bot to Kommo CRM using the official integration. +icon: '/integrations/integration-guides/assets/icons/kommo.svg' +tag: New +--- + +{/* vale off */} + +import integrationVersions from '/snippets/integrations/versions.mdx' +import { OpenInHub } from '/snippets/integrations/open-in-hub.jsx' +import Cards from '/snippets/integrations/cards/botpress/kommo.mdx' + + + +{/* vale on */} + +The official Kommo integration allows your bot to create and update leads, manage contacts, and search your CRM data. + +## Setup + + + Before you begin, you need: + + - A [published bot](/get-started/quick-start) + - A Kommo account with **administrator** access + - A **private integration** in your Kommo account + - A **long-lived access token** from that private integration + + + + + 1. In Botpress Studio, select **Explore Hub** in the upper-right corner. + 2. Search for the **Kommo** integration, then select **Install Integration**. + + Leave the configuration fields empty for now, you will fill them in after you create the private integration and token in Kommo. + + + 1. Log in to your Kommo account. + 2. Go to **Settings** → **Integrations marketplace**. + 3. Select **Create Integration** in the upper-right corner. + 4. Enter a name for your integration. + 5. Select **all** scopes. + 6. Save the integration. + + + 1. Open your integration’s settings in Kommo. + 2. Select **Generate long-lived token**. + 3. Choose an expiration date. + 4. Copy the long-lived token and store it securely. + + + Treat the token like a password. If it is exposed, revoke it in Kommo and generate a new one. + + + + In the Kommo integration **Configuration** page in Botpress, enter: + + - **Base Domain**: Your Kommo subdomain only (for example `mycompany.kommo.com`) + + Do not include `https://` or trailing slashes. + + - **Access Token**: The long-lived token from the previous step. + + Select **Save Configuration** and enable the integration. + + + +--- + +## Cards + +