Ringostat: налаштування з нуля — покроковий приклад

Від порожнього кабінету до першого дзвінка в CRM: три типові схеми номерів, співробітники, телефон CRM, вебхук і перевірка.

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

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

#Крок 0. Оберіть схему номерів

Схема	Коли підходить	Кому належить дзвінок
А. Особистий номер у кожного менеджера	Клієнт має «свого» менеджера й дзвонить йому напряму: B2B, дорогі продажі, сервіс	Прийнятий — тому, хто взяв. Пропущений — власнику набраного номера
Б. Один номер на весь проєкт	Загальна лінія відділу продажів чи інтернет-магазину: хто вільний, той і бере	Прийнятий — тому, хто взяв. Пропущений — відповідальному за лінію
В. Змішана	Реклама веде на загальний номер, а постійні клієнти дзвонять менеджерам напряму	Як у А для особистих номерів і як у Б для загальної лінії

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

#Крок 1. Підготовка в Ringostat

Кожен менеджер заведений у Ringostat співробітником (не лише SIP-акаунтом) і має свій SIP-акаунт. CRM бачить саме співробітників.
Схема А: на кожен особистий номер — схема дзвінка на SIP-акаунт його менеджера.
Схема Б: загальний номер веде на один SIP-акаунт — його й підключимо до телефону CRM (наприклад, office). Якщо менеджери лишаються в застосунку Ringostat — на групу їхніх SIP-акаунтів.
У кожній схемі вкажіть, куди йде дзвінок, якщо ніхто не відповів: інший співробітник, голосова пошта. Інакше клієнт почує «зайнято».
Увімкніть запис розмов, якщо він потрібен у CRM.

Ringostat: картка співробітника з SIP-акаунтом

#Крок 2. Ключ API

Кабінет Ringostat → Інтеграції → Ringostat API. Скопіюйте ID проєкту і Auth-key.

#Крок 3. Підключення в CRM

CRM → Налаштування → Телефонія → Ringostat → «Додати підключення».
Вставте ID проєкту Ringostat і Auth-key, часовий пояс — Europe/Kyiv.
Проєкти CRM — проєкт, у якому мають з'являтися заявки з дзвінків.
Режим дзвінків: «SIP-транк через телефон xCRM», якщо менеджери говорять у CRM; «Ringostat Callback» — якщо в застосунку Ringostat.
Увімкніть Журнал дзвінків, Записи розмов і Заявка на незнайомий номер.
«Зберегти налаштування» — CRM перевірить ключ і завантажить співробітників.

#Крок 4. Співробітники і номери

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

Схема	Що вписати в «Номери Ringostat»
А. Особистий номер	Кожному менеджеру — його особистий номер
Б. Один номер, менеджери в застосунку Ringostat	Загальний номер — одному відповідальному (керівнику або черговому). Решті — нічого
Б. Один номер, менеджери в телефоні CRM	Нічого. SIP-акаунт лінії (`office`) нікому не прив'язуйте: дзвінки на неї веде телефонія CRM, див. крок 5
В. Змішана	Особисті номери — їхнім менеджерам, загальний — відповідальному

CRM: співробітники Ringostat, прив'язані користувачі та їхні номери

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

#Крок 5. Телефон CRM (якщо менеджери говорять у CRM)

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

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

CRM: маршрут номера — на оператора (схема А) або на групу (схема Б)

#Крок 6. Вебхук

Без вебхука дзвінок з'являється в CRM через 1–2 хвилини після завершення розмови. З вебхуком заявка створюється в момент дзвінка. Створити вебхук можна лише в кабінеті Ringostat.

У CRM на сторінці Ringostat скопіюйте Webhook URL.
Кабінет Ringostat → Інтеграції → Webhooks → Додати.
Перший вебхук: подія «Перед дзвінком» (вхідний), метод POST, формат JSON, адреса — Webhook URL із ?event=start в кінці.
Другий вебхук: подія «Після дзвінка» (вхідний), те саме, але в кінці адреси ?event=finish.
В обидва додайте параметри: назва латиницею, значення — однойменна змінна Ringostat.

Параметри вебхука

uniqueid
caller
dst
call_type
employee_number
connected_with
billsec
duration
disposition

Ringostat: вебхук «Перед дзвінком» з параметрами

#Крок 7. Перевірка контрольними дзвінками

Менеджер входить у CRM і тримає вкладку відкритою (для телефону CRM браузер один раз попросить доступ до мікрофона — «Дозволити»). Далі — три дзвінки з номера, якого немає в CRM:

Дзвінок	Що має статися
Менеджер бере трубку	Телефон CRM: картка нової заявки відкривається під час дзвінка. Застосунок Ringostat: заявка з'являється в CRM. В обох — дзвінок і запис у картці
Ніхто не бере	Заявка створена, менеджер лінії отримує «Пропущений виклик» із посиланням на неї (схема А — власник номера, схема Б — відповідальний за лінію або вся група прийому)
Той самий номер дзвонить ще раз	Нової заявки немає — дзвінок додався до першої

CRM: вхідний дзвінок — панель телефону і відкрита картка клієнта

#Як поводиться CRM під час дзвінка

Менеджер у момент дзвінка	Що відбувається
Вільний або дивиться заявку без змін	Одразу відкривається картка того, хто дзвонить
Заповнює заявку й не зберіг	Картка не перемикається — вписане не губиться. Після «Зберегти» (без перезавантаження) відкривається картка того, хто дзвонить
Уже говорить з іншим клієнтом	Поточна розмова не переривається. Другий дзвінок іде за схемою Ringostat (інший співробітник, голосова пошта), менеджер отримує «Пропущений виклик»
Натискає посилання, яке перезавантажує сторінку	CRM попереджає, що перехід обірве дзвінок

#Типові помилки

Симптом	Що не так
Дзвінків менеджера немає в CRM	Він не прив'язаний до користувача (крок 4)
Прийняті є, пропущених немає	Номер нікому не вписаний у «Номери Ringostat» (крок 4)
Людини немає в таблиці співробітників	У Ringostat вона лише SIP-акаунт — заведіть її співробітником і синхронізуйте ще раз
Вхідні не дзвонять у браузері	SIP-акаунт увімкнений ще й у застосунку Ringostat або не застосовано конфігурацію телефонії (крок 5)
Заявка з'являється через 1–2 хвилини	Немає вебхука (крок 6)
Нова заявка без відповідального	У номера в CRM не заповнено «Власник номера» (крок 5)

#Чек-лист

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