Asterisk এবং Bitrix24 এর ইন্টিগ্রেশন

নেটওয়ার্কে IP-PBX Asterisk এবং CRM Bitrix24 সংহত করার জন্য বিভিন্ন বিকল্প রয়েছে, কিন্তু আমরা এখনও আমাদের নিজস্ব লেখার সিদ্ধান্ত নিয়েছি।

কার্যকারিতার পরিপ্রেক্ষিতে, সবকিছু মানক:

• Bitrix24-এ একটি ক্লায়েন্টের ফোন নম্বর সহ একটি লিঙ্কে ক্লিক করার মাধ্যমে, Asterisk ব্যবহারকারীর অভ্যন্তরীণ নম্বরকে সংযুক্ত করে যার পক্ষে ক্লায়েন্টের ফোন নম্বরের সাথে ক্লিক করা হয়েছে। Bitrix24-এ, কলের একটি রেকর্ড রেকর্ড করা হয় এবং কলের শেষে, কথোপকথনের একটি রেকর্ডিং টানা হয়।
• Asterisk বাইরে থেকে একটি কল পায় - Bitrix24 ইন্টারফেসে আমরা সেই কর্মচারীকে ক্লায়েন্ট কার্ড দেখাই যার নম্বরে এই কল এসেছে।
  যদি এমন কোন ক্লায়েন্ট না থাকে, আমরা একটি নতুন লিড তৈরি করার জন্য কার্ড খুলব।
  কলটি সম্পন্ন হওয়ার সাথে সাথে, আমরা এটি কার্ডে প্রতিফলিত করি এবং কথোপকথনের একটি রেকর্ডিং টান।

কাটের নীচে আমি আপনাকে বলব কীভাবে নিজের জন্য সবকিছু সেট আপ করবেন এবং আপনাকে গিথুবের একটি লিঙ্ক দিতে হবে - হ্যাঁ, হ্যাঁ, এটি নিন এবং এটি ব্যবহার করুন!

সাধারণ বিবরণ

আমরা আমাদের ইন্টিগ্রেশনকে কলমি বলেছি। CallMe হল পিএইচপি-তে লেখা একটি ছোট ওয়েব অ্যাপ্লিকেশন।

ব্যবহৃত প্রযুক্তি এবং পরিষেবা

• পিএইচপি 5.6
• পিএইচপি এএমআই লাইব্রেরি
• সুরকার
• Nginx + php-fpm
• অধীক্ষক
• AMI (স্টারিস্ক ম্যানেজার ইন্টারফেস)
• বিট্রিক্স ওয়েবহুক (সরলীকৃত REST API বাস্তবায়ন)

প্রাক-সেটিং

Asterisk সহ একটি সার্ভারে, আপনাকে একটি ওয়েব সার্ভার ইনস্টল করতে হবে (আমাদের জন্য এটি nginx+php-fpm), সুপারভাইজার এবং গিট।

ইনস্টলেশন কমান্ড (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 ব্যবহার করতে পারেন), অন্যথায় Bitrix api কাজ করবে না। আপনার যদি ক্লাউড সংস্করণ থাকে তবে চিন্তা করবেন না - এটি ইতিমধ্যেই এসএসএল রয়েছে।

গুরুত্বপূর্ণ!

"প্রসেসরের ঠিকানা" ক্ষেত্রে অবশ্যই ইন্টারনেট থেকে অ্যাক্সেসযোগ্য একটি ঠিকানা থাকতে হবে!

এবং একটি চূড়ান্ত স্পর্শ হিসাবে, আসুন কল করার জন্য একটি অ্যাপ্লিকেশন হিসাবে আমাদের CallMeOut ইনস্টল করি (যাতে আপনি যখন PBX-এর নম্বরে ক্লিক করবেন, কলটি শুরু করার নির্দেশটি উড়ে যাবে)।

মেনুতে, নির্বাচন করুন: আরও -> টেলিফোনি -> আরও -> সেটিংস, "ডিফল্ট আউটগোয়িং কল নম্বর" অ্যাপ্লিকেশনে সেট করুন: CallMeOut এবং "সংরক্ষণ করুন" এ ক্লিক করুন

তারকাচিহ্ন সেট আপ করা হচ্ছে

Asterisk এবং Bitrix24 এর মধ্যে সফল ইন্টারঅ্যাকশনের জন্য, আমাদের এএমআই ব্যবহারকারী কলমে যোগ করতে হবে 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});
}

এই এক্সটেনশনের জন্য সিডিআর টেবিলে প্রবেশ অক্ষম করুন (এটি সেখানে প্রয়োজন নেই), কলের শেষ সময় সেট করুন, সময়কাল গণনা করুন, যদি কলের ফলাফল জানা না থাকে - সেট (ভেরিয়েবল 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());

সে পিবিএক্সকে ইন্সটল করতে বলে CallerID(নাম) পরিবর্তনশীলের সমান CallMeCallerIDName.

CallMeCallerIDName ভেরিয়েবল নিজেই CallMe অ্যাপ্লিকেশন দ্বারা সেট করা হয় (যদি Bitrix24-এর কলারের নম্বরের জন্য একটি সম্পূর্ণ নাম থাকে, তাহলে এটিকে এইভাবে সেট করুন CallerID(নাম), না - আমরা কিছুই করব না)।

অ্যাপ্লিকেশন সেটআপ

অ্যাপ্লিকেশন সেটিংস ফাইল - /var/www/pbx.vistep.ru/config.php

অ্যাপ্লিকেশন পরামিতি বর্ণনা:

• কলMeDEBUG — যদি 1, তাহলে অ্যাপ্লিকেশন দ্বারা প্রক্রিয়াকৃত সমস্ত ইভেন্ট লগ ফাইলে লেখা হবে, 0 — আমরা কিছু লিখি না
• প্রযুক্তি - SIP/PJSIP/IAX/ইত্যাদি
• authToken — Bitrix24 অনুমোদন টোকেন, বহির্গামী ওয়েবহুক অনুমোদন কোড
• bitrixApiUrl — আগত ওয়েবহুকের URL, প্রোফাইল ছাড়া/
• এক্সটেনশন - বাহ্যিক সংখ্যার তালিকা
• প্রসঙ্গ - একটি কলের উদ্ভবের প্রসঙ্গ
• শ্রোতা_সময় শেষ — তারকাচিহ্ন থেকে ইভেন্ট প্রক্রিয়াকরণের গতি
• তারকাচিহ্ন — তারকাচিহ্নের সাথে সংযোগ করার জন্য সেটিংস সহ একটি অ্যারে:
• নিমন্ত্রণকর্তা — আইপি বা তারকাচিহ্ন সার্ভারের হোস্টনাম
• পরিকল্পনা — সংযোগ চিত্র (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

উপসংহার

এটি বেশ জটিল বলে প্রমাণিত হয়েছে, তবে আমি নিশ্চিত যে একজন অভিজ্ঞ প্রশাসক এটি বাস্তবায়ন করতে এবং তার ব্যবহারকারীদের খুশি করতে সক্ষম হবেন।

প্রতিশ্রুত, github লিঙ্ক.

প্রশ্ন, পরামর্শ - মন্তব্যে তাদের ছেড়ে দিন. এছাড়াও, আপনি যদি এই একীকরণের বিকাশ কীভাবে হয়েছে তা নিয়ে আগ্রহী হন তবে লিখুন এবং পরবর্তী নিবন্ধে আমি আরও বিস্তারিতভাবে সবকিছু প্রকাশ করার চেষ্টা করব।

উত্স: www.habr.com