# Пошаговая инструкция интеграции WhatsApp и других мессенджеров внутри Битрикс24
Чат-боты для Битрикс24 — отличный инструмент для автоматизации маркетинговых процессов связанных воронками продаж, роботами, бизнес-процессами, смарт-процессами. От простых ботов для обслуживания клиентов, они отличаются эффективностью: вместо пассивного общения они сами инициируют диалог при помощи настроенных автоматизаций в Битрикс24, рекомендуют в нужный момент актуальные продукты, рассказывают о новых акциях/скидках или реактивируют “спящих” клиентов, собирают обратную связь после покупок. При этом им не нужна поддержка живого оператора-консультанта, по крайней мере на первом этапе воронки.
Маркетинговых чат-ботов в Битрикс24 обычно создают так, чтобы они реагировали на события происходящие в CRM Битрикс24 и инициировали диалог тогда, когда клиент готов к взаимодействию. Это позволяет вести диалоги более естественно и сделать их похожими на обычных консультантов.
**!!! Важно! Для подключение Битрикса необходимо админские права и нужно быть залогининым в ИД и в Битриксе в одном браузере!**
## №1. Установка виджета IntellectDialog внутри Битрикс24
1. Войдите в **Bitrix24.**
2. Зайдите в пункт меню **“Маркет“.**
3\. Найдите приложение **IntellectDialog** через поиск.
После нажмите на кнопку **“Посмотреть“.**
4\. Нажмите кнопку **“Установить“** в приложении **IntellectDialog**.
5\. Подтвердите согласие с лицензионным соглашением и политикой конфиденциальности.
6\. Нажмите кнопку **“Установить“**.
Приложение “IntellectDialog“ установлено.
{% hint style="info" %}
Важно! Менять наименование **"Открытой линии"** нельзя!
{% endhint %}
7\. Дальнейшие настройки происходят внутри платформы **IntellectDialog**.
## №2. Подключение провайдера Bitrix24 в IntellectDialog
1\. Перейдите в раздел **“Провайдеры“** и нажмите кнопку **“Добавить“.**
2\. Выберите приложение **Bitrix24.**
4\. Укажите необходимые параметры:
4.1. Проверьте корректность выбора **“Наименования организации“.**
4.2. Введите **“Наименование провайдера“.**
4.3. Введите ваш домен **Bitrix24** как в примере “[b24-4swd20.bitrix24.ru](https://b24-4swd20.bitrix24.ru/)”
4.4. Домен (адрес вашего портала или коробки) можно посмотреть **в адресной строке браузера**, как на примере ниже.
5\. Нажмите кнопку **“Сохранить“**.
Провайдер **Bitrix24** подключен.
{% hint style="info" %}
*Важно! После сохранения провайдера Битрикс24 сообщения со всех подключенных каналов начинают поступать автоматически в CRM-систему*
{% endhint %}
## №3. Настройка провайдера Битрикс24 внутри IntellectDialog
### Основные настройки
| Настройка | Описание | Пример |
| ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Активен** | Включает или отключает всю интеграцию с Битрикс24 | Выключено — сообщения перестают передаваться в CRM |
| **Передавать комментарии** | Передача комментариев из мессенджеров, которые поддерживают работу с комментариями (например, Instagram\* и Facebook\*). Входящие комментарии обрабатываются и передаются в Битрикс24. *\*Instagram и Facebook — запрещённые на территории РФ социальные сети, принадлежат компании Meta, признанной экстремистской организацией* | Пользователь оставил комментарий под постом в Instagram\* → комментарий передаётся в Битрикс24 как входящее сообщение |
| **Создание диалогов в CRM при ответе клиента** | При входящем сообщении от клиента автоматически создаётся диалог в Битрикс24 | Клиент написал в WhatsApp — в Битрикс24 мгновенно появился диалог с его сообщением |
| **Дополнительные настройки. Только при создании сделки или лида** | Открывает блок дополнительных параметров для работы с лидами и контактами. Если выключено — сообщение просто передаётся без дополнительных действий | Включено: при новом обращении система создаёт лид и заполняет нужные поля. Выключено: сообщение просто попадает в чат, без создания лида |
***
### Настройка передачи пользовательских переменных
Позволяет передавать значения переменных, установленных в персоне IntellectDialog, в нужные поля лида, сделки или контакта в Битрикс24.
| Настройка | Описание | Пример |
| ------------------------------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| **Пользовательская переменная** | Переменная, заданная в персоне IntellectDialog, значение которой нужно передать в CRM | Переменная `avito_chat_url` хранит ссылку на чат с клиентом на Авито |
| **Установить в поле лида** | Поле лида в Битрикс24, в которое будет записано значение переменной | Значение `avito_chat_url` → поле лида «Ссылка на чат» |
| **Установить в поле сделки** | Поле сделки в Битрикс24, в которое будет записано значение переменной | Значение `avito_chat_url` → поле сделки «Ссылка на чат» |
| **Установить в поле контакта** | Поле контакта в Битрикс24, в которое будет записано значение переменной | Значение `avito_chat_url` → поле контакта «Источник» |
***
### Настройка передачи пользовательских метрик
Аналогично переменным, но для пользовательских метрик. Значения метрик передаются в выбранные поля лида, сделки или контакта в Битрикс24.
| Настройка | Описание | Пример |
| ------------------------------ | -------------------------------------------------------------------- | ----------------------------------------------------------- |
| **Пользовательские метрики** | Метрика, значение которой нужно передать в CRM | Метрика Andata содержит данные об источнике трафика клиента |
| **Установить в поле лида** | Поле лида в Битрикс24, в которое будет записано значение метрики | Значение метрики Andata → поле лида «UTM-метка» |
| **Установить в поле сделки** | Поле сделки в Битрикс24, в которое будет записано значение метрики | Значение метрики Andata → поле сделки «UTM-метка» |
| **Установить в поле контакта** | Поле контакта в Битрикс24, в которое будет записано значение метрики | Значение метрики Andata → поле контакта «Рекламный канал» |
***
### Служебные действия
| Действие | Описание | Пример |
| ------------------- | ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **Обновить данные** | Обновляет все данные интеграции: поля и колонки из Битрикс24 | В Битрикс24 добавили новое поле сделки «Регион» → нажали «Обновить», и оно появилось в списке доступных полей для маппинга |
| **Переподключить** | Обновляет токены авторизации для восстановления соединения с Битрикс24 | Интеграция перестала работать после истечения токена → нажали «Переподключить», и соединение восстановилось без повторной настройки |
## **№4.** Передача данных из переменных в Битрикс24
Вы можете записывать данные из ответов ваших клиентов в переменные и передавать в CRM Битрикс24. Ниже мы расскажем, как это реализовать.
{% hint style="info" %}
Внимание! Данная инструкция подойдет для всех подключенных мессенджеров (Telegram, Viber, "ВКонтакте", WhatsApp, Facebook)
{% endhint %}
1. Зайдите в подключенный провайдер **Bitrix24**.
2\. Найдите пункт **“Используется создание сделки или лида”** и включаете бегунок.
3\. После включения вам станет доступна **“Настройка передачи пользовательских переменных”**.
4\. Выберите **“Пользовательскую переменную“,** данные из которой вы хотите передавать в Битрикс24. В нашем случае это "**Телефон".**
5\. После выбора **переменной** вам необходимо указать, в **какую сущность** **Битрикс 24** вы будете передавать данные.
Вы можете передавать данные в сделку, лид или контакт.
6\. В нашем случае мы передаем **"Телефон"**, поэтому можем выбрать **"Передавать данные в контакт или лид".** Будет зависеть от того, какой режим CRM в Битрикс24 вы используете (классический или простой). Подробнее о смене режима в Битрикс24 читайте по ссылке: [Как изменить режим работы CRM?](https://helpdesk.bitrix24.ru/open/5933651/)
7\. Выбираем нужное поле в Битрикс24, где хотим передавать **"Телефон"**, и данные сопоставятся. **Система запомнит такую настройку, и вы сможете настроить следующие поля по тому же принципу.**
## №5. Настройка открытых линий в Битрикс24
### Отключение и редактирование первого сообщения, подписи в чатах Bitrix24.
1. Зайдите в ваш Bitrix24 и перейдите в раздел меню **“Контакт-центр”.**
2. Перейдите в **IntellectDialogConnector**.
3\. Выберите открытую линию и нажмите на кнопку **“Настроить“.**
4\. Перейдите в раздел меню **“Автоматические действия“** и произведите необходимые настройки.
5\. Чтобы отключить подпись имени сотрудника при ответе из чата, перейдите в раздел **“Очередь”** и произведите необходимые настройки.
### Настройка создания автоматических сделок либо лидов в Битрикс24
1. Необходимо зайти в Битркс24, найти **“Контакт-центр”**, а далее — виджет компании IntellectDialog.
2. Нажимаете на виджет компании IntellectDialog, выбираете открытые линии.
3\. Когда выберете открытую линию, нажмите **“Настроить”**.
4\. Выберите нужный вариант, если хотите отключить создание сделки или лида. В этом случае включите в выпадающем списке функцию **"Создать вручную в окне чата"**.
Так необходимо настроить каждую открытую линию. При необходимости вы сможете создавать вручную сделки или лиды в окне чата.
### Автоматическое закрытие диалогов в Битрикс24 в режиме "Открытые линии"
1. Перейдите в "**Контакт-центр"**, найдите и выберите коннектор IntellectDialog.
2. Далее выберите открытую линию, в которой вы хотите автоматически закрывать диалоги и нажмите на кнопку "**Настроить"**.
3. В открывшемся меню выберите раздел "**Автоматические действия"**.
4. Найдите настройку "**Время последней активности для автозакрытия диалога"** и укажите желаемое время последней активности.
Чтобы снова активировать диалог, нужно нажать кнопку "**Ответить"** и отправить сообщение клиенту.
После этого таймер автозакрытия перезапустится и будет каждый раз сбрасываться при активном общении. То есть диалог будет закрыт только тогда, когда с момента последнего сообщения пройдет указанное вами время.
{% hint style="info" %}
Важно! Если не написать клиенту после нажатия кнопки "**Ответить"**, то диалог не будет считаться активным — автозакрытие не произойдет
{% endhint %}
---
# 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.intellectdialog.com/crm-sistemy/bitriks24/poshagovaya-instrukciya-integracii-whatsapp-i-drugikh-messendzherov-vnutri-bitriks24.md?ask=
```
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.