# Как работает окно чатов в Битрикс24

### 🛠 Как установить виджет

Виджет необходимо устанавливать через [личный кабинет RadistWeb.](https://radist.online/login)

{% hint style="info" %}
Подробная инструкция [тут](https://docs.radist.online/radist.online-docs/nashi-produkty/radist-web/integracii/okno-chatov-v-b24)
{% endhint %}

После установки в левом боковом меню CRM появляется ярлык виджета. При нажатии на него на всю рабочую область CRM открывается окно чатов Radist.Online (меню остаётся на месте): 

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2Fq1v1aGmNiJ6yLgFon9ar%2FScreenshot%202025-11-24%20at%2011-57-13.png?alt=media&#x26;token=ef0d36ca-81c9-4969-825a-dc22735400a5" alt=""><figcaption></figcaption></figure>

### Как работает окно чатов в Битрикс24:

### Открытие окна чатов

#### 1. Через левое боковое меню&#x20;

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FOPet3M7rG453URMS9RHL%2F1%20-%D0%92%D0%B8%D0%B4%D0%B6%D0%B5%D1%82%20%D0%B2%20%D0%BB%D0%B5%D0%B2%D0%BE%D0%BC%20%D0%BC%D0%B5%D0%BD%D1%8E.png?alt=media&#x26;token=38d7d06c-7788-436b-b5ec-aeae0d7afd58" alt=""><figcaption></figcaption></figure>

При открытии через левое меню отображаются **все чаты (и соответствующие контакты), к которым сотрудник имеет доступ в Bitrix24** — то есть чаты тех открытых линий, участником которых он является. \
\
**Чтобы чат появился в списке чатов, сотрудник должен быть его участником в Открытой линии.**\
Это означает, что он должен:

* либо быть автоматически добавлен в чат;
* либо вручную «забрать» чат в самой Открытой линии.

**Важно:** после добавления сотрудника в чат, в нём должно появиться новое входящее сообщение от клиента — только тогда чат отобразится у сотрудника в списке (даже если чат был создан через окно чатов).

**Обратите внимание:** если виджет открыт из карточки сущности в Битриксе, то будут отображаться **все** чаты, включая те, к которым сотрудник по настройкам доступа в Битрикс не должен иметь доступ.

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FQJOsenLm1emgnY0LG9Bw%2FScreenshot%202025-11-24%20at%2012-16-50.png?alt=media&#x26;token=2e23c4a2-ef37-4b9c-bc3c-67c9d0643da8" alt=""><figcaption></figcaption></figure>

Если у контакта есть несколько чатов, а сотруднику доступен только один, то в списке будет показан только этот чат, даже если фактически у контакта чатов больше.

#### 2. Из сущностей CRM

Окно чатов можно открыть со страниц:

* лида
* сделки
* контакта
* открытой линии

Для этого используется кнопка **«Radist Online»** в меню действий **«Ещё»**.&#x20;

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2F8tlNzabyMN7TqY24uJ8d%2FScreenshot%202025-11-24%20at%2012-19-23.png?alt=media&#x26;token=846c54c9-d27b-4587-83f9-6d27ec40cd17" alt=""><figcaption></figcaption></figure>

В этом случае в окне отображаются **все чаты, связанные с сущностью**, из которой был выполнен переход. \
⚠ **Важно:** такие чаты отображаются **даже если у сотрудника в Bitrix24 на них нет прав доступа!**

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FdNFaX3IlfXgWAY0hZeV8%2FScreenshot%202025-11-24%20at%2012-22-03.png?alt=media&#x26;token=b73ada79-1a5c-43d3-b32f-dfb0e28af443" alt=""><figcaption></figcaption></figure>

#### 3. Из сделки через правое меню виджетов

Если выбрать виджет Radist.Online в списке, окно откроется в области чата сделки. Меню информации по сделке остаётся на месте (если не было свёрнуто).\
В левом верхнем углу окна чатов доступна кнопка **крестик**, чтобы закрыть окно и вернуться на предыдущую страницу.

***

### Роли сотрудников и доступы

Чтобы сотрудник мог пользоваться виджетом, при первом открытии окна чатов автоматически создаётся его профиль сотрудника в компании в **RadistWeb** по имени и почте из CRM, роль сотрудника - «**Менеджер**».&#x20;

> Подробнее узнать про права доступа и роли сотрудников можно тут: <https://docs.radist.online/radist.online-docs/nashi-produkty/radist-web/polzovateli>

#### Доступы:

* **Администратор Bitrix24** → видит *все чаты*, включая групповые.
* **Обычные сотрудники**:
  * при открытии через левое меню → видят только те чаты, к которым имеют доступ в Bitrix24 (как участники открытых линий);
  * при открытии через сущности → видят **все чаты, связанные с этой сущностью**, независимо от своих прав в Bitrix24.

{% hint style="info" %}
Чтобы настроить права сотрудников в личном кабинете RadistWeb используйте инструкцию "[Как настроить роли сотрудников](https://docs.radist.online/radist.online-docs/nashi-produkty/radist-web/polzovateli#sozdanie-kastomnykh-rolei-dlya-sotrudnikov-v-radistweb)"&#x20;
{% endhint %}

***

### Интерфейс виджета «Окно чатов»

После открытия виджета отображается страница с чатами.&#x20;

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FJFgySWc7nTlNX83wlGsd%2FScreenshot%202025-11-24%20at%2016.02.29.png?alt=media&#x26;token=dfef1332-23da-47a0-a849-68ec09766d6b" alt=""><figcaption></figcaption></figure>

**📋 Список чатов**

* В списке показаны контакты из RadistWeb.
* У каждого контакта можно раскрыть список его чатов и выбрать нужный.
* Если нажать просто на контакт, откроется последний активный чат с ним. <br>

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FOPyzG8yhluubEWmYCwyO%2FScreenshot%202025-11-24%20at%2016.03.09.png?alt=media&#x26;token=f8078a2d-ac7b-4914-9ffd-900eb72f925c" alt=""><figcaption></figcaption></figure>

**🔍 Поиск по чатам**&#x20;

* Доступен в виджете, открытом через **левое боковое меню**.
* Поиск работает по части строки (от 4 символов).
* Поддерживается поиск по:
  * имени контакта,
  * номеру телефона,
  * Telegram username.

**👥 Групповые чаты**&#x20;

* Видны **только администраторам**.
* Отображаются **только при открытии виджета через левое меню**.

**🕓 Неотвеченные сообщения**&#x20;

* В списке помечаются чаты с неотвеченными сообщениями.
* В чате можно нажать кнопку **«Не требует ответа»**, чтобы убрать пометку и снизить приоритет этого чата.

***

### Работа в чате

Вы можете:

* Отправлять и получать сообщения&#x20;

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FgEkM1O6zIEYndX6Ks5HE%2FScreenshot%202025-08-04%20at%2015-42-13.png?alt=media&#x26;token=9eb85a58-2db6-4dbc-b9e2-e4aa3464c8b0" alt=""><figcaption></figcaption></figure>
* Отправлять шаблоны (из RadistWeb)&#x20;

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FJ4c8pkd8EDJ04h7Ca5Rt%2FScreenshot%202025-11-24%20at%2016.04.24.png?alt=media&#x26;token=3ac3a98a-85cc-4868-b196-00934657c7fe" alt=""><figcaption></figcaption></figure>
* Использовать эмодзи, отправлять файлы и голосовые сообщения &#x20;

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FKtdovI6PinKp79mzHw1k%2FScreenshot%202025-11-24%20at%2016.05.08.png?alt=media&#x26;token=74d194b4-70c4-44ca-bc28-29e9f935668f" alt=""><figcaption></figcaption></figure>
* Получать корзины и просматривать их содержимое
* Смотреть изображения, видео, прослушивать голосовые прямо в чате
* Открывать превью некоторых файлов
* Работать в рамках 24-часового диалога (WABA)
* Снимать пометку «неотвеченное сообщение» кнопкой **«Не требует ответа»**

#### Ограничения

Могут быть ограничения на ввод/отправку сообщений, если:

* подписка не оплачена,
* нет оплаченных WABA-шаблонов,
* чат в чёрном списке.

#### ⚠️ Возможные уведомления и ошибки

Сообщения с ошибками подсвечиваются красным. При наведении на значок «!» отображается причина ошибки.\
В новых исходящих сообщениях отображается имя сотрудника CRM, который их отправил.

| Ситуация                                 | Сообщение                                                                           |
| ---------------------------------------- | ----------------------------------------------------------------------------------- |
| Чат уже существует и сотруднику доступен | “Такой чат уже существует. Перейдите к нему по кнопке ниже.” → кнопка **“Перейти”** |
| Чат уже существует, но доступа нет       | “Доступ к чату ограничен. Обратитесь к администратору CRM.”                         |
| Подключение не в подписке                | “Подключение не входит в активную подписку.”                                        |
| Подписка не оплачена                     | “Подписка не оплачена.”                                                             |
| Ошибка авторизации                       | “Ошибка авторизации. Попробуйте позже.”                                             |
| Неккоректная длина номера                | “Укажите корректный номер телефона.”                                                |
| Не зарегистрирован в WhatsApp            | “Пользователь не зарегистрирован в WhatsApp.”                                       |
| Контакт не найден                        | “Контакт не найден.”                                                                |

***

### Дополнительное меню чата

#### 1. Профиль контакта

Открывается:

* по нажатию на имя контакта в верхней части чата,
* или через меню «три точки» → **Профиль**. <br>

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2F3HRqTk0Yy4KDjPLgMo79%2FScreenshot%202025-11-24%20at%2012-24-10.png?alt=media&#x26;token=e7a9cace-bcfd-4952-8012-d8b2625168db" alt=""><figcaption></figcaption></figure>

В профиле отображается:

* аватар,
* имя,
* email (если есть),
* телефоны,
* данные аккаунта Telegram (user ID, username).

#### 2. **Возможность добавления чата в Черный список:**

{% hint style="danger" %}
В черный список доступен в Битрикс24 только для пользователей с правами "Администратор"
{% endhint %}

В интерфейсе чатов Битрикс24 для администраторов отображается дополнительное действие — **«Заблокировать / Разблокировать»**. Это действие доступно в списке опций чата.

* При нажатии на **«Заблокировать»** контакт добавляется в **Чёрный список** в личном кабинете RW. <br>

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2F5T0zYOB5VZPlT3ceujZk%2FScreenshot%202025-09-16%20at%2016-35-21.png?alt=media&#x26;token=2a51049b-c068-4210-8a6c-b5aa0fd97327" alt=""><figcaption></figcaption></figure>

* При нажатии на **«Разблокировать»** — удаляется из Чёрного списка. <br>

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2F6kgZSLE1dZUvD361CVL2%2FScreenshot%202025-09-16%20at%2016-37-13.png?alt=media&#x26;token=5b607921-4b9d-4363-b757-b836538a31fa" alt=""><figcaption></figcaption></figure>

После блокировки:

* Поле ввода сообщений в чате становится недоступным.
* Отправка и получение сообщений блокируется.

У пользователей без административных прав в Битрикс24 опция блокировки / разблокировки чата **не отображается**

{% hint style="info" %}
❗️ *Сообщения, которые были отправлены, пока контакт был заблокирован, не подтягиваются в чат.*
{% endhint %}

***

### Создание чата &#x20;

Теперь в окне чатов доступна возможность **создавать новые чаты** прямо из виджета.

{% hint style="warning" %}
Создание чатов возможно исключительно через открытие виджета «Окна чатов» в левом боковом меню. Через отдельные сущности, такие как сделки, контакты и прочие создание чатов невозможно.
{% endhint %}

#### 🔹 Где находится кнопка создания чата

* **Общая кнопка “+”** — рядом с полем поиска по чатам.
* **Дополнительные кнопки “Создать чат”** — под списками чатов конкретного контакта.\
  \&#xNAN;*(см. скриншот)* &#x20;

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FoCPS8WKC78eRcbrIoQkk%2FScreenshot%202025-10-13%20at%2015-47-32.png?alt=media&#x26;token=3a20d570-7f32-4d9d-8c70-ae30997986bb" alt=""><figcaption></figcaption></figure>

***

#### ⚙️ Как создать чат

1. Нажмите кнопку **“+”** или **“Создать чат”**.
2. В поле **“Подключение”** выберите нужный канал (из списка подключений вашего ЛК RadistWeb).
3. В поле **“Номер телефона”** введите номер контакта, с которым хотите начать чат.
   * Если выбрано подключение **Telegram**, можно переключиться на ввод **ID Telegram** вместо номера телефона.
4. Нажмите **“Создать чат”**.&#x20;

***

### Переход в сделки &#x20;

При открытии чата с клиентом в виджете, в верхней части окна отображается кнопка **«Выбрать сделку»**.&#x20;

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2F0yGFdtKARI85tuPgwi00%2FScreenshot%202025-11-24%20at%2012-28-39.png?alt=media&#x26;token=8c9f8804-d389-41f6-bbd9-b7604401e9d3" alt=""><figcaption></figcaption></figure>

В чате доступна кнопка **«Выбрать сделку»**, через которую отображаются:

* сделки, привязанные к контактам Bitrix24,
* контакты, связанные с профилем в RadistWeb&#x20;

Также есть кнопка **«Создать сделку»** — она открывает страницу создания новой сделки&#x20;