Для використання інтеграції необхідні облікові записи в обох сервісах - 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/{код}
/api/integration-modules/{code}/edit
Потрібно внести ці дані в налаштування проекту Ringostat ("Інтеграції" -> “Готові інтеграції” -> "retailCRM") і активувати інтеграцію.
Після успішної активації інтеграції, інтеграція “Ringostat” відображатиметься у загальному списку інтеграцій retailCRM (унизу сторінки "Адміністрування" -> "Інтеграції" -> "Маркетплейс").
Налаштування співробітників у retailCRM.
Для того, щоб співробітники з retailCRM були доступні для налаштування інтеграції - необхідно додати співробітника в розділі "Адміністрування" -> "Користувачі", і обов'язково встановити для співробітника групу "Менеджери" та пункт "Активована".
Створення співробітників у ЛК Ringostat описано в цій статті.
Після налаштування співробітників їх необхідно зв'язати з відповідними співробітниками retailCRM.
Для цього переходимо в розділ "Інтеграції" -> "retailCRM" і зв'язуємо співробітників, після цього зберігаємо налаштування. При цьому вибираємо одного з менеджерів та призначаємо його "Старшим менеджером".
Після налаштування та зв'язки співробітників, щоб у клієнтах / замовленнях були видні UTM мітки переходу, слід зайти в налаштування полів, що відображаються, і вибрати спеціальні поля для передачі UTM міток Ringostat:
І вибрати потрібні UTM мітки:
Вітаємо! Інтеграція налаштована.
Зберігання даних про дзвінки для інтеграцій з CRM retailCRM
При інтеграції Ringostat і ratailCRM в останню автоматично передаються дані про дзвінки: їх аудіозаписи, інформація про те, з якого і який номер був здійснений дзвінок, статус дзвінка, а також UTM мітки. Але іноді може статися поломка. Наприклад, користувач, з-під якого активували інтеграцію, змінив пароль до особистого кабінету CRM. У такому випадку генерується новий API-токен, яким підключається інтеграція, і Ringostat не може більше передавати дані по дзвінках в CRM-систему не знаючи новий токен. В результаті дані про наступні дзвінки не надходитимуть до CRM-системи.
Щоб уникнути подібних ситуацій, необхідно включити додаткове налаштування керування записами про дзвінки. Якщо інтеграція поламається, достатньо активувати її заново і поставити галочку в чек-боксі «Надіслати дані в CRM після повторної активації»:
Чек-бокс з'являється після вимкнення інтеграції. Перед активацією інтеграції потрібно поставити галочку.
Якщо опція включена, то після повторної активації інтеграції Ringostat відправить усі накопичені дані у вашу CRM за останні 3 дні, 2 попередні та сьогоднішній.