> For the complete documentation index, see [llms.txt](https://docs.intellectdialog.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intellectdialog.com/crm-sistemy/retail-crm.md).

# Retail CRM

## Интеграция RetailCRMПодключение канала Retail CRM <a href="#title-text" id="title-text"></a>

Рaбота с API доступна только на платных тарифах или в режиме тестового периода.

1. Зайдите в свой аккаунт RetailCRM.
2. Перейдите в раздел **“Администрирование“.**

![](/files/3UdvN1JsYvmLE1NRzoRU)

3\. Далее перейдите в пункт меню **“Интеграции“.** Далее перейдите в пункт подменю **“Ключи доступа API“** и нажмите кнопку **“Добавить“.**<br>

![](/files/sb20EbuHMXD9WzVZAUlR)

4\. Скопируйте **“Ключ“** который далее вставьте в поле apiKey при подключении провайдера в intellectdialog.

5\. Поставьте галочку напротив **“Активность“.** Тип доступа **“Доступ к отдельным магазинам“.**

Выберите только один магазин (если нужно подключить несколько магазинов, создайте дополнительный API ключ, для каждого нового магазина) (если выберите несколько магазинов, связка работать не будет). Далее нажмите кнопку **“Сохранить“.**

![](/files/E59LKZCQyn3n5WbtyoOE)

6\. Необходимо активировать **“Чаты“** поставив галочку в подразделе **“Чаты“** напротив **“Активирована“.**

![](/files/m37mJs06ZhFenUAWn4kW)

На этом первоначальная настройка RetailCRM завершена.

### Подключение канала Retail CRM в IntellectDialog<br>

1. Зайдите в раздел **“Провайдеры”** и нажмите кнопку **“Добавить”.**
2. Выберите провайдера **“RetailCRM“.**

![](/files/0HkBZwXJOFnM9UXF8hcz)

3\. Укажите необходимые настройки (проверьте что провайдер RetailCRM доступен в вашем тарифе).

* Введите наименование провайдера (минимально 5 символов)
* Укажите domain от учетной записи RetailCRM

Пример:<br>

![](/files/OIu9angmQjYaSRF5wCm2)

* Вставьте **apiKey**, ранее созданный в RetailCRM. (apiKey, должен ссылаться только на 1 магазин)

![](/files/n88x0gvdaKdw90miiBKY)

* Нажмите кнопку **“Сохранить“**

## Синхронизация новых входящих сообщений c Retail CRM. Создание связок

После завершения интеграции Retail CRM необходимо для нужных мессенджеров **обязательно создать связки для входящих сообщений!**

#### Шаг 1. <a href="#shag-1." id="shag-1."></a>

1. Перейдите в раздел **“Связки“** и нажмите кнопку **“Добавить“.**

![](/files/p8KtE45wPmaWAfUcwTGp)

### Входящие сообщения: создание связок из подключенного аккаунта WhatsApp

* Выберите исходящий провайдер: **мессенджер, который нужно интегрировать.**
* Выберите входящий провайдер **“RetailCRM”.**
* Нажмите кнопку **“Далее“.**

![](/files/mNvCRLsLIlmxlM1sQrMN)

#### Шаг 2. Создание нового контакта в RetailCRM <a href="#shag-2." id="shag-2."></a>

1. Выберите тип связки у исходящего провайдера **“Входящие сообщения”.**

2\. Выберите тип связки у входящего провайдера **“Новый контакт”.**

3\. Нажмите кнопку **“Далее“.**

![](/files/TL5AdWqB3AhG0Al1yAJC)

4\. Откроется форма **“Редактирования связки“.**<br>

![](/files/YDLtuBVb1RFCkr15cdER)

5\. Перейдите к редактированию **“Новый контакт“.**<br>

![](/files/3zOSLTzL4t3CprEibP3w)

6\. В пункте **“Телефон контакта“** выберите **у подключенного мессенджера**  **“id отправителя“.**

![](/files/jWNYbJfAGBiQr8wMkUkx)

7\. При необходимости можно добавить в **“Источнике”** тип провайдера.

![](/files/UR17ICDUlvs39N6l5IeL)

8\. Нажмите кнопку **“Сохранить“.**

#### **Шаг 3.** Создание новой сделки в RetailCRM

* **Создание новой сделки в нашей платформе соответствует создания заказа в RetailCRM**

1. Добавьте **“Новую сделку“** или **“Новое сообщение“.**<br>

![](/files/anboiIZB11EG7EOj7Xdo)

![](/files/Vy063h1t2cX9Pgo6irE0)

![](/files/P06V0hkdMEkBtQLlJy22)

2\. Нажмите кнопку **“Сохранить“.**

3\. Перейдите к редактированию параметров **“Новая сделка“.**

![](/files/aNkDlpOqfNlsP7JR9pkN)

4\. В пункте **“Телефон контакта“** выберите параметр **“Телефон контакта”** из RetailCRM.<br>

![](/files/ZRvTAaL5Zu5bobdDRKTN)

5\. В пункте **“ID контакта“** выберите параметр **“ID контакта“** из RetailCRM.<br>

![](/files/qc0JXYNiyN0roMxFR4iE)

#### Шаг 4.  Передача входящих сообщений в RetailCRM <a href="#shag-4." id="shag-4."></a>

1. Добавьте в связку **“Новое сообщение“.**<br>

![](/files/cGzC0b7Ev9I18qH6kZnd)

![](/files/WGpwKsnxlleu53NLjgNu)

![](/files/Un3woVcvIExOXaJkNKCW)

2\. В пункте **“ID контакта“** выберите параметр **“ID контакта“** из RetailCRM.<br>

![](/files/NA9O7fcmQoIeQ4uwFGj3)

3\. В пункте **“Текст сообщения“** выберите параметр **“Текст сообщения“** из подключенного мессенджера.<br>

![](/files/WfRD5rs64PtXuUwxciYJ)

4\. Нажмите кнопку **“Сохранить“.**

5\. При необходимости измените название связки, подтверждая нажатием кнопки **“Enter”.**

6\. Запустите связку.

## Настройка RetailCRM для отправки триггеров <a href="#title-text" id="title-text"></a>

**Шаг 1.**&#x20;

1. Перейдите в раздел **“Настройки”,** нажав на шестеренку и далее выбираем подраздел **“Триггеры“**

![](/files/P6THu4bwsEhYj4rVgBm6)

2\. Далее нажмите кнопку **“Создать триггер“. Есть возможность сгруппировать триггеры по функциональности.**<br>

![](/files/WNes8C1J2sw5n7mariHE)

#### Шаг 2. <a href="#shag-2." id="shag-2."></a>

Перейдите к настройки триггеров:

1. Поставьте галочку напротив пункта **“Активность“.**

2\. Укажите название триггера: **Обработка нового заказа**

3\. Выбираем группу триггеров. Поле **«Группа»** определяет, к какой группе будет относиться созданный триггер.

5\. **Комментарий:** Можете написать подсказку, что делает триггер. Поле **«Комментарий»** выводится в списке триггеров и поможет без особых усилий определить, за что отвечает триггер и какие функции выполняет. Поле заполняется в свободной форме.

6\. В пункте “**Порядок”** ставьте от **0** до **990**. Поле **«Порядок»** определяет очередность выполнения триггеров. По умолчанию подставляется 990.

![](/files/HfB73ljJWuvNTZ4P3CVc)

#### Шаг 3. Привязка к событию. <a href="#shag-3.-privyazka-k-sobytiyu." id="shag-3.-privyazka-k-sobytiyu."></a>

1. Нажимаем на кнопку **“+событие“,** для выбора события.

![](/files/Tp0tY9Su5TM49Z0qJnEb)

2\. После выбора конкретного события нажимаем кнопку **“Добавить“.** В нашем случае **“Новый звонок“.**<br>

![](/files/XS3wLLIB8M7sZFBzNtRN)

3\. Настраиваем условия события:&#x20;

3.1. Прописываем конкретное условие.

![](/files/pW7UYf1lPL4ERxxkaB0I)

3.2. Прописываем действие по конкретному условию.

![](/files/QDoJoJqLlVaxn0Ts8NQi)

3.3. Заполняем тело HTTP - запроса.<br>

![](/files/5cL7q0FwhaBj0UiQ1C5Z)

4\. Пояснение

В пункте “**Aдрес”** вставьте следующую строку:

`https://connect.intellectdialog.com/api/retail/<id>`![](blob:https://intellectdialog.atlassian.net/c07f3095-9a50-4a25-8e6f-7affef41db38#media-blob-url=true\&id=a06479b5-5c96-407e-a344-3f8ebf9d11b0\&collection=contentId-11501576\&contextId=11501576\&mimeType=image%2Fpng\&name=image-20220330-074208.png\&size=8444\&height=173\&width=521\&alt=)<br>

![](/files/CGSBYcPAtjJSm3g1te4J)

где `<id>` это id провайдера RetailCRM в IntellectDialog.

Пример:<br>

![](/files/tiOxjWkI81rLCLA3fAsO)

5\. В пункте **“HTTP метод”** выберите параметр **“POST”.**<br>

![](/files/wWNzIyTf7kFs0La2ujXW)

6\. В пункте **“Передавать параметры”** выберите **“Указать тело запроса самостоятельно”.**<br>

![](/files/AIuIcxsQ6JsbK6xjD0DE)

7\. В пункте **“Тело запроса”** вставьте следующую строку кода:

```
type=order&status={{ changeSet.getNewValue("status").getCode() }}&id={{ order.id }}&event={% if changeSet.isCreate() %}new{% else %}status{% endif %}
```

8\. После заполнения всех полей, нажимаем кнопку **“Сохранить”.**

Запуск чат-ботов и рассылок по заказам из RetailCRM\ <a href="#title-text" id="title-text"></a>
-----------------------------------------------------------------------------------------------

#### Шаг 1. <a href="#shag-1." id="shag-1."></a>

### Просмотр доступных статусов заказов <a href="#prosmotr-dostupnykh-statusov-zakazov" id="prosmotr-dostupnykh-statusov-zakazov"></a>

1. Перейдите в раздел **“Заказы”**<br>

![](/files/PBLEDpI9nQPil6XVRxHT)

2\. Откройте **список заказов** или **создайте новый заказ.**<br>

![](/files/zbmU17DyLwyeohVdNi9V)

3\. В правом верхнем углу доступен “**Список статусов заказа”.** Список статусов заказа появляется после создания заказа.<br>

![](/files/1sqgfiDjpvK3h5djKxWl)

![](/files/gST1YT8qJQXPOtkD4Pc8)![](/files/0AtmF1OZWvOGbjNbmQgT)

#### Шаг 2. <a href="#shag-2." id="shag-2."></a>

### Создание связок по сделкам из RetailCRM с WhatsApp <a href="#sozdanie-svyazok-po-sdelkam-iz-retailcrm-s-whatsapp" id="sozdanie-svyazok-po-sdelkam-iz-retailcrm-s-whatsapp"></a>

1. Перейдите в раздел **“Связки”** и нажмите кнопку **“Добавить”.**

![](/files/wgSYq7BnAU4QOwTx3AHB)

2\. В исходящем канале выберите провайдер “**RetailCRM”.**

3\. Во входящем канале выберите провайдер “**ChatAPI”.**

4\. Нажмите кнопку **“Далее”.**

![](/files/OQB7xoXpYb3ZujTX0T5C)

5\. Далее необходимо выбрать “**Тип события”**, например “**Новая сделка”** в исходящем канале провайдера RetailCRM.

![](/files/wBiy6F33fM7N7r0Ioa8g)

6\. Во входящем канале ChatAPI по умолчанию будет выбран тип события **“Отправить сообщение”.**

![](/files/wentnePY56QmW5QnDwZ5)

7\. Откроется рабочая область для редактирования связки.

![](/files/9vxMlLYcKWRzoLhlnc08)

#### Шаг 3.  <a href="#shag-3." id="shag-3."></a>

1. Переходим к редактированию параметров исходящего события **“Новая сделка”.**

![](/files/BTd7lOLZej82eSox7UxN)

2\. Выберите необходимый статус сделки RetailCRM. Нажмите кнопку **“Сохранить”.**

![](/files/tLvdtUOHz8tZa5Ni4une)

3\. Перейдите к редактированию параметров отправки сообщения в **WhatsApp.**

![](/files/Kaw1USuVRf9nhL3NdKEe)

4\. В пункте **“Получатель”** выберите параметр RetailCRM “**Телефон контакта”.**<br>

![](/files/oDgounn0j6QhICa6gCKe)

![](/files/AWB4F1unBPqrfSwTtwEQ)

5\. В пункте **“Текст сообщения”** введите **“Текст сообщения**” подтверждая его нажатием кнопки **“Enter”**, при необходимости добавьте доступные параметры из RetailCRM, как в примере мы обращаемся по Имени.

![](/files/YVbNx5i5NptWl9vJTVpX)

6\. Нажмите кнопку **“Сохранить”.**

7\. Измените при необходимости **название Связки**, подтверждая нажатием кнопки **“Enter”.**

![](/files/enFhryWthab24ju4zpjB)

8\. Нажмите кнопку **“Запустить связку”.**<br>

![](/files/ktSPfanjyfLPAQDz0qW9)