Go to the website

Настройка интеграции с телефонией (VOIP)

Ветменеджер может интегрироваться с рядом облачных АТС, а также с облачными телефониями на базе Астериск.

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

Настройка интеграции с телефонными системами

Ветменеджер интегрирован с двумя типами телефонных систем, и их настройка существенно отличается.

  • Облачные телефонные сервисы, Виртуальные IP АТС  (Манго, Zadarma, Binotel и др.)
  • Офисные IP телефонии или офисные IP АТС: Asterisk-совместимые системы (MyPBX, FreePBX), а также Oktell.

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

Подключение собственной АТС Asterisk (FreePBX или MyPBX)

Внимание! Настройку должен выполнять администратор Asterisk/FreePBX.

Для интеграции могут использоваться три независимых подключения:

  • AMI — для получения событий звонка и показа уведомлений;
  • CDR — для загрузки истории звонков;
  • FTP/FTPS — для получения записей разговоров.

На firewall АТС разрешите подключения от Vetmanager с диапазона IP `84.38.177.144/28`. Откройте только порты, которые используются для AMI, CDR и FTP/FTPS.

Перейдите в Настройки → Интеграция с сервисами → Телефония своя → Asterisk и нажмите кнопку редактирования.


Форма VOIP

  • Вид VOIP — выберите оболочку АТС: MyPBX или FreePBX.
  • Для всех клиник — включите, если одна АТС используется во всех филиалах. Если у каждого филиала отдельная АТС, не включайте эту настройку и заполните параметры для каждой клиники отдельно.
  • Автоматическое закрытие незаполненных сообщений о поступившем звонке — автоматически закрывает уведомление после завершения звонка.
  • Разрешать закрывать незаполненную форму редактирования звонка — позволяет закрыть карточку звонка без заполнения полей.


Подключение к серверу АТС по AMI

AMI используется для получения событий звонков в реальном времени.

Заполните поля:

  • IP — публичный IP-адрес или DNS-имя сервера Asterisk;
  • Порт — TCP-порт AMI, обычно `5038`;
  • Логин — логин пользователя AMI;
  • Пароль — пароль пользователя AMI;
  • Включено — включает получение событий телефонии.

На firewall АТС разрешите входящие подключения к порту AMI только из диапазона Vetmanager: `84.38.177.144/28`.

Проверка обработки событий звонка

Успешное подключение к AMI подтверждает доступность сервера и правильность учётных данных, но не подтверждает обработку всех сценариев звонка. События могут отличаться в зависимости от конфигурации Asterisk/FreePBX, PJSIP, очередей, переводов и dialplan.

После подключения выполните тестовые входящие и исходящие звонки. Если события отличаются от стандартного шаблона FreePBX, разработчик Vetmanager скорректирует `voip_json_config`.

Как Vetmanager обрабатывает события Asterisk: настройка voip_json_config


Подключение к CDR (MySQL/MariaDB)

CDR используется для загрузки истории завершённых звонков в модуль «Телефония». Для подключения используется IP или DNS-имя сервера, указанное в разделе AMI.

Заполните поля:

  • CDR Port — TCP-порт MySQL/MariaDB, обычно `3306`;
  • CDR DB Name — имя базы данных с журналом звонков;
  • CDR DB User — логин пользователя базы данных;
  • CDR DB Password — пароль пользователя базы данных.

Пользователю базы данных достаточно прав на чтение таблиц CDR. На firewall разрешите подключение к порту базы только из диапазона Vetmanager `84.38.177.144/28`.

Подключение к FTP

FTP/FTPS используется для получения записей разговоров.

Заполните поля:

  • Server — публичный IP-адрес или DNS-имя FTP/FTPS-сервера;
  • Port — порт FTP/FTPS-сервера;
  • Call recordings path — путь к каталогу с записями разговоров;
  • User — логин пользователя FTP/FTPS;
  • Password — пароль пользователя FTP/FTPS;
  • Use SSL — включите для подключения с использованием SSL.

На firewall разрешите подключение к FTP/FTPS только из диапазона Vetmanager `84.38.177.144/28`. Если сервер работает в пассивном режиме, также откройте настроенный диапазон пассивных портов.

Для корректного определения клиента по номеру телефона необходимо указать:

  • Телефонный код города клиники — указывается телефонный код город.
  • Код страны (через запятую) — указываются все телефонные коды, которые смогут выполнять входящие звонки.

После заполнения полей нажмите Сохранить (кнопка с дискетой).


Подключения проверяются отдельно:

  • AMI — доступность порта и авторизация;
  • CDR — подключение к базе данных;
  • FTP/FTPS — доступ к каталогу записей.

Успешная проверка соединения не подтверждает корректную обработку всех событий звонка. После сохранения выполните:

  1. входящий звонок с ответом;
  2. входящий пропущенный звонок;
  3. исходящий звонок с ответом;
  4. исходящий звонок без ответа;
  5. завершение разговора каждой стороной;
  6. перевод и звонок через очередь, если эти функции используются.

Проверьте появление уведомлений, направление звонка, внутренний номер, запись звонка в журнале и доступность записи разговора.

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

  • название и версию Asterisk/FreePBX;
  • используется ли PJSIP;
  • время тестового звонка;
  • направление звонка;
  • внешний и внутренний номера;
  • ожидаемый и фактический результат;
  • результат проверки AMI, CDR и FTP/FTPS.

Затем нажмите Запрос-подключение к Asterisk. Не отправляйте логины и пароли в открытом сообщении.

Подключение к Oktell

Перейдите в Настройки — Интеграция с сервисами — выберите раздел Телефония своя — Астериск — нажмите редактировать (карандаш).

В форме VOIP в поле Вид VOIP выберите Oktell.

Подключение к серверу АТС

Заполните параметры подключения к серверу Oktell:

  • IP — адрес сервера Oktell.
  • Порт — порт подключения.
  • Логин — логин пользователя для подключения.
  • Пароль — пароль пользователя для подключения.
  • Включено — при включении настройки в программе появится возможность отображать сообщения о входящих и исходящих звонках.

Подключение к CDR

CDR используется для выгрузки журнала звонков в модуль Телефония. Для Oktell Ветменеджер получает данные о звонках из базы данных Oktell.

Заполните параметры подключения к CDR:

  • CDR Port — порт подключения к базе данных.
  • CDR DB Name — название базы данных Oktell.
  • CDR DB User — логин пользователя базы данных.
  • CDR DB Password — пароль пользователя базы данных.

Получение записей разговоров

Для Oktell вместо FTP используется ссылка получения файла записи.

Заполните поле Script URI — адрес, по которому Ветменеджер сможет получить файл записи разговора.

После настройки Ветменеджер сможет синхронизировать журнал звонков, отображать данные о звонках в программе и получать записи разговоров, если они доступны на стороне Oktell.

Для корректного определения клиента по номеру телефона также укажите:

  • Телефонный код города клиники.
  • Код страны (через запятую).

После заполнения всех полей нажмите Сохранить и проверить.

Подключение к Облачным IP АТС

Настройки — Интеграция с сервисами — VOIP — Облачная АТС.

В открывшейся форме нужно выбрать провайдера и заполнить поля значениями из панели администратора в личном кабинете облачной АТС.

Ветменеджер работает с такими облачными АТС:

Gravitel

В личном кабинете в панели администратора в настройках интеграции нужно включить доступ к API и получить адрес облачной АТС и API ключ, а также заполнить поля Адрес вашей CRM и Ключ для авторизации в вашей CRM.


WestCall

Необходимо проделать аналогичные действия, что описаны в разделе Gravitel.


Дом.ru

Необходимо проделать аналогичные действия, что описаны в разделе Gravitel.


МегаФон

В настройках программы нужно выбрать провайдер ItooLabs.  

Необходимо проделать аналогичные действия, что описаны в разделе Gravitel.


Binotel

Для включения API облачной АТС необходимо отправить запрос в техподдержку провайдера с запросом включить API и выдать ключи доступа. Также в письме необходимо указать адрес вашей программы для получения сообщений из АТС.

Адрес можно посмотреть в поле Адрес CRM после нажатия на кнопку Сгенерировать.

В ответ должно прийти письмо с API ключом (REST API key) и API паролем (secret), их нужно ввести в поля “Уникальный код АТС” и “Ключ для подписи”.

Поле “Адрес облачной АТС” не используется


Mango-office

Для получения скидки позвоните по бесплатному номеру телефона 8-800-333-53-91 и назовите кодовое слово «ВЕТМЕНЕДЖЕР»

Для интеграции необходимо заполнить настройки в программе данными из панели администрирования в mango office:

  • Провайдер - выбираем Mango office
  • Уникальный код АТС - сюда вставляем уникальный код вашей АТС
  • Ключ для подписи - данные поля Ключ для создания подписи

В панели администрирования mango-office в поле Адрес внешней системы нужно внести данный из поля программы Адрес CRM


Важно: в разделе Интеграции Mango Office должна быть снята галочка «Не отправлять уведомления о промежуточном состоянии вызова и его параметрах (событие events/call)».

Если эта галочка включена, Mango Office передает в Ветменеджер только информацию о завершенном звонке и не отправляет уведомление о входящем вызове. В результате при звонке всплывающее окно с информацией о клиенте не появится.

Zadarma (Новофон)

Для получения ключей подключения к API необходимо отправить запрос. На почту придет письмо со ссылкой, по которой можно получить ключи. Значение из поля “Key” необходимо ввести в поле API Ключ, “Secret” —  в поле API Секрет.

Для получения сообщения о звонках необходимо ввести сгенерированную ссылку из поля “Адрес CRM” в поле “Ссылка вашего ресурса” и нажать кнопку “Обновить”.

Для Новофон необходимо перейти в раздел Интеграции и добавить ссылку для оповещения о звонках. 

Если в программе нет никаких входящих звонков то нужно перейти в личный кабинет https://my.zadarma.com/: Моя АТС — Внутренние номера – Включить. 

Если вкладки Моя АТС нет, то нужно активировать бесплатную АТС (кнопка “Настроить” на скриншоте)

https://zadarma.com/ru/support/instructions/pbx/


Настройки телефонии

Во вкладке Настройки телефонии можно произвести следующие настройки: 

  • Время отображения уведомления о звонке после ответа на звонок (в секундах)
  • Для всех клиник (если поставить галочку, во всех клиниках сети будут использоваться текущие настройки) 
  • Отображать сообщения о поступающих/исходящих звонках
  • Автоматическое закрытие незаполненных сообщений о поступившем звонке
  • Разрешать закрывать незаполненную форму редактирования звонка
  • Показывать уведомления о звонках всем пользователям.


Настройка справочников

Во вкладке Настройка справочников можно добавить, отредактировать или деактивировать результаты звонка и типы звонков. 


Абоненты

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

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

В колонке Привязка к клинике можно настроить, у каких пользователей будет всплывать окошко о звонке. Например, если к Клинике 1 привязан номер 110, то этот же пользователь, работая в Клинике 2, всплывающее окошко о звонке не увидит.   


Powered by