Верификация мобильных номеров – часть 1

Описание: в этой статье мы рассмотрим возможность проверки существования мобильного номера и его доступности.

Все инструкции тестировались на следующем оборудовании:

CentOS Linux release 7.5.1804

• Asterisk 13.21.0
• PHP 5.6.36
• Apache/2.2.15
• MySQL/10.1.33-MariaDB

Используемые технологии:

• PHP
• MySQL
• Dialplan asterisk

Вначале следует сказать, что программные АТС на базе asterisk умеют определять статус звонка и включают в себя следующие значения:

• «CANCEL»: Вызов отменен
• «ANSWER»: На вызов был получен ответ
• «NOANSWER»: На вызов не ответили
• «BUSY»: Получен сигнал занято
• «CONGESTION»: Канал перегружен
• «CHANUNAVAIL»: Канал недоступен (Для SIP, может быть в случае если пир не зарегистрирован)

Подробнее можете ознакомиться со встроенной отчётностью в нашей статье: https://voxlink.ru/kb/freepbx/statistika-zvonkov-cdr-v-freepbx-13/

Статус можно получить, обработав переменную канала ${DIALSTATUS} или же обратившись после звонка к внутренней базе asteriskcdrdb.cdr.

Наша задача заключается в реализации функции дозвона и возврате его статуса, поэтому реализуем небольшое API-которое будет выполнять эту задачу. Примерная логическая схема ниже:

• «Оранжевое» направление
  Получив номер мобильного и  номер договора API вызывает кастомный контекст диалплана asterisk

[phone-verification]
exten => _[87]9X.,1,NoOp( VERIFICATION ${EXTEN} BEGIN )

Разрешили обрабатывать только мобильные номера, начинающиеся с «79…» и «89…»

same => n(repeat),Set(link=http://127.0.0.1/verphone/?revolver=${EXTEN})

same => n,Set(outline=${SHELL(curl ${link})})

Сформировали и выполнили повторное обращение к API-скрипту

same => n,GotoIf($[“${outline}”=””]?exit)

Если полученный результат эквивалентен пустой строке – завершаем обработку

same => n,Set(trunk=${CUT(outline,|,1)})
same => n,Set(cid=${CUT(outline,|,2)})

Иначе разделяем полученный результат и присваиваем его соответствующим переменным.

same => n,NoOp( -------- trunk: ${trunk} , cid: ${cid} -------- )

same => n,Set(CALLERID(all)=${cid})
same => n,Set(TRUNKOUTCID=${cid})

Устанавливаем отображаемый номер (CID) аналогичный городской телефонной линии (транку), через которую будет производиться вызов.

same => n,Set(CDR(userfield)=${idblank})

Записываем номер договора в дополнительное поле базы данных asteriskcdrdb.cdr.userfield

same => n,Dial(SIP/${trunk}/7${EXTEN:1},10/n)

В течении 10 секунд пытаемся осуществить вызов через полученный от API транк.

same => n,NoOp(${DIALSTATUS})
same => n,Gotoif($["${DIALSTATUS}"!="CHANUNAVAIL"]?exit)

Если вызов прошёл корректно, а транк был доступен – завершаем обработку

same => n,Wait(1)
same => n,Goto(repeat)

Иначе, через секунду ожидания, возвращаемся к обращению за получением данных от API. Это необходимо для получения следующего в очереди транка при недоступности текущего.

same => n(exit),Macro(hangupcall,)

exten => h,1,Hangup()

Весь этот контекст должен быть дописан в файл extensions_custom.conf, после чего в консоли CLI выполнить команду:

CLI > dialplan reload

• «Синее» направление               
  • Возвращает по запросу статус вызова. Требует передачу номеров телефона и договора.
• «Зелёное» направление
  • Возвращает информацию о звонке во внутреннюю базу данных, в том числе и статус дозвона.

Так же нам для работы понадобится создать собственную таблицу и внести в неё список используемых транков, например как показано ниже:

На этом настройки со стороны АТС завершены в следующей части статьи мы рассмотрим API-скрипт, запросы для обращений к нему извне, а так же предоставим примеры «боевого» запуска.

Верификация мобильных номеров – часть 2