FreePBX को समझना और इसे Bitrix24 और अन्य के साथ एकीकृत करना

बिट्रिक्स24 एक विशाल गठबंधन है जो सीआरएम, वर्कफ़्लो, अकाउंटिंग और कई अन्य चीजों को जोड़ता है जो प्रबंधक वास्तव में पसंद करते हैं और आईटी कर्मचारी वास्तव में पसंद नहीं करते हैं। पोर्टल का उपयोग बहुत सी छोटी और मध्यम आकार की कंपनियों द्वारा किया जाता है, जिनमें छोटे क्लीनिक, निर्माता और यहां तक ​​कि ब्यूटी सैलून भी शामिल हैं। मुख्य कार्य जो प्रबंधक "प्यार" करते हैं, टेलीफोनी और सीआरएम का एकीकरण है, जब कोई कॉल तुरंत सीआरएम में दर्ज की जाती है, क्लाइंट कार्ड बनाए जाते हैं, आने पर, ग्राहक के बारे में जानकारी प्रदर्शित की जाती है और आप तुरंत देख सकते हैं कि वह कौन है, वह क्या है बेच सकता है और उसका कितना बकाया है। लेकिन Bitrix24 से टेलीफोनी और CRM के साथ इसके एकीकरण में पैसा खर्च होता है, कभी-कभी बहुत अधिक। लेख में मैं आपको ओपन टूल्स और लोकप्रिय आईपी पीबीएक्स के साथ एकीकरण का अनुभव बताऊंगा FreePBX, और विभिन्न भागों के कार्य के तर्क पर भी विचार करें

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

हम काम के तर्क का अध्ययन करते हैं

तो शुरुआत करने वालों के लिए, यह सब कैसे काम करना चाहिए। जब पीबीएक्स (प्रदाता से SIP INVITE इवेंट) पर बाहर से कॉल आती है, तो डायलप्लान (डायल प्लान, डायलप्लान) की प्रोसेसिंग शुरू हो जाती है - कॉल के साथ क्या और किस क्रम में करना है। पहले पैकेट से आप बहुत सारी जानकारी प्राप्त कर सकते हैं, जिसे बाद में नियमों में इस्तेमाल किया जा सकता है। एसआईपी के आंतरिक पहलुओं का अध्ययन करने के लिए एक उत्कृष्ट उपकरण विश्लेषक है sngrep (लिंक) जो केवल apt install/yum install और पसंद के माध्यम से लोकप्रिय वितरण में स्थापित है, लेकिन इसे स्रोत से भी बनाया जा सकता है। आइए स्नग्रेप में कॉल लॉग देखें

एक सरलीकृत रूप में, डायलप्लान केवल पहले पैकेट से संबंधित है, कभी-कभी बातचीत के दौरान भी, कॉल ट्रांसफर किए जाते हैं, बटन प्रेस (DTMF), विभिन्न दिलचस्प चीजें जैसे कि फॉलोमी, रिंगग्रुप, आईवीआर और अन्य।

इनवाइट पैक के अंदर क्या है

दरअसल, सबसे सरल डायलप्लान पहले दो क्षेत्रों के साथ काम करते हैं, और पूरा तर्क डीआईडी ​​​​और कॉलरआईडी के इर्द-गिर्द घूमता है। DID - जहाँ हम कॉल कर रहे हैं, CallerID - कौन कॉल कर रहा है।

लेकिन आखिरकार, हमारे पास एक कंपनी है और एक फोन नहीं है - जिसका अर्थ है कि पीबीएक्स में सबसे अधिक संभावना है कि शहर के नंबरों (रिंग ग्रुप), आईवीआर (हैलो, आपने कॉल किया है) पर कॉल समूह (कई उपकरणों की एक साथ / लगातार रिंगिंग) हैं ... प्रेस एक के लिए ...), आंसरिंग मशीन (वाक्यांश), समय की स्थिति, अन्य नंबरों या एक सेल को अग्रेषित करना (FollowMe, Forward)। इसका मतलब यह है कि स्पष्ट रूप से यह निर्धारित करना बहुत मुश्किल है कि वास्तव में कौन कॉल प्राप्त करेगा और कॉल आने पर किसके साथ बातचीत होगी। यहां हमारे ग्राहकों के पीबीएक्स में एक विशिष्ट कॉल की शुरुआत का एक उदाहरण दिया गया है

कॉल सफलतापूर्वक पीबीएक्स में प्रवेश करने के बाद, यह विभिन्न "संदर्भों" में डायलप्लान के माध्यम से यात्रा करता है। तारांकन चिह्न के दृष्टिकोण से संदर्भ आदेशों का एक क्रमांकित सेट है, जिनमें से प्रत्येक में डायल किए गए नंबर द्वारा फ़िल्टर होता है (इसे विस्तारित कहा जाता है, प्रारंभिक चरण exten=DID पर बाहरी कॉल के लिए)। डायलप्लान लाइन में कमांड कुछ भी हो सकते हैं - आंतरिक कार्य (उदाहरण के लिए, एक आंतरिक ग्राहक को कॉल करें - Dial(), फ़ोन नीचे रखो - Hangup()), सशर्त संचालक (IF, ELSE, ExecIF और इसी तरह), इस संदर्भ के अन्य नियमों में बदलाव (Goto, GotoIF), फ़ंक्शन कॉल (गोसब, मैक्रो) के रूप में अन्य संदर्भों में संक्रमण। एक अलग निर्देश include имя_контекста, जो वर्तमान संदर्भ के अंत में दूसरे संदर्भ से आदेश जोड़ता है। शामिल के माध्यम से शामिल कमांड हमेशा निष्पादित होते हैं के बाद वर्तमान संदर्भ के आदेश।

फ्रीपीबीएक्स का पूरा तर्क गोसब, मैक्रो और हैंडलर हैंडलर के माध्यम से शामिल और कॉल के माध्यम से अलग-अलग संदर्भों को एक-दूसरे में शामिल करने पर बनाया गया है। आने वाली फ्रीपीबीएक्स कॉल के संदर्भ में विचार करें

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

एक विशिष्ट पीबीएक्स के लिए एक विशिष्ट सेटअप आरेख नीचे दिखाया गया है। कॉल करते समय, डीआईडी ​​​​को आने वाले मार्गों में खोजा जाता है, इसके लिए अस्थायी स्थितियों की जांच की जाती है, यदि सब कुछ क्रम में है, तो आवाज मेनू लॉन्च किया जाता है। इसमें से, बटन 1 या टाइमआउट दबाकर, डायलिंग ऑपरेटरों के समूह से बाहर निकलें। कॉल समाप्त होने के बाद, हैंगअपकॉल मैक्रो को कॉल किया जाता है, जिसके बाद विशेष हैंडलर (हैंगअप हैंडलर) को छोड़कर डायलप्लान में कुछ भी नहीं किया जा सकता है।

इस कॉल एल्गोरिथ्म में हमें CRM को कॉल की शुरुआत के बारे में जानकारी कहाँ देनी चाहिए, रिकॉर्डिंग कहाँ शुरू करनी है, रिकॉर्डिंग कहाँ समाप्त करनी है और CRM को कॉल के बारे में जानकारी के साथ भेजना है?

बाहरी प्रणालियों के साथ एकीकरण

पीबीएक्स और सीआरएम एकीकरण क्या है? ये सेटिंग्स और प्रोग्राम हैं जो डेटा और घटनाओं को इन दो प्लेटफार्मों के बीच परिवर्तित करते हैं और उन्हें एक दूसरे को भेजते हैं। संचार करने के लिए स्वतंत्र प्रणालियों के लिए सबसे आम तरीका एपीआई के माध्यम से है, और एपीआई तक पहुंचने का सबसे लोकप्रिय तरीका एचटीटीपी रेस्ट है। लेकिन तारांकन के लिए नहीं।

अंदर तारांकन चिह्न है:

• एजीआई - बाहरी कार्यक्रमों/घटकों की तुल्यकालिक कॉल, मुख्य रूप से डायलप्लान में उपयोग की जाती है, जैसे पुस्तकालय हैं phpgi, PAGI

• एएमआई - एक टेक्स्ट टीसीपी सॉकेट जो घटनाओं की सदस्यता लेने और टेक्स्ट कमांड दर्ज करने के सिद्धांत पर काम करता है, अंदर से एसएमटीपी जैसा दिखता है, घटनाओं को ट्रैक कर सकता है और कॉल प्रबंधित कर सकता है, एक पुस्तकालय है पामी - तारांकन के साथ संबंध बनाने के लिए सबसे लोकप्रिय

एएमआई आउटपुट उदाहरण

घटना: नया चैनल
विशेषाधिकार: बुलाओ, सब
चैनल: PJSIP/VMS_pjsip-0000078b
चैनल स्टेट: 4
ChannelStateDesc: रिंग
कॉलरआईडीनम: 111222
कॉलर आईडीनाम: 111222
कनेक्टेडलाइननम:
जुड़ा हुआ लाइननाम:
भाषा: Hindi
खाता कोड:
संदर्भ: से-पीएसटीएन
एक्सटेन: एस
प्राथमिकता: १
यूनिकआईडी: 1599589046.5244
लिंक्डिड: 1599589046.5244

• एआरआई जेएसओएन प्रारूप में आरईएसटी, वेबसाकेट के माध्यम से दोनों का मिश्रण है - लेकिन ताजा पुस्तकालयों और रैपर के साथ, बहुत अच्छा नहीं, ऑफहैंड मिला (फ़ैपारिया, phpari) जो लगभग 3 साल पहले उनके विकास में बन गया।

कॉल शुरू होने पर ARI आउटपुट का उदाहरण

{ "वैरिएबल":"CallMeCallerIDName", "वैल्यू":"111222", "टाइप":"ChannelVarset", "टाइमस्टैम्प":"2020-09-09T09:38:36.269+0000", "चैनल":{ "id" »:»1599644315.5334″, «नाम»:»PJSIP/वीएमएसpjsip-000007b6″, "राज्य":"अंगूठी", "कॉलर":{"नाम":"111222″, "संख्या":"111222″ }, "कनेक्टेड":{"नाम":"", "संख्या" :""}, "खाता कोड":"", "डायलप्लान":{"संदर्भ":"से-पीएसटीएन", "विस्तार":"s", "प्राथमिकता":2, "ऐपname":"स्थिरता", "appdata":"hello-world" }, "creationtime":"2020-09-09T09:38:35.926+0000", "language":"hi" }, "एस्टरिस्कid":"48:5b:aa:aa:aa:aa", "application":"hello-world" }

सुविधा या असुविधा, किसी विशेष एपीआई के साथ काम करने की संभावना या असंभवता उन कार्यों से निर्धारित होती है जिन्हें हल करने की आवश्यकता होती है। सीआरएम के साथ एकीकरण के कार्य इस प्रकार हैं:

• कॉल की शुरुआत को ट्रैक करें, जहां इसे स्थानांतरित किया गया था, कॉलरआईडी, डीआईडी, प्रारंभ और समाप्ति समय निकालें, शायद निर्देशिका से डेटा (फोन और सीआरएम उपयोगकर्ता के बीच कनेक्शन खोजने के लिए)

• कॉल की रिकॉर्डिंग प्रारंभ और समाप्त करें, इसे वांछित प्रारूप में सहेजें, रिकॉर्डिंग के अंत में सूचित करें कि फ़ाइल कहाँ स्थित है

• एक बाहरी घटना (कार्यक्रम से) पर कॉल शुरू करें, एक आंतरिक नंबर, एक बाहरी नंबर पर कॉल करें और उन्हें कनेक्ट करें

• ऐच्छिक: सीआरएम, डायलर समूहों और फॉलोएमई के साथ एक जगह के अभाव में कॉल के स्वत: हस्तांतरण के लिए एकीकृत करें (सीआरएम के अनुसार)

इन सभी कार्यों को एएमआई या एआरआई के माध्यम से हल किया जा सकता है, लेकिन एआरआई बहुत कम जानकारी प्रदान करता है, कई घटनाएं नहीं हैं, एएमआई के पास अभी भी कई चर हैं (उदाहरण के लिए, मैक्रो कॉल, कॉल रिकॉर्डिंग सहित मैक्रोज़ के अंदर चर सेट करना) ट्रैक नहीं किए जाते हैं। इसलिए, सही और सटीक ट्रैकिंग के लिए, अभी के लिए एएमआई चुनें (लेकिन पूरी तरह से नहीं)। इसके अलावा (ठीक है, इसके बिना यह कहां होगा, हम आलसी लोग हैं) - मूल कार्य में (हैबर में लेख) पामी का प्रयोग करें। *फिर आपको एआरआई को फिर से लिखने की कोशिश करने की ज़रूरत है, लेकिन यह नहीं कि यह काम करेगा।

एकीकरण का पुनर्निमाण

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

यहां कॉल के प्रारंभ समय के लिए अपना स्वयं का चर सेट करने का एक उदाहरण दिया गया है (एस डायलप्लान में एक विशेष नंबर है जो डीआईडी ​​​​खोज शुरू करने से पहले किया जाता है)

[ext-did-custom]

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

इस लाइन के लिए एक उदाहरण एएमआई इवेंट

घटना: नया चैनल

विशेषाधिकार: बुलाओ, सब

चैनल: PJSIP/VMS_pjsip-0000078b

चैनल स्टेट: 4

ChannelStateDesc: रिंग

कॉलरआईडीनम: 111222

कॉलर आईडीनाम: 111222

कनेक्टेडलाइननम:

जुड़ा हुआ लाइननाम:

भाषा: Hindi

खाता कोड:

संदर्भ: से-पीएसटीएन

एक्सटेन: एस

प्राथमिकता: १

यूनिकआईडी: 1599589046.5244

लिंक्डिड: 1599589046.5244

आवेदन: ऐपडाटा सेट करें:

कॉलस्टार्ट=1599571046

क्योंकि फ्रीपीबीएक्स एक्सटेंशन. कॉन्फ और एक्सटेंशन_ फाइलों को ओवरराइट कर देता हैअतिरिक्त.कॉन्फ़, हम फ़ाइल का उपयोग करेंगे विस्तार_रिवाज.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 कर सकता है, लेकिन सभी संस्करण नहीं और यह हमेशा सुविधाजनक नहीं है)

• एक्सटेन => एच के माध्यम से अंत को संसाधित करने के बजाय, हैंगअप_हैंडलर के माध्यम से प्रसंस्करण शुरू किया गया था, क्योंकि फ्रीपीबीएक्स डायलप्लान केवल इसके साथ काम करता था

• फिक्स्ड स्क्रिप्ट कॉल स्ट्रिंग, जोड़े गए उद्धरण और बाहरी कॉल नंबर ExtNum

• प्रसंस्करण _कस्टम संदर्भों में ले जाया गया है और आपको फ्रीपीबीएक्स कॉन्फ़िगरेशन को स्पर्श या संपादित करने की अनुमति नहीं देता है - [के माध्यम से आ रहा है]ext-किया-कस्टम], आउटगोइंग थ्रू [आउटबाउंड-ऑलरूट्स-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/तारांकन में रखा जाना चाहिए, फिर कॉन्फ़िगरेशन को दोबारा पढ़ें (या तारांकन को पुनरारंभ करें)

# 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 के साथ काम करने की योजना, एएमआई के लिए एक सेवा, पूरी तरह से सरल और पारदर्शी नहीं है, इस पर अलग से चर्चा की जानी चाहिए। तारांकन चिह्न, जब एएमआई सक्रिय होता है, बस बंदरगाह खोलता है और यही वह है। जब कोई ग्राहक शामिल होता है, तो वह प्राधिकरण का अनुरोध करता है, फिर ग्राहक आवश्यक घटनाओं की सदस्यता लेता है। घटनाएँ सादे पाठ में आती हैं, जिसे PAMI संरचित वस्तुओं में परिवर्तित करता है और केवल रुचि, फ़ील्ड, संख्याओं आदि की घटनाओं के लिए फ़िल्टरिंग फ़ंक्शन सेट करने की क्षमता प्रदान करता है।

जैसे ही कॉल आती है, NewExten ईवेंट पैरेंट [from-pstn] संदर्भ से शुरू होता है, फिर सभी ईवेंट संदर्भों में पंक्तियों के क्रम में चलते हैं। जब _custom डायलप्लान में निर्दिष्ट CallMeCallerIDName और CallStart चर से जानकारी प्राप्त होती है, तो

1. जिस एक्सटेंशन नंबर पर कॉल आया था, उसके अनुरूप UserID का अनुरोध करने का कार्य। क्या होगा यदि यह एक डायल-अप समूह है? सवाल राजनीतिक है, क्या आपको एक बार में सभी को कॉल करने की ज़रूरत है (जब हर कोई एक बार में कॉल करता है) या बदले में कॉल करते समय कॉल करें? अधिकांश ग्राहकों के पास Fisrt उपलब्ध रणनीति है, इसलिए इसमें कोई समस्या नहीं है, केवल एक कॉल। लेकिन इस मुद्दे को सुलझाने की जरूरत है।

2. Bitrix24 में कॉल रजिस्ट्रेशन फंक्शन, जो कॉल आईडी लौटाता है, जिसे फिर कॉल पैरामीटर और रिकॉर्डिंग के लिंक की रिपोर्ट करने की आवश्यकता होती है। एक्सटेंशन संख्या या UserID की आवश्यकता है

कॉल के अंत के बाद, रिकॉर्ड डाउनलोड फ़ंक्शन को कॉल किया जाता है, जो एक साथ कॉल पूरा होने की स्थिति (व्यस्त, कोई जवाब नहीं, सफलता) की रिपोर्ट करता है, और रिकॉर्ड के साथ एमपी 3 फ़ाइल का लिंक भी डाउनलोड करता है (यदि कोई हो)।

क्योंकि 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 के माध्यम से अनुरोध प्राप्त होता है, अनुरोध में एक टोकन होता है

• बिट्रिक्स में कॉल, इसके पैरामीटर और रिकॉर्ड के बारे में संदेश। कॉल समाप्त होने पर [उप-कॉल-आंतरिक-समाप्त] डायलप्लान में तारांकन द्वारा निकाल दिया गया

वेब सर्वर की जरूरत केवल दो चीजों के लिए होती है - Bitrix रिकॉर्ड फाइल डाउनलोड करना (HTTPS के जरिए) और CallMeOut.php स्क्रिप्ट को कॉल करना। आप अंतर्निहित FreePBX सर्वर का उपयोग कर सकते हैं, जिसके लिए फ़ाइलें /var/www/html हैं, आप अन्य सर्वर स्थापित कर सकते हैं या एक अलग पथ निर्दिष्ट कर सकते हैं।

वेब सर्वर

स्वतंत्र अध्ययन के लिए वेब सर्वर सेटअप छोड़ दें (tyts, tyts, tyts). यदि आपके पास कोई डोमेन नहीं है, तो आप FreeDomain( https://www.freenom.com/ru/index.html), जो आपको आपके सफेद आईपी के लिए एक मुफ्त नाम देगा (राउटर के माध्यम से पोर्ट 80, 443 को अग्रेषित करना न भूलें यदि बाहरी पता केवल उस पर है)। यदि आपने अभी एक DNS डोमेन बनाया है, तो आपको सभी सर्वरों के लोड होने तक प्रतीक्षा करनी होगी (15 मिनट से 48 घंटे तक)। घरेलू प्रदाताओं के साथ काम करने के अनुभव के अनुसार - 1 घंटे से लेकर एक दिन तक।

स्थापना स्वचालन

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

डाक में काम करनेवाला मज़दूर

यदि आप जल्दी से समाधान का प्रयास करना चाहते हैं - डॉकर के साथ एक विकल्प है - जल्दी से एक कंटेनर बनाएं, इसे बाहर बंदरगाहों दें, सेटिंग्स फाइलों को पर्ची करें और कोशिश करें (यह LetsEncrypt कंटेनर के साथ विकल्प है, अगर आपके पास पहले से प्रमाण पत्र है , आपको केवल रिवर्स प्रॉक्सी को फ्रीपीबीएक्स वेब सर्वर पर रीडायरेक्ट करने की आवश्यकता है (हमने इसे एक और पोर्ट 88 दिया है), डोकर में LetsEncrypt पर आधारित है इस लेख का

आपको फ़ाइल को डाउनलोड किए गए प्रोजेक्ट फ़ोल्डर (गिट क्लोन के बाद) में चलाने की आवश्यकता है, लेकिन पहले तारांकन विन्यास (तारांकन फ़ोल्डर) में प्रवेश करें और वहां रिकॉर्ड और अपनी साइट के 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 APIs का अध्ययन किया, विशेष रूप से फ्री बिल्ट-इन PBX - ShugarCRM और Vtiger, और हाँ! हाँ, सिद्धांत वही है। लेकिन यह एक और कहानी है, जिसे हम बाद में अलग से जीथब पर अपलोड करेंगे।

संदर्भों

• कोड ही जीथब पर है - https://github.com/CrezZ/bitrix24-freepbx-php

• बीज के लिए स्रोत लेख https://habr.com/ru/post/349316/

अस्वीकरण: वास्तविकता से कोई भी समानता काल्पनिक है और यह मैं नहीं था।

स्रोत: www.habr.com