🥇 Asterisk र Bitrix24 को एकीकरण

नेटवर्कमा IP-PBX Asterisk र CRM Bitrix24 लाई एकीकृत गर्नका लागि विभिन्न विकल्पहरू छन्, तर हामीले अझै पनि आफ्नै लेख्ने निर्णय गर्यौं।

कार्यक्षमता को मामला मा, सबै मानक छ:

Bitrix24 मा ग्राहकको फोन नम्बर भएको लिङ्कमा क्लिक गरेर, Asterisk ले प्रयोगकर्ताको आन्तरिक नम्बर जडान गर्दछ जसको तर्फबाट ग्राहकको फोन नम्बरसँग क्लिक गरिएको थियो। Bitrix24 मा, कलको रेकर्ड रेकर्ड गरिन्छ र कलको अन्त्यमा, कुराकानीको रेकर्डिङ तानिन्छ।
Asterisk ले बाहिरबाट कल प्राप्त गर्छ - Bitrix24 इन्टरफेसमा हामी कर्मचारीलाई क्लाइन्ट कार्ड देखाउँछौं जसको नम्बरमा यो कल आयो।
यदि त्यहाँ त्यस्तो कुनै ग्राहक छैन भने, हामी नयाँ नेतृत्व सिर्जना गर्न कार्ड खोल्नेछौं।
कल पूरा हुने बित्तिकै, हामी यसलाई कार्डमा प्रतिबिम्बित गर्छौं र कुराकानीको रेकर्डिङ तान्दछौं।

काटिएको तल म तपाइँलाई तपाइँको लागि सबै कुरा कसरी सेट अप गर्ने र तपाइँलाई गिथबको लिङ्क दिनेछु - हो, हो, यसलाई लिनुहोस् र यसलाई प्रयोग गर्नुहोस्!

सामान्य वर्णन

हामीले हाम्रो एकीकरणलाई 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 सेटअप गर्दै

दुई वेबहुकहरू सिर्जना गरौं।

आगमन वेबहुक।

प्रशासक खाता अन्तर्गत (आईडी १ को साथ), मार्ग पछ्याउनुहोस्: अनुप्रयोगहरू -> वेबहुकहरू -> वेबहुक थप्नुहोस् -> आगमन वेबहुक

स्क्रिनसटहरूमा जस्तै आगमन वेबहुकको प्यारामिटरहरू भर्नुहोस्:

र बचत क्लिक गर्नुहोस्।

बचत गरेपछि, Bitrix24 ले आगमन वेबहुकको URL प्रदान गर्नेछ, उदाहरणका लागि:

अन्तिम / प्रोफाइल / बिना नै URL को आफ्नो संस्करण बचत गर्नुहोस् - यो आगमन कलहरूसँग काम गर्न अनुप्रयोगमा प्रयोग गरिनेछ।

मसँग यो छ https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/

बाहिर जाने वेबहुक।

अनुप्रयोगहरू -> वेबहुकहरू -> वेबहुक थप्नुहोस् -> बाहिर जाने वेबहुक

विवरणहरू फेरि स्क्रिनसटहरूमा छन्:

बचत गर्नुहोस् र प्राधिकरण कोड प्राप्त गर्नुहोस्

मसँग यो छ xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6। तपाईंले यसलाई आफ्नो लागि पनि प्रतिलिपि गर्न आवश्यक छ; तपाईंलाई बहिर्गमन कलहरू गर्न आवश्यक छ।

महत्वपूर्ण!

SSL प्रमाणपत्र Bitrix24 सर्भरमा कन्फिगर गरिएको हुनुपर्छ (तपाईले letsencrypt प्रयोग गर्न सक्नुहुन्छ), अन्यथा Bitrix api ले काम गर्ने छैन। यदि तपाइँसँग क्लाउड संस्करण छ भने, चिन्ता नगर्नुहोस् - यो पहिले नै ssl छ।

महत्वपूर्ण!

"प्रोसेसर ठेगाना" फिल्डमा इन्टरनेटबाट पहुँचयोग्य ठेगाना हुनु पर्छ!

र अन्तिम स्पर्शको रूपमा, कलहरू गर्नको लागि एउटा अनुप्रयोगको रूपमा हाम्रो CallMeOut स्थापना गरौं (यसकारण जब तपाईंले PBX मा रहेको नम्बरमा क्लिक गर्नुहुन्छ, कल सुरु गर्ने आदेश उड्नेछ)।

मेनुमा, चयन गर्नुहोस्: थप -> टेलिफोनी -> थप -> सेटिङ्हरू, "पूर्वनिर्धारित बहिर्गमन कल नम्बर" अनुप्रयोगमा सेट गर्नुहोस्: CallMeOut र "बचत गर्नुहोस्" मा क्लिक गर्नुहोस्।

तारांकन सेट अप गर्दै

Asterisk र Bitrix24 बीच सफल अन्तरक्रियाको लागि, हामीले AMI प्रयोगकर्ता 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

अर्को, त्यहाँ धेरै चालहरू छन् जुन 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});
}

};

सुरुबाट सुरु गरौं: निर्देशन ग्लोबलहरू.

परिवर्तनशील URLRECORDS कुराकानी रेकर्डिङ फाइलहरूमा 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 तालिकामा प्रविष्टि असक्षम गर्नुहोस् (यसलाई त्यहाँ आवश्यक छैन), कलको अन्त्य समय सेट गर्नुहोस्, अवधि गणना गर्नुहोस्, यदि कलको परिणाम थाहा छैन भने - सेट (चर कलMeDISPOSITION) र, अन्तिम चरण, प्रणाली कर्ल मार्फत 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 लाई स्थापना गर्न भन्छिन् कलरआईडी(नाम) चर बराबर CallMeCallerIDName.

CallMeCallerIDName चर आफैं, CallMe अनुप्रयोग द्वारा सेट गरिएको छ (यदि Bitrix24 कलरको नम्बरको लागि पूरा नाम छ भने, यसलाई यस रूपमा सेट गर्नुहोस्। कलरआईडी(नाम), होइन - हामी केहि गर्दैनौं)।

अनुप्रयोग सेट अप गर्दै

आवेदन सेटिङ फाइल - /var/www/pbx.vistep.ru/config.php

आवेदन मापदण्डहरूको विवरण:

कलMeDEBUG - यदि 1, तब अनुप्रयोग द्वारा प्रशोधन गरिएका सबै घटनाहरू लग फाइलमा लेखिनेछ, 0 - हामी केहि लेख्दैनौं।
प्रविधी - SIP/PJSIP/IAX/etc
authToken - Bitrix24 प्राधिकरण टोकन, बाहिर जाने वेबहुक प्राधिकरण कोड
bitrixApiUrl - आगमन वेबहुकको URL, बिना प्रोफाइल/
विस्तारहरू - बाह्य संख्याहरूको सूची
सन्दर्भ - कल उत्पत्तिको लागि सन्दर्भ
श्रोता_टाइमआउट - तारांकनबाट घटना प्रशोधनको गति
asterisk - तारांकनमा जडान गर्नको लागि सेटिङहरूको साथ एर्रे:
पाहुना - तारांकन सर्भरको 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

Asterisk र Bitrix24 को एकीकरण