Пример маршрутизации и проверки телефонного номера по API с использованием Python

В примере использовались CentOS 7, Asterisk 16, FreePBX 14, Python3.

В данной статье рассмотрим на конкретном примере, как это можно сделать.

Задача:

• Звонки поступают на номер 8(999) 999-99-99.
• В момент поступления звонка будет голосовое сообщение.
• В рабочие дни с 9.00 до 18.00 по местному времени филиала входящие звонки распределяются по регионам в соответствии со списком ниже.

1. Создаем Time Condition:

Applications -> Time Conditions -> Add Time Conditions

1. Название.
2. Укажите часовой пояс, если место назначения находится в другом часовом поясе.
3. Выбор временной группы, можно выбрать стандартную или создать свою.
4. При совпадении по времени попадаем на IVR (интерактивное голосовое меню) c приветствием и переводом, например, на очередь.
5. При несовпадении по времени попадаем на другой IVR с аудио сообщением о нерабочем времени и завершаем звонок.

2. Создаем Inbound Route:

Connectivity -> Inbound Routes -> Add Inbound Route

1. Название
2. Номер на который вам звонят, но в том виде как его передает оператор. Может передаваться без 7.
3. Место назначения вызова. В нашем случае это проверка по времени.

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]

1. NoOp – показывает номер с которого звонят
2. Для отладки
3. Вызывает скрипт ”nomer.sh”
4. Показывает номер региона, на который переводится звонок
5. Этот шаг отправляет, полученный с помощью скрипта сотовый номер филиала в 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

Проверяем звонок: