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