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