Для использования интеграции необходимы аккаунты в обоих сервисах — Ringostat и retailCRM.
Настройка полей в личном кабинете Ringostat.
Для настройки полей интеграции в личном кабинете Ringostat данные берем из retailCRM. А именно:
1. Portal address — адрес портала в retailCRM.
2. Email пользователя — email администратора портала retailCRM.
3. Текстовый код магазина — код магазина из retailCRM для интеграции. Находится в разделе "Администрирование" —>"Магазины".
4. Secret Key — ключ доступа к интеграции по API с retailCRM. Находится в разделе "Администрирование" —> "Интеграции" —> "Ключ доступа к API".
Для корректной работы интеграции нужно, чтобы у API-ключа были доступы к таким методам:
/api/users/{id}
/api/users
/api/users/{id}/status
/api/user-groups
/api/telephony/manager
/api/customers
/api/customers/{externalId}
/api/customers/create
/api/customers/{externalId}/edit
/api/orders
/api/orders/create
/api/tasks
/api/tasks/create
/api/reference/status-groups
/api/integration-modules/{code}
/api/integration-modules/{code}/edit
Нужно внести эти данные в настройки проекта Ringostat ("Интеграции"—>Готовые интеграции —> "retailCRM") и активировать интеграцию.
После успешной активации интеграции, интеграция “Ringostat” будет отображаться в общем списке интеграций retailCRM (в низу страницы "Администрирование" —> "Интеграции" —> "Маркетплейс").
Настройка сотрудников в retailCRM.
Для того, что бы сотрудники из retailCRM были доступны для настройки интеграции — необходимо добавить сотрудника в разделе "Администрирование" —> "Пользователи", и обязательно установить для сотрудника группу “Менеджеры” и пункт “Активирована”.
Создание сотрудников в ЛК Ringostat описано в этой статье.
После настройки сотрудников их необходимо связать с соответствующими сотрудниками retailCRM.
Для этого переходим в раздел "Интеграции" —> "retailCRM" и связываем сотрудников, после этого сохраняем настройки. При этом выбираем одного из менеджеров и назначаем его “Старшим менеджером”.
После настройки и связки сотрудников, чтобы в клиентах / заказах были видны UTM метки перехода, следует зайти в настройку отображаемых полей и выбрать специальные поля для передачи UTM меток Ringostat:
И выбрать нужные UTM метки:
Поздравляем! Интеграция закончена.
Хранение данных о звонках для интеграций с CRM retailCRM
При интеграции Ringostat и CRM ratailCRM в последнюю автоматически передаются данные о звонках: их аудиозаписи, информация о том, из какого и на какой номер был совершен звонок, статус звонка, а также UTM метки. Но иногда может случиться поломка. Например, пользователь, из-под доступов которого активировали интеграцию, сменил пароль к личному кабинету CRM. В таком случае генерируется новый API-токен, по которому подключается интеграция, и Ringostat не может более передавать данные по звонкам в CRM-систему не зная новый токен. В результате данные о последующих звонках не будут поступать в CRM-систему.
Во избежание подобных ситуаций необходимо включить дополнительную настройку управления записями о звонках. Если интеграция поломается, достаточно активировать ее заново и поставить галочку в чек-боксе «Отправить данные в CRM после повторной активации»:
Чек-бокс появляется после отключения интеграции. Перед активацией интеграции необходимо поставить галочку.
Если опция включена, то после повторной активации интеграции Ringostat отправит все накопленные данные в вашу CRM за последние 3 дня, 2 предыдущих и сегодняшний.