Інструкція з підключення та налаштування інтеграції UniTalk з NCRM
Підключення
Перейдіть в ОК UniTalk на сторінку інтеграції з NCRM і натисніть «Підключити».
Домен вказаний в особистому кабінеті NCRM в адресному рядку браузера.
API-токен вказаний в особистому кабінеті NCRM у розділі «Профіль» у полі «Ваш API-токен». У разі відсутності відображення поля «Ваш API-токен» у розділі «Профіль» зверніться в техпідтримку NCRM.
Налаштування
Для внесення основних налаштувань необхідно перейти на сторінку особистого кабінету «NCRM» і виконати наступні кроки:
1. У блоці «Налаштування» відмітити бажані опції;
- Якщо прапорець «Створювати контакти» вимкнено, то при ввімкненому прапорці «Створювати угоди» угоди будуть створюватися лише за наявності існуючих контактів.
- При ввімкненні прапорця «Створювати угоди, якщо немає відкритих» нова угода буде створена, лише якщо остання створена угода контакту має закритий статус.
- При ввімкненні прапорця «Створювати сутності при вихідних дзвінках» у CRM-системі будуть створені контакти та угоди при здійсненні вихідних дзвінків на мобільні номери контактів.
- При ввімкненні прапорця «Створювати сутності тільки для відповідей на дзвінки» у CRM-системі будуть створені контакти та угоди тільки за тими телефонними дзвінками, на які відповіли.
- При ввімкненні прапорця «Відображати відповідального при вхідних дзвінках у SIP-клієнті» необхідно додатково в особистому кабінеті UniTalk у розділі Користувачі для кожного користувача в блоці «Налаштування SIP» увімкнути прапорець «Відображати ім’я абонента».
- Для додавання посилання на прослуховування аудіо в коментар до карток клієнта та угоди ввімкніть прапорець «Надсилати записи дзвінків».
- Для створення завдань на передзвін при невідповідях на вхідні дзвінки ввімкніть прапорець «Створювати завдання при пропущених вхідних дзвінках» і вкажіть тип завдання.
2. Виберіть відповідальних користувачів NCRM у блоці «Розподіл відповідальних за замовчуванням»;
Блок налаштувань «Розподіл відповідальних за замовчуванням» вказує, хто з користувачів системи інтеграції буде зазначений як відповідальний у випадках, коли відповідального визначити не вдалося, а саме:
- Операторами пропущено вхідний дзвінок від нового клієнта;
- Дзвінок від нового клієнта оброблено без участі оператора;
- Номер оператора, який відповів на дзвінок від нового клієнта, не закріплений за жодним із користувачів системи інтеграції в блоці налаштувань «Номери телефонів операторів».
Налаштування
У блоці попарно відображені дні тижня та відповідні випадаючі списки користувачів системи інтеграції:
У випадаючих списках необхідно вказати, які з користувачів будуть призначені відповідальними у випадках, коли відповідального визначити не вдалося. Якщо вказати кількох користувачів у межах одного дня — буде обрано випадкового з них:
3. Укажіть внутрішні лінії та номери телефонів користувачів NCRM у блоці «Номери телефонів операторів»;
Блок налаштувань «Номери телефонів операторів» дозволяє встановити відповідність між користувачами системи інтеграції та номерами внутрішніх ліній або телефонними номерами, які вони використовують.
Налаштування
У блоці попарно відображені імена користувачів системи інтеграції та відповідні текстові поля:
У текстових полях можна через кому вказати номери внутрішніх ліній та номери телефонів, які вони використовують:
При налаштуванні не допускається вказання одного номера кільком операторам та використання внутрішніх ліній, що відсутні в проєкті. Як телефонний номер можна використовувати особистий номер, що не бере участі в проєкті, або FMC-номер із проєкту. У разі вказання однієї із зовнішніх ліній проєкту дзвінок буде перервано задля уникнення циклічних обробок:
У випадку, коли при обробці дзвінка необхідно створити або змінити сутність інтегрованої системи, відповідальний обирається на підставі номера оператора, який отримав або здійснив цей дзвінок. Якщо таку відповідність встановити не вдалося, відповідальний обирається на підставі налаштувань блоку «Розподіл відповідальних за замовчуванням».
При обробці вхідного дзвінка за вхідним сценарієм та використанні перенаправлення «На відповідального менеджера» з опцією «В CRM-системі» здійснюються запити до інтегрованих систем щодо наявності в них записів, які відповідають номеру абонента, та закріпленого за ними відповідального менеджера. Якщо такий запис знайдено, дзвінок перенаправляється на перший вказаний у блоці «Номери телефонів операторів» номер:
4. Якщо в блоці «Налаштування» ввімкнена опція «Створювати угоди», необхідно вибрати, у яких воронках та етапах будуть створюватися угоди в блоці «Розподіл угод із джерел по воронках»:
Блок налаштувань «Розподіл сутностей із джерел по сегментах» дозволяє вказати, у яких сегментах інтегрованої системи будуть створюватися сутності.
- Сегменти — внутрішні категорії сутностей інтегрованої системи, наприклад: воронки, етапи, статуси тощо.
- Сегменти та сутності варіюються залежно від інтегрованої системи та повноти інтеграції й відображені в назві блоку.
Налаштування
Зазвичай у блоці в кілька стовпців відображені джерела проєкту та відповідні їм поля вибору різних сегментів сутностей системи інтеграції:
Якщо в таблиці присутнє джерело «За замовчуванням», його заповнення є обов’язковим:
Кожне з полів є випадаючим списком, перелік допустимих значень відповідає тому, що представлений для конкретного сегмента в системі інтеграції.
Деякі сегменти можуть бути пов’язаними. Так, наприклад, обрана воронка угод може визначати перелік допустимих етапів.
Заповнення полів контактів
У межах підключеної інтеграції з NCRM доступне заповнення полів Угод та Контактів.
Блок налаштувань «Заповнення полів сутності» дозволяє вказати значення, якими будуть заповнюватися поля сутності при створенні. У межах налаштування інтеграції можуть бути присутні кілька таких блоків, кожен з яких відповідає одній із сутностей системи інтеграції. Сутність, до якої застосовується налаштування, вказана в назві блоку. Блоки приховуються, якщо придатні для заповнення поля не були знайдені в сутностях системи інтеграції.
Налаштування
У блоці в кілька стовпців відображені назви доступних для заповнення полів відповідної сутності системи інтеграції:
Натискання на назву відкриває поле введення. Існує кілька варіантів заповнення:
- У полі допускається введення значення з переліку, визначеного самою системою інтеграції;
- Поле заповнюється одним із динамічних значень UniTalk;
- Поле заповнюється статичним значенням, яке вказується вручну.
Логіка роботи
У момент створення відповідної сутності в системі інтеграції, окрім основних даних, визначених налаштуваннями інтеграції, передаються також і ті, що налаштовані в цьому блоці. Динамічні значення можуть бути відсутні залежно від обставин та подій, за яких створюється сутність.
Наприклад, при створенні сутності на основі вхідного дзвінка відсутні значення, пов’язані з обдзвонами.
Поля інтегрованої системи можуть мати вимоги до заповнення. У випадках, коли обране відповідно до налаштувань блоку значення порушує ці вимоги, створення сутності може завершитися помилкою. Повторні спроби створення не здійснюються, і сутність створена не буде, що, своєю чергою, може порушити роботу інтеграції.
Вимоги NCRM до заповнення полів:
- Значення поля типу «Прапорець» може бути або «0» (Вимкнено), або «1» (Ввімкнено);
- Значення поля типу «Дата» необхідно вводити у форматі «рррр-мм-дд» (Наприклад, 2024-01-01).
Обробка подій СРМ
Для автоматичного виконання обробника події при створенні угоди або зміні її статусу на вказаний, виберіть відповідний обробник події. На кожну подію можна налаштувати виконання максимально одного вебхука або не вказувати його зовсім. Статуси угоди відображаються за всіма існуючими воронками в CRM.
В особистому кабінеті NCRM у розділі «Налаштування/Бізнес-процеси» додайте процес при створенні угоди та зміні її статусу:
У формі, що з’явилася, заповніть необхідні поля:
- тип процесу: «Вебхук»;
- умова: «Угода створена», «Угода: зміна етапу»;
- URL: вкажіть заздалегідь скопійовану URL-адресу зі сторінки налаштування інтеграції з NCRM. URL містить у собі піддомен (subdomain), який необхідний для підключення інтеграції та слугує для визначення того, у якому проєкті необхідно виконати дії.
При спрацьовуванні обробника події з дією «Додати номер абонента в обдзвонювання» на сторінці «Обдзвонювання номерів/Номери обдзвонювань» в інформації про клієнта у полі «Нотатка» буде вказано ID угоди (створеної або зміненої на вказаний статус).
