🥇एस्टरिस्क और Bitrix24 का एकीकरण

नेटवर्क पर IP-PBX Asterisk और CRM Bitrix24 को एकीकृत करने के लिए अलग-अलग विकल्प हैं, लेकिन हमने फिर भी अपना खुद का लिखने का फैसला किया।

कार्यक्षमता के संदर्भ में, सब कुछ मानक है:

Bitrix24 में क्लाइंट के फ़ोन नंबर वाले लिंक पर क्लिक करने पर, Asterisk उस उपयोगकर्ता के आंतरिक नंबर को क्लाइंट के फ़ोन नंबर से जोड़ता है जिसकी ओर से क्लिक किया गया था। Bitrix24 में, कॉल का रिकॉर्ड रिकॉर्ड किया जाता है और कॉल के अंत में, बातचीत की रिकॉर्डिंग निकाली जाती है।
एस्टरिस्क को बाहर से कॉल प्राप्त होती है - Bitrix24 इंटरफ़ेस में हम उस कर्मचारी को क्लाइंट कार्ड दिखाते हैं जिसके नंबर पर यह कॉल आई थी।
यदि ऐसा कोई ग्राहक नहीं है, तो हम नई लीड बनाने के लिए कार्ड खोलेंगे।
जैसे ही कॉल पूरी हो जाती है, हम इसे कार्ड पर दर्शाते हैं और बातचीत की रिकॉर्डिंग निकाल लेते हैं।

कट के नीचे मैं आपको बताऊंगा कि अपने लिए सब कुछ कैसे सेट करें और आपको जीथब का लिंक दें - हाँ, हाँ, इसे लें और इसका उपयोग करें!

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

हमने अपने एकीकरण को CallMe कहा। CallMe PHP में लिखा गया एक छोटा वेब एप्लिकेशन है।

उपयोग की जाने वाली प्रौद्योगिकियाँ और सेवाएँ

PHP 5.6
पीएचपी एएमआई लाइब्रेरी
संगीतकार
Nginx + php-fpm
पर्यवेक्षक
एएमआई (तारांकन प्रबंधक इंटरफ़ेस)
बिट्रिक्स वेबहुक (सरलीकृत REST API कार्यान्वयन)

presetting

एस्टरिस्क वाले सर्वर पर, आपको एक वेब सर्वर (हमारे लिए यह 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 की स्थापना

आइए दो वेबहुक बनाएं।

आने वाली वेबहुक.

व्यवस्थापक खाते के अंतर्गत (आईडी 1 के साथ), पथ का अनुसरण करें: एप्लिकेशन -> वेबहुक -> वेबहुक जोड़ें -> इनकमिंग वेबहुक

स्क्रीनशॉट के अनुसार आने वाले वेबहुक के पैरामीटर भरें:

और सेव पर क्लिक करें.

सहेजने के बाद, Bitrix24 आने वाले वेबहुक का URL प्रदान करेगा, उदाहरण के लिए:

यूआरएल के अपने संस्करण को अंतिम /प्रोफ़ाइल/ के बिना सहेजें - इसका उपयोग इनकमिंग कॉल के साथ काम करने के लिए एप्लिकेशन में किया जाएगा।

मेरे पर यह है https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/

निवर्तमान वेबहुक.

एप्लिकेशन -> वेबहुक -> वेबहुक जोड़ें -> आउटगोइंग वेबहुक

विवरण फिर से स्क्रीनशॉट पर हैं:

प्राधिकरण कोड सहेजें और प्राप्त करें

मेरे पर यह है xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6. आपको इसे अपने लिए भी कॉपी करना होगा; आउटगोइंग कॉल करने के लिए आपको इसकी आवश्यकता होगी।

महत्वपूर्ण!

Bitrix24 सर्वर पर एक SSL प्रमाणपत्र कॉन्फ़िगर किया जाना चाहिए (आप Letsencrypt का उपयोग कर सकते हैं), अन्यथा Bitrix एपीआई काम नहीं करेगा। यदि आपके पास क्लाउड संस्करण है, तो चिंता न करें - इसमें पहले से ही एसएसएल है।

महत्वपूर्ण!

"प्रोसेसर पता" फ़ील्ड में इंटरनेट से पहुंच योग्य पता होना चाहिए!

और अंतिम स्पर्श के रूप में, आइए कॉल करने के लिए हमारे CallMeOut को एक एप्लिकेशन के रूप में इंस्टॉल करें (ताकि जब आप पीबीएक्स पर नंबर पर क्लिक करें, तो कॉल शुरू करने का आदेश उड़ जाए)।

मेनू में, चुनें: अधिक -> टेलीफोनी -> अधिक -> सेटिंग्स, "डिफ़ॉल्ट आउटगोइंग कॉल नंबर" एप्लिकेशन में सेट करें: CallMeOut और "सहेजें" पर क्लिक करें।

तारांकन स्थापित करना

Asterisk और Bitrix24 के बीच सफल इंटरेक्शन के लिए, हमें AMI उपयोगकर्ता callme को मैनेजर.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

इसके बाद, कई तरकीबें हैं जिन्हें डायलप्लान के माध्यम से लागू करने की आवश्यकता होगी (हमारे लिए यह एक्सटेंशन.एएल है)।

मैं पूरी फ़ाइल उपलब्ध कराऊंगा, और फिर स्पष्टीकरण दूंगा:

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});
}

इस एक्सटेंशन के लिए सीडीआर तालिका में प्रविष्टि अक्षम करें (वहां इसकी आवश्यकता नहीं है), कॉल का अंतिम समय निर्धारित करें, अवधि की गणना करें, यदि कॉल का परिणाम ज्ञात नहीं है - सेट (चर) कॉलमीडिस्पोज़िशन) और, अंतिम चरण, सिस्टम कर्ल के माध्यम से सब कुछ बिट्रिक्स को भेजें।

और थोड़ा और जादू - एक इनकमिंग कॉल:

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());

वह पीबीएक्स को इंस्टॉल करने के लिए कहती है कॉलरआईडी(नाम) परिवर्तनशील के बराबर कॉलमीकॉलरआईडीनाम.

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

एप्लिकेशन सेट करना

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

एप्लिकेशन पैरामीटर का विवरण:

कॉलमीडेबग - यदि 1, तो एप्लिकेशन द्वारा संसाधित सभी ईवेंट लॉग फ़ाइल में लिखे जाएंगे, 0 - हम कुछ भी नहीं लिखते हैं
तकनीक - एसआईपी/पीजेएसआईपी/आईएएक्स/आदि
authToken - Bitrix24 प्राधिकरण टोकन, आउटगोइंग वेबहुक प्राधिकरण कोड
bitrixApiUrl - आने वाले वेबहुक का यूआरएल, बिना प्रोफ़ाइल के/
विस्तार - बाहरी नंबरों की सूची
प्रसंग - कॉल शुरू करने का संदर्भ
श्रोता_समयबाह्य - तारांकन से घटना प्रसंस्करण की गति
तारांकन - तारांकन से कनेक्ट करने के लिए सेटिंग्स के साथ एक सरणी:
मेजबान - तारांकन सर्वर का आईपी या होस्टनाम
योजना - कनेक्शन आरेख (टीसीपी: //, टीएलएस: //)
बंदरगाह - पत्तन
उपयोगकर्ता नाम - उपयोगकर्ता नाम
गुप्त - पासवर्ड
कनेक्ट_टाइमआउट - रिश्तों का समय बाहर
समय से पढने की समय सीमा समाप्त - समय से पढने की समय सीमा समाप्त

उदाहरण सेटिंग फ़ाइल:

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

एस्टरिस्क और बिट्रिक्स24 का एकीकरण