FreePBX-ის გაგება და მისი ინტეგრირება Bitrix24-თან და სხვასთან

Bitrix24 არის უზარმაზარი კომბაინი, რომელიც აერთიანებს CRM-ს, სამუშაო პროცესს, ბუღალტრულ აღრიცხვას და ბევრ სხვა რამეს, რაც მენეჯერებს ნამდვილად მოსწონთ და IT პერსონალს ნამდვილად არ მოსწონთ. პორტალს იყენებს ბევრი მცირე და საშუალო კომპანია, მათ შორის მცირე კლინიკები, მწარმოებლები და სილამაზის სალონებიც კი. მთავარი ფუნქცია, რომელიც მენეჯერებს "უყვართ" არის ტელეფონისა და CRM-ის ინტეგრაცია, როდესაც ნებისმიერი ზარი დაუყოვნებლივ ჩაიწერება CRM-ში, იქმნება კლიენტის ბარათები, შემოსვლისას გამოჩნდება ინფორმაცია კლიენტის შესახებ და შეგიძლიათ დაუყოვნებლივ ნახოთ ვინ არის ის, რა არის. შეუძლია გაყიდოს და რამდენი აქვს ვალი. მაგრამ Bitrix24-ის ტელეფონია და მისი CRM-თან ინტეგრაცია ფულს ხარჯავს, ზოგჯერ ბევრი. სტატიაში გეტყვით ღია ინსტრუმენტებთან და პოპულარულ IP PBX-თან ინტეგრაციის გამოცდილებას უფასოPBXდა ასევე გაითვალისწინეთ სხვადასხვა ნაწილის მუშაობის ლოგიკა

მე ვმუშაობ აუთსორსერად კომპანიაში, რომელიც ყიდის და აკონფიგურირებს, აერთიანებს IP ტელეფონს. როდესაც მკითხეს, შეგვეძლო თუ არა რაიმე შევთავაზოთ ამ და ამ კომპანიას Bitrix24-ის ინტეგრირებისთვის PBX-ებთან, რომლებიც მომხმარებლებს აქვთ, ასევე ვირტუალურ PBX-ებთან სხვადასხვა VDS კომპანიებზე, მივედი Google-ში. და რა თქმა უნდა მან მომცა ბმული სტატია ჰაბრში, სადაც არის აღწერა და github და ყველაფერი მუშაობს. მაგრამ ამ გადაწყვეტის გამოყენების მცდელობისას აღმოჩნდა, რომ Bitrix24 აღარ არის იგივე, რაც ადრე და ბევრი რამის გადაკეთება სჭირდება. გარდა ამისა, FreePBX არ არის თქვენთვის შიშველი ვარსკვლავი, აქ თქვენ უნდა იფიქროთ იმაზე, თუ როგორ დააკავშიროთ მარტივი გამოყენება და მყარი აკრიფეთ გეგმა კონფიგურაციის ფაილებში.

ჩვენ ვსწავლობთ მუშაობის ლოგიკას

ასე რომ, დამწყებთათვის, როგორ უნდა მუშაობდეს ეს ყველაფერი. როდესაც ზარი მიიღება გარედან PBX-ზე (SIP INVITE ღონისძიება პროვაიდერისგან), იწყება აკრიფეთ გეგმის დამუშავება (აკრიფეთ გეგმა, აკრიფეთ გეგმა) - წესები თუ რა და რა თანმიმდევრობით უნდა გააკეთოთ ზარი. პირველი პაკეტიდან შეგიძლიათ მიიღოთ ბევრი ინფორმაცია, რომელიც შემდეგ შეგიძლიათ გამოიყენოთ წესებში. შესანიშნავი ინსტრუმენტი SIP-ის შიდა შესასწავლად არის ანალიზატორი sngrep (ლინკები) რომელიც უბრალოდ დაინსტალირებულია პოპულარულ დისტრიბუციებში apt install/yum install და მსგავსის საშუალებით, მაგრამ ის ასევე შეიძლება აშენდეს წყაროდან. მოდით შევხედოთ ზარის შესვლას sngrep-ში

გამარტივებული ფორმით, dialplan ეხება მხოლოდ პირველ პაკეტს, ზოგჯერ საუბრის დროსაც ხდება ზარების გადაცემა, ღილაკების დაჭერა (DTMF), სხვადასხვა საინტერესო რამ, როგორიცაა FollowMe, RingGroup, IVR და სხვა.

რა არის Invite Pack-ის შიგნით

სინამდვილეში, უბრალო აკრიფეთ გეგმების უმეტესობა მუშაობს პირველ ორ ველთან და მთელი ლოგიკა ტრიალებს DID-სა და CallerID-ის გარშემო. DID - სადაც ჩვენ ვურეკავთ, CallerID - ვინც რეკავს.

მაგრამ ბოლოს და ბოლოს, ჩვენ გვაქვს კომპანია და არა ერთი ტელეფონი - რაც ნიშნავს, რომ PBX-ს დიდი ალბათობით აქვს ზარის ჯგუფები (რამდენიმე მოწყობილობის ერთდროული / თანმიმდევრული ზარი) ქალაქის ნომრებზე (Ring Group), IVR (გამარჯობა, თქვენ დარეკეთ ... დააჭირეთ ერთი ...), ავტომოპასუხეები (ფრაზები), დროის პირობები, გადამისამართება სხვა ნომრებზე ან უჯრედში (FollowMe, Forward). ეს ნიშნავს, რომ ძალიან რთულია ცალსახად განსაზღვრა, თუ ვინ მიიღებს რეალურად ზარს და ვისთან ექნება საუბარი ზარის მოსვლისას. აქ მოცემულია ჩვენი კლიენტების PBX-ში ტიპიური ზარის დაწყების მაგალითი

მას შემდეგ, რაც ზარი წარმატებით შედის PBX-ში, ის მოძრაობს ციფრული გეგმის მეშვეობით სხვადასხვა „კონტექსტში“. კონტექსტი Asterisk-ის თვალსაზრისით არის ბრძანებების დანომრილი ნაკრები, რომელთაგან თითოეული შეიცავს ფილტრს აკრეფილი ნომრის მიხედვით (მას უწოდებენ exten, საწყის ეტაპზე გარე ზარისთვის exten=DID). Dialplan ხაზის ბრძანებები შეიძლება იყოს ნებისმიერი - შიდა ფუნქციები (მაგალითად, დარეკეთ შიდა აბონენტს - Dial()დადე ტელეფონი - Hangup()პირობითი ოპერატორები (IF, ELSE, ExecIF და მსგავსი), ამ კონტექსტის სხვა წესებზე გადასვლა (Goto, GotoIF), სხვა კონტექსტებზე გადასვლა ფუნქციის გამოძახების სახით (Gosub, Macro). ცალკე დირექტივა include имя_контекста, რომელიც ამატებს ბრძანებებს სხვა კონტექსტიდან მიმდინარე კონტექსტის ბოლოს. ბრძანებები, რომლებიც შედის ჩათვლით, ყოველთვის სრულდება შემდეგ მიმდინარე კონტექსტის ბრძანებები.

FreePBX-ის მთელი ლოგიკა აგებულია სხვადასხვა კონტექსტების ერთმანეთში ჩართვაზე Gosub, Macro და Handler ოპერატორების მეშვეობით ჩათვლით. განიხილეთ შემომავალი FreePBX ზარების კონტექსტი

ზარი თავის მხრივ გადის ყველა კონტექსტს ზემოდან ქვემოდან, თითოეულ კონტექსტში შეიძლება იყოს ზარები სხვა კონტექსტებზე, როგორიცაა მაკრო (მაკრო), ფუნქციები (Gosub) ან უბრალოდ გადასვლები (Goto), ასე რომ, ნამდვილი ხე, რასაც ეწოდება, შეიძლება მხოლოდ თვალყური ადევნეთ ჟურნალებში.

ტიპიური დაყენების დიაგრამა ტიპიური PBX-ისთვის ნაჩვენებია ქვემოთ. დარეკვისას, DID იძებნება შემომავალ მარშრუტებში, მოწმდება დროებითი პირობები, თუ ყველაფერი რიგზეა, იხსნება ხმოვანი მენიუ. მისგან, ღილაკ 1-ის დაჭერით ან დროის ამოწურვით, გადით აკრეფის ოპერატორების ჯგუფში. ზარის დასრულების შემდეგ გამოიძახება hangupcall მაკრო, რის შემდეგაც dialplan-ში არაფერი შეიძლება გაკეთდეს, გარდა სპეციალური დამმუშავებლებისა (hangup handler).

ამ ზარის ალგორითმში სად უნდა მივაწოდოთ ინფორმაცია CRM-ზე ზარის დაწყების შესახებ, სად დავიწყოთ ჩაწერა, სად დავასრულოთ ჩაწერა და გავაგზავნოთ ზარის შესახებ ინფორმაციას CRM-ში?

ინტეგრაცია გარე სისტემებთან

რა არის PBX და CRM ინტეგრაცია? ეს არის პარამეტრები და პროგრამები, რომლებიც კონვერტირებენ მონაცემებსა და მოვლენებს ამ ორ პლატფორმას შორის და უგზავნიან მათ ერთმანეთს. დამოუკიდებელი სისტემებისთვის კომუნიკაციის ყველაზე გავრცელებული გზა არის API-ები, ხოლო API-ებზე წვდომის ყველაზე პოპულარული გზაა HTTP REST. მაგრამ არა ვარსკვლავისთვის.

ასტერიკის შიგნით არის:

• AGI - გარე პროგრამების/კომპონენტების სინქრონული გამოძახება, რომელიც ძირითადად გამოიყენება აკრიფეთ გეგმაში, არის ბიბლიოთეკები, როგორიცაა phpagi, PAGI

• AMI - ტექსტური TCP სოკეტი, რომელიც მუშაობს მოვლენებზე გამოწერისა და ტექსტური ბრძანებების შეყვანის პრინციპზე, შიგნიდან წააგავს SMTP-ს, შეუძლია მოვლენების თვალყურის დევნება და ზარების მართვა, არის ბიბლიოთეკა. PAMI - ყველაზე პოპულარული Asterisk-თან კავშირის შესაქმნელად

AMI გამომავალი მაგალითი

ღონისძიება: ახალი არხი
პრივილეგია: დარეკეთ, ყველა
არხი: PJSIP/VMS_pjsip-0000078b
არხის მდგომარეობა: 4
ChannelStateDesc: ბეჭედი
CallerIDNum: 111222
CallerIDName: 111222
ConnectedLineNum:
დაკავშირებული ხაზის სახელი:
ენა: en
ანგარიშის კოდი:
კონტექსტი: from-pstn
გაფართოება: ს
პრიორიტეტი: 1
უნიკალური: 1599589046.5244
Linkedid: 1599589046.5244

• ARI არის ორივეს ნაზავი, ყველაფერი REST-ის, WebSocket-ის საშუალებით, JSON ფორმატში - მაგრამ ახალი ბიბლიოთეკებითა და შეფუთვით, არც თუ ისე კარგი, უპრობლემოდ ნაპოვნი (ფფარია, phpari) რომელიც მათ განვითარებაში შევიდა დაახლოებით 3 წლის წინ.

ARI გამომავალი მაგალითი ზარის დაწყებისას

{ "ცვლადი":"CallMeCallerIDName", "მნიშვნელობა":"111222", "type":"ChannelVarset", "timestamp":"2020-09-09T09:38:36.269+0000", "არხი":{ "id »:»1599644315.5334″, «სახელი»:»PJSIP/VMSpjsip-000007b6″, "state":"ზარი", "აბონენტი":{ "სახელი":"111222″, "ნომერი":"111222″ }, "დაკავშირებული":{ "სახელი":"", "ნომერი" :"" }, "accountcode":"", "dialplan":{ "context":"from-pstn", "exten":"s", "priority":2, "appსახელი":"სტაზისი", "აპიdata":"hello-world" }, "creationtime":"2020-09-09T09:38:35.926+0000", "language":"en" }, "ვარსკვლავიid":"48:5b:aa:aa:aa:aa", "application":"hello-world" }

მოხერხებულობა ან უხერხულობა, კონკრეტულ 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)})

მაგალითი AMI ღონისძიება ამ ხაზისთვის

ღონისძიება: ახალი არხი

პრივილეგია: დარეკეთ, ყველა

არხი: PJSIP/VMS_pjsip-0000078b

არხის მდგომარეობა: 4

ChannelStateDesc: ბეჭედი

CallerIDNum: 111222

CallerIDName: 111222

ConnectedLineNum:

დაკავშირებული ხაზის სახელი:

ენა: en

ანგარიშის კოდი:

კონტექსტი: from-pstn

გაფართოება: ს

პრიორიტეტი: 1

უნიკალური: 1599589046.5244

Linkedid: 1599589046.5244

აპლიკაცია: დააყენეთ AppData:

CallStart=1599571046

რადგან FreePBX გადაწერს extension.conf და extension_ ფაილებსდამატებითი.conf, ჩვენ გამოვიყენებთ ფაილს გაფართოება_საბაჟო.დათანხმდი

extension_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

მახასიათებელი და განსხვავება ორიგინალური სტატიის ავტორების თავდაპირველი ნომრისგან -

• Dialplan .conf ფორმატში, როგორც ამას FreePBX სურს (დიახ, შეუძლია .ael, მაგრამ არა ყველა ვერსია და ყოველთვის არ არის მოსახერხებელი)

• დასასრულის exten=>h-ით დამუშავების ნაცვლად, დამუშავება დაინერგა hangup_handler-ის მეშვეობით, რადგან FreePBX dialplan მუშაობდა მხოლოდ მასთან.

• ფიქსირებული სკრიპტის ზარის სტრიქონი, დამატებული ციტატები და გარე ზარის ნომერი ExtNum

• დამუშავება გადატანილია _custom კონტექსტში და საშუალებას გაძლევთ არ შეეხოთ ან არ შეცვალოთ FreePBX კონფიგურაციები - შემომავალი [ექს-გაკეთებული-ჩვეულებრივი], გამავალი [outbound-allroutes-custom]

• ციფრებთან დაკავშირება არ არის - ფაილი უნივერსალურია და საჭიროა მხოლოდ კონფიგურაცია გზისა და სერვერის ბმულისთვის

დასაწყებად, თქვენ ასევე უნდა გაუშვათ სკრიპტები AMI-ში შესვლისა და პაროლით - ამისთვის FreePBX-ს ასევე აქვს _custom ფაილი.

manager_custom.conf ფაილი

;;  это логин
[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-ზე

სკრიპტების ინიცირება და სერვისის შექმნა

ვინაიდან Bitrix 24-თან მუშაობის სქემა, AMI სერვისი, არ არის სრულიად მარტივი და გამჭვირვალე, ის ცალკე უნდა იყოს განხილული. ვარსკვლავი, როდესაც AMI გააქტიურებულია, უბრალოდ ხსნის პორტს და ეს არის ის. როდესაც კლიენტი უერთდება, ის ითხოვს ავტორიზაციას, შემდეგ კლიენტი იწერს საჭირო ღონისძიებებს. მოვლენები მოდის უბრალო ტექსტში, რომელსაც PAMI გარდაქმნის სტრუქტურირებულ ობიექტებად და უზრუნველყოფს ფილტრაციის ფუნქციის დაყენების შესაძლებლობას მხოლოდ საინტერესო მოვლენებისთვის, ველებისთვის, რიცხვებისთვის და ა.შ.

როგორც კი ზარი შემოდის, NewExten ღონისძიება ირთვება საწყისი [from-pstn] კონტექსტიდან დაწყებული, შემდეგ ყველა მოვლენა მიდის კონტექსტში ხაზების თანმიმდევრობით. როდესაც ინფორმაცია მიიღება CallMeCallerIDName და CallStart ცვლადებიდან, რომლებიც მითითებულია _custom dialplan-ში,

1. იმ გაფართოების ნომრის შესაბამისი UserID-ის მოთხოვნის ფუნქცია, სადაც მოვიდა ზარი. რა მოხდება, თუ ეს არის dial-up ჯგუფი? კითხვა პოლიტიკურია, აუცილებელია თუ არა ყველასთვის მოწოდების ერთდროულად შექმნა (როცა ყველა ერთდროულად ურეკავს) თუ შექმნა, როგორც რიგრიგობით დარეკვისას ეძახიან? კლიენტების უმეტესობას აქვს Fisrt Available სტრატეგია, ამიტომ ამაში პრობლემა არ არის, მხოლოდ ერთი ზარი. მაგრამ საკითხი უნდა მოგვარდეს.

2. ზარის რეგისტრაციის ფუნქცია Bitrix24-ში, რომელიც აბრუნებს CallID-ს, რომელიც შემდეგ საჭიროებს ზარის პარამეტრების მოხსენებას და ჩანაწერის ბმულს. მოითხოვს გაფართოების ნომერს ან მომხმარებლის ID-ს

ზარის დასრულების შემდეგ გამოიძახება ჩანაწერის ჩამოტვირთვის ფუნქცია, რომელიც ერთდროულად აცნობებს ზარის დასრულების სტატუსს (დაკავებული, პასუხის გარეშე, წარმატებები) და ასევე ჩამოტვირთავს ბმულს mp3 ფაილის ჩანაწერთან ერთად (ასეთის არსებობის შემთხვევაში).

იმის გამო, რომ CallMeIn.php მოდული მუდმივად უნდა იმუშაოს, ამისათვის შეიქმნა SystemD გაშვების ფაილი დარეკე.სერვისი, რომელიც უნდა განთავსდეს /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 ან სერვისის საშუალებით

# systemctl enable callme
# systemctl start callme

სერვისი განახლდება საჭიროებისამებრ (ავარიის შემთხვევაში). შემოსულების თვალთვალის სერვისი არ საჭიროებს ვებ სერვერის დაყენებას, საჭიროა მხოლოდ php (რომელიც აუცილებლად FeePBX სერვერზეა). მაგრამ ვებ სერვერის საშუალებით ზარის ჩანაწერებზე წვდომის არარსებობის შემთხვევაში (ასევე https-ით), შეუძლებელი იქნება ზარის ჩანაწერების მოსმენა.

ახლა მოდით ვისაუბროთ გამავალ ზარებზე. CallMeOut.php სკრიპტს აქვს ორი ფუნქცია:

• ზარის დაწყება, როდესაც მოთხოვნა მიიღება php სკრიპტზე (მათ შორის, ღილაკის "ზარის" გამოყენებით თავად Bitrix-ში). ის არ მუშაობს ვებ სერვერის გარეშე, მოთხოვნა მიიღება HTTP POST-ის საშუალებით, მოთხოვნა შეიცავს ტოკენს

• შეტყობინება ზარის, მისი პარამეტრების და ჩანაწერების შესახებ Bitrix-ში. გააქტიურებულია Asterisk-ით [ქვეზარი-შიდა დასრულებული] ციფერბლატით, როდესაც ზარი დასრულდება

ვებ სერვერი საჭიროა მხოლოდ ორი რამისთვის - Bitrix ჩანაწერის ფაილების ჩამოტვირთვა (HTTPS-ის საშუალებით) და CallMeOut.php სკრიპტის გამოძახება. შეგიძლიათ გამოიყენოთ ჩაშენებული FreePBX სერვერი, რომლის ფაილებია /var/www/html, შეგიძლიათ დააინსტალიროთ სხვა სერვერი ან მიუთითოთ სხვა გზა.

ვებ სერვერი

მოდით დავტოვოთ ვებ სერვერის დაყენება დამოუკიდებელი შესწავლისთვის (tyts, tyts, tyts). თუ არ გაქვთ დომენი, შეგიძლიათ სცადოთ FreeDomain( https://www.freenom.com/ru/index.html), რომელიც მოგცემთ უფასო სახელს თქვენი თეთრი IP-სთვის (არ დაგავიწყდეთ 80, 443 პორტების გადაგზავნა როუტერის საშუალებით, თუ გარე მისამართი მხოლოდ მასზეა). თუ თქვენ ახლახან შექმენით DNS დომენი, მაშინ უნდა დაელოდოთ (15 წუთიდან 48 საათამდე) სანამ ყველა სერვერი ჩაიტვირთება. შიდა პროვაიდერებთან მუშაობის გამოცდილების მიხედვით - 1 საათიდან დღეში.

ინსტალაციის ავტომატიზაცია

ინსტალერი შეიქმნა github-ზე ინსტალაციის გასაადვილებლად. მაგრამ ეს იყო გლუვი ქაღალდზე - სანამ ჩვენ ამას ვაინსტალირებთ ხელით, რადგან ამ ყველაფრის დალაგების შემდეგ ნათელი გახდა, ვინ ვისთან მეგობრობს, ვინ სად მიდის და როგორ უნდა გამართოს იგი. ჯერ არ არის ინსტალერი

docker

თუ გსურთ სწრაფად სცადოთ გამოსავალი - არის ვარიანტი Docker-თან ერთად - სწრაფად შექმენით კონტეინერი, მიეცით პორტები გარედან, გადაიტანეთ პარამეტრების ფაილები და სცადეთ (ეს არის ვარიანტი LetsEncrypt კონტეინერით, თუ უკვე გაქვთ სერთიფიკატი , თქვენ უბრალოდ უნდა გადამისამართოთ საპირისპირო პროქსი FreePBX ვებ სერვერზე (ჩვენ მივეცით სხვა პორტი არის 88), LetsEncrypt in docker საფუძველზე ამ მუხლის

თქვენ უნდა გაუშვათ ფაილი გადმოწერილი პროექტის საქაღალდეში (git კლონის შემდეგ), ოღონდ ჯერ შეხვიდეთ ვარსკვლავის კონფიგურაციაში (ასტერიკის საქაღალდე) და ჩაწეროთ ჩანაწერების ბილიკები და თქვენი საიტის 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 სკრიპტებში ერთდროულად, ვფიქრობდით. ჩვენ შევისწავლეთ რამდენიმე სხვა CRM API, განსაკუთრებით უფასო ჩაშენებული PBX - ShugarCRM და Vtiger, და დიახ! დიახ, პრინციპი იგივეა. მაგრამ ეს სხვა ამბავია, რომელსაც მოგვიანებით ცალკე ავტვირთავთ github-ში.

ლიტერატურა

• თავად კოდი არის github-ზე - https://github.com/CrezZ/bitrix24-freepbx-php

• წყაროს სტატია თესლისთვის https://habr.com/ru/post/349316/

უარი პასუხისმგებლობაზე: რეალობასთან ნებისმიერი მსგავსება ფიქტიურია და ეს მე არ ვიყავი.

წყარო: www.habr.com