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

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

По отношение на функционалността всичко е стандартно:

• Щраквайки върху линк с телефонен номер на клиент в Bitrix24, Asterisk свързва вътрешния номер на потребителя, от чието име е направено кликването, с телефонния номер на клиента. В Bitrix24 се записва запис на разговора и в края на разговора се изтегля запис на разговора.
• Asterisk получава обаждане отвън - в интерфейса на Bitrix24 показваме клиентската карта на служителя, на чийто номер е пристигнало това обаждане.
  Ако няма такъв клиент, ще отворим картата за създаване на нов лийд.
  Веднага след приключване на разговора отразяваме това на картата и изваждаме запис на разговора.

По-долу ще ви кажа как да настроите всичко за себе си и ще ви дам връзка към github - да, да, вземете го и го използвайте!

Общо описание

Нарекохме нашата интеграция CallMe. CallMe е малко уеб приложение, написано на PHP.

Използвани технологии и услуги

• PHP 5.6
• PHP AMI библиотека
• композирам
• Nginx + php-fpm
• ръководител
• AMI (Asterisk Manager интерфейс)
• Bitrix webhooks (опростена реализация на REST API)

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

На сървър със Asterisk трябва да инсталирате уеб сървър (при нас е nginx+php-fpm), supervisor и 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

Нека създадем две уебкукички.

Входяща уебкукичка.

Под администраторския акаунт (с идентификатор 1) следвайте пътя: Приложения -> Webhooks -> Add webhook -> Incoming webhook

Попълнете параметрите на входящия webhook, както е показано на екранните снимки:

И щракнете върху запазване.

След запазване Bitrix24 ще предостави URL адреса на входящия webhook, например:

Запазете вашата URL версия без крайния /профил/ ​​- той ще се използва в приложението за работа с входящи обаждания.

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

Изходяща уебкукичка.

Приложения -> Webhooks -> Add webhook -> Outgoing webhook

Подробностите са отново на екранните снимки:

Запазете и получете кода за оторизация

имам това xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6. Трябва също да го копирате за себе си; трябва ви, за да извършвате изходящи повиквания.

Важно!

SSL сертификатът трябва да бъде конфигуриран на сървъра Bitrix24 (можете да използвате letsencrypt), в противен случай API на Bitrix няма да работи. Ако имате облачна версия, не се притеснявайте - тя вече има ssl.

Важно!

Полето “Адрес на процесора” трябва да съдържа адрес, достъпен от Интернет!

И като последен щрих, нека инсталираме нашия CallMeOut като приложение за провеждане на разговори (така че когато щракнете върху номера на PBX, командата за започване на разговора ще изчезне).

В менюто изберете: Още -> Телефония -> Още -> Настройки, задайте в “Номер за изходящо повикване по подразбиране” Приложение: CallMeOut и натиснете “Запазване”

Настройване на звездичка

За успешно взаимодействие между Asterisk и Bitrix24 трябва да добавим AMI user callme към 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

След това има няколко трика, които ще трябва да бъдат внедрени чрез диалплан (за нас това е 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ЗАПИСИ съхранява 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 чрез системния curl.

И още малко магия - входящо обаждане:

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 да инсталира Caller ID (име) равно на променлива CallMeCallerIDName.

Самата променлива CallMeCallerIDName от своя страна се задава от приложението CallMe (ако Bitrix24 има пълно име за номера на обаждащия се, задайте го като Caller ID (име), не - няма да направим нищо).

Настройка на приложението

Файл с настройки на приложението - /var/www/pbx.vistep.ru/config.php

Описание на параметрите на приложението:

• CallMeDEBUG — ако 1, всички събития, обработени от приложението, ще бъдат записани в лог файла, 0 — не пишем нищо
• технологии - SIP/PJSIP/IAX/и др
• authToken — Токен за оторизация на Bitrix24, код за оторизация на изходящ webhook
• bitrixApiUrl — URL на входящия webhook, без профил/
• разширения — списък с външни номера
• контекст — контекст за генериране на повикване
• слушател_таймаут — скорост на обработка на събития от звездичка
• звездичка — масив с настройки за свързване към звездичката:
• домакин — ip или име на хост на сървъра със звездичка
• схема — диаграма на свързване (tcp://, tls://)
• порт - порт
• потребителско име - Потребителско име
• тайна - парола
• изчакване_за свързване — таймаут на връзката
• изчакване_за четене - таймаут за четене

примерен файл с настройки:

 <?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

);

Настройка на супервайзър

Supervisor се използва за стартиране на процеса на обработка на събития от 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