Источники данных

Обзор

Раздел «Источники данных» — это панель управления входящими интеграциями. Источником может быть:

• CRM-источник, например Bitrix24
• прямой источник телефонии, например Streamtelecom
• публичный API — без подключения к какому-либо поставщику вообще: вы сами отправляете данные звонков и чатов через API-ключ

Управление источниками данных находится в разделе Настройки -> Источники данных.

Вкладки

Раздел включает две вкладки:

Подключение

Используйте эту вкладку, чтобы:

• просмотреть текущий подключённый источник
• изучить метаданные подключения: поставщик, домен, дата установки
• сменить источник
• отключить источник

Смена или отключение источника требует подтверждения в диалоговом окне, так как это влияет на процесс приёма данных.

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

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

Отключённое CRM-приложение можно включить обратно на той же вкладке: во вкладке «Подключение» оно отображается со статусом Отключено и кнопкой Подключить снова, которая заново подписывает портал на события о звонках. Если за это время авторизация портала перестала действовать, при попытке подключения мы сообщим, что приложение нужно установить в портале заново.

Импорт

Используйте эту вкладку для запуска первоначального или догоняющего импорта, если источник его поддерживает.

Примечания:

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

Импорт списывает баланс за каждую запись, поэтому это действие в два шага: выберите объём и диапазон дат, нажмите «Рассчитать стоимость» — и 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, эти элементы намеренно скрыты.