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