Интеграција на Asterisk и Bitrix24

Постојат различни опции за интегрирање на IP-PBX Asterisk и CRM Bitrix24 на мрежата, но сепак решивме да напишеме своја.

Во однос на функционалноста, сè е стандардно:

• Со кликнување на врска со телефонски број на клиентот во Bitrix24, Asterisk го поврзува внатрешниот број на корисникот во чие име е направен кликнувањето со телефонскиот број на клиентот. Во Bitrix24, се снима запис од повикот и на крајот од повикот, се повлекува снимка од разговорот.
• Ѕвездичката добива повик однадвор - во интерфејсот Bitrix24 ја покажуваме клиентската картичка на вработениот на чиј број пристигна овој повик.
  Доколку нема таков клиент, ќе ја отвориме картичката за создавање на ново водство.
  Штом повикот е завршен, го одразуваме ова на картичката и повлекуваме снимка од разговорот.

Под сечењето ќе ви кажам како да поставите сè за себе и ќе ви дадам линк до github - да, да, земете го и искористете го!

Општ опис

Ја нарековме нашата интеграција CallMe. CallMe е мала веб-апликација напишана во PHP.

Користени технологии и услуги

• PHP 5.6
• PHP AMI библиотека
• композитор
• Nginx + php-fpm
• супервизор
• AMI (интерфејс за менаџер на ѕвездичка)
• Bitrix веб-куки (поедноставена имплементација на REST API)

Пред-поставување

На сервер со Asterisk треба да инсталираш веб сервер (за нас е nginx+php-fpm), супервизор и git.

Команда за инсталација (CentOS):

yum install nginx php-fpm supervisor git

Одиме во директориумот достапен до веб-серверот, ја повлекуваме апликацијата од Git и ги поставуваме потребните права на папката:

cd /var/www
git clone https://github.com/ViStepRU/callme.git
chown nginx. -R callme/

Следно, ајде да го конфигурираме nginx, нашата конфигурација се наоѓа во

/etc/nginx/conf.d/pbx.vistep.ru.conf

server {
	server_name www.pbx.vistep.ru pbx.vistep.ru;
	listen *:80;
	rewrite ^  https://pbx.vistep.ru$request_uri? permanent;
}

server {
#        listen *:80;
#	server_name pbx.vistep.ru;


	access_log /var/log/nginx/pbx.vistep.ru.access.log main;
        error_log /var/log/nginx/pbx.vistep.ru.error.log;

    listen 443 ssl http2;
    server_name pbx.vistep.ru;
    resolver 8.8.8.8;
    ssl_stapling on;
    ssl on;
    ssl_certificate /etc/letsencrypt/live/pbx.vistep.ru/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/pbx.vistep.ru/privkey.pem;
    ssl_dhparam /etc/nginx/certs/dhparam.pem;
    ssl_session_timeout 24h;
    ssl_session_cache shared:SSL:2m;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers kEECDH+AES128:kEECDH:kEDH:-3DES:kRSA+AES128:kEDH+3DES:DES-CBC3-SHA:!RC4:!aNULL:!eNULL:!MD5:!EXPORT:!LOW:!SEED:!CAMELLIA:!IDEA:!PSK:!SRP:!SSLv2;
    ssl_prefer_server_ciphers on;
    add_header Strict-Transport-Security "max-age=31536000;";
    add_header Content-Security-Policy-Report-Only "default-src https:; script-src https: 'unsafe-eval' 'unsafe-inline'; style-src https: 'unsafe-inline'; img-src https: data:; font-src https: data:; report-uri /csp-report";
	
	root /var/www/callme;
	index  index.php;
        location ~ /. {
                deny all; # запрет для скрытых файлов
        }

        location ~* /(?:uploads|files)/.*.php$ {
                deny all; # запрет для загруженных скриптов
        }

        location ~* ^.+.(ogg|ogv|svg|svgz|eot|otf|woff|mp4|ttf|rss|atom|jpg|jpeg|gif|png|ico|zip|tgz|gz|rar|bz2|doc|xls|exe|ppt|tar|mid|midi|wav|bmp|rtf)$ {
                access_log off;
                log_not_found off;
                expires max; # кеширование статики
        }

	location ~ .php {
		root /var/www/callme;
		index  index.php;
		fastcgi_pass unix:/run/php/php5.6-fpm.sock;
	#	fastcgi_pass 127.0.0.1:9000;
		fastcgi_index index.php;
		fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name;
		include /etc/nginx/fastcgi_params;
		}
}

Ќе го оставам парсирањето на конфигурацијата, безбедносните проблеми, добивањето сертификат, па дури и изборот на веб-сервер надвор од опсегот на статијата - многу е напишано за ова. Апликацијата нема ограничувања, работи и преку http и преку https.

Ние користиме https, ајде да го шифрираме сертификатот.

Ако сте направиле сè правилно, тогаш со кликнување на врската треба да видите вакво нешто

Поставување на Bitrix24

Ајде да создадеме две веб-куки.

Дојдовна веб-кука.

Под администраторската сметка (со id 1), следете ја патеката: Апликации -> Веб-куки -> Додај веб-кука -> Дојдовна веб-кука

Пополнете ги параметрите на дојдовната веб-кука како на сликите од екранот:

И кликнете зачувај.

По зачувувањето, Bitrix24 ќе ја обезбеди URL-то на дојдовната веб-кука, на пример:

Зачувајте ја вашата верзија на URL-то без конечниот /профил/ ​​- ќе се користи во апликацијата за работа со дојдовни повици.

Јас го имам ова https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/

Појдовна веб-кука.

Апликации -> Веб-куки -> Додај веб-кука -> Појдовна веб-кука

Деталите се повторно на сликите од екранот:

Зачувајте и примете го кодот за авторизација

Јас го имам ова xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6. Исто така, треба да го копирате за себе;

Важно!

Мора да се конфигурира SSL сертификат на серверот Bitrix24 (можете да користите letsencrypt), инаку Bitrix api нема да работи. Ако имате облак верзија, не грижете се - таа веќе има ssl.

Важно!

Полето „Адреса на процесорот“ мора да содржи адреса достапна од Интернет!

И како последен допир, да го инсталираме нашиот CallMeOut како апликација за остварување повици (така што кога ќе кликнете на бројот на PBX, командата за започнување на повикот ќе одлета).

Во менито, изберете: Повеќе -> Телефонија -> Повеќе -> Поставки, поставете го во „Стандарден број за појдовен повик“ Апликација: CallMeOut и кликнете „Зачувај“

Поставување ѕвездичка

За успешна интеракција помеѓу Asterisk и Bitrix24, треба да го додадеме корисничкиот callme на AMI на manager.conf:

[callme]
secret = JD3clEB8_f23r-3ry84gJ
deny = 0.0.0.0/0.0.0.0
permit = 127.0.0.1/255.255.255.0
permit= 10.100.111.249/255.255.255.255
permit = 192.168.254.0/255.255.255.0
read = system,call,log,verbose,agent,user,config,dtmf,reporting,cdr,dialplan
write = system,call,agent,log,verbose,user,config,command,reporting,originate

Следно, има неколку трикови кои ќе треба да се имплементираат преку dialplan (за нас ова е extensions.ael).

Ќе ја дадам целата датотека, а потоа ќе дадам објаснување:

globals {
    WAV=/var/www/pbx.vistep.ru/callme/records/wav; //Временный каталог с WAV
    MP3=/var/www/pbx.vistep.ru/callme/records/mp3; //Куда выгружать mp3 файлы
    URLRECORDS=https://pbx.vistep.ru/callme/records/mp3;
    RECORDING=1; // Запись, 1 - включена.
};

macro recording(calling,called) {
        if ("${RECORDING}" = "1"){
              Set(fname=${UNIQUEID}-${STRFTIME(${EPOCH},,%Y-%m-%d-%H_%M)}-${calling}-${called});
	      Set(datedir=${STRFTIME(${EPOCH},,%Y/%m/%d)});
	      System(mkdir -p ${MP3}/${datedir});
	      System(mkdir -p ${WAV}/${datedir});
              Set(monopt=nice -n 19 /usr/bin/lame -b 32  --silent "${WAV}/${datedir}/${fname}.wav"  "${MP3}/${datedir}/${fname}.mp3" && rm -f "${WAV}/${fname}.wav" && chmod o+r "${MP3}/${datedir}/${fname}.mp3");
	      Set(FullFname=${URLRECORDS}/${datedir}/${fname}.mp3);
              Set(CDR(filename)=${fname}.mp3);
	      Set(CDR(recordingfile)=${fname}.wav);
              Set(CDR(realdst)=${called});
              MixMonitor(${WAV}/${datedir}/${fname}.wav,b,${monopt});

       };
};


context incoming {
888999 => {
	&recording(${CALLERID(number)},${EXTEN});
        Answer();
        ExecIF(${CallMeCallerIDName}?Set(CALLERID(name)=${CallMeCallerIDName}):NoOp()); // выставляем CallerID если узнали его у Битрикс24
        Set(CallStart=${STRFTIME(epoch,,%s)});  
        Queue(Q1,tT);
        Set(CallMeDISPOSITION=${CDR(disposition)}); 
        Hangup();
        }

h => {
    Set(CDR_PROP(disable)=true); 
    Set(CallStop=${STRFTIME(epoch,,%s)}); 
    Set(CallMeDURATION=${MATH(${CallStop}-${CallStart},int)}); 
    ExecIF(${ISNULL(${CallMeDISPOSITION})}?Set(CallMeDISPOSITION=${CDR(disposition)}):NoOP(=== CallMeDISPOSITION already was set ===));  
}

}


context default {

_X. => {
        Hangup();
        }
};


context dial_out {

_[1237]XX => {
	&recording(${CALLERID(number)},${EXTEN});
        Set(__CallIntNum=${CALLERID(num)})
	Set(CallStart=${STRFTIME(epoch,,%s)});
        Dial(SIP/${EXTEN},,tTr);
        Hangup();
        }

_11XXX => {
	&recording(${CALLERID(number)},${EXTEN});
	Set(CallStart=${STRFTIME(epoch,,%s)});
	Set(__CallIntNum=${CALLERID(num)});
        Dial(SIP/${EXTEN:2}@toOurAster,,t);
        Hangup();
        }

_. => {
	&recording(${CALLERID(number)},${EXTEN});
        Set(__CallIntNum=${CALLERID(num)})
	Set(CallStart=${STRFTIME(epoch,,%s)});
	Dial(SIP/${EXTEN}@toOurAster,,t);
	Hangup();
        }

h => {
        Set(CDR_PROP(disable)=true);
        Set(CallStop=${STRFTIME(epoch,,%s)});
        Set(CallMeDURATION=${MATH(${CallStop}-${CallStart},int)});
	if(${ISNULL(${CallMeDISPOSITION})}) {
          Set(CallMeDISPOSITION=${CDR(disposition)});
        }
	System(curl -s http://pbx.vistep.ru/CallMeOut.php --data action=sendcall2b24 --data call_id=${CallMeCALL_ID} --data-urlencode FullFname=${FullFname} --data CallIntNum=${CallIntNum} --data CallDuration=${CallMeDURATION} --data-urlencode CallDisposition=${CallMeDISPOSITION});
}

};

Да почнеме од почеток: директивата глобули.

Променлива УРЛ-РЕКОРДИ ја складира URL-то на датотеките за снимање разговори, според кои Bitrix24 ќе ги повлече во контактната картичка.

Следно, ние сме заинтересирани за макро макро снимање.

Овде, покрај снимањето разговори, ќе ја поставиме и променливата Целосно име.

Set(FullFname=${URLRECORDS}/${datedir}/${fname}.mp3);

Ја складира целосната URL адреса на одредена датотека (макрото се повикува насекаде).

Ајде да го анализираме појдовниот повик:

_. => {
	&recording(${CALLERID(number)},${EXTEN});
        Set(__CallIntNum=${CALLERID(num)})
	Set(CallStart=${STRFTIME(epoch,,%s)});
	Dial(SIP/${EXTEN}@toOurAster,,t);
	Hangup();
        }

h => {
        Set(CDR_PROP(disable)=true);
        Set(CallStop=${STRFTIME(epoch,,%s)});
        Set(CallMeDURATION=${MATH(${CallStop}-${CallStart},int)});
	if(${ISNULL(${CallMeDISPOSITION})}) {
          Set(CallMeDISPOSITION=${CDR(disposition)});
        }
	System(curl -s http://pbx.vistep.ru/CallMeOut.php --data action=sendcall2b24 --data call_id=${CallMeCALL_ID} --data-urlencode FullFname=${FullFname} --data CallIntNum=${CallIntNum} --data CallDuration=${CallMeDURATION} --data-urlencode CallDisposition=${CallMeDISPOSITION});
}

Да речеме дека се јавивме на 89991234567, најпрво доаѓаме овде:

&recording(${CALLERID(number)},${EXTEN});

тие. Се повикува макрото за снимање разговор и се поставуваат потребните променливи.

Понатаму

        Set(__CallIntNum=${CALLERID(num)})
	Set(CallStart=${STRFTIME(epoch,,%s)});

Снимаме кој го иницирал повикот и го снимаме времето на започнување на повикот.

И по неговото завршување, во посебен контекст h

h => {
        Set(CDR_PROP(disable)=true);
        Set(CallStop=${STRFTIME(epoch,,%s)});
        Set(CallMeDURATION=${MATH(${CallStop}-${CallStart},int)});
	if(${ISNULL(${CallMeDISPOSITION})}) {
          Set(CallMeDISPOSITION=${CDR(disposition)});
        }
	System(curl -s http://pbx.vistep.ru/CallMeOut.php --data action=sendcall2b24 --data call_id=${CallMeCALL_ID} --data-urlencode FullFname=${FullFname} --data CallIntNum=${CallIntNum} --data CallDuration=${CallMeDURATION} --data-urlencode CallDisposition=${CallMeDISPOSITION});
}

оневозможи влез во табелата CDR за оваа екстензија (таму не е потребно), поставете го времето на завршување на повикот, пресметајте го времетраењето, ако резултатот од повикот не е познат - поставете (променлива CallMeDISPOSITION) и, последниот чекор, испратете сè до Bitrix преку системот навивам.

И уште малку магија - дојдовен повик:

888999 => {
	&recording(${CALLERID(number)},${EXTEN});
        Answer();
        ExecIF(${CallMeCallerIDName}?Set(CALLERID(name)=${CallMeCallerIDName}):NoOp()); // выставляем CallerID если узнали его у Битрикс24
        Set(CallStart=${STRFTIME(epoch,,%s)}); // начинаем отсчет времени звонка
        Queue(Q1,tT);
        Set(CallMeDISPOSITION=${CDR(disposition)}); 
        Hangup();
        }

Овде не интересира само една линија.

ExecIF(${CallMeCallerIDName}?Set(CALLERID(name)=${CallMeCallerIDName}):NoOp());

Таа му кажува на PBX да инсталира ID на повикувач (име) еднаква на променлива CallMeCallerIDName.

Самата променлива CallMeCallerIDName, пак, е поставена од апликацијата CallMe (ако Bitrix24 има целосно име за бројот на повикувачот, поставете го како ID на повикувач (име), не - нема да направиме ништо).

Поставување на апликацијата

Датотека за поставки за апликација - /var/www/pbx.vistep.ru/config.php

Опис на параметрите на апликацијата:

• CallMeDEBUG — ако 1, тогаш сите настани обработени од апликацијата ќе бидат запишани во датотеката за евиденција, 0 — не пишуваме ништо
• технологија - SIP/PJSIP/IAX/итн
• authToken — токен за авторизација Bitrix24, код за овластување за појдовна веб-кука
• bitrixApiUrl — URL на дојдовната веб-кука, без профил/
• проширувања — список на надворешни броеви
• контекст — контекст за започнување на повик
• listener_timeout — брзина на обработка на настани од ѕвездичка
• ѕвездичка — низа со поставки за поврзување со ѕвездичката:
• домаќин — IP или име на домаќин на серверот со ѕвездичка
• шема — дијаграм за поврзување (tcp://, tls://)
• пристаниште - пристаниште
• корисничко име - Корисничко име
• тајна - лозинка
• connect_timeout — истек на врската
• read_timeout - тајмаут за читање

пример датотека за поставки:

 <?php
return array(

        'CallMeDEBUG' => 1, // дебаг сообщения в логе: 1 - пишем, 0 - не пишем
        'tech' => 'SIP',
        'authToken' => 'xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6', //токен авторизации битрикса
        'bitrixApiUrl' => 'https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/', //url к api битрикса (входящий вебхук)
        'extentions' => array('888999'), // список внешних номеров, через запятую
        'context' => 'dial_out', //исходящий контекст для оригинации звонка
        'asterisk' => array( // настройки для подключения к астериску
                    'host' => '10.100.111.249',
                    'scheme' => 'tcp://',
                    'port' => 5038,
                    'username' => 'callme',
                    'secret' => 'JD3clEB8_f23r-3ry84gJ',
                    'connect_timeout' => 10000,
                    'read_timeout' => 10000
                ),
        'listener_timeout' => 300, //скорость обработки событий от asterisk

);

Поставување на супервизор

Супервизорот се користи за стартување на процесот на управувач со настани од Asterisk CallMeIn.php, кој ги следи дојдовните повици и комуницира со Bitrix24 (покажи картичка, скриј картичка итн.).

Датотека за поставки што треба да се креира:

/etc/supervisord.d/callme.conf

[program:callme]
command=/usr/bin/php CallMeIn.php
directory=/var/www/pbx.vistep.ru
autostart=true
autorestart=true
startretries=5
stderr_logfile=/var/www/pbx.vistep.ru/logs/daemon.log
stdout_logfile=/var/www/pbx.vistep.ru/logs/daemon.log

Стартувајте ја и рестартирајте ја апликацијата:

supervisorctl start callme
supervisorctl restart callme

Приказ на оперативниот статус на апликацијата:

supervisorctl status callme
callme                           RUNNING   pid 11729, uptime 17 days, 16:58:07

Заклучок

Се испостави дека е доста комплицирано, но сигурен сум дека искусен администратор ќе може да го спроведе и да ги задоволи своите корисници.

Како што е ветено, линк до github.

Прашања, предлози - ве молиме оставете ги во коментари. Исто така, доколку ве интересира како помина развојот на оваа интеграција, пишете, а во следната статија ќе се обидам да ви откријам се подетално.

Извор: www.habr.com