Настройка интеграции «Водяного» с REST API провайдера «Билайн»
Для совершения исходящих звонков и показа информации о входящем звонке в программе один из компьютеров назначается сервером Водяного (как правило это тот же компьютер, на котором находится база данных). Он должен иметь статический IP-адрес, доступный из внешней сети по порту 10385 (при перенастройке сетевого оборудования желательно сразу настроить и пробросы 10380, 10400).
Программе «Водяной» в настройках брандмауэра должен быть разрешен выход в интернет.
Для связи с АТС требуется, чтобы на машине, имеющей статический IP-адрес, был запущена служба «Водяной», а для остальных пользователей в «Водяном» были указаны внутренние номера телефонов (имена пользователей АТС).
Настройка на стороне оператора
Для подключения необходимо зайти для настройки в личный кабинет ВАТС
https://cloudpbx.beeline.ru/
ПЕРЕЙТИ В СТАРУЮ ВЕРСИЮ КАБИНЕТА БИЛАЙН (В НОВОЙ НАСТРОЙКА НЕДОСТУПНА)
и открыть в верхнем меню страницу «настройки», затем «API»
На этой странице надо включить услугу (ПЛАТНОЕ действие, ваш тариф изменится).
Затем нажать «создать новый токен» и ввести название, например, Водяной.
Собственно значение токена (например, 8c0711c0-b11b-11fd-b111-111a111d18e1) скопировать и вставить в Водяном в соответствующее поле справочника облачных АТС.
Справочник «Облачные АТС»
В создаем строку в справочнике «администрирование — облачные АТС», указываем в ней адрес сервера провайдера
https://cloudpbx.beeline.ru/apis/portal
в поле «токен (пароль)» указываем токен, полученный в личном кабинете, например 8c0711c0-b11b-11fd-b111-111a111d18e1
тип сервера выбираем Билайн.
В поле «Запускать сервер от имени пользователя» указываем пользователя «служба». Если такого нет — установите службу Водяного через меню обработки — управление службой, (запустив программу от имени администратора КОМПЬЮТЕРА, нажав правую кнопку на ярлыке Водяного и выбрав соответствующий пункт меню).
После записи настроек перезапускаем службу.
Не забудьте «пробросить» порт 10385 на сервер Водяного.
Справочник «Внутренние номера телефонов»
В Водяном, в справочнике «Администрирование - Внутренние номера (настройки софтфонов)» надо создать строки, соответствующие каждому внутреннему номеру (пользователю АТС).
Помимо наименования (номера), в поле «вариант подключения телефонии» выбираем «Билайн», а на вкладке «пользователь, пароль» указываем имя пользователя, как оно задано в атс (номера - абоненты - sip аккаунт, имеет вид 9117777777@ip.beeline.ru).
Дополнительная информация (2024 год). К сожалению, по API может возвращаться иное имя пользователя, отличное от данных в личном кабинете АТС, например 9117777777@spb.ims.mnc099.mcc250.3gppnetwork.org (при этом до символа @ номер совпадает). Увидеть имя можно в протоколах интеграции с АТС (%ProgramData%\vodjanoj\ats) в строках информации о входящих звонках.
Если Водяной работает локально, не на терминальном сервере и на компьютере установлена программа для звонков (софтфон), установите флажок «при исходящем вызове использовать callto:».
Назначение номеров пользователям программы
В справочнике «Администрирование — пользователи» на вкладке «IP-телефония» выбираем его внутренний номер.
Если пользователь уже вошел в программу на момент назначения или изменения настроек номера, он должен выйти и войти повторно для использования телефонии.