Различия

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

--- asterisk [2019/07/18 08:11] – timofeev
+++ asterisk [2024/02/12 14:28] (текущий) – timofeev
@@ Строка 17: / Строка 17: @@
 ==== Настройка Водяного для взаимодействия с Астериск =====
-Есть 2 режима работы: напрямую и через встроенный прокси. Вторая схема эффективнее (в т.ч. в части нагрузки на Астериск), но требует постоянно запущенного отдельного экземпляра Водяного в режиме сервера (эту функцию может исполнять тот же экземпляр, что и для мобильного приложения).\\
+Есть 2 режима работы: напрямую и через встроенный прокси. Вторая схема эффективнее (в т.ч. в части нагрузки на Астериск), но требует постоянно запущенного отдельного экземпляра Водяного в режиме сервера (можно задействовать тот же экземпляр, что и для мобильного приложения).\\
 ==== Режим "Астериск (AMI напрямую)" ====
-В этом режиме не требуется отдельного экземпляра Водяного в серверном режиме, обмен с сервером ведет каждый пользователь напрямую.\\
+В этом режиме обмен с сервером ведет каждый пользователь напрямую.\\
 === Добавление внутреннего номера в справочник ===
 Входим в меню администрирование- [[внутренние_номера|внутренние номера (настройки софтфонов)]].
@@ Строка 25: / Строка 25: @@
 {{:vn1.png|}}
-Вносим внутренний номер и выбираем вариант подключения телефонии "Астериск (AMI напрямую)"
+На вкладке "основные" вносим внутренний номер и выбираем вариант подключения телефонии "Астериск (AMI напрямую)"\\
+Флажок ”Искать клиента в базе только после поднятия трубки” на данный момент рекомендуется к установке - поиск номера телефона в базе начнется лишь после ответа оператора, что удобно, если звонок приходит одновременно ко всем сотрудникам. Кроме того, нагрузка на базу снизится по сравнению с поиском всех номеров, в т.ч. по звонкам, на которые сотрудник отвечать не будет.\\
-Кроме номера и варианта подключения на вкладке “основные” может потребоваться задать префикс выхода на городскую линию (например, 9) для исходящего звонка  и коды страны или города для входящего. Последние нужны, если оператор связи передает мобильные номера в 11-ти, а городские в 7 или 6-ти значном формате. При задании кода страны и города они добавляются впереди, если длина входящего номера меньше 11.\\
+Флажок “при исходящем вызове использовать callto” рекомендуется включить, если и Водяной, и софтфон (программа-"звонилка") установлены локально. При исходящем вызове Водяной запустит софтфон, назначенный на компьютере для обработки ссылок вида “callto:” (поддерживается подавляющим большинством софтфонов).\\
+ЕСЛИ ВЫ ИСПОЛЬЗУЕТЕ АППАРАТНЫЙ ТЕЛЕФОН, а не софтфон, либо работаете в терминальном режиме, НЕ включайте этот параметр.
+Кроме номера и варианта подключения на вкладке “основные” можно задать префикс выхода на городскую линию (например, 9) для исходящего звонка  и коды страны или города для входящего. Последние нужны, если оператор связи передает мобильные номера в 11-ти, а городские в 7 или 6-ти значном формате. При задании кода страны и города они добавляются впереди, если длина входящего номера меньше 11 (если вы не в России, отключите эту функцию через константу "").\\
+На вкладке "пользователь, пароль" указываем пользователя Астериск и его пароль (см п.1 требований к настройке АТС).\\
+{{:vn2.png|}}\\
+На вкладке Asterisk AMI указываем адрес сервера Asterisk (см п.1 требований к настройке АТС).
+Обязательно указываем контекст, обычно это “from-internal”. Если контекст не задан, то будет подставляться “default”.\\
 Полезно также задать список своих внешних телефонных номеров во избежание ложного определения входящих звонков с этих номеров.\\
+Флажок "Вести лог AMI" нужен для локализации проблем при настройке, в рабочем режиме необходимости в нем нет.\\
+"Автоответ при обратном вызове" определяет, будет ли при ИСХОДЯЩЕМ звонке сначала звонить телефон пользователя и только при снятии трубки начнется собственно вызов другого абонента. Удобнее, особенно при использовании гарнитуры, чтобы при наборе из программы пользователь "уже ответил" и не совершал лишних действий.
+Большинство аппаратных IP-телефонов поддерживают автоответ, но может потребоваться, в зависимости от модели телефона, изменить значение константы “заголовок автоответа” (по умолчанию SIPADDHEADER=Call-Info: Auto Answer).\\
+Если используются программные телефоны (софтфоны), целесообразнее включить упомянутый ранее режим “Вместо обратного вызова использовать callto”, исключение - если Водяной работает в режиме терминального сервера, а софтфон - локально. В такой ситуации вызов должен идти через команду originate Астериска, но автоответ должен поддерживаться софтфоном (в частности, такая функция есть в MicroSIP и в большинстве платных софтфонов). \\
-Задаем параметры на вкладке Asterisk AMI (пользователя, пароль, адрес сервера Asterisk):
+==== Астериск (AMI через встроенный прокси) ====
+Этот режим эффективнее (в т.ч. в части нагрузки на Астериск), но требует постоянно запущенного отдельного экземпляра Водяного в режиме [[служба|службы]].\\
+=== Добавление внутреннего номера в справочник ===
+Заполнение справочника внутренних номеров в таком случае несколько проще:\\
+{{:vn4.png|}}\\
+Заполняем лишь первую вкладку, указав внутренний номер, вариант подключения "Астериск (AMI через встроенный прокси)" и описанные ранее параметры с вкладки "основные".\\
+Параметры собственно Астериска и данные пользователя заполним в отдельном справочнике [[облачные_атс|"облачные АТС"]]
-Помимо пользователя, пароля и адреса сервера, может потребоваться указать:
+=== Заполнение справочника "Облачные АТС" ===
-) контекст, обычно это “from-internal”. Если контекст не задан, то будет подставляться “default”
+Открываем администрирование - [[облачные_атс|"облачные АТС"]].\\
-) параметры обратного вызова.
-Автоответ должен поддерживаться софтфоном (функция поддерживается бесплатным софтфоном MicroSIP, в большинстве других софтфонов доступна в платных версиях), большинстве аппаратных IP-телефонов (имеет смысл при использовании гарнитуры совместно с аппаратом).
-Для аппаратных телефонов может потребоваться, в зависимости от модели телефона, изменить значение константы “заголовок автоответа” (по умолчанию SIPADDHEADER=Call-Info: Auto Answer).
-) “Вместо обратного вызова использовать callto:”. Рекомендуется включение этого параметра, если и программа, и софтфон установлены локально. Вместо создания обратного вызова Водяной запустит софтфон, назначенный на компьютере для обработки ссылок вида “callto:” (поддерживается подавляющим большинством софтфонов).
-)”Искать клиента в базе только после поднятия трубки”. Включение параметра может снизить нагрузку на базу при одновременном звонке у всех операторов, как правило, не рекомендуется.
+Внимание! В поле «**Порт** локального ПК» по умолчанию установлен порт 10385, для Астериск его НЕОБХОДИМО ИЗМЕНИТЬ НА **5038**.\\
+В поле «Запускать сервер от имени пользователя» указываем пользователя "Служба" (если его еще нет - оставляем поле пустым). \\
+Тип сервера указываем "Астериск (AMI через встроенный прокси)".
-При взаимодействии с Астериск, если используется софтфон, установленный локально, а Водяной установлен на терминальном сервере, можно отметить “не ждать ответа responce…” и “автоответ при обратном вызове”.  Последний параметр позволяет при наборе номера из программы сразу включить соединение, без ответа на “виртуальный” звонок оператору, что удобнее стандартного поведения.
+{{:asteroats.png|}}\\
-Включение функции телефонии для пользователя
+Остальные параметры почти не отличаются от ранее описанных: адрес сервера, логин (указывается и в поле "учетная запись" и в поле "логин").
+Переходим на вкладку "Asterisk":\\
+{{:asteroats2.png|}}\\
+Указываем контекст (обычно from-internal) и автоответ при обратном вызове.\\
+Для снижения нагрузки на АТС и повышения стабильности обмена желательно заполнить поле фильтрации событий.\\
+Например, чтобы оставить только события поднятия трубки, указываем
+<code>
+Event: BridgeEnter
+</code>
-После внесения всех внутренних номеров назначим их пользователям. Открываем справочник “пользователи” в меню “администрирование” и на вкладке “IP-телефония” выбираем соответствующий номер для каждого пользователя.
+== Запуск в режиме службы ==
+Для начала работы серверной части Водяного требуется установить [[служба|службу]] на серверной машине. В дальнейшем служба будет запускаться автоматически после перезагрузки серверного компьютера.
-ами 3
+==== Включение функции телефонии для пользователя ====
+При любом режиме работы после добавления внутренних номеров следует указать, каким пользователи они принадлежат.\\
+После внесения всех внутренних номеров назначим их пользователям. Открываем справочник “[[пользователи|пользователи]]” в меню “администрирование” и на вкладке “IP-телефония” выбираем соответствующий номер для каждого пользователя.
+{{:polztel.png|}}
 После очередного входа в систему, пользователю станут доступны функции телефонии: в главном меню появится надпись “софтфон вкл.”, которая при входящем звонке будет заменяться на информацию о звонящем; двойной щелчок по номеру будет приводить к открытию карточки клиента или созданию нового клиента (если телефон не найден в справочнике адресов).
@@ Строка 61: / Строка 92: @@
-===== Интеграция с Октелл по протоколу AMI =====
+== Интеграция с Октелл по протоколу AMI ==
 Кроме Астериск, можно использовать другие АТС, поддерживающие протокол Asterisk Manager Interface (АМИ/AMI), в частности Октелл.
+[[телефония|Варианты интеграции Водяного с АТС]]