Подключение АТС МТС к 1С:УНФ

14.07.20

Интеграция - Телефония, SIP

В статье опишу реализацию HTTP сервиса для приема уведомлений от АТС.

Вводные

1. Набор сотовых номеров привязанных к АТС

2. Нужно зафиксировать в 1С:УНФ для наполнения информацией о телефонных звонках и их контактах.

3. Из всего многообразия подключений именно с этой АТС нет, хотя на "источнике" в Рарус:Софтфон реализация появилась.

 

Документация и поддержка

Документация доступна в формате PDF только из ЛК АТС (https://vpbx.mts.ru/)

Сообщения идут с IP (в документации это не указано)

  • 213.87.45.43
  • 213.87.45.47

Для сис админов которые открывают порт для всего интернета рекомендую прочитать http://184.105.247.252/, этот IP выловлен из логов апача, при том что входящий порт HTTP нестандартный.

 

Сообщения телефонии шлют параллельно два канала (если включить),

  1. HTTP API, но для этого нужно добавить пользователя в подписку POST запросом, при этом добавляя подписку по одному пользователю уведомления идут по всем.
  2. WebHook (по факту тот же протокол) который при недоступности принимающей стороны может отключится, активируется через POST запрос

В документации такое поведение объяснено "оптимизацией нагрузки на сервер vpbx".

Вопрос решается по цепочке "менеджер по продажам" - "ответственный по АТС в регионе" - "группа разработки".

Нормальной системы тикетов нет, только переписка по почте, в которой часть вопросов теряется.

 

Функционал

По функционалу и админ панели серьезно уступает Манго (сравниваю с ним потому что у клиента в параллель эта АТС), используем только потому что привязка сотовых к МТС.

Функция переадресации по API запустить не удалось, поэтому только фиксируем входящие. Функцию вызова из формы не реализовывал, пользователи звонят с сотовых и состыковка (физически) с формой на ПК работает не так хорошо как со стационарным SIP.

 

Реализация

Реализовал в виде расширения, добавил HTTP сервис с одним корневым URL и методом POST. Опубликовал HTTP сервис на web сервере.

Нужно учитывать что HTTP сервисы расширений публикуются все, в отличии от сервисов конфигурации список которых вы можете выбрать при публикации. Для телефонии (типовому блоку из УНФ) в файле vrd (настроек подключения web компоненты к базе) прописывается логин с паролем сервисного пользователя "TelephonyService" с правами "Администратор системы", соответственно под этими правами потенциально (если не отфильтровать) могут запускаться остальные сервисы (HTTP, Web, Odata).

 
 Код HTTP сервиса

 

Аутентификация проходит по токену

 
 Код аутентификации

 

Функции вынесены в общий модуль потому что при критичной ошибке в коде (HTTP 500) если код в модуле HTTP сервиса в журнал регистрации ничего не пишется. Предположу что это "оптимизация" для предотвращения забивания ЖР большим потоком запросов, хотя факт аутентификации по HTTP работает.

 
 Код обработки входящего сообщения

 

Результат обработки отправляю в подсистему телефонии УНФ, в которой решается вопрос фиксации события и уведомления пользователя.

Повтор подписки на событие, реализовал через функцию в общем модуле и сделал внешнюю обработку с серверным вызовом для простой настройки расписания.

 
 код обновления пописок

 

Итог

Относительно простое API сообщения от которого можно обработать одной процедурой и отправить в уже существующую подсистему телефонии.

Благодарю за внимание.

Вступайте в нашу телеграмм-группу Инфостарт

АТС МТС API

Вы можете заказать платную адаптацию этой статьи под ваши задачи на «Бирже заказов».

  • 0% комиссии — оплата напрямую исполнителю;
  • Исполнители любого масштаба — от отдельных специалистов до команд под проект;
  • Прямой обмен контактами между заказчиком и исполнителем;
  • Безопасная сделка — при необходимости;
  • Рейтинги, кейсы и прозрачная система откликов.

См. также

Разработка внешних компонент Телефония, SIP Разработчик 1С:Предприятие 8 1C:Бухгалтерия Россия Платные (руб)

Внешняя компонента выполнена по технологии Native API для 1С 8.х, обеспечивает доступ к программным АТС Asterisk (FreePBX, Elastix) через AMI интерфейс. Через него можно управлять многими функциями Asterisk (определение номеров, перевод звонков, набор телефона и т. д.)

5246 руб.

04.05.2018    52221    128    68    

72

Телефония, SIP Пользователь 1С:Предприятие 8 1С:Управление нашей фирмой 3.0 Автомобили, автосервисы Бытовые услуги, сервис Управленческий учет Абонемент ($m)

Расширение для 1С:УНФ, которое связывает облачную АТС Новофон с заказ-нарядами автосервиса. При входящем звонке оно находит последний заказ-наряд по номеру звонящего и сразу открывает его. Номер ищется у контрагента и у его контактных лиц. Узнать о звонке можно тремя способами: через вебхук Новофон, периодическим опросом API или по запросу. Для запроса есть яркая кнопка «Текущий звонок» в списке заказ-нарядов и клавиша F12. Пользователей 1С можно сопоставить с сотрудниками АТС или разрешить всем открывать текущий звонок на линии. Конфигурация УНФ остаётся на поддержке. В статье описаны устройство расширения, настройка, лимиты API и подводные камни разработки расширений.

1 стартмани

28.09.2026    422    0    krumenko    0    

0

Телефония, SIP Учет рабочего времени Анализ учета 1С:Предприятие 8 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1C:ERP Россия Платные (руб)

Расширение для 1С. Контролируйте реальные переговоры менеджеров прямо в 1С: смотрите статистику звонков, слушайте разговоры и быстрее находите слабые места в продажах.

6100 руб.

08.05.2026    874    0    0    

0

Телефония, SIP Пользователь 1С 8.3 Абонемент ($m)

Расширение для работы с телефонией Билайн. Код открыт и может быть доработан. Тестировалось на УТ 11.5, но должно работать на УТ11 / КА / ЕРП.

5 стартмани

02.04.2026    1000    1    4361fmv    0    

0

Телефония, SIP Разработчик Пользователь 1С 8.3 1С:Управление торговлей 11 Абонемент ($m)

Обработка загружает звонки по API MTS в документ Телефонный звонок.

10 стартмани

28.11.2025    1203    5    user2175092    0    

2

Телефония, SIP 1С:Предприятие 8 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Абонемент ($m)

Удобная универсальная обработка для быстрых звонков с мобильного телефона по контактам из 1С. Также поддерживается работа с электронными адресами, адресами сайтов, почтовыми адресами и другими видами контактов. Возможно копирование карточки контакта на мобильный телефон. Просто отсканируйте QR-код камерой телефона!

3 стартмани

26.11.2024    2285    2    bme    0    

3

Телефония, SIP Пользователь 1С:Предприятие 8 1С:Бухгалтерия 2.0 1С:Управление торговлей 10 Россия Абонемент ($m)

Данная внешняя обработка позволяет делать звонки из программы 1С, используя сервис сайта zvonok.com.

1 стартмани

18.01.2024    3926    1    v3132    0    

3

Телефония, SIP Россия Бесплатно (free)

Делимся опытом разработки системы обзвона абонентов-задолжников.

18.01.2024    3784    slavik27    11    

5
Для отправки сообщения требуется регистрация/авторизация