на главную страницу программы "Водяной"

Инструменты пользователя

Инструменты сайта


asterisk

Различия

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

Ссылка на это сравнение

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