Различия

Показаны различия между двумя версиями страницы.

--- билайн [2021/11/01 06:27] – создано timofeev
+++ билайн [2025/12/17 08:46] (текущий) – timofeev
@@ Строка 1: / Строка 1: @@
 ===Настройка интеграции «Водяного» с REST API провайдера «Билайн»===
-Для совершения исходящих звонков и показа информации о входящем звонке в программе один из компьютеров назначается сервером телефонии. Он должен иметь статический IP-адрес, доступный из внешней сети по порту 10385 (при перенастройке сетевого оборудования желательно сразу настроить диапазон адресов 10380-10400, он может потребоваться для других функций программы).\\
+Для совершения исходящих звонков и показа информации о входящем звонке в программе один из компьютеров назначается сервером Водяного (как правило это тот же компьютер, на котором находится база данных). Он должен иметь статический IP-адрес, доступный из внешней сети по порту 10385 (при перенастройке сетевого оборудования желательно сразу настроить и пробросы 10380, 10400).\\
 Программе «Водяной» в настройках брандмауэра должен быть разрешен выход в интернет.\\
 Для связи с АТС требуется, чтобы на машине, имеющей статический IP-адрес, был запущена служба «Водяной», а для остальных пользователей в «Водяном» были указаны внутренние номера телефонов (имена пользователей АТС).\\
 ==Настройка на стороне оператора==
-Для подключения необходимо зайти для настройки в личный кабинет ВАТС\\
+Для подключения необходимо зайти для настройки в личный кабинет ВАТС
 https://cloudpbx.beeline.ru/ \\
-и открыть в верхнем меню страницу «настройки», затем «API»\\
+и в разделе "услуги" включить услугу интеграции по API (ПЛАТНОЕ действие, ваш тариф изменится).\\
-На этой странице надо включить услугу (ПЛАТНОЕ действие, ваш тариф изменится).\\
+{{:beeline2025.png}}
 Затем нажать «создать новый токен» и ввести название, например, Водяной.\\
-{{:beeline1.png}}
+{{:beeline2025token.png}}
 Собственно значение токена (например, 8c0711c0-b11b-11fd-b111-111a111d18e1) скопировать и вставить в Водяном в соответствующее поле справочника облачных АТС.\\
 ==Справочник «Облачные АТС»==
-В создаем строку в справочнике «администрирование — облачные АТС», указываем в ней адрес сервера провайдера https://cloudpbx.beeline.ru/apis/portal\\
+В создаем строку в справочнике «администрирование — облачные АТС», указываем в ней адрес сервера провайдера <code> https://cloudpbx.beeline.ru/apis/portal </code> \\
 в поле «токен (пароль)» указываем токен, полученный в личном кабинете, например 8c0711c0-b11b-11fd-b111-111a111d18e1\\
 тип сервера выбираем Билайн.\\
@@ Строка 21: / Строка 22: @@
 В поле «Запускать сервер от имени пользователя» указываем пользователя «служба». Если такого нет — установите [[служба|службу Водяного]] через меню обработки — управление службой, (запустив программу от имени администратора КОМПЬЮТЕРА, нажав правую кнопку на ярлыке Водяного и выбрав соответствующий пункт меню).\\
-После записи настроек перезапускаем службу.\\
+После записи настроек **перезапускаем службу**.\\
+Не забудьте "пробросить" порт 10385 на сервер Водяного.\\
 ==Справочник «Внутренние номера телефонов»==
-В справочнике «Администрирование - Внутренние номера (настройки софтфонов)» надо создать строки, соответствующие каждому внутреннему номеру (пользователю АТС).\\
+В Водяном, в справочнике «Администрирование - [[внутренние_номера|Внутренние номера]] (настройки софтфонов)» надо создать строки, соответствующие каждому внутреннему номеру (пользователю АТС).\\
-Помимо наименования (номера), в поле «вариант подключения телефонии» выбираем «Билайн».\\
+Помимо наименования (номера), в поле «вариант подключения телефонии» выбираем «Билайн», а на вкладке "пользователь, пароль" указываем имя пользователя, как оно задано в атс (номера - абоненты - sip аккаунт, имеет вид 9117777777@ip.beeline.ru).\\
+Дополнительная информация (2024 год). К сожалению, по API может возвращаться иное имя пользователя, отличное от данных в личном кабинете АТС,  например 9117777777@abc.imc.mnc091.mcc150.311pnetwork.org (при этом до символа @ номер совпадает). Увидеть имя можно в протоколах интеграции с АТС (%ProgramData%\vodjanoj\ats) в строках информации о входящих звонках.\\
 {{:beeline3.png}}
@@ Строка 31: / Строка 35: @@
 Если Водяной работает локально, не на терминальном сервере и на компьютере установлена программа для звонков (софтфон), установите флажок «при исходящем вызове использовать callto:».\\
 Назначение номеров пользователям программы\\
-В справочнике «Администрирование — пользователи» на вкладке «IP-телефония» выбираем его внутренний номер. Если пользователь уже вошел в программу на момент назначения или изменения настроек номера, он должен выйти и войти повторно для использования телефонии.\\
+В справочнике «Администрирование — пользователи» на вкладке «IP-телефония» выбираем его внутренний номер. \\
+Если пользователь уже вошел в программу на момент назначения или изменения настроек номера, он должен выйти и войти повторно для использования телефонии.\\
+[[телефония|к списку интеграций с облачными АТС]]
+[[облачные_атс|Справочник «Облачные АТС»]]
+[[внутренние_номера|Внутренние номера (настройки софтфонов)]]