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 (ასტერიკის მენეჯერის ინტერფეისი)
• Bitrix webhooks (გამარტივებული 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-ის დაყენება

მოდით შევქმნათ ორი ვებჰუკი.

შემომავალი webhook.

ადმინისტრატორის ანგარიშის ქვეშ (ID 1-ით) გაიარეთ გზა: აპლიკაციები -> ვებჰუკები -> ვებჰუკის დამატება -> შემომავალი ვებჰუკი

შეავსეთ შემომავალი webhook-ის პარამეტრები, როგორც ეკრანის სურათებში:

და დააჭირეთ შენახვას.

შენახვის შემდეგ, Bitrix24 მოგაწვდით შემომავალი ვებჰუკის URL-ს, მაგალითად:

შეინახეთ URL-ის თქვენი ვერსია ბოლო /პროფილის/ გარეშე - ის გამოყენებული იქნება აპლიკაციაში შემომავალ ზარებთან მუშაობისთვის.

მაქვს https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/

გამავალი webhook.

პროგრამები -> Webhooks -> დამატება Webhook -> Outgoing Webhook

დეტალები მოცემულია ეკრანის სურათებზე:

შეინახეთ და მიიღეთ ავტორიზაციის კოდი

მაქვს xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6. თქვენ ასევე უნდა დააკოპიროთ იგი საკუთარ თავს, საჭიროა გამავალი ზარების განსახორციელებლად.

მნიშვნელოვანია!

ssl სერთიფიკატი უნდა იყოს კონფიგურირებული Bitrix24 სერვერზე (შეგიძლიათ გამოიყენოთ letsencrypt), წინააღმდეგ შემთხვევაში BitrixXNUMX 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 ჩანაწერები ინახავს საუბრის ჩამწერი ფაილების URL-ს, რომლის მიხედვითაც Bitrix24 გაიყვანს მათ საკონტაქტო ბარათში.

შემდეგი, ჩვენ გვაინტერესებს მაკრო მაკრო ჩაწერა.

აქ, საუბრების ჩაწერის გარდა, ჩვენ დავაყენებთ ცვლადს FullFname.

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 ცხრილში ამ გაფართოებისთვის (ის არ არის საჭირო იქ), დააყენეთ ზარის დასრულების დრო, გამოთვალეთ ხანგრძლივობა, თუ ზარის შედეგი უცნობია - დააყენეთ (ცვლადი დამირეკე DISPOSITION) და, ბოლო ნაბიჯი, გაუგზავნე ყველაფერი 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-ის დაყენება აბონენტის ID (სახელი) ცვლადი CallMeCallerIDName.

თავად CallMeCallerIDName ცვლადი, თავის მხრივ, დაყენებულია CallMe აპლიკაციის მიერ (თუ Bitrix24-ს აქვს აბონენტის ნომრის სრული სახელი, ჩვენ დავაყენებთ მას, როგორც აბონენტის ID (სახელი), არა - არაფერს გავაკეთებთ).

აპლიკაციის დაყენება

აპლიკაციის პარამეტრების ფაილი - /var/www/pbx.vistep.ru/config.php

განაცხადის პარამეტრების აღწერა:

• CallMeDEBUG - თუ 1, მაშინ აპლიკაციის მიერ დამუშავებული ყველა მოვლენა ჩაიწერება ჟურნალის ფაილში, 0 - ჩვენ არაფერს ვწერთ
• Tech SIP/PJSIP/IAX/ა.შ
• authToken — Bitrix24 ავტორიზაციის ჟეტონი, გამავალი webhook ავტორიზაციის კოდი
• bitrixApiUrl — შემომავალი webhook-ის 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