Як підключити телефонію Ringostat в G-PLUS CRM?

За замовчуванням, з корбки, CRM система постачається з уже вбудованою системою телефонії. Це означає, що ви одразу можете телефонувати із CRM лідам та клієнтам, отримувати записи дзвінків, переглядати аналітику.

Однак, ми підтримуємо інтеграції із сторонніми постачальниками телефонії, в тому числі з Ringostat.

Інтеграція з Ringostat опціональна і дозволяє налаштувати необхідну логіку телефонії для вашої будівельної компанії.

Як підключити телефонію Ringostat?

Відкриваємо сторінку інтеграції в CRM. https://crm.g-plus.app/manage/crm/integrations

Із списку доступних інтеграцій обираємо інтеграцію з Ringostat.

Інтерфейс інтеграцій, для підключення Телефонії Ringostat в G-PLUS CRM

Відриваємо сторінку налаштувань телефонії Ringostat та вводимо такі дані, як:

API Key
API Secret
Спосіб дзвінка

Зверніть увагу, отримати API дані для увімкнення інтеграції з G-PLUS CRM, ви можете в особистому кабінеті Ringostat за посиланням https://app.ringostat.com/ru/login/

В меню вашого проекту – відкриваємо Інтеграції – далі Ringostat API

Значення Auth-key – поле 1, копіюємо в Ringostat і ставимо в G-PLUS CRM в поле API Key

Значення Project id: – поле 2, копіюємо в Ringostat і ставимо в G-PLUS CRM в поле Client ID

В налаштуванні інтеграції, вам буде потрібен URL адреса для веб-хука. Адресу ви також копіюєте з налаштувань інтеграції з ringostat. Поле для копіювання – Адрес для Webhook.

Отримані дані вставляємо у вікні налаштувань інтеграції з Ringostat в поля, які виділені червоним кольором, як на скріншоті вище

Вибір способу дзвінка означає, яким саме чином працюватиме телефонія в CRM.

Вибір із браузера (гарнітура) – означає, що ви можете телефонувати із CRM, приймати дзвінки на фізичний апарат, мобільний телефон чи в додаток. Даний спосіб означає, що ви можете телефонувати з CRM, а при вхідному дзвінку бачитимите модальне вікно сповіщення про вхідний дзвінок, з можливістью перейти в карточку ліда/клієнта, який телефонує.

Через телефон (апарат, на якому налаштовано SIP) – означає, що ви можете або одразу телефонувати зі стаціонарного телефону, або ініцюювати дзвінок з CRM, а продовжити з фізичного апарату – телефону.

Вспливаючі вікна в CRM при вхідному дзвінку

Щоб в CRM системі G-PLUS CRM працювали сповіщення та вспливаючі вікна з інформуванням про вхідний дзвінок, необхідно вказати наступні дані в налаштуваннях Web-hooks (на стороні Ringostat).

Систмені сповіщення в G-PLUS CRM
(*при вхідному дзвінку*)

Які значення задати для Ringostat Webhooks?

В інтерфейсі Ringostat відкриваємо Інтеграції – Webhooks – Додати

Модальне вікно в Ringostat для створення Webhook

Формат і метод відправки даних

В налаштуваннях Ringostat обираємо формат даних JSON. Метод відправки даних вказуємо POST.

В налаштуваннях вказуємо наступні значення:

Webhook – G-PLUS before incoming call

Назва параметру	Значення параметру
phone_from	Номер, хто телефонує
phone_to	Куди телефонують
started_at	Дата
pbx_call_id	ID дзвінка
manager	Відповідальні менеджери
type	Тип
webhook_type	before_incoming

Таблиця значення Webhook, які надсилаються до дзвінка (при вхідному)!

Webhook – G-PLUS after incoming call

Назва параметру	Значення параметру
phone_from	Номер, хто телефонував
phone_to	Кому телефонували
status	Статус
started_at	Дата
duration	Розмова
staff	E-mail співробітника
is_recorded	Є запис
recording_url	Посилання на аудіозапис
manager	Відповідальні менеджери
pbx_call_id	ID дзвінка
internal_number	Внутрішній номер співробітника
type	Тип
utm_source	Джерело
utm_medium	Канал
utm_campaign	Кампанія
utm_content	Оголошення
utm_term	Ключове слово

Таблиця значення Webhook, які надсилаються по завершенні вхідного дзвінка.

Webhook – G-PLUS outgoing call

Назва параметру	Значення параметру
phone_from	Номер, хто телефонував
phone_to	Кому телефонували
status	Статус
started_at	Дата
duration	Розмова
staff	E-mail співробітника
is_recorded	Є запис
recording_url	Посилання на аудіозапис
manager	Відповідальні менеджери
pbx_call_id	ID дзвінка
internal_number	Внутрішній номер співробітника
type	Тип
outgoing_number	Вихідний номер

Таблиця значення Webhook, які надсилаються по завершенні вихідного дзвінка.

Як передавати UTM-мітки дзвінка з Ringostat в G-PLUS CRM?

Для передачі UTM-міток в налаштуваннях Webhook – G-PLUS after incoming call передайте відповідні значення UTM. Підтримуються всі UTM-типи даних, які відображені в таблиці вище. Також дублюємо UTM-параметри нижче з необхідними відповідностями.

Рекомендована структура UTM-розмітки

UTM_SOURCE	ДЖЕРЕЛО
UTM_MEDIUM	КАНАЛ
UTM_CAMPAIGN	КАМПАНІЯ
UTM_CONTENT	ОГОЛОШЕННЯ
UTM_TERM	КЛЮЧОВЕ СЛОВО

Рекомендований стандарт UTM розмітки

Якщо необхідно задати власний сценарій визначення першоджерела згідно отриманих параметрів UTM, використовуйте функціонал автоматизації UTM-міток – https://www.youtube.com/watch?v=2-DUkj4Pz6Q

SIP налаштування для співробітників в CRM

В налаштуванні співробітників, вказуємо такі дані, як:

Внутрішній номер
SIP Login
SIP Password
SIP Server

Щоб отримати ці дані, перейдіть в меню Ringostat - Віртуальна АТС - Підключення номерів.

Меню для отримання SIP-акаунтів в Ringostat. Після підключення номерів, перейтіть в SIP-акаунти.

Натисніть на розкрити список “Показати облікові дані внутрішніх ліній/Приховати облікові дані внутрішніх ліній“.

Натискаємо зберегти і оновлюємо сторінку. Ваша інтеграція з Ringostat налаштована.

ISO формат передачі інформації про дату.

Для коректної передачі інформації про час дзвінка (вхідного чи вихідного) в G-PLUS CRM, необхідно в налаштуваннях Ringostat вибрати формат ISO 8601. Даний формат потрібно виставити в налаштуваннях кожного веб-хуку.