Підключення Ringostat: дзвінки, заявки й записи в CRM

Два режими роботи, прив'язка співробітників і їхніх номерів, заявки з вхідних, пропущені, вебхук і записи розмов.

12 хв читанняОновлено 28 вересня 2026 р.

Ringostat лишається вашим провайдером телефонії, а X10 CRM — робочим місцем менеджера. Після підключення кожен дзвінок менеджера потрапляє в CRM: вхідний з нового номера стає заявкою, дзвінок знайомого клієнта лягає в його заявку, пропущений приходить менеджеру сповіщенням, а запис розмови з'являється поруч. Ця сторінка — про те, який режим обрати, що куди вписати і як перевірити, що все працює.

#Як це влаштовано

CRM щохвилини забирає журнал дзвінків Ringostat — той самий, з якого беруть дані інші системи, підключені до вашого проєкту. Тому цифри в CRM сходяться з кабінетом Ringostat незалежно від того, звідки менеджер дзвонив: з браузера, із застосунку Ringostat чи з мобільного.

CRM бере з журналу нові дзвінки і визначає, чий це дзвінок: за SIP-акаунтом, який його прийняв або зробив, або — для пропущених — за номером, на який дзвонили.
Дзвінки співробітників, прив'язаних до користувача CRM, імпортуються. Решта пропускається — так у CRM не з'являються розмови людей, які в ній не працюють.
Вхідний з нового номера створює заявку на менеджера, якому належить номер. Вхідний від відомого клієнта додається в його наявну заявку.
Якщо дзвінок пропущений, менеджер отримує сповіщення «Пропущений виклик» із посиланням на заявку.
Запис розмови завантажується в картку дзвінка — зазвичай протягом кількох хвилин.

#Два режими: як менеджер розмовляє

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

	Ringostat Callback	SIP-транк через телефон xCRM
Де менеджер говорить	У застосунку Ringostat, на SIP-телефоні або мобільному — як і раніше	У браузері, у вбудованому телефоні CRM
Дзвінок із заявки	Ringostat спершу дзвонить менеджеру, після відповіді набирає клієнта	Менеджер натискає номер — дзвінок іде одразу з браузера
Вхідний дзвінок	Дзвонить там, куди його веде схема Ringostat	Дзвонить у CRM, картка клієнта відкривається автоматично
Автодайлер і AI-працівник	Недоступні	Доступні
Налаштування	Лише ключ API і співробітники — 10 хвилин	Ще SIP-транк, номер і маршрут на кожного менеджера

Обирайте Ringostat Callback, якщо команда звикла до застосунку Ringostat чи мобільних і змінювати це зараз не хоче. CRM усе одно отримає всі дзвінки, створить заявки й покаже записи.
Обирайте телефон xCRM, якщо менеджери працюють у CRM цілий день: дзвінок, картка клієнта, скрипт і статус — в одному вікні, а розмова не рветься при переході між заявками.

#Крок 1. Ключ API і підключення

У кабінеті Ringostat відкрийте Інтеграції → Ringostat API і скопіюйте два значення: ID проєкту і Auth-key.

У CRM перейдіть у Налаштування → Телефонія → Ringostat і натисніть «Додати підключення».

Підключення до API

Назва підключеннятекстобов'язкове
Як підключення підписане в CRM, наприклад Відділ продажів. Корисно, коли підключень кілька.
ID проєкту Ringostatчислообов'язкове
Зі сторінки Ringostat API у кабінеті. Один проєкт Ringostat можна підключити лише один раз.
Auth-keyключобов'язкове
Там само. Після збереження CRM показує його замаскованим — щоб змінити, просто вставте новий.
Часовий поясназва поясу
Пояс, у якому працює ваш проєкт Ringostat, зазвичай Europe/Kyiv. Від нього залежить, за який час CRM забирає журнал.

Доступ і маршрутизація

Власник каналукористувач
Відповідальний за підключення. Потрібен для доступу «Лише власник».
Хто бачить каналвибір
«Спільний для всіх операторів», «Лише користувачі проєкту» або «Лише власник» — кому доступні дзвінки через це підключення.
Проєкти CRMсписок
У якому проєкті створюються заявки з вхідних. Для режиму Callback — ще й з яких заявок можна дзвонити через Ringostat.
Режим дзвінківвибіробов'язкове
«Ringostat Callback» або «SIP-транк через телефон xCRM» — див. режими.
SIP-транк Ringostatтранк
Лише для режиму через телефон xCRM — див. крок 4.

Синхронізація

Інтеграція активнаперемикач
Вимкнена інтеграція не дзвонить і не забирає журнал.
Журнал дзвінківперемикач
Щохвилинний імпорт дзвінків. Вимикати має сенс лише тимчасово.
Записи розмовперемикач
Завантажувати аудіо до дзвінків. Запис має бути ввімкнений і в самому Ringostat.
Заявка на незнайомий номерперемикач
Увімкнено — вхідний з номера, якого немає в CRM, створює заявку. Вимкнено — дзвінок лягає в журнал без заявки.

Натисніть «Зберегти налаштування». CRM одразу перевірить ключ і завантажить список співробітників. Кнопка «Перевірити з'єднання» робить те саме без змін у налаштуваннях — зручно, якщо підозрюєте, що ключ відкликали.

#Крок 2. Співробітники та їхні номери

Нижче на тій самій сторінці — блок «Співробітники та SIP-акаунти Ringostat». Тут вирішується, чиї дзвінки потраплять у CRM і кому вони належать.

01
Оновіть список
Натисніть «Синхронізувати співробітників» — підтягнуться співробітники проєкту Ringostat разом з їхніми SIP-акаунтами і внутрішніми номерами.
02
Прив'яжіть користувача CRM
У колонці «Користувач CRM» оберіть, хто це в CRM. Один користувач — один співробітник Ringostat.
03
Впишіть номери
У колонці «Номери Ringostat» — особистий номер менеджера в Ringostat і спільні лінії, за які він відповідає, через кому: 380731234567, 380737654321.
04
Збережіть
Натисніть «Зберегти зіставлення». Дзвінки цього менеджера почнуть надходити протягом хвилини.

Навіщо вписувати номери

Прийнятий дзвінок CRM приписує тому, хто взяв трубку, — це видно з журналу Ringostat. У пропущеного такого співробітника немає: ніхто не відповів. Тоді CRM дивиться, на який номер дзвонили, і шукає його в колонці «Номери Ringostat».

Ситуація	Кому належить дзвінок
Менеджер прийняв дзвінок або зателефонував сам	Цьому менеджеру — завжди, незалежно від номерів
Пропущений на особистий номер менеджера	Власнику номера з колонки «Номери Ringostat»
Пропущений на спільну лінію	Тому, у кого ця лінія вписана
Пропущений на номер, якого немає ні в кого	Не імпортується
Дзвінок прийняв неприв'язаний співробітник	Не імпортується, навіть якщо номер вписаний комусь іншому

#Крок 3. Режим Ringostat Callback

Нічого додатково налаштовувати не треба — досить обраного режиму, прив'язаних співробітників і проєктів CRM у підключенні. Як дзвонить менеджер:

Натискає кнопку дзвінка в картці заявки або вводить номер у панелі дзвінків CRM — там буде підказка «Ringostat Callback — введіть номер».
Ringostat телефонує на пристрій менеджера — туди, куди в Ringostat налаштований його основний напрямок: SIP-телефон, застосунок або мобільний.
Менеджер піднімає трубку — Ringostat набирає клієнта.
У картці заявки одразу з'являється подія «Запущено вихідний дзвінок через Ringostat», а після розмови — тривалість і запис.

Менеджеру потрібне право calls.ringostat_callback.
Дзвонити з картки можна лише по заявках із проєктів, вибраних у полі «Проєкти CRM» підключення.
Якщо Ringostat відповідає, що менеджера не знайдено, перевірте, що в нього в Ringostat є основний напрямок і що він прив'язаний у таблиці співробітників.

#Крок 4. Режим через телефон xCRM

Тут сервер CRM підключається до Ringostat як SIP-телефон менеджера. Ringostat бачить звичайний SIP-акаунт, а менеджер говорить у браузері. Налаштування — на кожен SIP-акаунт окремо.

01
Візьміть SIP-дані в Ringostat
У кабінеті Ringostat відкрийте SIP-акаунт менеджера й запишіть логін, пароль і сервер — зазвичай sip.ringostat.net.
02
Створіть SIP-транк у CRM
За інструкцією Крок 3. SIP-транк провайдера: хост sip.ringostat.net, порт 5060, логін і пароль SIP-акаунта, перемикач «Реєструватись у провайдера» увімкнено. Системну назву дайте зрозумілу, наприклад ringostat_ivan.
03
Додайте номер
За кроком 4 додайте номер, прив'язаний до цього транку. Зручно вписати особистий номер менеджера в Ringostat — так маршрут одразу впізнаваний.
04
Направте вхідні на менеджера
За кроком 7 створіть маршрут: цей номер → оператор, якому належить SIP-акаунт. Вхідні з Ringostat прийдуть на цей маршрут автоматично — CRM впізнає їх за логіном SIP-акаунта.
05
Прив'яжіть транк до підключення
У налаштуваннях Ringostat оберіть «Режим дзвінків» → «SIP-транк через телефон xCRM» і в полі «SIP-транк Ringostat» — щойно створений транк. Збережіть.
06
Застосуйте конфігурацію
Як у кроці 9: без цього телефонія не дізнається про новий транк.

Дзвінок, що пройшов через телефон CRM, записує і сама CRM, і журнал Ringostat. Дубля не буде: CRM впізнає, що це та сама розмова, і доповнює свій запис даними з Ringostat.

#Заявки з вхідних і пропущені

Що сталося	Що робить CRM
Дзвонить номер, якого немає в CRM	Створює заявку «Невідомий вхідний» у стартовому статусі воронки, відповідальний — менеджер, якому належить дзвінок
Дзвонить відомий клієнт	Додає дзвінок у його наявну заявку, нової не створює
Той самий номер дзвонить кілька разів	Усі дзвінки лягають в одну заявку
Номер уже дзвонив раніше, але заявки в нього не було	Нова заявка забирає й усі його попередні дзвінки — менеджер бачить повну історію
Дзвінок пропущений	Менеджер отримує сповіщення «Пропущений виклик» з номером і посиланням на заявку

Сповіщення про пропущений приходить у центр сповіщень CRM і спливає на екрані, якщо вкладка відкрита. На один дзвінок — одне сповіщення. Про дзвінки, старші за три години, CRM не сповіщає: після тривалої перерви в зв'язку менеджер отримав би пачку давно оброблених «пропущених».

Стартовий статус — системний «Нова». Якщо ви його видалили і завели власний, CRM візьме перший статус групи «Обробка». Детальніше про воронку — у статусах заявок.

#Вебхук: заявка в момент дзвінка

Вебхук налаштовується лише в кабінеті Ringostat — у Ringostat немає API, яким це могла б зробити CRM. Адресу візьміть у CRM: на сторінці Ringostat, блок Webhook URL.

У кабінеті Ringostat відкрийте Інтеграції → Webhooks і створіть два вебхуки:

Подія Ringostat	Адреса	Метод
Перед дзвінком (вхідний)	Webhook URL із CRM + `?event=start` в кінці	POST, JSON
Після дзвінка (вхідний)	Webhook URL із CRM + `?event=finish` в кінці	POST, JSON

В обидва вебхуки додайте параметри. Назву пишіть латиницею, як у таблиці, а значення оберіть зі списку змінних Ringostat з тим самим змістом:

Параметр	Що передає
`uniqueid`	ID дзвінка — за ним події одного дзвінка зводяться разом
`caller`	Номер клієнта
`dst`	Номер, на який дзвонили
`call_type`	Тип дзвінка
`employee_number`	Внутрішній номер співробітника
`connected_with`	Хто взяв трубку
`billsec`	Тривалість розмови
`duration`	Загальна тривалість
`disposition`	Результат дзвінка

#Записи розмов

Запис з'являється в картці дзвінка зазвичай протягом кількох хвилин після розмови — поруч із тривалістю й результатом.
CRM зберігає оригінальні записи Ringostat без перекодування — з окремими каналами клієнта й менеджера. Саме за ними транскрипція розрізняє, хто що сказав.
Ringostat обмежує частоту завантаження записів. Коли записів багато — наприклад, після імпорту історії, — CRM докачує їх порціями, і на це може піти кілька годин. Нічого робити не треба.
Хто може слухати записи, визначають звичайні права CRM — див. Записи розмов.

#Дзвінки, що були до підключення

Щохвилинна синхронізація бере лише свіжі дзвінки. Історію за минулі тижні завантажує команда впровадження — напишіть, з якої дати вона потрібна.

Історія імпортується без створення заявок: заявки з минулих дзвінків з'явились би з сьогоднішньою датою і зіпсували б статистику воронки. Дзвінки лягають у журнал зі своїми справжніми датами, а якщо в клієнта вже є заявка — прикріплюються до неї. Коли такий клієнт подзвонить знову, його нова заявка забере і всю попередню історію.

#Діагностика

Симптом	Причина і що зробити
Дзвінків менеджера немає в CRM	Він не прив'язаний до користувача в таблиці співробітників. Прив'яжіть — дзвінки почнуть надходити протягом хвилини.
Прийняті є, пропущених немає	У менеджера не вписані «Номери Ringostat». Впишіть його особистий номер і спільні лінії.
«Ringostat відхилив Auth-key»	Ключ відкликали або перевипустили. Скопіюйте новий з кабінету Ringostat і вставте в поле Auth-key.
«Ringostat повернув 0 співробітників»	Невірний ID проєкту або в проєкті ще немає співробітників. Звірте ID на сторінці Ringostat API.
Заявка з'являється через хвилину-дві після дзвінка	Це без вебхука — Ringostat додає дзвінок у журнал після завершення розмови. Для миттєвої заявки налаштуйте вебхук.
Вхідні не дзвонять у браузері (режим телефону xCRM)	SIP-акаунт активний ще в застосунку Ringostat або не застосована конфігурація телефонії. Див. діагностику телефонії.
Запис розмови ще не з'явився	Записи докачуються порціями — зачекайте кілька хвилин. Перевірте, що запис увімкнений і в Ringostat, і в перемикачі «Записи розмов».

На сторінці Ringostat у CRM, у блоці «Стан підключення», видно час останнього успішного обміну і текст останньої помилки — з нього варто починати.

#Права доступу

Право	Що дає
`settings.integrations_ringostat`	Налаштовувати підключення Ringostat і співробітників
`settings.integrations`	Те саме для всіх інтеграцій разом
`calls.ringostat_callback`	Дзвонити клієнтам через Ringostat Callback

Решта — перегляд заявок, прослуховування записів — працює за звичайними правами ролі, див. Ролі та права.

#Чек-лист запуску

ID проєкту і Auth-key вписані, «Перевірити з'єднання» проходить
Обрано режим дзвінків і проєкти CRM
Кожен менеджер прив'язаний до свого користувача CRM
Кожному менеджеру вписаний особистий номер, спільні лінії — відповідальним
Для телефону xCRM: транк, номер і маршрут на кожен SIP-акаунт, конфігурація застосована
У Ringostat створено два вебхуки — на початок і на завершення дзвінка
Тестовий дзвінок з незнайомого номера створив заявку, пропущений — прийшов сповіщенням