Интеграция с телефонией Новофон

"Компанией ЛарджСпейс реализован собственный модуль интеграции с телефонией Новофон (бывшая Задарма) для внедрения как отдельное решение или как подсистема в существующие расширения.

Назначение решения

Назначение решения - предоставить возможность интеграции телефонии Новофон с существующим решением 1С, как в автономном варианте, так и при встройке в существующее расширение. Решение использует сервер-клиент вызовы через обсуждения для более быстрой реакции на входящий звонок, а также HTTP-сервисы для организации обработки веб-хуков со стороны телефонии. Данный модуль позволяет обрабатывать входящие звонки, выполнять исходящий звонок клиенту, просматривать историю звонков по клиентам.

Объекты подсистемы

Интеграция с телефонией включает в себя следующие объекты метаданных:

• Подсистемы:
  • ЛС_ТелефонияНовофон
• Общие модули
  • БЛС_РеглЗадания - для подключения регламентных заданий телефонии
  • ЛС_ЗадармаБиблиотеки - библиотечные процедуры для работы интеграции
  • ЛС_ЗадармаКоллтрекинг
  • ЛС_ЗадармаКоллтрекингВызовСервера
  • ЛС_ЗадармаКоллтрекингИнтерфейс
  • ЛС_ЗадармаКоллтрекингСлужебный
  • ЛС_ЗадармаОбменСерверКлиент
  • ЛС_ЗадармаОбменСерверКлиентНаКлиентеГлобальный - для подключения либо обработчика от системы взаимодействия, либо обработчика ожидания по получению данных о новых звонках
  • ЛС_ЗадармаОбщиеПроцедуры
  • ЛС_ЗадармаТелефония
  • ЛС_ЗадармаТелефонияAPI
  • ЛС_ЗадармаТелефонияВызовСервера
  • ЛС_ЗадармаТелефонияКлиент
  • ЛС_ЗадармаТелефонияПовтИсп
• Роли
• Функциональные опции
• Определяемые типы
• Общие команды
• Группы команд
• Общие формы
• Общие картинки
• HTTP-сервисы
• Константы
• Справочники
• Документы
• Обработки
• Отчеты
• Перечисления
• Планы видов характеристик
• Регистры сведений

Технические операции для подключения телефонии

Для подключения интеграции с телефонией необходимо выполнить следующие действия со стороны 1С:

1) Войти в пользовательском режиме под полными правами, через режим технического специалиста открыть константу (ЛС) Телефония Новофон. Использовать интеграцию. Включить.

2) Создать профиль "Телефония Новофон" с ролями:

а) (ЛС) Телефония Новофон. Доступ к API

б) Запуск внешнего соединения

После создания профиля создать одноименную группу с указанием ссылки на профиль

Создать служебного пользователя (например ТелефонияНовофон). Для пользователя обязательно установить пароль. Подключить пользователю профиль "Телефония Новофон" через одноименную группу

3) Подготовить публикацию базы 1С на веб-сервере. Для этого необходимо через конфигуратор создать нужный профиль публикации, обязательно указав галочку "Публиковать HTTP-сервисы расширений по умолчанию". Затем нужно отредактировать файл публикации, явно указав логин и пароль от нашего пользователя в конце строки ib, например

ib="Srvr="localhost";Ref="fb_unf";Usr=ТелефонияНовофон;Pwd=password;>

После настройки нужно перезагрузить службу веб-сервера

Следующие операции выполняются в личном кабинете Новофон.

1) В личном кабинете нужно перейти в раздел "Настройки" - "Интеграции и API".

2) Перейти на закладку "Ключи и API"

3) Нажать на кнопку "Создать ключи" На почту придут данные Key и Secret. Их нужно указать в полях на данной странице, а также в панели управления телефонией в 1С

4) Перейти на закладку "Интеграции", добавить интеграцию "Уведомления о событиях"

Указать в ссылке "О звонках в АТС" значение: <путь к базе 1С>/hs/sip

В ссылке "О событиях" значение: <путь к базе 1С>/hs/ct

Также необходимо отметить что данная интеграция является основной - это позволит управлять маршрутизацией звонков через 1С

Эксплуатация решения

Для управления телефонией (персональные настройки, список звонков и т.д.) используется панель телефонии. По первом запуске системы она не будет открываться автоматически, поэтому ее нужно открыть самостоятельно. Расположение панели телефонии определяется разработчиком при внедрении подсистемы. Для получения доступа к панели необходимо предоставить пользователю роль ...

В панели телефонии есть три закладки:

1. Основное – для осуществления вызова по номеру телефона в произвольном виде, а также просмотра связей между внутренним номером и пользователем 1С
2. История – для просмотри истории звонков с уазанием номера звонящего, получателя, переадресации на внутренний номер, клиента, длительность звонка и состояния.
3. Пропущенные – список пропущенных входящих звонков.

Также в правой части панели находится кнопка шестеренки для выполнения индивидуальных настроек.

Кнопка индивидуальных настроек

В персональных настройках указываются параметры индивидуальные для пользователя

Индивидуальные настройки

В настройках можно включить автоматический запуск панели телефонии, а также настроить поведение системы при звонке – отображать только окно или открывать окно и карточку клиента. В процессе развития модуля могут появиться и другие настройки.

Кроме этого в административном режиме рядом с признаком активности API находится команда настройки администратором.

Исходящие звонки

Для совершения исходящего звонка можно использовать поле ввода номера телефона на панели телефонии, а также воспользоваться командой звонка, доступной у карточке контрагента, партнера, документах спецификации, заказа покупателя и события звонка:

Набор номера в панели для совершения звонка

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

Уведомление об исходящем звонке

В карточке заказа покупателя и в контрагенте присутствует подменю «Новофон», в котором размещена команда «Позвонить». При нажатии на кнопку отобразится один или несколько телефонов клиента и его контактных лиц. Нужно выбрать нужный телефон и нажать кнопку Позвонить.

Меню для звонков