> ## Documentation Index
> Fetch the complete documentation index at: https://aitextura.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitrix24

> Bitrix24 интегрируется с AI Textura двумя независимыми способами: как канал (источник сообщений из открытых линий) и как талант (CRM-операции через MCP). Можно подключить оба одновременно.

<Frame>
  <img src="https://mintcdn.com/aitextura/RUgF9PTnaDyK7QnO/public/screenshots/28-channel-bitrix24.png?fit=max&auto=format&n=RUgF9PTnaDyK7QnO&q=85&s=c33462cfd43fbae44713524fb5ac6e79" alt="Подключение Bitrix24 как канала" width="1440" height="900" data-path="public/screenshots/28-channel-bitrix24.png" />
</Frame>

<CardGroup cols={2}>
  <Card title="Каналы — обзор" icon="plug" href="/ru/channels">
    Что такое канал и как он работает в AI Textura
  </Card>

  <Card title="amoCRM" icon="address-book" href="/ru/channels/amocrm">
    Аналогичная CRM с разделением канал / талант
  </Card>

  <Card title="Уведомления" icon="bell" href="/ru/guides/notifications">
    Триггеры и доставка уведомлений в Bitrix24
  </Card>

  <Card title="Таланты" icon="puzzle-piece" href="/ru/guides/talents">
    Каталог MCP-инструментов и интеграций
  </Card>
</CardGroup>

## Два способа подключения Bitrix24

Bitrix24 интегрируется с AI Textura **двумя независимыми способами**. Они не заменяют друг друга и могут работать одновременно:

|                              | **Канал**                                                       | **Талант**                                                                                                |
| ---------------------------- | --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Где настраивается            | Вкладка **Канал** агента                                        | Вкладка **Таланты** агента                                                                                |
| Что делает                   | ИИ принимает и отвечает на сообщения из открытых линий Bitrix24 | ИИ выполняет действия в CRM: создаёт сделки и лиды, назначает ответственных, ставит задачи, ищет контакты |
| Технология                   | REST-вебхук для приёма сообщений                                | MCP-сервер с правами CRM/Users/Tasks/Im/Imbot/Openlines                                                   |
| Минимальные права в Bitrix24 | Открытые линии, Чат-боты, CRM, Диск, Уведомления                | CRM, Пользователи, Задачи, Чат и уведомления, Создание чат-ботов, Открытые линии                          |

<Tip>
  Чаще всего нужны **оба**: канал — чтобы ИИ слышал клиента, талант — чтобы ИИ умел квалифицировать лида и создавать сделку прямо во время разговора.
</Tip>

***

## Подключение Bitrix24 как канала

Канал — это путь, по которому сообщения из открытых линий Bitrix24 попадают к ИИ-сотруднику.

### Что даёт канал

* ИИ-сотрудник отвечает на сообщения из открытых линий Bitrix24.
* Все обращения автоматически попадают в CRM.
* Менеджеры могут подключиться к диалогу в любой момент.

### Шаг 1. Создайте вебхук в Bitrix24

<Steps>
  <Step title="Авторизуйтесь в Bitrix24">
    Войдите в свой аккаунт Bitrix24.
  </Step>

  <Step title="Перейдите к вебхукам">
    Откройте **Приложения → Разработчикам → Другое → Входящий вебхук**.
  </Step>

  <Step title="Скопируйте адрес">
    Скопируйте поле **«Вебхук для вызова REST API»**.
  </Step>
</Steps>

### Шаг 2. Подключите канал в AI Textura

<Frame>
  <img src="https://mintcdn.com/aitextura/RUgF9PTnaDyK7QnO/public/screenshots/30-channel-bitrix24-config.png?fit=max&auto=format&n=RUgF9PTnaDyK7QnO&q=85&s=a2c11b1fb93f89c0712b64eba027fac0" alt="Поле webhook URL при подключении канала Bitrix24" width="1440" height="900" data-path="public/screenshots/30-channel-bitrix24-config.png" />
</Frame>

<Steps>
  <Step title="Откройте раздел «Канал»">
    Перейдите в [ИИ-сотрудники](/ru/guides/ai-employees) → выберите сотрудника → вкладка **Канал** → подвкладка **Подключить новый**.
  </Step>

  <Step title="Выберите Bitrix24">
    В списке платформ найдите **Bitrix24** и нажмите на него.
  </Step>

  <Step title="Вставьте вебхук">
    В боковой панели выберите **Создать** и вставьте адрес вебхука в поле **WEBHOOK**.
  </Step>

  <Step title="Выдайте права в Bitrix24">
    Вернитесь в Bitrix24 и настройте права для вебхука. Необходимые разрешения для работы канала:

    * Открытые линии
    * Создание и управление чат-ботами
    * CRM
    * Диск
    * Уведомления
  </Step>

  <Step title="Сохраните">
    Нажмите **Сохранить**. Канал появится во вкладке **Подключённые**.
  </Step>
</Steps>

### Шаг 3. Настройте чат-бота в Bitrix24

После подключения канала в AI Textura нужно настроить Bitrix24:

1. Перейдите: **CRM → Интеграции → Мессенджеры**.
2. Откройте нужный чат → **Открытая линия**.
3. Включите галочку **«Назначить чат-бота ответственным»**.
4. Выберите ИИ-сотрудника → **Сохранить**.

<Tip>
  После настройки отправьте тестовое сообщение через открытую линию, чтобы убедиться, что ИИ-сотрудник получает и обрабатывает обращения.
</Tip>

***

## Подключение Bitrix24 как таланта (MCP)

Талант — это **MCP-сервер**, через который ИИ-сотрудник может выполнять действия в CRM Bitrix24: создавать сделки и лиды, искать контакты и компании, ставить задачи, **назначать ответственных**, отправлять сообщения в чаты Bitrix24.

<Frame>
  <img src="https://mintcdn.com/aitextura/RUgF9PTnaDyK7QnO/public/screenshots/15-talent-bitrix24-modal.png?fit=max&auto=format&n=RUgF9PTnaDyK7QnO&q=85&s=84718c04763a3f711c4490cded3b89a4" alt="Модал подключения таланта Bitrix24" width="1440" height="900" data-path="public/screenshots/15-talent-bitrix24-modal.png" />
</Frame>

### Два варианта подключения

При открытии модала **«Подключить Битрикс24»** во вкладке «Таланты» доступны две вкладки:

#### 1. Подключённый канал (рекомендуется)

Если у вас уже подключён **канал** Bitrix24 (см. выше) — талант может использовать его авторизацию. Это самый простой путь.

<Steps>
  <Step title="Откройте «Таланты»">
    На странице агента перейдите на вкладку **Таланты** → **Обзор приложений**.
  </Step>

  <Step title="Выберите Bitrix24">
    Найдите карточку **Bitrix24** в категории **Business Management** и нажмите на неё.
  </Step>

  <Step title="Вкладка «Подключённый канал»">
    В выпадающем списке выберите ранее подключённый канал Bitrix24.
  </Step>

  <Step title="Подтвердите подключение">
    Нажмите **Далее** — талант появится во вкладке **Подключённые**.
  </Step>
</Steps>

#### 2. Webhook (если канал не подключён)

Если канал ещё не подключён или нужны расширенные права — используйте отдельный вебхук специально для таланта.

<Frame>
  <img src="https://mintcdn.com/aitextura/RUgF9PTnaDyK7QnO/public/screenshots/16-talent-bitrix24-webhook.png?fit=max&auto=format&n=RUgF9PTnaDyK7QnO&q=85&s=ccc0e2de2e830a6838763cac3384bd8d" alt="Подключение таланта Bitrix24 через webhook с правами CRM/Users/Tasks/Im/Imbot/Openlines" width="1440" height="900" data-path="public/screenshots/16-talent-bitrix24-webhook.png" />
</Frame>

<Steps>
  <Step title="Создайте входящий вебхук в Bitrix24">
    Откройте **Приложения → Разработчикам → Другое → Входящий вебхук**.
  </Step>

  <Step title="Выдайте права для CRM-операций">
    Для работы таланта нужны более широкие права, чем для канала:

    * **CRM** (`crm`) — сделки, лиды, контакты, компании, воронки
    * **Пользователи** (`user`) — поиск ответственных
    * **Задачи** (`task`) — постановка задач
    * **Чат и уведомления** (`im`) — отправка сообщений
    * **Создание и управление Чат-ботами** (`imbot`)
    * **Открытые линии** (`imopenlines`)
  </Step>

  <Step title="Скопируйте URL вебхука">
    Скопируйте «Вебхук для вызова REST API» из Bitrix24.
  </Step>

  <Step title="Вставьте URL в AI Textura">
    Вернитесь в модал таланта Bitrix24 → вкладка **Webhook** → вставьте URL → **Подключить**.
  </Step>
</Steps>

<Warning>
  Талант Bitrix24 действует от лица того пользователя, чей вебхук подключён. Если этот пользователь имеет ограниченные права в самой Bitrix24 — талант унаследует те же ограничения.
</Warning>

***

## Назначение ответственных

После подключения **таланта** Bitrix24 ИИ-сотрудник может **самостоятельно назначать ответственных** на сделки и лиды прямо во время разговора с клиентом — например, передавать тёплый лид конкретному менеджеру по правилам или загруженности.

### Видео-инструкция

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/d8ZT_BM2K0A" title="Как назначить ответственных в Bitrix24" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

### Как это работает

<Steps>
  <Step title="Подключите талант Bitrix24">
    См. раздел «Подключение Bitrix24 как таланта (MCP)» выше — для назначения ответственных нужны права `user` и `crm`.
  </Step>

  <Step title="Опишите правила в инструкции агента">
    На вкладке **Персона** агента укажите, кому передавать лида: например, «Если клиент спрашивает про бронирование номеров — назначь ответственным менеджера Анну (ID 12)» или «При запросе на VIP-обслуживание ставь ответственным Ивана».
  </Step>

  <Step title="Проверьте на тестовом чате">
    Откройте встроенный тест-чат агента и сымитируйте обращение клиента. ИИ должен создать сделку и сразу проставить ответственного.
  </Step>
</Steps>

<Tip>
  Подсказывайте ИИ контекст: правила сегментации, ID или имена ответственных, нужно ли создавать новую сделку или искать существующую. Чем точнее формулировка в инструкции — тем стабильнее результат.
</Tip>

***

## Уведомления через Bitrix24

Помимо канала и таланта, Bitrix24 также может выступать **каналом доставки уведомлений**: триггер срабатывает, и ИИ-сотрудник присылает сообщение в чат Bitrix24 ответственному менеджеру.

### Видео-инструкция

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/9IsmdbQ7Dfc" title="Уведомления в Bitrix24" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

Подробнее о настройке триггеров и доставке уведомлений: [Уведомления](/ru/guides/notifications).

***

## Частые вопросы

<AccordionGroup>
  <Accordion title="Нужно ли подключать и канал, и талант?">
    Не обязательно, но рекомендуется. Канал отвечает за приём сообщений из открытых линий, талант — за действия в CRM. Если вам нужны только переписки без CRM-операций — хватит канала. Если нужны CRM-операции (сделки, ответственные, задачи) — нужен талант.
  </Accordion>

  <Accordion title="Можно ли использовать один вебхук для канала и таланта?">
    Технически можно, если в нём выданы все необходимые права. Но удобнее держать вебхуки раздельно: канал — с минимальными правами для открытых линий, талант — с расширенными правами на CRM, Users, Tasks.
  </Accordion>

  <Accordion title="ИИ создаёт сделки в Bitrix24 даже без таланта?">
    Нет. Без подключённого таланта Bitrix24 ИИ-сотрудник не имеет доступа к CRM-операциям. Канал передаёт только сообщения, но не создаёт сделки автоматически.
  </Accordion>

  <Accordion title="Что делать, если webhook вернул 401 / Permission denied?">
    Проверьте список прав вебхука в Bitrix24. Для таланта обязательны права `crm`, `user`, `task`, `im`, `imbot`, `imopenlines`. Для канала — `imopenlines`, `imbot`, `crm`, `disk`. Также убедитесь, что пользователь, создавший вебхук, имеет соответствующие права на разделы Bitrix24.
  </Accordion>

  <Accordion title="ИИ не отвечает в открытой линии — что проверить?">
    Убедитесь, что (1) канал активен в AI Textura; (2) в Bitrix24 на нужной открытой линии включена галочка «Назначить чат-бота ответственным»; (3) выбран именно тот ИИ-сотрудник, к которому подключён канал; (4) сотрудник «Active» и на смене (см. рабочее время).
  </Accordion>
</AccordionGroup>