> For the complete documentation index, see [llms.txt](https://docs.aiokk.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aiokk.io/en/settings/datasource/compatible-data-sources/crm-systems/bitrix24.md).

# Bitrix24

## Requirements for Integration with Bitrix24

To ensure a successful connection, the **following requirements must be met**:

1. To integrate aiokk with Bitrix24, you need an **active Bitrix24 portal**. Whether it’s cloud-based or self-hosted, it doesn’t matter.
   1. **Don’t have a Bitrix24 account yet?** Fix this by [**registering your own cloud-based Bitrix24**](https://www.bitrix24.kz/create.php?p=8068335\&utm_source=aiokk_gitbook). If you prefer the self-hosted version, the MASNAGET Digital Studio team can assist you. Just [**submit a request**](https://masnaget.digital/bitrix24.html?utm_source=aiokk.gitbook) on our website!
   2. **For self-hosted Bitrix24 users:** Ensure you have an active subscription. Confirm that your portal has internet access and is not operating within a closed network.
2. **Necessary permissions:** You must have the right to install applications from the Bitrix24 Marketplace.
3. **aiokk account:** You must have a registered aiokk account. If you don’t have one yet, create an account following the instructions 👇

{% content-ref url="/pages/bORzNWxNHJ2FTsIBfe3S" %}
[Signing up and onboarding](/en/lets-start/signing-up-and-onboarding.md)
{% endcontent-ref %}

## Steps for Installing the Application

<figure><img src="/files/m3uld23V1uOjasilyuiB" alt=""><figcaption><p>Cloud-Based Bitrix24 Connection establishing guide</p></figcaption></figure>

{% stepper %}
{% step %}

### Select “Bitrix24” as a Data Source

1. Navigate to **Settings → Data Source**.
2. Select **Bitrix24** from the available sources.
3. Enter your **existing Bitrix24 domain** in the appropriate field.
   1. **For Cloud-Based Bitrix24 Portals:** Click the “**Check Connection**” button, then click “**Establish Connection**”.
   2. **For Self-Hosted Bitrix24 Portals:** You will need to additionally specify the **licensing country of your portal.** This ensures that we direct you to the **correct regional page** for our application in the Bitrix24 Marketplace.

      <figure><img src="/files/e0ZExwux5GJT8b0Feuez" alt=""><figcaption><p>Self-Hosted Bitrix24 Connection establishing guide</p></figcaption></figure>

{% endstep %}

{% step %}

### Install the aiokk Application from the Bitrix24 Marketplace

1. We will verify your Bitrix24 domain and **open** the portal in the current browser window.
2. If required, **log in** to the portal. If you’re already logged in, the aiokk application page in the Bitrix24 Marketplace will open directly.
3. On the aiokk application page, click “**Install**”, review and accept the terms and conditions, and click “**Install**” again.

<figure><img src="/files/45VKVwKLggBolVBIW2gT" alt=""><figcaption></figcaption></figure>

4. **Open the aiokk Application:** After installation, click “**Open**” in the installation window or refresh the page and access it from the left menu.
   {% endstep %}

{% step %}

### Establish Connection with Your aiokk Account

1. Open the application after installation and wait for it to fully load.
2. If the application has been installed correctly and the connection with your aiokk account is established, you will see the connection status and your login in the bottom left corner.

<figure><img src="/files/L2YOdA3FxLHJLq9dWZS5" alt=""><figcaption></figcaption></figure>

3. Great! The data source is connected. Return to your account in our service and continue the setup.
   {% endstep %}
   {% endstepper %}