artem

09.01.2018

GitHub инструкция внутренние номера callerid FreePBX for asterisk sip Подключение centOS настройка установка

Голосовой набор в Asterisk.

Думаю каждому помнится удобный функционал мобильных телефонов Nokia, когда можно было позвонить абоненту, лишь произнеся его имя. В данной статье мы рассмотрим прекрасную разработку Дмитриева Сергея, которая написана на NodeJS и позволяет реализовать функционал быстрого голосового набора в Asterisk.

Все описанные действия в статье на сервере телефонии необходимо выполнять от имени суперпользователя (root). Установка и настройка производилась на предустановленной системе CentOS 6.9 + Asterisk 11.23.1 + FreePBX 13.

Инструкция:

Голосовой набор реализован на базе мини AGI сервера и имеет возможность работы с такими распространёнными сервисами распознавания голоса как Yandex SpeechKit Cloud, Google Speech(и данные сервисы ранее рассматривались у нас на сайте (Синтез речи средствами yandex speech / Автоответчик с распознаванием речи или принятие заявок в автоматическом режиме). Но в данной статье мы рассмотрим новый для нас сервис распознавания голоса Wit.AI с которым мини AGI сервер так же способен работать.

1. Получим API ключ от сервиса Wit.AI, для этого нам необходимо пройти регистрацию на странице https://wit.ai/ . Регистрация на сервисе возможна с помощью учетной записи GitHub или Facebook. В нашем случае будет рассмотрена регистрация с использованием учетной записи GitHub, нажмём на кнопку “Log in with GitHub”:

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

2. Подтвердим процедуру авторизации нажатием кнопки “Authorize wit-ai”:

3. Введем свой email адрес и информацию о том для каких целей будете использовать сервис Wit.AI:

4. После завершения процедуры регистрации можем приступить к получению API ключа для использования сервиса. Перейдём в “Settings” и заполним пункты в соответствии с планируемым региональным использованием приложения распознавания голоса, а так же скопируем “Server Access Token”, который потребуется в дальнейшей настройке.

5. Для начала нам необходимо произвести установку NodeJS, выполним подключение по SSH к серверу телефонии, в зависимости от используемой системы(Windows, Linux, MacOS), подключение по SSH можно выполнить с использованием различного дополнительного программного обеспечения(Putty), либо системного терминала. И выполним ряд команд вида:

# yum -y groupinstall ‘Development Tools’
# curl –silent –location https://rpm.nodesource.com/setup_7.x | bash –
# yum -y install nodejs

6. Приступим к установке и настройке AGI сервера, выполним ряд команд вида:

# npm install voicer -g
# npm install pm2 -g

7. Выполним настройку установленного AGI сервера:

# mkdir /etc/voicer
# mkdir /etc/voicer/data
# nano /etc/voicer/config.js

Приведем файл к виду:

module.exports = {
    agi: {
        port: 3000
    },
    web: {
        port: 3100,
        auth: true,
        username: ‘admin’,
        password: ‘admin’,
        realm: ‘My company’
    },
    processing: {
        totalAttempts: 2,
        playGreeting: true,
        playBeepBeforeRecording: false   //use system beep
    },
    asterisk: {
        sounds: {
            onErrorBeforeFinish: ‘invalid’,
            onErrorBeforeRepeat: ‘invalid’,
            greeting: ‘beep’
        },
        recognitionDialplanVars: {
            status: ‘RECOGNITION_RESULT’,
            target: ‘RECOGNITION_TARGET’
        }
    },
    record: {
            directory: ‘/tmp’,
            type: ‘wav’,
            duration: 2,
    },
    recognize: {
            directory: ‘/tmp’,
        type: ‘witai’,    // [‘yandex’, ‘google’, ‘witai’]
        options: {
            developer_key: ‘API_ключ’
        }
    },
    lookup: {
        type: ‘file’,
        options: {
            dataFile: ‘/etc/voicer/data/peernames.json’
        }
    },
    logger: {
        console: {
            colorize: true
        },
        file: {
            filename: ‘/var/log/voicer.log’,
            json: false
        }
    }
};

Где основными элементами требующими настройки является:

username, password – логин и пароль для доступа к WEB панели управления AGI сервером

type: ‘witai’ – имя используемого сервиса распознавания голоса

developer_key – API ключ сервиса распознавания голоса

8. Для того чтобы AGI сервер обращался корректно к созданному конфигурационному файлу, закрепим системную переменную:

# export VOICER_CONFIGFILE=/etc/voicer/config.js

9. AGI сервер перенаправляет звонок на соответствующий номер внесенный в конфигурационный файл. Для удобства занесения соответствия имени сотрудника и внутреннего номера, был написан BASH скрипт, который парсит занесенный внутренние номера и присвоенные им имена.

# nano /usr/src/parser.sh

Приведём данный файл к виду:

#!/bin/bash

r=”33[0;31m”
g=”33[0;32m”
y=”33[0;33m”
n=”33[0m”
FILE=/etc/voicer/data/peernames.json

clear
echo -e “${y}Привет! Я скрипт выгрузки информации по внутренним номерам ${n}”

rm -f $FILE && echo -e “${y}Я уже удалил предыдущий файлик и приступил к заполнению нового ${n}”

for i in $(asterisk -rx ‘sip show peers’ | grep -P ‘OK|UNKNOWN’ | sed ‘s/// /g’ | awk ‘{print $1}’); do

        if [[ “${#i}” < 6 && -z “${i//[0-9]/}” ]];then
                #echo ${i}

                str=$( asterisk -rx “sip show peer $i” | grep “Reg. Contact : sip”; )
                #echo $str

                name=$( asterisk -rx “sip show peer $i” | grep “Callerid”; )
                #echo $name

                ext=${str##*’sip:’}
                ext=${ext%%’@’*}

                name=${name##*’: “‘}
                name=${name%%'” <‘*}
                name=${name%%’ ‘*}

                echo -e “n {n    “name”: “$ext”,n    “target”: “SIP/$ext”,n    “variants”: [n      “${name}”n    ]n },” >> $FILE
                echo -e “${g}Номерок $ext уже обработан и добавлен в список. Следующий…${n}”
        fi

done

sed -i -e ‘1 s/^/[/;’ $FILE
echo ‘]’ >> $FILE
echo -e “${y}Я закончил! До свидания! =^_^=${n}”

# chmod 777 /usr/src/parser.sh
# cd /usr/src/
# ./parser.sh

10. Отредактируем исполнительный файл приложения:

# nano /usr/bin/voicer

Приведем данный файл к виду:

#!/usr/bin/node

var configfile = ‘/etc/voicer/config.js’;
var fileExists = require(‘file-exists’);
var conf = configfile;

if (fileExists(conf)) {
var config = require(configfile);
var Voicer = require(‘./index’);

var voicer = new Voicer(config);
voicer.start();
} else {
console.log(‘no configfile:’, conf);
}

11. Для возможности автозапуска и управлением AGI сервером как сложбой, создадим сервис:

# nano /etc/init.d/voicer

Приведём данный файл к виду:

#!/bin/sh

### BEGIN INIT INFO
# Provides:          voicer
# Required-Start:    $network $syslog $named
# Required-Stop:     $network $syslog $named
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Start/stop voicer
### END INIT INFO

set -e

if [ -z “$1” ] ; then
    echo “Usage: $0 [start|stop|restart]”
    exit 0
fi

if [ “$1” = “start” ] ; then
    pm2 start voicer
elif [ “$1” = “stop” ] ; then
    pm2 stop voicer
elif [ “$1” = “restart” ] ; then
    $0 stop
    sleep 5
    $0 start
fi
# chmod 777 /etc/init.d/voicer
# chkconfig voicer on
# service voicer start

12. Добавим в диалплан Asterisk возможность обращения к AGI серверу:

# nano /etc/asterisk/extensions_custom.conf

И добавим строки вида:

exten=777,1,AGI(agi://localhost:3000)
exten=777,n,GotoIf($[${RECOGNITION_RESULT}=SUCCESS]?:default,777,4)
exten=777,n,Dial(${RECOGNITION_TARGET})

13. Теперь при звонке по короткому номеру 777, после звукового сигнала произнесем имя сотрудника и система автоматически соединит с указанным в конфигурационном файле внутренним номером.

14. Редактирование соответствия имени сотрудника с внутренним номером, добавление вариантов имени, можно производить в WEB интерфейсе, доступному по адресу http://IP_адрес_АТС:3001

Остались вопросы?

Я - Виталий Шелест, менеджер компании Voxlink. Хотите уточнить детали или готовы оставить заявку? Укажите номер телефона, я перезвоню в течение 3-х секунд.