نتعامل مع FreePBX وندمجها مع Bitrix24 وليس فقط

Bitrix24 عبارة عن حصاد ضخم يجمع بين CRM وتدفق المستندات والمحاسبة والعديد من الأشياء الأخرى التي يحبها المديرون حقًا ولا يحبها موظفو تكنولوجيا المعلومات حقًا. يتم استخدام البوابة من قبل الكثير من الشركات الصغيرة والمتوسطة ، بما في ذلك العيادات الصغيرة وعمال التصنيع وحتى صالونات التجميل. الوظيفة الرئيسية التي "يحبها" المديرون هي تكامل الاتصال الهاتفي وإدارة علاقات العملاء ، عندما يتم تسجيل أي مكالمة على الفور في CRM ، يتم إنشاء بطاقات العملاء ، ويتم عرض معلومات حول العميل عند وصوله ، ويمكنك على الفور معرفة من هو وماذا يمكنه بيعه وكم يدين به. لكن الاتصال الهاتفي من Bitrix24 وتكامله مع CRM يكلف الكثير من المال في بعض الأحيان. سأخبرك في المقال بتجربة التكامل مع الأدوات المفتوحة و IP PBX FreePBX المشهور ، وأيضًا ضع في اعتبارك منطق عمل الأجزاء المختلفة

أعمل كشركة تعهيد في شركة تبيع وتتكامل مع المهاتفة عبر بروتوكول الإنترنت. عندما سُئلت عما إذا كان بإمكاننا تقديم هذا الشيء وهذه الشركة لدمج Bitrix24 مع PBXs التي يمتلكها العملاء ، وكذلك مع PBXs الافتراضية في العديد من شركات VDS ، ذهبت إلى Google. وقد أعطاني ، بالطبع ، رابطًا لمقال في حبر ، حيث يوجد وصف ، وجيثب ، ويبدو أن كل شيء يعمل. ولكن عند محاولة استخدام هذا الحل ، اتضح أن Bitrix24 لم يعد كما كان عليه من قبل ، وهناك الكثير بحاجة إلى إعادة بنائه. بالإضافة إلى ذلك ، فإن FreePBX ليس علامة نجمية عارية بالنسبة لك ، وهنا تحتاج إلى التفكير في كيفية الجمع بين سهولة الاستخدام وخطة الطلب القوية في ملفات التكوين.

ندرس منطق العمل

لذا أولاً ، كيف من المفترض أن يعمل. عندما تأتي مكالمة من الخارج إلى PBX (حدث SIP INVITE من الموفر) ، تبدأ معالجة مخطط الطلب (dialplan ، dialplan) - قواعد ما يجب فعله بالمكالمة وبأي ترتيب. يمكن الحصول على الكثير من المعلومات من الحزمة الأولى ، والتي يمكن استخدامها بعد ذلك في القواعد. أداة ممتازة لدراسة الأجزاء الداخلية لـ SIP هي محلل sngrep ( رابط ) ، والذي يتم تثبيته ببساطة في التوزيعات الشائعة عبر تثبيت apt / yum install وما شابه ، ولكن يمكنك أيضًا بنائه من المصدر. دعونا نرى سجل المكالمات في sngrep

في شكل مبسط ، يتعامل مخطط الطلب مع الحزمة الأولى فقط ، وأحيانًا أثناء المحادثة ، يتم تحويل المكالمات ، والضغط على الأزرار (DTMF) ، والعديد من الأشياء المثيرة للاهتمام مثل FollowMe و RingGroup و IVR وغيرها.

ماذا يوجد داخل حزمة Invite

DID CallerID. DID - , CallerID - .

- (/ ) (Ring Group), IVR (, ... ...), (Phrases), (Time Conditions), (FollowMe, Forward). , .

"". Asterisk - , ( exten, exten=DID). - ( - Dial(), - Hangup()), (IF, ELSE, ExecIF ), (Goto, GotoIF), (Gosub, Macro). include _, . , include .

FreePBX include Gosub, Macro Handler. FreePBX

, (Macro), (Gosub) (Goto), , .

. DID, , - . 1 . hangupcall, , (hangup handler).

CRM, , CRM?

CRM? , . API, API HTTP REST. asterisk.

Asterisk :

• AGI - /, , phpagi, PAGI

• AMI - TCP , , SMTP , , , PAMI - Asterisk

• ARI - , , REST, WebSocket, JSON - , (phparia, phpari) 3 .

, API , . CRM :

• , , CallerID, DID, , ( CRM)

• , ,

• ( ), ,

• : CRM, FollowME ( CRM)

AMI ARI, ARI , , , AMI ( , , ). , - AMI ( ). ( , ) - ( ) PAMI. * ARI, .

, FreePBX AMI , , , , , - . PAMI -.

(s - , DID)

[ext-did-custom]

exten => s,1,Set(CallStart=${STRFTIME(epoch,,%s)})

FreePBX extention.conf extention_additional.conf, extention_custom.conf

[globals]	
;;       -  asterisk     
;;    
WAV=/var/www/html/callme/records/wav 
MP3=/var/www/html/callme/records/mp3

;;        
URLRECORDS=https://www.host.ru/callmeplus/records/mp3

;;      
URLPHP=https://www.host.ru/callmeplus

;;   
RECORDING=1

;;        . 
;;     ,      - 
;;  
[recording]
exten => ~~s~~,1,Set(LOCAL(calling)=${ARG1})
exten => ~~s~~,2,Set(LOCAL(called)=${ARG2})
exten => ~~s~~,3,GotoIf($["${RECORDING}" = "1"]?4:14)
exten => ~~s~~,4,Set(fname=${UNIQUEID}-${STRFTIME(${EPOCH},,%Y-%m-%d-%H_%M)}-${calling}-${called})
exten => ~~s~~,5,Set(datedir=${STRFTIME(${EPOCH},,%Y/%m/%d)})
exten => ~~s~~,6,System(mkdir -p ${MP3}/${datedir})
exten => ~~s~~,7,System(mkdir -p ${WAV}/${datedir})
exten => ~~s~~,8,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")
exten => ~~s~~,9,Set(FullFname=${URLRECORDS}/${datedir}/${fname}.mp3)
exten => ~~s~~,10,Set(CDR(filename)=${fname}.mp3)
exten => ~~s~~,11,Set(CDR(recordingfile)=${fname}.wav)
exten => ~~s~~,12,Set(CDR(realdst)=${called})
exten => ~~s~~,13,MixMonitor(${WAV}/${datedir}/${fname}.wav,b,${monopt})
exten => ~~s~~,14,NoOp(Finish if_recording_1)
exten => ~~s~~,15,Return()


;;      
[ext-did-custom]

;;  ,     ,   -    '8'
exten =>  s,1,Set(CALLERID(num)=8${CALLERID(num)})

;;     
exten =>  s,n,Gosub(recording,~~s~~,1(${CALLERID(number)},${EXTEN}))
exten =>  s,n,ExecIF(${CallMeCallerIDName}?Set(CALLERID(name)=${CallMeCallerIDName}):NoOp())
exten =>  s,n,Set(CallStart=${STRFTIME(epoch,,%s)})
exten =>  s,n,Set(CallMeDISPOSITION=${CDR(disposition)})

;;  !   . 
;;      (exten=>h,1,)  FreePBX   - Macro(hangupcall,)  . 
;;   Hangup_Handler   
exten => s,n,Set(CHANNEL(hangup_handler_push)=sub-call-from-cid-ended,s,1(${CALLERID(num)},${EXTEN}))

;;    
[sub-call-from-cid-ended]

;;      
exten => s,1,Set(CDR_PROP(disable)=true)
exten => s,n,Set(CallStop=${STRFTIME(epoch,,%s)})
exten => s,n,Set(CallMeDURATION=${MATH(${CallStop}-${CallStart},int)})

;;   - ,  ...
exten => s,n,Set(CallMeDISPOSITION=${CDR(disposition)})
exten => s,n,Return


;;    -  
[outbound-allroutes-custom]

;; 
exten => _.,1,Gosub(recording,~~s~~,1(${CALLERID(number)},${EXTEN}))
;; 
exten => _.,n,Set(__CallIntNum=${CALLERID(num)})
exten => _.,n,Set(CallExtNum=${EXTEN})
exten => _.,n,Set(CallStart=${STRFTIME(epoch,,%s)})
exten => _.,n,Set(CallmeCALLID=${SIPCALLID})

;;  Hangup_Handler   
exten => _.,n,Set(CHANNEL(hangup_handler_push)=sub-call-internal-ended,s,1(${CALLERID(num)},${EXTEN}))

;;    
[sub-call-internal-ended]

;; 
exten => s,1,Set(CDR_PROP(disable)=true)
exten => s,n,Set(CallStop=${STRFTIME(epoch,,%s)})
exten => s,n,Set(CallMeDURATION=${MATH(${CallStop}-${CallStart},int)})
exten => s,n,Set(CallMeDISPOSITION=${CDR(disposition)})

;;  ,      CRM -  , 
;;     
exten => s,n,System(curl -s ${URLPHP}/CallMeOut.php --data action=sendcall2b24 --data ExtNum=${CallExtNum} --data call_id=${SIPCALLID} --data-urlencode FullFname='${FullFname}' --data CallIntNum=${CallIntNum} --data CallDuration=${CallMeDURATION} --data-urlencode CallDisposition='${CallMeDISPOSITION}')
exten => s,n,Return

-

• .conf, FreePBX ( .ael, )

• exten=>h hangup_handler, FreePBX

• , ExtNum

• _custom FreePBX - [ext-did-custom], [outbound-allroutes-custom]

• -

AMI - FreePBX _custom

;;   
[callmeplus]
;;  
secret = trampampamturlala
deny = 0.0.0.0/0.0.0.0

;;      -   ,    
permit = 127.0.0.1/255.255.255.255
read = system,call,log,verbose,agent,user,config,dtmf,reporting,cdr,dialplan
write = system,call,agent,log,verbose,user,config,command,reporting,originate

/etc/asterisk, ( )

# astrisk -rv
  Connected to Asterisk 16.6.2 currently running on freepbx (pid = 31629)
#freepbx*CLI> dialplan reload
     Dialplan reloaded.
#freepbx*CLI> exit

PHP

24, AMI , . AMI . , . , PAMI , , ..

, NewExten [from-pstn], . _custom CallMeCallerIDName CallStart

1. UserID, , . ? , ( ) ? Fisrt Available, , .

2. 24, CallID, . UserID

, (, , ), mp3 ( ).

CallMeIn.php , SystemD callme.service, /etc/systemd/system/callme.service

[Unit]
Description=CallMe

[Service]
WorkingDirectory=/var/www/html/callmeplus
ExecStart=/usr/bin/php /var/www/html/callmeplus/CallMeIn.php 2>&1 >>/var/log/callmeplus.log
ExecStop=/bin/kill -WINCH ${MAINPID}
KillSignal=SIGKILL

Restart=on-failure
RestartSec=10s

#  ,   
#User=www-data  #Ubuntu - debian
#User=nginx #Centos

[Install]
WantedBy=multi-user.target

systemctl service

# systemctl enable callme
# systemctl start callme

( ). , php ( FeePBX). ( https) .

. CallMeOut.php :

• php ( "" ). , HTTP POST,

• , . Asterisk [sub-call-internal-ended]

- ( HTTPS) CallMeOut.php. FreePBX, /var/www/html, .

(, , ). , FreeDomain( https://www.freenom.com/ru/index.html), IP ( 80, 443 , ). DNS , ( 15 48 ) . - 1 .

github , . - , , , . (

Docker

- Docker - , , ( LetsEncrypt , , FreePBX ( - 88), LetsEncrypt

( git clone), ( asterisk) URL

version: '3.3'
services:
  nginx:
    image: nginx:1.15-alpine
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx/ssl_docker.conf:/etc/nginx/conf.d/ssl_docker.conf
  certbot:
    image: certbot/certbot
  freepbx:
    image: flaviostutz/freepbx
    ports:
      - 88:80 #  
      - 5060:5060/udp
      - 5160:5160/udp
      - 127.0.0.1:5038:5038 #  CallMeOut.php
#      - 3306:3306
      - 18000-18100:18000-18100/udp
    restart: always
    environment:
      - ADMIN_PASSWORD=admin123
    volumes:
      - backup:/backup
      - recordings:/var/spool/asterisk/monitor
      - ./callme:/var/www/html/callme
      - ./systemd/callme.service:/etc/systemd/system/callme.conf
      - ./asterisk/manager_custom.conf:/etc/asterisk/manager_custom.conf
      - ./asterisk/extensions_custom.conf:/etc/asterisk/extensions_custom.conf
#      - ./conf/startup.sh:/startup.sh

volumes:
  backup:
  recordings:

docker-compose.yaml,

docker-compose up -d

nginx , nginx/ssl_docker.conf

CRM , . API CRM, - ShugarCRM Vtiger, ! , . , .

• - https://github.com/CrezZ/bitrix24-freepbx-php

• https://habr.com/ru/post/349316/

: ,