Перейти до основного контенту
Усі колекціїТелефонія
Телефонія UniTalk у Uspacy
Телефонія UniTalk у Uspacy

Тут ми розкажемо що потрібно зробити, щоб підключити телефонію UniTalk і здійснювати чи приймати дзвінки від клієнтів прямо в Uspacy.

Uspacy Support Team avatar
Автор: Uspacy Support Team
Оновлено понад 2 міс. тому

Розширюйте можливості вашої CRM, підключивши до неї IP-телефонію UniTalk (Юнітолк).

Одним із ключів до успішних продажів є задоволення потреб клієнтів. А використання IP-телефонії дозволяє налагодити комунікацію з ними та за рахунок цього якісно підвищити рівень обслуговування.

Особливості роботи

У Uspacy телефонія працює за рахунок інтеграцій зі спеціалізованими сервісами. У розділі Крамниця представлені безкоштовні застосунки, які після їх встановлення та налаштування дозволять без перешкод телефонувати клієнтам або приймати дзвінки від них.

💡 Оплата за послуги використання телефонії здійснюється на стороні сервісів.

Ознайомитися з тарифами та цінами UniTalk можна ⬇️

Отже, для успішної роботи телефонії Unitalk потрібно виконати стартові налаштування як на стороні самого сервісу, так і на стороні Uspacy. Після цього залишиться ще встановити спеціальне розширення для Google Chrome, щоб здійснювати вхідні та приймати вихідні дзвінки на будь-яких сторінках браузера, враховуючи ваш Простір Uspacy.

Але про все по черзі ⬇️

Дії на стороні UniTalk

Крок 1. Реєстрація або вхід

Найперше, що потрібно зробити – це зареєструватися в сервісі.

🔍 Детальніше про створення особистого кабінету UniTalk можна прочитати в окремій статті.

Сервіс має свою власну базу знань, де розміщено більше інформації про роботу з ним.

Радимо ознайомитися ➡️ ТУТ

Якщо ви вже маєте обліковий запис UniTalk, то просто здійсніть вхід, використовуючи свій логін і пароль.

Крок 2. API ключ

Після успішної реєстрації та входу, спершу потрібно створити API ключ. Для цього перейдіть у розділ лівого меню Інтеграції – АPI. І натисніть кнопку Створити API ключ.

Після цього він з’явиться у спеціальному полі.

Цей ключ потрібен, що використати його в наступному кроці.

Крок 3. Вихідні вебхуки

Далі потрібно налаштувати обробку двох вихідних вебхуків. Це забезпечить передавання інформації про дзвінки в системі Unitalk до Uspacy.

Новий дзвінок

Натисніть Додати вебхук і заповніть форму створення.

  • Дія: Надіслати вебхук

  • Назва: Новий дзвінок

  • 💡 Це посилання потрібно скопіювати зі сторінки налаштування застосунку UniTalk у вашому Просторі Uspacy.

  • HTTP код: POST

  • Далі натисніть Додати HTTP header та заповніть необхідні поля:

  1. Ключ: Authorization

  2. Значення: ваш створений ключ API з попереднього кроку

  • Тіло запиту: Вказаний JSON

    І у поле нижче потрібно вставити наступне значення:


{
"event": "CALL_NEW",
"call": {
"id": "{{CALL_RANDOM_ID}}",
"dbid": "{{CALL_DB_ID}}",
"from": "{{CALLED_FROM}}",
"to": "{{CALLED_TO}}",
"outerNumber": "{{OUTER_NUMBER}}",
"direction": "{{CALL_DIRECTION}}",
"date": "{{CALL_START_TIME}}",
"utmSource": "{{UTM_SOURCE}}",
"utmMedium": "{{UTM_MEDIUM}}",
"utmCampaign": "{{UTM_CAMPAIGN}}",
"utmTerm": "{{UTM_TERM}}",
"utmContent": "{{UTM_CONTENT}}",
"googleId": "{{GOOGLE_CLIENT_ID}}",
"facebookClientId": "{{FACEBOOK_CLIENT_ID}}",
"referer": "{{REFERER}}",
"comment": "{{CALL_META}}",
"source": "{{CALL_TYPE}}",
"meta": "{{CALL_META}}"
}
}

Залишається тільки Зберегти налаштування вебхуку для нових дзвінків.

Завершений дзвінок

Натисніть Додати вебхук і заповніть форму створення.

  • Дія: Надіслати вебхук

  • Назва: Завершений дзвінок

  • 💡 Це посилання потрібно скопіювати зі сторінки налаштування застосунку UniTalk у вашому Просторі Uspacy.

  • HTTP код: POST

  • Далі натисніть Додати HTTP header та заповніть необхідні поля:

  1. Ключ: Authorization

  2. Значення: ваш створений ключ API з попереднього кроку

  • Тіло запиту: Вказаний JSON

    І у поле нижче потрібно вставити наступне значення:


{
"event": "CALL_END",
"call": {
"id": "{{CALL_RANDOM_ID}}",
"dbid": "{{CALL_DB_ID}}",
"from": "{{CALLED_FROM}}",
"to": "{{CALLED_TO}}",
"outerNumber": "{{OUTER_NUMBER}}",
"direction": "{{CALL_DIRECTION}}",
"date": "{{CALL_START_TIME}}",
"secondsFullTime": "{{CALL_SECONDS_FULL}}",
"secondsTalk": "{{CALL_SECONDS_TALK}}",
"utmSource": "{{UTM_SOURCE}}",
"utmMedium": "{{UTM_MEDIUM}}",
"utmCampaign": "{{UTM_CAMPAIGN}}",
"utmTerm": "{{UTM_TERM}}",
"utmContent": "{{UTM_CONTENT}}",
"googleId": "{{GOOGLE_CLIENT_ID}}",
"facebookClientId": "{{FACEBOOK_CLIENT_ID}}",
"referer": "{{REFERER}}",
"comment": "{{CALL_META}}",
"state": "{{CALL_STATUS}}",
"source": "{{CALL_TYPE}}",
"link": "{{CALL_AUDIO_LINK}}",
"meta": "{{CALL_META}}",
"cause": "{{CALL_END_CODE}}"
}
}

Залишається тільки Зберегти налаштування вебхуку для завершених дзвінків.

Перенаправлення дзвінку

Натисніть Додати вебхук і заповніть форму створення.

💡 Це посилання потрібно скопіювати зі сторінки налаштування застосунку UniTalk у вашому Просторі Uspacy.

  • HTTP код: POST

  • Далі натисніть Додати HTTP header та заповніть необхідні поля:

    • Ключ: Authorization

    • Значення: ваш створений ключ API з попереднього кроку

  • Тіло запиту: Вказаний JSON

І у поле нижче потрібно вставити наступне значення:


{
"event": "CALL_REDIRECT",
"call": {
"id": "{{CALL_RANDOM_ID}}",
"dbid": "{{CALL_DB_ID}}",
"from": "{{CALLED_FROM}}",
"to": "{{CALLED_TO}}",
"outerNumber": "{{OUTER_NUMBER}}",
"direction": "{{CALL_DIRECTION}}",
"date": "{{CALL_START_TIME}}",
"secondsFullTime": "{{CALL_SECONDS_FULL}}",
"secondsTalk": "{{CALL_SECONDS_TALK}}",
"utmSource": "{{UTM_SOURCE}}",
"utmMedium": "{{UTM_MEDIUM}}",
"utmCampaign": "{{UTM_CAMPAIGN}}",
"utmTerm": "{{UTM_TERM}}",
"utmContent": "{{UTM_CONTENT}}",
"googleId": "{{GOOGLE_CLIENT_ID}}",
"facebookClientId": "{{FACEBOOK_CLIENT_ID}}",
"referer": "{{REFERER}}",
"comment": "{{CALL_META}}",
"state": "{{CALL_STATUS}}",
"source": "{{CALL_TYPE}}",
"link": "{{CALL_AUDIO_LINK}}",
"meta": "{{CALL_META}}",
"cause": "{{CALL_END_CODE}}"
}
}

Залишається тільки Зберегти налаштування вебхуку для перенаправлення дзвінків.

Відповідь на дзвінок

Натисніть Додати вебхук і заповніть форму створення.

💡 Це посилання потрібно скопіювати зі сторінки налаштування застосунку UniTalk у вашому Просторі Uspacy.

  • HTTP код: POST

  • Далі натисніть Додати HTTP header та заповніть необхідні поля:

    • Ключ: Authorization

    • Значення: ваш створений ключ API з попереднього кроку

  • Тіло запиту: Вказаний JSON

І у поле нижче потрібно вставити наступне значення:


{
"event": "CALL_ANSWER",
"call": {
"id": "{{CALL_RANDOM_ID}}",
"dbid": "{{CALL_DB_ID}}",
"from": "{{CALLED_FROM}}",
"to": "{{CALLED_TO}}",
"outerNumber": "{{OUTER_NUMBER}}",
"direction": "{{CALL_DIRECTION}}",
"date": "{{CALL_START_TIME}}",
"secondsFullTime": "{{CALL_SECONDS_FULL}}",
"secondsTalk": "{{CALL_SECONDS_TALK}}",
"utmSource": "{{UTM_SOURCE}}",
"utmMedium": "{{UTM_MEDIUM}}",
"utmCampaign": "{{UTM_CAMPAIGN}}",
"utmTerm": "{{UTM_TERM}}",
"utmContent": "{{UTM_CONTENT}}",
"googleId": "{{GOOGLE_CLIENT_ID}}",
"facebookClientId": "{{FACEBOOK_CLIENT_ID}}",
"referer": "{{REFERER}}",
"comment": "{{CALL_META}}",
"state": "{{CALL_STATUS}}",
"source": "{{CALL_TYPE}}",
"link": "{{CALL_AUDIO_LINK}}",
"meta": "{{CALL_META}}",
"cause": "{{CALL_END_CODE}}"
}
}

Залишається тільки Зберегти налаштування вебхуку для відповіді на дзвінки.

Крок 4. Обробка вихідних вебхуків

Для того, щоб система почала надсилати дані при подіях дзвінка з UniTalk у Uspacy, необхідно додати створені вебхуки в блок Обробка подій дзвінків (Вихідні вебхуки) у розділі Інтеграції – API.

Новий дзвінок – відправка вебхука відбувається при ініціалізації виклику. Тобто як тільки інформація про якийсь новий дзвінок (вхідний/вихідний) потрапляє до системи Unitalk, відбувається відправлення даного вебхука до Uspacy.

Перенаправлення – коли дзвінок перенаправлено, то подія повідомляє про те, якому саме оператору. Але при цьому відповіді на виклик ще не було.

Відповідь на дзвінок – вебхук надсилається, коли оператор прийняв (взяв) слухавку.

Дзвінок завершено – подія, що сигналізує про закінчення виклику. Дзвінок може бути пропущеним, тобто неуспішним, або прийнятим, якщо дзвінок успішний.

Таким чином у CRM-систему надходять дані про подію дзвінку як таку, безпосередньо про початок чи завершення виклику та його перенаправлення.

Крок 5. Призначення відповідальних за лінії користувачів

Щоб з телефонією змогли працювати декілька співробітників потрібно створити окремі лінії для кожного з них. Зробити це можна в розділі Користувачі.

❗️Призначити відповідальних за лінії потрібно обов'язково. Інакше при спробі встановити підключення на стороні Uspacy це не вдасться зробити. А система повідомить про Помилку підключення.

Отже, спершу потрібно натиснути ДОДАТИ SIP ЛІНІЮ.

☝🏻Зверніть увагу, що кількість SIP ліній має бути з розрахунку – 1 лінія на 1 співробітника, який буде підключений до телефонії.

Далі потрібно ДОДАТИ КОРИСТУВАЧА.

Для початку потрібно ввести email, щоб відкрилися інші поля, які також мають бути заповнені.

Далі вказуємо роль, вибираємо зі списку створену нами SIP лінію, вводимо ім’я та прізвище, а також ще потрібно Згенерувати пароль.

Натискаємо Додати. Тепер співробітник закріплений за SIP лінією.

Згенерований пароль та вказана електронна пошта будуть в подальшому використовувати для входу в розширення для UniTalk Web dialer для Google Chrome.

А номер внутрішньої лінії – для налаштувань на стороні Uspacy.

Крок 5.1 Налаштування вхідних сценаріїв. Переадресація

Для зручності роботі з вхідними викликами від відомих контактів, які вже існують у базі СRM, є можливість направлення дзвінків одразу на відповідальних за ці контакти менеджерів. А також налаштування переадресації у разі відсутності відповіді.

Для цього потрібно в особистому кабінеті UniTalk перейти в пункт меню Вхідні сценарії.

Далі натисніть ДОДАТИ СЦЕНАРІЙ.

Відкриється форма для налаштувань. Тут спершу введіть назву сценарію.

Потім можна переходити безпосередньо до створення самого сценарію.


💡 Це можна зробити, використовуючи Базове правило робочого часу. Тобто сценарій буде працювати безперервно, від Понеділка до Неділі з 00:00 до 23:59.

Або додати своє і вказати потрібні вам робочі дні та години.


Для початку перетягнути у відповідну область блок На відповідального менеджера.

Далі налаштувати його параметри. У полі Шукати відповідального обов’язково вказати Запит у Ваше API.

Ще одним важливим параметром є URL.

У це поле потрібно прописати наступне значення:


https://unitalk.uspacy.app/unitalk_integration/v1/call_events/route?key=N

Де N – API Ключ. Його можна знайти у відповідному полі в розділі Інтеграції – АPI.

Далі залишається вказати час очікування та вибрати мелодію гудків. Ці поля заповнюються відповідно до власних потреб і смаків.

Коли налаштування цього блоку завершені, потрібно вказати як будуть розподілятися вхідні виклики від відомих контактів у разі, якщо відповідальні за них менеджери не приймуть їх. Для цього необхідно перетянути у відповідну область пункт На відділ.

Далі залишається налаштувати його відповідно до потреб.


💡Зверніть увагу!

  • Для параметру Як дзвонити можна краще вибрати одне з цих значень: Випадковому оператору, Випадково з пріоритетом, За порядком пріоритету.

  • Потрібні номери, які будуть використовуються для переадресації мають бути додані у відділ. Для цього налаштуйте це у відповідному розділі особистого кабінету Unitalk.


На цьому налаштування завершене. Залишиться тільки Зберегти сценарій.

💡 Порада! Щоб дзвінки почали надходити менеджерам, кожному з них потрібно натиснути Почати працювати.

Дії на стороні Uspacy

У розділі Маркетплейс представлений безкоштовний застосунок UniTalk telephony, який після його встановлення та додаткових налаштувань дозволить без перешкод телефонувати клієнтам або приймати дзвінки від них.

Крок 1. Встановлення

Отже, спершу потрібно встановити цей застосунок у всій Простір. Для цього натискаємо Отримати.

Далі переходимо до налаштувань вже встановленого застосунку.

Крок 2. Статус підключення

У цьому блоці налаштувань потрібно буде лише ввести API ключ, який був створений на стороні UniTalk.

І натиснути Перевірити підключення.

У результаті статус підключення повинен змінитися.

💡 Поле Uspacy вебхук фактично є службовим і не потребує заповнення. А його значення вже використовувалося при створенні вихідних вебхуків на стороні UniTalk.

Крок 3. Інтеграція з CRM

Зараз у результаті обробки як вихідних, так і успішних вхідних дзвінків у CRM будуть створюватися ліди. Їх потім можна опрацювати та конвертувати в угоди, компанії чи контакти.

Лише на основі пропущеного виклику від відомого номеру буде створена справа у відповідній картці компанії чи контакту.

❗️Вибір інших сутностей буде доступний незабаром.

Крок 4. Зіставлення телефонних номерів

У Uspacy теж потрібно вказати для кожного відповідального співробітника окрему лінію, яка вже була створена в UniTalk. Спершу натисніть Додати.

Далі у полі Співробітники виберіть зі списку користувача. Почніть вводити ім’я, щоб пришвидшити пошук колеги.

У полі Внутрішній номер або значення лінії, вкажіть ту SIP лінію, яка була створена в UniTalk і за яку відповідальний цей користувач.

І збережіть ці налаштування, натиснувши на галочку.

Крок 5. Призначення типового відповідального

У Uspacy є можливість призначити окремого користувача відповідальним за нові сутності, створені на основі обробки пропущених дзвінків.

💡 Якщо цього не зробити, то типовим відповідальним буде вважатися суперадміністратор (власник) порталу.

Розширення UniTalk для Google Chrome

Для того, щоб телефонувати клієнтам не потрібно встановлювати додаткові сторонні програми на ваші пристрої. Завдяки спеціальному розширенню у Google Chrome можна здійснювати вхідні та приймати вихідні дзвінки на будь-яких сторінках браузера, враховуючи ваш Простір Uspacy.

Крок 1. Встановлення

Знайти це розширення можна у Веб-магазині Chrome. У пошуковий рядок потрібно почати вводити його назву – UniTalk Web Dialer.

Або можна додати в Chrome, одразу перейшовши за прямим посиланням ТУТ.

Після встановлення це розширення стане активним у вашому браузері.

Крок 2. Вхід у акаунт UniTalk

Потрібно ввести електронну адресу та згенерований пароль, які були використані при призначенні відповідальних за лінії користувачів та натиснути Увійти.

Робота з телефонією

☎️ Після цього можна починати працювати з телефонією UniTalk прямо в Uspacy– здійснювати чи приймати дзвінки від клієнтів.

☎️ Усі дзвінки (вхідні, вихідні та пропущені) будуть збережені в історії та знаходитимуться на сторінці Журнал дзвінків.

💡Він доступний лише на комерційних тарифах.

На сторінці журналу дзвінків одразу можете опрацювати виклики, наприклад, прослухати записи розмов або перейти в картку пов'язаної сутності CRM.

🙌🏻 Зверніть увагу, що записи розмов зазвичай додаються із затримкою у 10-15 хвилин. А якщо дзвінок був довгий, то затримка може бути ще трошки більшою.

А записи розмов будуть також міститися в картці CRM, у правій її частині, під фільтром активностей, там де відображена історія взаємодії з елементом.

Оновлення налаштувань

🟣 вересень 2024. Можливість передавати інформацію через UTM-мітки. Для цього потрібно у вебхук Завершений дзвінок обов'язково додати наступну частину:

"utmSource": "{{UTM_SOURCE}}",

"utmMedium": "{{UTM_MEDIUM}}",

"utmCampaign": "{{UTM_CAMPAIGN}}",

"utmTerm": "{{UTM_TERM}}",

"utmContent": "{{UTM_CONTENT}}",

🔍 Детальніше про налаштування та повне тіло запиту JSON для вебхука Завершений дзвінок ➡️ Дії на стороні Unitalk – Крок 3. Вихідні вебхуки – Завершений дзвінок.

Ви отримали відповідь на своє запитання?