# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aiokk.io/en/settings/datasource/compatible-data-sources/crm-systems/bitrix24.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.