אינטגרציה של Asterisk ו-Bitrix24

ישנן אפשרויות שונות לשילוב IP-PBX Asterisk ו-CRM Bitrix24 ברשת, אך בכל זאת החלטנו לכתוב משלנו.

מבחינת פונקציונליות, הכל סטנדרטי:

• על ידי לחיצה על קישור עם מספר טלפון של לקוח ב-Bitrix24, Asterisk מחברת את המספר הפנימי של המשתמש שבשמו בוצעה הקליק עם מספר הטלפון של הלקוח. ב-Bitrix24 מוקלטת תיעוד השיחה ובסיום השיחה נשלפת הקלטה של ​​השיחה.
• כוכבית מקבלת שיחה מבחוץ - בממשק Bitrix24 אנו מציגים את כרטיס הלקוח לעובד שאליו הגיעה השיחה הזו.
  אם אין לקוח כזה, נפתח את הכרטיס ליצירת ליד חדש.
  מיד עם השלמת השיחה, אנו משקפים זאת בכרטיס ושולפים הקלטה של ​​השיחה.

מתחת לגזרה אני אגיד לך איך להגדיר הכל לעצמך ואתן לך קישור ל-github - כן, כן, קח את זה והשתמש בו!

תיאור כללי

קראנו לאינטגרציה שלנו CallMe. CallMe הוא יישום אינטרנט קטן שנכתב ב-PHP.

טכנולוגיות ושירותים בשימוש

• PHP 5.6
• ספריית PHP AMI
• מלחין
• Nginx + php-fpm
• מפקח
• AMI (ממשק מנהל כוכביות)
• Bitrix webhooks (יישום פשוט של REST API)

הגדרה מראש

בשרת עם כוכבית צריך להתקין שרת אינטרנט (אצלנו זה nginx+php-fpm), supervisor ו-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

בואו ניצור שני webhooks.

Webhook נכנס.

תחת חשבון המנהל (עם מזהה 1), עקוב אחר הנתיב: Applications -> Webhooks -> Add webhook -> Incoming webhook

מלא את הפרמטרים של ה-webhook הנכנס כמו בצילומי המסך:

ולחץ על שמור.

לאחר השמירה, Bitrix24 תספק את כתובת האתר של ה-webhook הנכנס, לדוגמה:

שמור את הגרסה שלך של כתובת האתר ללא /profile/ הסופי - היא תשמש באפליקציה לעבודה עם שיחות נכנסות.

יש לי את זה https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/

Webhook יוצא.

יישומים -> Webhooks -> הוסף webhook -> Webhook יוצא

הפרטים מופיעים שוב בצילומי המסך:

שמור וקבל את קוד ההרשאה

יש לי את זה xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6. אתה גם צריך להעתיק את זה לעצמך; אתה צריך את זה כדי לבצע שיחות יוצאות.

חשוב!

יש להגדיר תעודת SSL בשרת Bitrix24 (תוכל להשתמש ב-letsencrypt), אחרת ה-API של Bitrix לא יעבוד. אם יש לך גרסת ענן, אל תדאג - כבר יש לה ssl.

חשוב!

השדה "כתובת מעבד" חייב להכיל כתובת הנגישה מהאינטרנט!

וכמגע אחרון, בואו נתקין את CallMeOut שלנו כאפליקציה לביצוע שיחות (כך שכאשר תלחצו על המספר במרכזייה, הפקודה ליצירת השיחה תעוף משם).

בתפריט, בחר: עוד -> טלפוניה -> עוד -> הגדרות, הגדר ב"מספר שיחה יוצאת כברירת מחדל" יישום: 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 מאחסן את כתובת האתר לקבצי הקלטת השיחה, לפיה Bitrix24 תמשוך אותם לכרטיס איש הקשר.

בשלב הבא אנו מתעניינים במאקרו המאקרו הקלטה.

כאן, בנוסף להקלטת שיחות, נגדיר את המשתנה שם מלא.

Set(FullFname=${URLRECORDS}/${datedir}/${fname}.mp3);

הוא מאחסן את כתובת האתר המלאה לקובץ ספציפי (המאקרו נקרא בכל מקום).

בואו ננתח את השיחה היוצאת:

_. => {
	&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 עבור שלוחה זו (אין צורך שם), קבע את שעת הסיום של השיחה, חשב את משך הזמן, אם תוצאת השיחה לא ידועה - הגדר (משתנה 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());

היא אומרת למרכזייה להתקין זיהוי מתקשר (שם) שווה למשתנה CallMeCallerIDName.

המשתנה CallMeCallerIDName עצמו, בתורו, נקבע על ידי אפליקציית CallMe (אם ל-Bitrix24 יש שם מלא למספר של המתקשר, הגדר אותו בתור זיהוי מתקשר (שם), לא - לא נעשה כלום).

הגדרת האפליקציה

קובץ הגדרות היישום - /var/www/pbx.vistep.ru/config.php

תיאור פרמטרי יישום:

• CallMeDEBUG - אם 1, אז כל האירועים שעובדו על ידי האפליקציה ייכתבו לקובץ היומן, 0 - אנחנו לא כותבים כלום
• טק - SIP/PJSIP/IAX/וכו'
• authToken — אסימון הרשאה של Bitrix24, קוד הרשאת webhook יוצא
• bitrixApiUrl - כתובת האתר של ה-webhook הנכנס, ללא פרופיל/
• הרחבות - רשימה של מספרים חיצוניים
• הקשר - הקשר ליצירת שיחה
• פסק זמן_מאזין - מהירות עיבוד האירועים מכוכבית
• כוכבית — מערך עם הגדרות לחיבור לכוכבית:
• המארח - ip או שם מארח של שרת הכוכביות
• תכנית - דיאגרמת חיבור (tcp://, tls://)
• נמל - נמל
• שם משתמש - שם משתמש
• סוד - סיסמה
• פסק זמן connect_ - פסק זמן לחיבור
• הפסקת קריאה - הפסקת קריאה

קובץ הגדרות לדוגמה:

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

);

הגדרת מפקח

Supervisor משמש כדי להפעיל את תהליך המטפל באירועים מ-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