Джерела даних

Огляд

Розділ «Джерела даних» — це панель керування вхідними інтеграціями. Джерело може бути:

• CRM-джерелом, наприклад Bitrix24
• прямим телефонним джерелом, наприклад Streamtelecom
• публічним API — без підключення до жодного постачальника: ви самі надсилаєте дані дзвінків і чатів через API-ключ

Управління джерелами даних знаходиться в Налаштування -> Джерело даних.

Вкладки

Розділ наразі використовує дві вкладки:

Підключення

Використовуйте цю вкладку, щоб:

• переглянути поточно підключене джерело
• ознайомитися з метаданими підключення (постачальник/домен/дата встановлення)
• змінити джерело
• відключити джерело

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

Відключення CRM-застосунку (Bitrix24, Uspacy) зупиняє прийом даних і відписує портал від подій про дзвінки, які він надсилав. Сам застосунок залишається встановленим у порталі — видаліть його там, якщо хочете прибрати і з інтерфейсу. Наявні записи та аналізи зберігаються.

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

Відключений CRM-застосунок можна увімкнути назад на тій самій вкладці: у вкладці «Підключення» він показується зі статусом Відключено та кнопкою Підключити знову, яка заново підписує портал на події про дзвінки. Якщо за цей час авторизація порталу перестала діяти, під час спроби підключення ми повідомимо, що застосунок треба встановити в порталі заново.

Імпорт

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

Примітки:

• Bitrix24 підтримує CRM-орієнтовані потоки імпорту
• Streamtelecom підтримує прямий телефонний імпорт через історію CDR
• інші телефонні постачальники можуть надавати вебхук для прийому даних ще до повного клієнта імпорту

Імпорт списує баланс за кожен запис, тому це дія у два кроки: виберіть обсяг і діапазон дат, натисніть «Розрахувати вартість» — і Aelo покаже, скільки записів у діапазоні, скільки це хвилин до оплати та скільки буде списано з урахуванням включених хвилин тарифу й гаманця. Кнопка «Запустити» розблоковується лише після цього, а зміна діапазону потребує перерахунку: сума, яку ви підтверджуєте, завжди стосується того діапазону, що імпортується. Якщо оцінка перевищує баланс, запуск можливий, але суму потрібно ввести вручну.

Імпорт телефонії з CDR охоплює не більше 30 днів за один запуск — це обмеження API самого провайдера. Довшу історію імпортуйте послідовними запусками.

Зіставлення полів CRM (доставка результатів аналізу назад у CRM) більше не є вкладкою цього розділу — воно налаштовується окремо, в «Налаштування аналізу → Оновлення CRM», і доступне лише організаціям на Bitrix24. Елементи керування Smart Process є специфічними для Bitrix24.

Майстер налаштування джерела

Коли немає активного підключеного джерела, Aelo показує покроковий майстер налаштування:

1. Вибір джерела
2. Налаштування облікових даних/параметрів
3. Перевірка підключення
4. Імпорт початкових даних (якщо підтримується)

Картка «Публічний API» на кроці вибору джерела — це четвертий шлях, який повністю пропускає кроки 2-4: вона одразу веде в Налаштування → API ключі, де ви видаєте ключ, замість того щоб проходити налаштування облікових даних конкретного постачальника. Повний опис — у розділі Публічний API. Картка з’являється лише тоді, коли організація взагалі може відкрити цей розділ; на безкоштовному тарифі розділ усе одно видно, але замість форми видачі ключа він показує пояснення про потребу платного тарифу.

Поточна модель підтримки

Bitrix24

• повна CRM-інтеграція
• підтримка вбудованого застосунку
• вебхук для прийому даних
• налаштування доставки
• підтримка Smart Process

Unitalk

• пряме телефонне джерело, хмарна АТС / контакт-центр
• вебхук для прийому даних
• тестування/налаштування через потік «Джерело даних»
• масовий імпорт недоступний: дзвінки надходять вебхуком з моменту підключення
• без зворотного запису в CRM

Streamtelecom

• пряме телефонне джерело
• вебхук для прийому даних
• тестування/налаштування через потік «Джерело даних»
• імпорт/бекфіл з історії CDR
• без зворотного запису в CRM

Два потоки даних

Streamtelecom надає два незалежні потоки:

1. Історія дзвінків (CDR) — імпортується одразу після підключення за логіном, паролем і API-ключем. API-ключ розташований у кабінеті Stream Telecom: Адміністрування → Профіль компанії → API KEY.
2. Дзвінки в реальному часі — надходять через вебхук, який активує лише підтримка Stream Telecom (самостійно увімкнути не можна). На кроці майстра «Прийом дзвінків у реальному часі» скопіюйте ваш webhook URL і надішліть готовий лист на support@streamtele.com — це підписка на події Stream CALL API v3.0. Активація зазвичай триває до 24 годин. Той самий URL та інструкція завжди доступні в Налаштування → Джерела даних → Підключення.

Binotel

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

Ringostat

• хмарна АТС — та сама категорія, що й Streamtelecom та Binotel, а не інструмент аналітики дзвінків
• присутній у каталозі джерел, але позначений як неверифікований: схему вебхука вгадано, а не підтверджено на реальних даних Ringostat, а імпорт історії дзвінків (CDR) не реалізовано
• не вважайте це робочою інтеграцією, доки її не верифіковано

Правила активного джерела

• в організації допускається лише одне активне телефонне джерело
• переключення активного джерела деактивує попереднє телефонне джерело
• стан підключення зчитується з бекенду, а не визначається локально в UI

Типовий робочий процес

1. Відкрийте Налаштування -> Джерело даних
2. Запустіть майстер або відкрийте Змінити
3. Виберіть провайдера
4. Введіть облікові дані/конфігурацію, специфічні для постачальника
5. Запустіть перевірку підключення, якщо доступно
6. Розпочніть початковий імпорт, якщо джерело підтримує
7. Для CRM-джерел налаштуйте зіставлення полів у «Налаштування аналізу → Оновлення CRM»

Примітки щодо оновлення CRM

Для джерел із підтримкою CRM крок «Налаштування аналізу → Оновлення CRM» може включати:

• маппінг полів
• перемикачі доставки транскрипту/резюме/оцінки
• дії налаштування або відновлення Smart Process, якщо застосовно

Для джерел лише телефонії Aelo розглядає інтеграцію лише як прийом даних, і крок «Оновлення CRM» для них недоступний.

Усунення проблем

Майстер відкривається, хоча джерело підключено

Зазвичай це означає, що UI не зміг розв’язати запит активного джерела. Перевірте підключення API і знову відкрийте розділ «Джерело даних».

Крок «Оновлення CRM» недоступний

Це очікувано для прямих телефонних джерел — крок «Налаштування аналізу → Оновлення CRM» існує лише для організацій на Bitrix24.

Елементи керування Smart Process відсутні

Smart Process є специфічним для Bitrix24. Якщо активний провайдер не є Bitrix24, ці елементи навмисно приховані.