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

Обзор

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

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

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

Вкладки

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

Подключение

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

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

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

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

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

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

Переключатель Комментарий о состоянии сделки для подключённого источника Bitrix24 или Uspacy находится не на этой вкладке, а в Настройках анализа → Обновление CRM — по умолчанию включён, тарифы Pro и выше (у Uspacy, где нет сопоставления полей, шаг появляется только на этих тарифах), менять его могут Владелец и Администратор. После каждого проанализированного разговора по сделке или лиду Aelo добавляет в ленту CRM отдельный комментарий с состоянием сделки — только в активную CRM организации (ту, что получает отчёты о звонках) и только по разговорам не старше 7 дней. Переключатель не зависит от переключателей комментария и заметки с отчётом о звонке. См. Сделки.

Импорт

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

Примечания:

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

Импорт списывает баланс за каждую запись, поэтому это действие в два шага: выберите объём и диапазон дат, нажмите «Рассчитать стоимость» — и Aelo покажет, сколько записей в диапазоне, сколько это минут к оплате и сколько будет списано с учётом включённых минут тарифа и кошелька. Кнопка «Запустить» разблокируется только после этого, а смена диапазона требует пересчёта: сумма, которую вы подтверждаете, всегда относится к тому диапазону, который импортируется. Если оценка превышает баланс, запуск возможен, но сумму нужно ввести вручную.

Импорт телефонии из CDR охватывает не более 30 дней за один запуск — это ограничение API самого провайдера. Более длинную историю импортируйте последовательными запусками.

Сопоставление полей CRM (доставка результатов анализа обратно в CRM) больше не является вкладкой этого раздела — оно настраивается отдельно, в «Настройка анализа → Обновление CRM», и сопоставление полей доступно только организациям на Bitrix24. Сам шаг показывается организациям на Bitrix24 и Uspacy: у Uspacy в нём только переключатель Комментарий о состоянии сделки, и шаг показывается только на тарифах, где есть состояние сделки (Pro и выше). Элементы управления Smart Process специфичны для Bitrix24.

Мастер источника

Если ни один активный источник не подключён, Aelo показывает пошаговый мастер источника:

Выбор источника
Настройка учётных данных/параметров
Тест подключения
Импорт начальных данных (если поддерживается)

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

Текущие поддерживаемые источники

Bitrix24

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

Unitalk

прямой источник телефонии, облачная АТС / контакт-центр — бета
вебхук-приём
тестирование/настройка через процесс «Источники данных»
массового импорта прошлых звонков нет: звонки приходят вебхуком, а ещё Aelo каждые несколько минут забирает новые звонки из истории Unitalk, так что пропущенный вебхуком звонок всё равно придёт
без записи обратно в CRM

Streamtelecom

прямой источник телефонии
вебхук-приём
тестирование/настройка через процесс «Источники данных»
импорт/бэкфилл из истории CDR
без записи обратно в CRM

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

Streamtelecom предоставляет два независимых потока:

История звонков (CDR) — импортируется сразу после подключения по логину, паролю и API-ключу. API-ключ находится в кабинете Stream Telecom: Администрирование → Профиль компании → API KEY.
Звонки в реальном времени — приходят по вебхуку, который активирует только поддержка Stream Telecom (самостоятельно включить нельзя). На шаге мастера «Приём звонков в реальном времени» скопируйте ваш webhook URL и отправьте готовое письмо на support@streamtele.com — это подписка на события Stream CALL API v3.0. Активация обычно занимает до 24 часов. В URL есть секретный токен, поэтому отправляйте его только в поддержку Stream Telecom; снова получить его можно в Настройки → Источники данных → Подключение по кнопке Показать адрес (владелец и администраторы).

Binotel

прямой источник телефонии
вебхук-приём (звонки принимаются с адресов Binotel)
импорт/бэкфилл из истории CDR
может быть и источником только аудио для записей, приходящих из Bitrix24
без записи обратно в CRM

Ringostat

облачная АТС — та же категория, что у Streamtelecom и Binotel, а не инструмент аналитики звонков
бета: вебхук-приём через процесс «Источники данных» — звонки приходят после настройки вебхука в Ringostat с заголовком Authorization (как настроить)
формат вебхука ещё не подтверждён на реальных данных Ringostat, а проверка подключения не обращается к Ringostat: если после настройки звонки не появились, напишите в поддержку
массовый импорт недоступен: импорта истории звонков (CDR) нет
без записи обратно в CRM

Правила активного источника

один активный источник телефонии на роль (источник записей или источник только аудио), а не на организацию
переключение активного источника деактивирует предыдущий источник телефонии
состояние подключения считывается с бэкенда, а не определяется локально в UI

Типичный рабочий сценарий

Откройте Настройки -> Источники данных
Запустите мастер или нажмите Изменить
Выберите провайдера
Введите специфичные для провайдера учётные данные/конфигурацию
Запустите тест подключения, если доступно
Начните первоначальный импорт, если источник поддерживает
Для CRM-источников настройте сопоставление полей в «Настройка анализа → Обновление CRM»

Примечания по обновлению CRM

Для источников с поддержкой CRM раздел «Настройка анализа → Обновление CRM» может включать:

маппинг полей
переключатели доставки транскрипта/резюме/оценки
настройку или ремонт Smart Process (если применимо)

Для источников только-телефония Aelo считает интеграцию только-входящей, и шаг «Обновление CRM» для них недоступен.

Устранение проблем

Мастер открывается, хотя источник подключён

Обычно это означает, что UI не смог определить активный источник. Проверьте доступность API и перезапустите раздел «Источники данных».

Шаг «Обновление CRM» недоступен

Это ожидаемо для прямых источников телефонии — шаг «Настройка анализа → Обновление CRM» существует только для организаций на Bitrix24 и Uspacy. У Uspacy он к тому же показывается только на тарифах, где есть состояние сделки (Pro и выше); на тарифе ниже отсутствие шага — ожидаемо.

Элементы управления Smart Process отсутствуют

Smart Process специфичен для Bitrix24. Если активный провайдер — не Bitrix24, эти элементы намеренно скрыты.