# Retail CRM
## Интеграция RetailCRMПодключение канала Retail CRM
Рaбота с API доступна только на платных тарифах или в режиме тестового периода.
1. Зайдите в свой аккаунт RetailCRM.
2. Перейдите в раздел **“Администрирование“.**
3\. Далее перейдите в пункт меню **“Интеграции“.** Далее перейдите в пункт подменю **“Ключи доступа API“** и нажмите кнопку **“Добавить“.**
4\. Скопируйте **“Ключ“** который далее вставьте в поле apiKey при подключении провайдера в intellectdialog.
5\. Поставьте галочку напротив **“Активность“.** Тип доступа **“Доступ к отдельным магазинам“.**
Выберите только один магазин (если нужно подключить несколько магазинов, создайте дополнительный API ключ, для каждого нового магазина) (если выберите несколько магазинов, связка работать не будет). Далее нажмите кнопку **“Сохранить“.**
6\. Необходимо активировать **“Чаты“** поставив галочку в подразделе **“Чаты“** напротив **“Активирована“.**
На этом первоначальная настройка RetailCRM завершена.
### Подключение канала Retail CRM в IntellectDialog
1. Зайдите в раздел **“Провайдеры”** и нажмите кнопку **“Добавить”.**
2. Выберите провайдера **“RetailCRM“.**
3\. Укажите необходимые настройки (проверьте что провайдер RetailCRM доступен в вашем тарифе).
* Введите наименование провайдера (минимально 5 символов)
* Укажите domain от учетной записи RetailCRM
Пример:
* Вставьте **apiKey**, ранее созданный в RetailCRM. (apiKey, должен ссылаться только на 1 магазин)
* Нажмите кнопку **“Сохранить“**
## Синхронизация новых входящих сообщений c Retail CRM. Создание связок
После завершения интеграции Retail CRM необходимо для нужных мессенджеров **обязательно создать связки для входящих сообщений!**
#### Шаг 1.
1. Перейдите в раздел **“Связки“** и нажмите кнопку **“Добавить“.**
### Входящие сообщения: создание связок из подключенного аккаунта WhatsApp
* Выберите исходящий провайдер: **мессенджер, который нужно интегрировать.**
* Выберите входящий провайдер **“RetailCRM”.**
* Нажмите кнопку **“Далее“.**
#### Шаг 2. Создание нового контакта в RetailCRM
1. Выберите тип связки у исходящего провайдера **“Входящие сообщения”.**
2\. Выберите тип связки у входящего провайдера **“Новый контакт”.**
3\. Нажмите кнопку **“Далее“.**
4\. Откроется форма **“Редактирования связки“.**
5\. Перейдите к редактированию **“Новый контакт“.**
6\. В пункте **“Телефон контакта“** выберите **у подключенного мессенджера** **“id отправителя“.**
7\. При необходимости можно добавить в **“Источнике”** тип провайдера.
8\. Нажмите кнопку **“Сохранить“.**
#### **Шаг 3.** Создание новой сделки в RetailCRM
* **Создание новой сделки в нашей платформе соответствует создания заказа в RetailCRM**
1. Добавьте **“Новую сделку“** или **“Новое сообщение“.**
2\. Нажмите кнопку **“Сохранить“.**
3\. Перейдите к редактированию параметров **“Новая сделка“.**
4\. В пункте **“Телефон контакта“** выберите параметр **“Телефон контакта”** из RetailCRM.
5\. В пункте **“ID контакта“** выберите параметр **“ID контакта“** из RetailCRM.
#### Шаг 4. Передача входящих сообщений в RetailCRM
1. Добавьте в связку **“Новое сообщение“.**
2\. В пункте **“ID контакта“** выберите параметр **“ID контакта“** из RetailCRM.
3\. В пункте **“Текст сообщения“** выберите параметр **“Текст сообщения“** из подключенного мессенджера.
4\. Нажмите кнопку **“Сохранить“.**
5\. При необходимости измените название связки, подтверждая нажатием кнопки **“Enter”.**
6\. Запустите связку.
## Настройка RetailCRM для отправки триггеров
**Шаг 1.**
1. Перейдите в раздел **“Настройки”,** нажав на шестеренку и далее выбираем подраздел **“Триггеры“**
2\. Далее нажмите кнопку **“Создать триггер“. Есть возможность сгруппировать триггеры по функциональности.**
#### Шаг 2.
Перейдите к настройки триггеров:
1. Поставьте галочку напротив пункта **“Активность“.**
2\. Укажите название триггера: **Обработка нового заказа**
3\. Выбираем группу триггеров. Поле **«Группа»** определяет, к какой группе будет относиться созданный триггер.
5\. **Комментарий:** Можете написать подсказку, что делает триггер. Поле **«Комментарий»** выводится в списке триггеров и поможет без особых усилий определить, за что отвечает триггер и какие функции выполняет. Поле заполняется в свободной форме.
6\. В пункте “**Порядок”** ставьте от **0** до **990**. Поле **«Порядок»** определяет очередность выполнения триггеров. По умолчанию подставляется 990.
#### Шаг 3. Привязка к событию.
1. Нажимаем на кнопку **“+событие“,** для выбора события.
2\. После выбора конкретного события нажимаем кнопку **“Добавить“.** В нашем случае **“Новый звонок“.**
3\. Настраиваем условия события:
3.1. Прописываем конкретное условие.
3.2. Прописываем действие по конкретному условию.
3.3. Заполняем тело HTTP - запроса.
4\. Пояснение
В пункте “**Aдрес”** вставьте следующую строку:
`https://connect.intellectdialog.com/api/retail/`
где `` это id провайдера RetailCRM в IntellectDialog.
Пример:
5\. В пункте **“HTTP метод”** выберите параметр **“POST”.**
6\. В пункте **“Передавать параметры”** выберите **“Указать тело запроса самостоятельно”.**
7\. В пункте **“Тело запроса”** вставьте следующую строку кода:
```
type=order&status={{ changeSet.getNewValue("status").getCode() }}&id={{ order.id }}&event={% if changeSet.isCreate() %}new{% else %}status{% endif %}
```
8\. После заполнения всех полей, нажимаем кнопку **“Сохранить”.**
Запуск чат-ботов и рассылок по заказам из RetailCRM\
-----------------------------------------------------------------------------------------------
#### Шаг 1.
### Просмотр доступных статусов заказов
1. Перейдите в раздел **“Заказы”**
2\. Откройте **список заказов** или **создайте новый заказ.**
3\. В правом верхнем углу доступен “**Список статусов заказа”.** Список статусов заказа появляется после создания заказа.
#### Шаг 2.
### Создание связок по сделкам из RetailCRM с WhatsApp
1. Перейдите в раздел **“Связки”** и нажмите кнопку **“Добавить”.**
2\. В исходящем канале выберите провайдер “**RetailCRM”.**
3\. Во входящем канале выберите провайдер “**ChatAPI”.**
4\. Нажмите кнопку **“Далее”.**
5\. Далее необходимо выбрать “**Тип события”**, например “**Новая сделка”** в исходящем канале провайдера RetailCRM.
6\. Во входящем канале ChatAPI по умолчанию будет выбран тип события **“Отправить сообщение”.**
7\. Откроется рабочая область для редактирования связки.
#### Шаг 3.
1. Переходим к редактированию параметров исходящего события **“Новая сделка”.**
2\. Выберите необходимый статус сделки RetailCRM. Нажмите кнопку **“Сохранить”.**
3\. Перейдите к редактированию параметров отправки сообщения в **WhatsApp.**
4\. В пункте **“Получатель”** выберите параметр RetailCRM “**Телефон контакта”.**
5\. В пункте **“Текст сообщения”** введите **“Текст сообщения**” подтверждая его нажатием кнопки **“Enter”**, при необходимости добавьте доступные параметры из RetailCRM, как в примере мы обращаемся по Имени.
6\. Нажмите кнопку **“Сохранить”.**
7\. Измените при необходимости **название Связки**, подтверждая нажатием кнопки **“Enter”.**
8\. Нажмите кнопку **“Запустить связку”.**
