2651
правка
Изменения
м
Для осуществления звонков из мобильного приложения через сервер телефонии [httpsВсе подключения от клиентов на андроиде происходят с одного IP-адреса://ru138.wikipedia201.org/wiki/Asterisk Asterisk] используется подключение через [http://asteriskpbx228.ru/display/Asterisk/Asterisk+Managment+Interface+%28AMI%29 AMI]71, так что смело указывайте только его — этого требует безопасность.
Включите AMIОсторожно! AMI — вещь достаточно дырявая, задайте адреса, с которых и открытие порта на весь мир очень опасно. Тем более что через эту функцию можно получить к нему доступ в файле /etc/asterisk/managerза ваш счет соединить 2 произвольных номера.conf
Создайте Пропишите настройки подключения [https://home.courierexe.ru/extraclient/phones_settings здесь]:* '''Адрес сервера''' — IP или доменное имя. Предполагается, что у сервера Asterisk статичный внешний IP или проброшен порт AMI, иначе ничего работать не будет;* '''Порт сервера''' — на каком порту находится AMI;* '''Имя пользователя''' — логин AMI, созданный в manager.conf (или manager_custom.conf);* '''Пароль''' — пароль пользователя - ;* '''Канал''' — канал, через который должен происходить звонок. Обычно выглядит как «SIP/trunk_name», где trunk_name — название транка, прописанного, обычно это делается , в файле /etc/asterisk/sip.conf. Для старых версий драйвера SIP можно указывать «SIP/trunk_name», в этом случае номер звонящего будет подставляться в конце: «SIP/trunk_name/79001234567». Для новых версий драйвера SIP можно указывать «SIP/{NUMBER}@trunk_name», в этом случае номер звонящего будет подставляться вместо {NUMBER}: «SIP/79001234567@trunk_name»;* '''Контекст''' — контекст обработки запроса. Обычно настраиваются в диалплане в файлах файле /etc/asterisk/manager_customextensions.conf или <spoiler text="Тут настраивается запись исходящих">В стандартной поставке Asterisk не записывает исходящие звонки от курьеров. Решение — в /etc/asteriskразместить файл кастомного диалплана [http://courierexe.ru/download/managerextensions_custom.conf extensions_custom.conf]. В файле в 5-й строке нужно заменить транк на тот, который используется в вашей установке. Далее в настройках подключения мобильного приложения используйте контекст «from-courier». Чтобы в CDR звонки курьеров имели номер звонящего курьера, во второй строке файла уберите «<COURIER>». Это добавлено для того, чтобы можно было отфильтровать все звонки курьеров. Для уменьшения размера файлов записей рекомендуем использовать кодек G.729</spoiler>* '''Внутренний телефон офиса''' — внутренний номер, на который приходит звонок при выборе «Позвонить в офис». Рекомендуется в настройках Asterisk указать в этом поле номер группы менеджеров;* '''Городской телефон офиса''' — внешний номер телефона офиса. Приложение будет звонить по сотовой сети на этот номер в случае, если не удалось послать запрос на соединение с офисом в Asterisk. Заполните это поле, даже если не вы не интегрируете приложение с телефонией, это позволит курьерам совершать звонки в офис из приложения;* '''Префикс курьера''' — префикс, который будет добавляться к номеру вызывающего абонента;* '''Префикс клиента''' — префикс, который будет добавляться к номеру вызываемого абонента.
Откройте порт в файерволе (обычно 5038, прописывается в /etc/asterisk/manager.conf) ([httpsСохраните настройку и проверьте ее работоспособность://accessвведите 2 телефона и нажмите на кнопку '''Тест'''.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Security_Guide/sect-Security_Guide-Firewalls.html MeaSoft отправляет запрос на всякий случай Вам в помощь]). Все подключения от клиентов Asterisk, и он должен позвонить сначала на андроиде происходят с одного IP-адреса: 138.201.228.71первый телефон, потом, после поднятия трубки, так что смело "зажимайте" только идет вызов на него - этого требует безопасность. Осторожно! AMI - вещь достаточно дыряваявторой номер, и открытие порта на весь мир очень опасно. Тем более что через эту функцию можно за ваш счет соединить 2 произвольных номерапроисходит их коммутация.
Пропишите настройки подключения здесь: [https://home.courierexe.ru/extraclient/phones_settings https://home.courierexe.ru/extraclient/phones_settings]*'''Адрес На этом уровне MeaSoft может зафиксировать ошибку только в адресе сервера''' - IP или доменное имя. Предполагается, что у сервера Asterisk, естественно, статичный внешний IP или проброшен если указан неверный/закрытый порт AMI, иначе ничего работать не будет.*'''Порт сервера''' - На каком порту находится AMI*'''Имя пользователя''' - Логин AMI, созданный в manager.conf (или manager_custom.conf)*'''Пароль''' - пароль пользователя.*'''Канал''' - канал, через который должен происходить Если звонок. Обычно выглядит как "SIP/trunk_name"не удался, где trunk_name - название транкапроверьте все введенные данные, прописанного, обычнопосмотрите, что происходит в файле /etc/Asterisk с помощью команды <code>asterisk/sip.conf*'''Контекст''' - Контекст обработки запроса. Обычно настраиваются в диалплане в файле r</etc/asterisk/extensions.conf*'''Внутренний телефон офиса''' - Внутренний номер, на который приходит звонок, при выборе "Позвонить в офис". Рекомендуется в настройках Asterisk сделать этот номер - номером группы менеджеровcode>.*'''Городской телефон офиса''' - Внешний номер телефона офиса. Приложение будет звонить по сотовой сети на этот номер в случае, если не удалось послать запрос на соединение с офисом в Asterisk. '''Заполните это поле''', даже если не вы не интегрируете приложение с телефонией, это позволит курьерам совершать звонки в офис из приложения!
Сохраните настройку, и проверьте ее работоспособность, введя 2 телефона, и нажав кнопку "Тест"'''Примечание'''. Система должна отправить запрос на Asterisk, и он Для успешных звонков из мобильного приложения в карточке курьера должен позвонить сначала на первый телефон, потом, после поднятия трубки, идет вызов на второй быть введен номер, и происходит их коммутация. К сожалению, на этом уровне наша система может "поймать" и отобразить только ошибки подключения к AMI, т.е. ошибочный адрес сервера и/или неверный/закрытый порт. В случае неверного указания остальных данных, включая логин и пароль, система "подумает", что все прошло гладко, запрос она сформировала и на сервер отправила. В случае, если все хорошо - вы получите телефонный звонок. Если же этого не произошло - проверьте все введенные данные, попробуйте посмотреть что происходит мобильного телефона в астериске - команда "asterisk -r"соответствующее поле.
Events: on
Как Вы уже заметили$CALL-FROM-NUMBER и $CALL-TO-NUMBER нормируются и приводятся к международному формату +7ХХХХХХХХХХ (для России и Казахстана). Для других стран, возможно, тестирование не проводилось, в случае проблем обращайтесь, данная настройка будем изучать форматирование номеров в конкретной стране. Настройка подразумевает наличие глубоких знаний в области администрирования asterisk-сервераAsterisk, поэтому, убедительная просьба: если Вы вы ими не обладаете, прежде чем звонить нам и просить помощи, обратитесь к специалисту, поддерживающему вашу телефонию, покажите ему данное это руководство. С очень большой вероятностью ему все будет понятно, и он все настроит за 30 минут. Наша служба технической поддержки не обладает достаточной квалификацией в данной области, и, скорее всего, мы не сможем оказать вам поддержку в этом вопросе.
Интеграция офисной системы Конечно, при желании можно все это объединить в один запрос и гораздо быстрее за одно действие получить информацию о том, кто звонит и что с Asterisk происходит аналогично курьерской (смним надо делать. выше) с той разницей, что Здесь приведены только шаблонные запросы на астериск идут не . В общих словах: таблица contacts содержит все индексированными контактные данные из большинства таблиц системы. И все обращения за поиском по телефону должны заходить именно с единого сервера, а непосредственно с пользовательских рабочих мест, поэтому файервол на сервере телефонии нужно настраивать соответственнонее. Коды таблиц для поля SourceCodeType можно посмотреть в таблице schema.table_list.
Параметры подключения нужно вводить == Записи разговоров ==В разных конфигурациях Asteriks по-разному организуется хранение записей разговоров, поэтому чтобы их прикреплять к звонкам в разделе "Справочники" системе, необходима настройка «по месту». Нужно, чтобы ваш администратор телефонного сервера предоставил FTP-> "Переменные" -> "Подключения" -> "Asterisk"доступ к хранилищу записей, и наши специалисты настроят модуль автоматизации, чтобы он привязывал ссылки на файлы на сервере к звонкам в системе.
Так же обязательно нужно == Устранение неполадок ==Если при попытке совершения исходящего звонка из системы появляется ошибка «Ошибка соединения с сервером телефонии», проверьте доступность порта, указанного в карточках пользователей "Настройка" - "Пользователи" ввести внутренние номера абонентовнастройках телефонии, с помощью стандартного компонента Windows «Клиент Telnet». У пользователя может быть несколько номеровЕсли через «Клиент Telnet» не удается подключиться к порту, обратитесь к системному администратору, перечисленных через запятую. При нажатии кнопки "Позвонить"отвечающему за телефонию, программа будет соединять первый телефон из списка. При входящих звонках - будет показывать сообщение при звонке на любой из номеров в спискечтобы он проверил настройки прав доступа к указанному порту.
Нет описания правки
MeaSoft интегрируется с Asterisk — это самый популярный телефонный сервер, который не заменяет телефонную компанию, а дополняет ее.
Как это работает: вы в телефонной компании берете линии связи (номера телефонов, каналы и т. д.), можете одновременно брать разные каналы в разных компаниях (с разными тарифами, из разных регионов и т.д), можете добавлять свои, например GSM-шлюзы для экономии на звонках с помощью безлимитных или безлимитных внутри сети SIM-карт. Эти линии заводятся в сервер Asterisk, к нему подключаются ваши телефоны, он программируется — откуда куда какие линии должны быть задействованы. К нему же подключается MeaSoft, причем отдельно офисная система и курьерское приложение.
Что вы получаете:
В офисе:
* операторы звонят просто кнопкой из программы;
* журнал звонков прямо в программе, с привязкой к заказам, клиентам, вашим сотрудникам. Можно подключить записи разговоров;
* при входящем звонке программа показывает оператору, кто звонит: определяет по базе клиента (вплоть до конкретного сотрудника), курьера или получателя;
* отслеживание звонков курьеров с привязкой к заказам. Можно подключить записи разговоров;
* экономия: вы можете подключить телефоны всех ваших офисов (в том числе в разных городах) к одному серверу, и связь между ними будет бесплатной. Вы можете делать исходящие звонки через GSM-шлюзы, можете подключить номера из разных регионов, и все филиалы будут звонить в эти регионы через эти линии по локальным тарифам;
* снижение нагрузки на операторов: вы можете настроить Asterisk так, чтобы, например, он направлял звонки от клиентов или курьеров не всем операторам, и их личным менеджерам (в том числе и на мобильный телефон).
У курьеров:
* экономия: звонок от курьера через телефонию делается так, что сервер курьеру перезванивает, для курьера звонок бесплатный. Для большей экономии можно использовать GSM-шлюзы, чтобы звонок шел через SIM-карту с бесплатной связью внутри оператора курьера;
* запись разговора курьера с получателем.
У получателей:
* солидность: звонок от курьера получателю можно отправлять с вашего основного городского номера, и у получателя будет определяться фирменный номер;
* снижение нагрузки на операторов: gомимо того, что система определяет кто звонит и подсказывает это оператору, Asterisk можно настроить так, чтобы он сразу маршрутизировал звонок на курьера, если звонит получатель, заказ которого находится на руках у курьера;
* отзывы: вы можете настроить сбор отзывов после звонка о работе операторов и курьеров, и мы можем настроить их получение прямо в систему с привязкой к заказу, курьеру и т. д., наравне со сбором отзывов о доставке через [[Личный кабинет курьерской службы#Сбор отзывов|веб-сервис]].
Безопасность:
* при базовом использовании, когда вы/курьеры можете звонить, система ведет журнал, и оператор видит уведомления о том, кто звонит, сервер телефонии и его администраторы не имеют доступа ни к каким данным системы. В сервер телефонии передаются только номера телефонов, на которые нужно позвонить, вся остальная информация о звонках идет из сервера телефонии к нашей системе;
* чтобы телефония могла маршрутизировать звонки на ответственных курьеров, менеджеров клиентов и т. д., ей нужно дать доступ к этой информации — как правило, это только номера телефонов клиентов, курьеров, менеджеров и связи между ними. Данные достаточно обезличенные, могут не включать в себя названия, имена, адреса и прочее.
Asterisk выступает посредником между вами и телефонной компанией. Им пользуются многие наши клиенты и мы сами. Это позволяет нашим операторам сразу сказать «Здравствуйте, Иван», если вы звоните со своего мобильного телефона.
Без интеграции с Asterisk при звонке из мобильного приложения фиксируется только факт попытки звонка. При этом нет ни записи разговора, ни его длительности, ни статуса: дозвонился или нет. Офисное приложение при нажатии кнопки звонка вызывает программу для звонков, установленную по умолчанию в Windows — это может быть программный телефон или Skype. О дальнейшей судьбе этой попытки позвонить мы также ничего не знаем.
== Где взять сервер? ==
Сам сервер можно арендовать в ДЦ или установить у себя в офисе. Установить на него телефонию, настроить под вас и сопровождать должны специалисты. Они же помогут и в выборе сервера. Рекомендовать можем проверенных нами админов из https://southbridge.io/, впрочем, на рынке их немало.
== Интеграция мобильного приложения ==
Для чего это нужноосуществления звонков из мобильного приложения через сервер телефонии [https: использование звонков //ru.wikipedia.org/wiki/Asterisk Asterisk] используется подключение через корпоративную телефонию позволяет снизить расходы на мобильную связь[http://asteriskpbx.ru/display/Asterisk/Asterisk+Managment+Interface+%28AMI%29 AMI]. Включите AMI, задайте адреса, организовать централизованную записьс которых можно получить к нему доступ в файле /etc/asterisk/manager.conf. Создайте пользователя, учет и контроль совершаемых вызововобычно это делается в файлах /etc/asterisk/manager_custom.conf или /etc/asterisk/manager.conf. Откройте порт в файерволе (обычно 5038, прописывается в /etc/asterisk/manager.conf) ([https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Security_Guide/sect-Security_Guide-Firewalls.html на всякий случай вам в помощь]).
При осуществлении вызова сервер приложения посылает на Asterisk AMI-запрос вида:
Action: login
Username: $USERNAME
Secret: $PASSWORD
Channel: $CHANEL/$CALL-FROM-NUMBER
WaitTime: 30
CallerId: 0
Exten: $CALL-TO-NUMBER
Context: $CONTEXT
Action: Logoff
== Интеграция системы с телефонным сервером ==
Интеграция офисной системы с телефонией позволяет упростить работу операторов Asterisk происходит аналогично курьерской (см. выше) с той разницей, что запросы на Asterisk идут не с единого сервера, а непосредственно с пользовательских рабочих мест, поэтому файервол на сервере телефонии нужно настраивать соответственно. Параметры подключения нужно вводить в разделе '''Справочники''' > '''Переменные''' > '''Подключения''' -> '''Asterisk'''. В карточках пользователей '''Настройка''' > '''Пользователи''' введите внутренние номера абонентов. У пользователя может быть несколько номеров, перечисленных через запятую. При нажатии на кнопку '''Позвонить''' программа будет соединять первый телефон из списка. При входящих звонках будет показывать сообщение при звонке на любой из номеров в списке. == Обратные запросы от Asterisk ==Если серверу телефонии нужно получить данные из БД при входящем звонке, он напрямую подключается к MySQL, база данных courier. Приведем наиболее популярные задачи и их решения: * Звонит получатель, нужно его соединить с курьером, у которого находится его заказ. Это особенно актуально, если мобильное приложение курьера звонит через офисную телефонию, у получателя определяется номер телефона офиса, и администраторов компаниион перезванивает. Запрос ниже выдает сразу номер телефона курьера, с которым нужно соединить. SELECT k.code, k.name, k.`phonem`, k.`phonek` FROM contacts c JOIN givn g ON g.address=c.Source JOIN kurier k ON k.code=g.`kurier` WHERE c.SourceCodeType=3 /*Контакты именно получателей*/ AND g.State=1 /*Статус "На руках у курьера"*/ AND c.VALUE='79161234567' /*Вот тут нормированный телефон звонящего ИМЕННО в таком формате*/ * Звонит курьер, нужно его соединить с менеджером. Запрос вернет внутренний номер менеджера курьера: набор номера одной кнопкой SELECT k.code, k.name, u.extPhone AS managerext FROM contacts c JOIN kurier k ON k.code=c.Source JOIN users u ON u.`user`=k.`manager` WHERE c.SourceCodeType=1 /*Контакты именно курьеров*/ AND c.VALUE='79161234567' /*Вот тут нормированный телефон звонящего ИМЕННО в таком формате*/ * Звонит клиент, нужно его соединить с менеджером. Запрос вернет внутренний номер менеджера клиента, а также статус клиента. Запрос очень упрощен. По-хорошему надо в первую очередь смотреть контакты, не столько привязанные к клиентам, сколько к их контактным лицам (таблица fio, код 39). SELECT k.code, k.company, u.extPhone AS managerext, c.State FROM contacts c JOIN clients k ON k.code=c.Source LEFT JOIN users u ON u.`user`=k.`manager` WHERE c.SourceCodeType=2 /*Контакты именно клиентов*/ AND c.VALUE='79161234567' /*Вот тут нормированный телефон звонящего ИМЕННО в таком формате*/ * Определить просто отправление из программытех, автоматическое определение компании что в работе. Возвращает данные отправления, заказа и ФИО клиента: SELECT * FROM contacts c JOIN address a on a.code=c.Source join zakaz b on a.zakaz=b.code join clients k on k.code=b.source WHERE c.SourceCodeType=3 /*Контакты именно получателей*/ AND a.date_put is null /*Заказ в работе, ведение журнала звонковне закрытый*/ AND c.VALUE='79161234567' /*Вот тут нормированный телефон звонящего ИМЕННО в таком формате*/
