Asterisk आणि Bitrix24 चे एकत्रीकरण

IP-PBX Asterisk आणि CRM Bitrix24 समाकलित करण्यासाठी नेटवर्कमध्ये भिन्न पर्याय आहेत, परंतु तरीही, आम्ही आमचे स्वतःचे लिहिण्याचा निर्णय घेतला.

कार्यात्मकपणे, सर्वकाही मानक आहे:

• Bitrix24 मधील क्लायंटच्या फोन नंबरसह लिंकवर क्लिक करून, Asterisk वापरकर्त्याच्या अंतर्गत नंबरला जोडते ज्याच्या वतीने हे क्लिक क्लायंटच्या फोन नंबरसह केले गेले होते. Bitrix24 मध्ये, कॉलचे रेकॉर्ड रेकॉर्ड केले जाते आणि कॉलच्या शेवटी, संभाषण रेकॉर्ड वर खेचले जाते.
• Asterisk वर बाहेरून कॉल येतो - Bitrix24 इंटरफेसमध्ये, ज्याच्या नंबरवर हा कॉल आला होता त्याला आम्ही क्लायंट कार्ड दाखवतो.
  असा कोणताही क्लायंट नसल्यास, नवीन लीड तयार करण्यासाठी कार्ड उघडा.
  कॉल पूर्ण होताच, आम्ही हे कार्डमध्ये प्रतिबिंबित करतो आणि संभाषणाचे रेकॉर्डिंग काढतो.

कट अंतर्गत, मी तुम्हाला स्वतःसाठी सर्वकाही कसे सेट करायचे ते सांगेन आणि गिथबला एक लिंक द्या - होय, होय, ते घ्या आणि वापरा!

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

आम्ही आमच्या एकत्रीकरणास CallMe म्हटले. CallMe हे PHP मध्ये लिहिलेले एक लहान वेब ऍप्लिकेशन आहे.

वापरलेले तंत्रज्ञान आणि सेवा

• कृपया PHP 5.6
• PHP AMI लायब्ररी
• संगीतकार
• nginx + php fpm
• पर्यवेक्षक
• AMI (Asterisk Manager Interface)
• बिट्रिक्स वेबहुक्स (सरलीकृत REST API अंमलबजावणी)

प्रीसेटिंग

Asterisk सह सर्व्हरवर, तुम्हाला वेब सर्व्हर (आमच्याकडे nginx + php-fpm आहे), पर्यवेक्षक आणि git स्थापित करणे आवश्यक आहे.

इंस्टॉलेशन कमांड (CentOS):

yum install nginx php-fpm supervisor 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 सह) आम्ही या मार्गाचे अनुसरण करतो: अनुप्रयोग -> वेबहुक -> वेबहुक जोडा -> येणारे वेबहुक

इनकमिंग वेबहुकचे पॅरामीटर्स स्क्रीनशॉटमध्ये भरा:

आणि save वर क्लिक करा.

सेव्ह केल्यानंतर, Bitrix24 इनकमिंग वेबहुकची URL प्रदान करेल, उदाहरणार्थ:

तुमची URL ची आवृत्ती ट्रेलिंग /प्रोफाइल/ शिवाय जतन करा - ती येणार्‍या कॉलसह कार्य करण्यासाठी अनुप्रयोगात वापरली जाईल.

माझ्याकडे आहे https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/

आउटगोइंग वेबहुक.

अनुप्रयोग -> वेबहुक -> वेबहुक जोडा -> आउटगोइंग वेबहुक

तपशील स्क्रीनशॉटमध्ये आहेत:

सेव्ह करा आणि ऑथोरायझेशन कोड मिळवा

माझ्याकडे आहे xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6. तुम्हाला ते स्वतःवर कॉपी करणे देखील आवश्यक आहे, ते आउटगोइंग कॉल करण्यासाठी आवश्यक आहे.

महत्त्वाचे!

Bitrix24 सर्व्हरवर ssl प्रमाणपत्र कॉन्फिगर केलेले असणे आवश्यक आहे (तुम्ही 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

पुढे, डायलप्लान (आमच्याकडे 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});
}

या विस्तारासाठी सीडीआर टेबलमधील एंट्री बंद करा (तेथे आवश्यक नाही), कॉलची समाप्ती वेळ सेट करा, कालावधीची गणना करा, कॉलचा निकाल माहित नसल्यास - सेट करा (व्हेरिएबल मला डिस्पोजिशन कॉल करा) आणि, शेवटची पायरी, सिस्टम कर्लद्वारे सर्वकाही 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 ​​install करा कॉलरआयडी(नाव) चल CallMeCallerIDName.

CallMeCallerIDName व्हेरिएबल स्वतः CallMe ऍप्लिकेशनद्वारे सेट केले जाते (जर Bitrix24 मध्ये कॉलरच्या नंबरसाठी पूर्ण नाव असेल, तर आम्ही ते असे सेट करू कॉलरआयडी(नाव), नाही - आम्ही काहीही करणार नाही).

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

ऍप्लिकेशन सेटिंग्ज फाइल - /var/www/pbx.vistep.ru/config.php

अनुप्रयोग पॅरामीटर्सचे वर्णन:

• कॉलMeDEBUG - जर 1, तर अनुप्रयोगाद्वारे प्रक्रिया केलेले सर्व कार्यक्रम लॉग फाइलवर लिहिले जातील, 0 - आम्ही काहीही लिहित नाही
• टेक SIP/PJSIP/IAX/इ
• authToken - Bitrix24 अधिकृतता टोकन, आउटगोइंग वेबहुक अधिकृतता कोड
• bitrixApiUrl — येणार्‍या वेबहुकची URL, प्रोफाइलशिवाय/
• विस्तार - बाह्य संख्यांची यादी
• संदर्भ - कॉल उत्पत्तीसाठी संदर्भ
• श्रोता_कालबाह्य - तारकावरून इव्हेंट प्रोसेसिंग गती
• तारा - तारकाशी कनेक्शन सेटिंग्जसह अॅरे:
• यजमान - ip किंवा asterisk सर्व्हरचे होस्टनाव
• योजना — कनेक्शन डायग्राम (tcp://, tls://)
• पोर्ट - बंदर
• वापरकर्ता नाव - वापरकर्तानाव
• गुप्त - पासवर्ड
• कनेक्ट_टाइमआउट - कनेक्शन कालबाह्य
• 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

निष्कर्ष

हे खूप कठीण झाले, परंतु मला खात्री आहे की एक अनुभवी प्रशासक त्याच्या वापरकर्त्यांना अंमलात आणण्यास आणि संतुष्ट करण्यास सक्षम असेल.

आश्वासन, गिथबशी दुवा.

प्रश्न, सूचना - कृपया टिप्पण्यांमध्ये. तसेच, या एकत्रीकरणाचा विकास कसा झाला याबद्दल आपल्याला स्वारस्य असल्यास, लिहा आणि पुढील लेखात मी सर्वकाही अधिक तपशीलवार प्रकट करण्याचा प्रयत्न करेन.

स्त्रोत: www.habr.com