Пример маршрутизации и проверки телефонного номера по API с использованием Python
В примере использовались CentOS 7, Asterisk 16, FreePBX 14, Python3. В данной статье рассмотрим на конкретном примере, как это можно сделать. Задача: Звонки поступают на номер 8(999) 999-99-99. В момент поступления звонка будет голосовое сообщение. В рабочие дни с 9.00 до 18.00 по местному времени филиала входящие звонки распределяются по регионам в соответствии со списком […]
В примере использовались CentOS 7, Asterisk 16, FreePBX 14, Python3.
В данной статье рассмотрим на конкретном примере, как это можно сделать.
Задача:
- Звонки поступают на номер 8(999) 999-99-99.
- В момент поступления звонка будет голосовое сообщение.
- В рабочие дни с 9.00 до 18.00 по местному времени филиала входящие звонки распределяются по регионам в соответствии со списком ниже.
№ | Филиал | Сотовый номер (не АТС) |
1 | Столичный филиал: Москва и МО, Калужская, Рязанская, Тульская, Владимирская, Ярославская обл., Смоленская обл. Тверская обл. Ивановская, Костромская, Смоленская | Ресепшн Москва |
2 | Северо-Западный филиал: Санкт-Петербург, Ленинградская обл., Республика Карелия, Архангельская, Вологодская, Калининградская, Мурманская, Кировская области, Новгородская, Псковская | Тел. +7 111 111 11 11 |
3 | Краснодарский филиал: Краснодарский край, Республики Адыгея, Дагестан, Ингушетия, Кабардино-Балкарская Республика, Карачаево-Черкесская Республика, Республика Северная Осетия – Алания, Чеченская Республика; Ставропольский край; Ростовская, Тамбовская области, Астраханская обл., Республика Калмыкия | Тел. +7 222 222 22 22 |
4 | Воронежский филиал: Воронежская обл., Белгородская, Воронежская, Липецкая, Тамбовская Орловская обл., Брянская, Курская, Саратовская, Волгоградская обл. | Тел. +7 333 333 33 33 |
5 | Нижегородский филиал: Нижегородская обл., Мордовия, Чувашия, Пензенская, Марий Эл, Республика Коми, Кировская область. | Тел. +7 444 444 44 44 |
6 | Уральский (ЕКБ) филиал: Свердловская обл., Республика Башкортостан, Пермский край, Челябинская обл., Курганская, Тюменская области; Ханты-Мансийский АО – Югра, Ямало-Ненецкий АО | Тел. +7 555 555 55 55 |
7 | Новосибирский филиал: Красноярский край, Хакасия, Алтайский край, Новосибирская обл., Республика Алтай, Тыва; Кемеровская, Омская, Томская области | Филиал Новосибирск Тел. +7 666 666 66 66 |
8 | Дальневосточный филиал: (Республика Бурятия, Саха (Якутия); Забайкальский, Камчатский, Приморский, Хабаровский края; Амурская, Иркутская, Магаданская, Сахалинская области; Еврейская автономная область; Чукотский автономный округ | Филиал Новосибирск Тел. +7 666 666 66 66 |
9 | Самарский филиал: Республика Удмуртия, Татарстан, Чувашская Республика, Оренбургская, Самарская, Ульяновская области | Тел. +7 777 777 77 77 |
1. Создаем Time Condition:
Applications -> Time Conditions -> Add Time Conditions
- Название.
- Укажите часовой пояс, если место назначения находится в другом часовом поясе.
- Выбор временной группы, можно выбрать стандартную или создать свою.
- При совпадении по времени попадаем на IVR (интерактивное голосовое меню) c приветствием и переводом, например, на очередь.
- При несовпадении по времени попадаем на другой IVR с аудио сообщением о нерабочем времени и завершаем звонок.
2. Создаем Inbound Route:
Connectivity -> Inbound Routes -> Add Inbound Route
- Название
- Номер на который вам звонят, но в том виде как его передает оператор. Может передаваться без 7.
- Место назначения вызова. В нашем случае это проверка по времени.
3. Меняем контекст транка
Connectivity -> Trunks -> Имя транка -> sip Settings
4. Редактируем диалплан
- Открываем vim /etc/asterisk/extensions_custom.conf
- Создаем контекст
[from-trunk-pre]
exten=> 79999999999,1,NoOp(${CALLERID(num)})
same=> n,Noop(================================= START AGI =====================================)
same=> n,Agi(nomer.sh)
same=> n,Noop(====================== Полученный номер региона ${number} =================================)
same=> n,GotoIf($["${number}" = "+79999999999"]?ext-did-0002,79999999999,1)
same=> n,GotoIf($["${number}" = "+71111111111"]?ext-did-0002,71111111111,1)
same=> n,GotoIf($["${number}" = "+72222222222"]?ext-did-0002,72222222222,1)
same=> n,GotoIf($["${number}" = "+73333333333"]?ext-did-0002,73333333333,1)
same=> n,GotoIf($["${number}" = "+74444444444"]?ext-did-0002,74444444444,1)
same=> n,GotoIf($["${number}" = "+75555555555"]?ext-did-0002,75555555555,1)
same=> n,GotoIf($["${number}" = "+76666666666"]?ext-did-0002,76666666666,1)
same=> n,GotoIf($["${number}" = "+77777777777"]?ext-did-0002,77777777777,1)
same=> n,GoTo(ext-did-0002,79999999999,1)
Логика звонка:
Входящий звонок на номер 8(999)999-99-99 будет обрабатываться в контексте [from-trunk-pre]
- NoOp – показывает номер с которого звонят
- Для отладки
- Вызывает скрипт ”nomer.sh”
- Показывает номер региона, на который переводится звонок
- Этот шаг отправляет, полученный с помощью скрипта сотовый номер филиала в Inbound Routes. Это нужно для проверки времени и проигрывания приветствия, т.к. в филиале нет АТС.
- Создаем входящий маршрут с номером филиала 7777777777
- Назначение Time Conditions -> Samara time
- Если совпадает по времени, то выдает приветствие и звонит на custom extension 77777777777 и проигрывает файл приветствия «1» (Он загружается в Admin -> System Recordings)
- Если не совпадает, то проигрывает сообщение «0» и кладет трубку
- Настройки extension 77777777777
Где 77777777777 – номер филиала
outrt-3 – номер исходящего маршрута
- Контекст [ext-did-0002] смотрим в файле:
У вас может быть другой контекст.
6. На случай, если скрипт не выдаст номер, вызов перейдет на входящий маршрут с DID 79999999999.
5. Скрипт nomer.sh
Данный скрипт отправляет запрос с номером на сайт num.voxlink.ru и возвращает номер филиала
- Создаем текстовый файл:
nano /var/lib/asterisk/agi-bin/nomer.sh
- Копируем в него скрипт:
#!/usr/bin/python3
import requests
from asterisk.agi import AGI
agi = AGI()
phone = str(agi.env["agi_callerid"])
phone_number = {"num":phone}
def main(number):
citys = {
# Столичный филиал
"+79999999999": ["Владимирская область", "Ивановская область", "Калужская область", "Костромская область",
"Московская область", "Рязанская область", "Смоленская область", "Тверская область", "Тульская область",
"Ярославская область", "г. Москва", "г. Москва * Московская область", "Владимирская обл.",
"Ивановская обл.",
"Калужская обл.", "Костромская обл.", "Московская обл.", "Рязанская обл.", "Смоленская обл.",
"Тверская обл.", "Тульская обл.", "Ярославская обл.", "г. Москва и Московская область"],
# Северо - Западный филиал
"+71111111111": ["Республика Карелия", "Архангельская область", "Вологодская область",
"Калининградская область", "Ленинградская область", "Мурманская область",
"Новгородская область", "Псковская область", "г. Санкт-Петербург", "Архангельская обл.",
"Вологодская обл.", "Калининградская обл.", "Ленинградская обл.", "Мурманская обл.",
"Новгородская обл.", "Псковская обл.", "г. Санкт-Петербург и Ленинградская область", "г. Санкт-Петербург * Ленинградская область"],
# Краснодарский филиал
"+72222222222": ["Республика Адыгея", "Республика Дагестан", "Республика Ингушетия",
"Кабардино-Балкарская Республика", "Республика Калмыкия", "Карачаево-Черкесская Республика",
"Республика Северная Осетия - Алания", "Чеченская Республика", "Краснодарский край",
"Ставропольский край", "Астраханская область", "Ростовская область",
"Республика Кабардино-Балкарская",
"Республика Карачаево-Черкесская", "Республика Чеченская", "Астраханская обл.",
"Ростовская обл."],
# Воронежский филиал
"+73333333333": ["Белгородская область", "Брянская область", "Воронежская область", "Курская область",
"Тамбовская область", "Липецкая область", "Орловская область", "Волгоградская область",
"Саратовская область", "Белгородская обл.", "Брянская обл.", "Воронежская обл.",
"Курская обл.",
"Тамбовская обл.", "Липецкая обл.", "Орловская обл.", "Волгоградская обл.",
"Саратовская обл."],
# Нижегородский филиал
"+74444444444": ["Республика Коми", "Республика Марий Эл", "Республика Мордовия", "Нижегородская область",
"Пензенская область", "Кировская область", "Нижегородская обл.", "Пензенская обл.",
"Кировская обл."],
# Уральский (ЕКБ) филиал
"+75555555555": ["Республика Башкортостан", "Пермская область", "Пермский край",
"Коми-Пермяцкий автономный округ", "Республика Коми", "Курганская область",
"Свердловская область", "Тюменская область", "Ханты-Мансийский автономный округ - Югра",
"Ямало-Ненецкий АО", "Челябинская область", "Пермская обл.", "Курганская обл.",
"Свердловская обл.", "Тюменская обл.", "Челябинская обл."],
# Новосибирский филиал
"+76666666666": ["Республика Алтай", "Республика Тыва", "Республика Хакасия", "Алтайский край",
"Красноярский край", "Кемеровская область", "Новосибирская область",
"Омская область", "Томская область", "Кемеровская обл.", "Новосибирская обл.",
"Омская обл.", "Томская обл."
# Дальневосточный филиал
"Республика Бурятия", "Иркутская область", "Республика Саха /Якутия/",
"Приморский край", "Хабаровский край", "Амурская область", "Магаданская область",
"Сахалинская область",
"Еврейская автономная область", "Чукотский АО", "Иркутская обл.", "Амурская обл.",
"Камчатский край", "Магаданская обл.", "Сахалинская обл.", "Еврейская автономная обл."],
# Самарский филиал
"+77777777777": ["Республика Татарстан", "Удмуртская Республика", "Оренбургская область", "Самарская область",
"Ульяновская область", "Чувашская Республика", "Республика Удмуртская", "Оренбургская обл.",
"Самарская обл.",
"Ульяновская обл.", "Чувашская Республика - Чувашия"]
}
payload = ""
uri = "http://num.voxlink.ru/get/"
response = requests.request("GET", uri, data=payload, params=number).json()
for c in citys:
for n in citys[c]:
if n == response["region"].split("|")[-1]:
agi.set_variable('number', str(c))
print(c)
if __name__ == "__main__":
main(phone_number)
- chmod +x /var/lib/asterisk/agi-bin/nomer.sh – делает файл исполняемым
- chown asterisk. /var/lib/asterisk/agi-bin/nomer.sh – дает права Астериску выполнять файл
- устанавливаем модули
pip3 install requests
pip3 install asterisk
Проверяем звонок:
Остались вопросы?
Я - Першин Артём, менеджер компании Voxlink. Хотите уточнить детали или готовы оставить заявку? Укажите номер телефона, я перезвоню в течение 3-х секунд.
категории
- DECT
- Linux
- Вспомогательный софт при работе с Asterisk
- Интеграция с CRM и другими системами
- Интеграция с другими АТС
- Использование Elastix
- Использование FreePBX
- Книга
- Мониторинг и траблшутинг
- Настройка Asterisk
- Настройка IP-телефонов
- Настройка VoIP-оборудования
- Новости и Статьи
- Подключение операторов связи
- Разработка под Asterisk
- Установка Asterisk
VoIP оборудование
ближайшие курсы
Новые статьи
10 доводов в пользу Asterisk
Распространяется бесплатно.
Asterisk – программное обеспечение с открытым исходным кодом, распространяется по лицензии GPL. Следовательно, установив один раз Asterisk вам не придется дополнительно платить за новых абонентов, подключение новых транков, расширение функционала и прочие лицензии. Это приближает стоимость владения станцией к нулю.
Безопасен в использовании.
Любое программное обеспечение может стать объектом интереса злоумышленников, в том числе телефонная станция. Однако, сам Asterisk, а также операционная система, на которой он работает, дают множество инструментов защиты от любых атак. При грамотной настройке безопасности у злоумышленников нет никаких шансов попасть на станцию.
Надежен в эксплуатации.
Время работы серверов некоторых наших клиентов исчисляется годами. Это значит, что Asterisk работает несколько лет, ему не требуются никакие перезагрузки или принудительные отключения. А еще это говорит о том, что в районе отличная ситуация с электроэнергией, но это уже не заслуга Asterisk.
Гибкий в настройке.
Зачастую возможности Asterisk ограничивает только фантазия пользователя. Ни один конструктор шаблонов не сравнится с Asterisk по гибкости настройки. Это позволяет решать с помощью Asterisk любые бизнес задачи, даже те, в которых выбор в его пользу не кажется изначально очевидным.
Имеет огромный функционал.
Во многом именно Asterisk показал какой должна быть современная телефонная станция. За многие годы развития функциональность Asterisk расширилась, а все основные возможности по-прежнему доступны бесплатно сразу после установки.
Интегрируется с любыми системами.
То, что Asterisk не умеет сам, он позволяет реализовать за счет интеграции. Это могут быть интеграции с коммерческими телефонными станциями, CRM, ERP системами, биллингом, сервисами колл-трекинга, колл-бэка и модулями статистики и аналитики.
Позволяет телефонизировать офис за считанные часы.
В нашей практике были проекты, реализованные за один рабочий день. Это значит, что утром к нам обращался клиент, а уже через несколько часов он пользовался новой IP-АТС. Безусловно, такая скорость редкость, ведь АТС – инструмент зарабатывания денег для многих компаний и спешка во внедрении не уместна. Но в случае острой необходимости Asterisk готов к быстрому старту.
Отличная масштабируемость.
Очень утомительно постоянно возвращаться к одному и тому же вопросу. Такое часто бывает в случае некачественного исполнения работ или выбора заведомо неподходящего бизнес-решения. С Asterisk точно не будет такой проблемы! Телефонная станция, построенная на Asterisk может быть масштабируема до немыслимых размеров. Главное – правильно подобрать оборудование.
Повышает управляемость бизнеса.
Asterisk дает не просто набор полезных функций, он повышает управляемость организации, качества и комфортности управления, а также увеличивает прозрачность бизнеса для руководства. Достичь этого можно, например, за счет автоматизации отчетов, подключения бота в Telegram, санкционированного доступа к станции из любой точки мира.
Снижает расходы на связь.
Связь между внутренними абонентами IP-АТС бесплатна всегда, независимо от их географического расположения. Также к Asterisk можно подключить любых операторов телефонии, в том числе GSM сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.