Телефония: Mango Office, UIS, МегаФон
Как подключить виртуальную АТС, чтобы записи звонков автоматически попадали на анализ в CallSense.
Интеграция с виртуальной АТС — самый простой способ анализировать все звонки без ручной загрузки. Платформа по расписанию забирает журнал звонков, список сотрудников и записи разговоров, а дальше их обрабатывает автоматизация CallSense.
Все провайдеры подключаются в разделе «Интеграции» → «Телефония»: найдите провайдера в блоке «Доступные провайдеры» и нажмите «Добавить». Общий порядок подключения, проверки и отключения описан в статье Интеграции: обзор.
Что загружается
| Данные | Mango Office | UIS | МегаФон (UIS) | МегаФон (PBX) |
|---|---|---|---|---|
| Журнал звонков | да | да | да | да |
| Сотрудники и добавочные номера | да | да | да | да |
| Записи разговоров | да | да | да | да |
Сотрудники АТС становятся операторами: в подразделе «Интеграции» → «Операторы» их можно связать с участниками команды. Тогда звонки распределяются по сотрудникам, а фильтры по операторам и добавочным номерам работают в автоматизациях и отчётах.
Загрузка у телефонии работает в режиме «REST pull»: платформа сама опрашивает АТС с выбранной периодичностью.
Mango Office
Где взять ключи
В личном кабинете Mango Office откройте настройки подключения по API. Там указаны уникальный код вашей АТС и ключ для создания подписи.
Поля формы
| Поле | Что указать |
|---|---|
| «Название» | Например, «Mango — колл-центр» |
| «Uin (уникальный код вашей АТС)» | Уникальный код АТС из настроек API |
| «API ключ (ключ для создания подписи)» | Ключ для подписи запросов из тех же настроек |
| «Режим загрузки» | «REST pull» |
| «Расписание загрузки» | «Каждую минуту», «Каждые 15 минут», «Каждый час» или «Раз в сутки» |
| «Список добавочных номеров (через запятую)» | Необязательно. Например, 101,102,103. Если оставить пустым, загружаются все доступные добавочные |
Список добавочных удобен, если анализировать нужно только один отдел: остальные звонки даже не будут загружаться.
UIS
Где взять ключ
В личном кабинете ВАТС UIS откройте «Настройки» → «API» и создайте ключ доступа к API.
Поля формы
| Поле | Что указать |
|---|---|
| «Название» | Например, «UIS — продажи» |
| «API-токен» | Ключ доступа к API из личного кабинета |
| «Адрес Data API» | Заполнен по умолчанию. Меняйте, только если поддержка выдала другой адрес |
| «Режим загрузки» | «REST pull» |
| «Расписание загрузки» | Как часто забирать новые звонки |
МегаФон (UIS)
У МегаФона несколько видов виртуальной АТС. Интеграция «МегаФон (UIS)» — для АТС, которая работает на той же платформе, что и UIS, поэтому подключение устроено одинаково. Если адрес вашего личного кабинета выглядит как vatsXXXXXX.megapbx.ru, это другая АТС — см. раздел «МегаФон (PBX)» ниже.
Где взять ключ
В личном кабинете ВАТС МегаФон откройте «Настройки» → «API» и получите ключ доступа.
Поля формы
| Поле | Что указать |
|---|---|
| «Название» | Например, «МегаФон — офис» |
| «API-токен» | Ключ доступа к API из личного кабинета ВАТС |
| «Адрес Data API» | Заполнен по умолчанию. Меняйте, только если поддержка выдала другой адрес |
| «Режим загрузки» | «REST pull» |
| «Расписание загрузки» | Как часто забирать новые звонки |
МегаФон (PBX)
Для виртуальной АТС МегаФон с личным кабинетом по адресу вида vatsXXXXXX.megapbx.ru.
Где взять ключ
- В кабинете АТС откройте «Тариф» → «Изменить тариф», отметьте опцию «Интеграция с CRM» и сохраните. Опция платная, стоимость видна в той же таблице.
- Откройте «Настройки» → «Ещё» → «Интеграция с CRM», в карточке «Ваша CRM» нажмите «Подключить».
- Впишите имя подключения, например «CallSense», и нажмите «Сохранить».
- Скопируйте «Ключ для авторизации в АТС».
Пока опция выключена, проверка доступа сообщит, что «Интеграция с CRM» не подключена.
Поля формы
| Поле | Что указать |
|---|---|
| «Название» | Например, «МегаФон — офис» |
| «Адрес АТС» | Адрес личного кабинета, например https://vats123456.megapbx.ru |
| «Ключ API» | «Ключ для авторизации в АТС» из кабинета |
| «Линии» | Необязательно. Номера компании через запятую — загружаются только звонки через эти номера. Пусто — все линии |
| «Режим загрузки» | «REST pull» |
| «Расписание загрузки» | Как часто забирать новые звонки |
У каждого звонка сохраняется номер компании, через который он прошёл. Чтобы анализировать только часть линий в автоматизации, используйте фильтр по номеру звонящего или вызываемого либо фильтр «Операторы».
Проверка после подключения
- Нажмите «Проверить доступ» — платформа проверит ключ. Для UIS и «МегаФон (UIS)» также определяется часовой пояс аккаунта, чтобы время звонков отображалось правильно.
- Сохраните интеграцию и нажмите «Sync» — загрузятся сотрудники АТС.
- Нажмите «Проверить интеграцию»: в результатах будут разделы «Доступ», «Пользователи», «Звонки» и «Запись». Если звонки найдены и запись доступна — всё готово.
Запуск анализа
Чтобы звонки начали анализироваться, в рабочем пространстве CallSense создайте автоматизацию: «Автоматизация» → «Создать автоматизацию», в поле «Тип источника» выберите подключённую АТС. В шаге «Фильтры триггеров» можно ограничить загрузку, например:
- «Мин. длительность (сек)» — отсечь короткие и пропущенные звонки;
- «Добавочные номера» или «Операторы» — анализировать только нужных сотрудников;
- «Направление звонка» — только входящие или только исходящие.
Подробнее — в статье Автоматизации.
Если что-то не работает
- «Проверка не выполнена.» — проверьте, что ключ скопирован целиком и не был отозван в личном кабинете АТС.
- Звонки есть, но записей нет — убедитесь, что запись разговоров включена в настройках АТС для нужных сотрудников.
- Звонки не попадают в CallSense — проверьте, что интеграция активна, автоматизация создана и включена, а её фильтры не слишком строгие.
Если АТС одновременно связана с Bitrix24, обычно удобнее загружать звонки через Bitrix24: тогда каждый звонок будет сразу привязан к лиду или сделке.