FreePBX बुझ्दै र Bitrix24 र थपसँग यसलाई एकीकृत गर्दै

Bitrix24 CRM, कार्यप्रवाह, लेखा र प्रबन्धकहरूलाई साँच्चै मनपर्ने र IT कर्मचारीहरूलाई मन नपर्ने अन्य धेरै कुराहरू संयोजन गर्ने एउटा ठूलो संयोजन हो। पोर्टल धेरै साना र मध्यम आकारका कम्पनीहरू द्वारा प्रयोग गरिन्छ, साना क्लिनिकहरू, निर्माताहरू र सौन्दर्य सैलूनहरू समेत। प्रबन्धकहरूले "प्रेम" गर्ने मुख्य कार्य भनेको टेलिफोनी र सीआरएमको एकीकरण हो, जब कुनै पनि कल सीआरएममा तुरुन्तै रेकर्ड हुन्छ, ग्राहक कार्डहरू सिर्जना हुन्छन्, जब आगमन हुन्छ, ग्राहकको बारेमा जानकारी प्रदर्शित हुन्छ र तपाईंले तुरुन्तै देख्न सक्नुहुन्छ कि उहाँ को हुनुहुन्छ, उहाँ के हो। बेच्न सक्छ र उसको कति ऋण छ। तर Bitrix24 बाट टेलिफोनी र CRM सँग यसको एकीकरणमा पैसा खर्च हुन्छ, कहिलेकाहीँ धेरै। लेखमा म तपाईंलाई खुला उपकरणहरू र लोकप्रिय IP PBX सँग एकीकरणको अनुभव बताउनेछु freepbx, र विभिन्न भागहरूको कामको तर्कलाई पनि विचार गर्नुहोस्

म आईपी टेलिफोनी बेच्ने र कन्फिगर गर्ने, एकीकृत गर्ने कम्पनीमा आउटसोर्सरको रूपमा काम गर्छु। जब मलाई यो र यस कम्पनीलाई ग्राहकहरूले भएका PBXs र साथै विभिन्न VDS कम्पनीहरूमा भर्चुअल PBX सँग एकीकरण गर्न हामी यो र यो कम्पनीलाई केही प्रस्ताव गर्न सक्छौं कि भनेर सोधियो, म Google गएँ। र पक्कै पनि उसले मलाई एउटा लिङ्क दियो habr मा लेख, जहाँ एक वर्णन छ, र github, र सबै काम जस्तो देखिन्छ। तर यो समाधान प्रयोग गर्ने प्रयास गर्दा, यो पत्ता लाग्यो कि Bitrix24 अब पहिले जस्तै छैन, र धेरै पुन: गर्न आवश्यक छ। थप रूपमा, FreePBX तपाईंको लागि एउटा नग्न तारा चिन्ह होइन, यहाँ तपाईंले कन्फिग फाइलहरूमा प्रयोगको सहजता र हार्डकोर डायलप्लान कसरी संयोजन गर्ने भन्ने बारे सोच्न आवश्यक छ।

हामी कामको तर्क अध्ययन गर्छौं

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

सरलीकृत रूपमा, डायलप्लानले पहिलो प्याकेटसँग मात्र व्यवहार गर्दछ, कहिलेकाहीँ कुराकानीको क्रममा, कलहरू स्थानान्तरण गरिन्छ, बटन थिच्ने (डीटीएमएफ), फलोमी, रिङ्ग्रुप, आईभीआर र अन्य जस्ता विभिन्न रोचक कुराहरू।

निमन्त्रणा प्याक भित्र के छ

वास्तवमा, धेरै साधारण डायलप्लानहरू पहिलो दुई क्षेत्रहरूसँग काम गर्दछ, र सम्पूर्ण तर्क DID र CallerID वरिपरि घुम्छ। DID - जहाँ हामी कल गर्दैछौं, CallerID - जसले कल गर्दैछ।

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

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

FreePBX को सम्पूर्ण तर्क Gosub, Macro र ह्यान्डलर ह्यान्डलरहरू मार्फत समावेश र कल मार्फत एकअर्कामा विभिन्न सन्दर्भहरू समावेश गर्नमा निर्मित छ। आगमन FreePBX कलहरूको सन्दर्भलाई विचार गर्नुहोस्

कल माथिदेखि तलसम्म सबै सन्दर्भहरू मार्फत जान्छ, प्रत्येक सन्दर्भमा म्याक्रो (म्याक्रो), प्रकार्यहरू (गोसब) वा बस ट्रान्जिसनहरू (गोटो) जस्ता अन्य सन्दर्भहरूमा कल हुन सक्छ, त्यसैले के भनिन्छ भन्ने वास्तविक रूख मात्र हुन सक्छ। लगहरूमा ट्र्याक गर्नुहोस्।

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

यस कल एल्गोरिथ्ममा हामीले CRM लाई कल सुरु भएको जानकारी, कहाँ रेकर्डिङ सुरु गर्ने, कहाँ रेकर्डिङ अन्त्य गर्ने र CRM मा कलको जानकारी सहित पठाउने बारे जानकारी उपलब्ध गराउनुपर्छ?

बाह्य प्रणाली संग एकीकरण

PBX र CRM एकीकरण के हो? यी सेटिङहरू र प्रोग्रामहरू हुन् जसले यी दुई प्लेटफर्महरू बीच डेटा र घटनाहरू रूपान्तरण गर्दछ र तिनीहरूलाई एकअर्कालाई पठाउँदछ। स्वतन्त्र प्रणालीहरूको लागि सञ्चार गर्ने सबैभन्दा सामान्य तरिका API मार्फत हो, र API हरू पहुँच गर्ने सबैभन्दा लोकप्रिय तरिका HTTP REST हो। तर ताराङ्कनको लागि होइन।

Asterisk भित्र छ:

• AGI - बाह्य कार्यक्रमहरू/कम्पोनेन्टहरूको सिंक्रोनस कल, मुख्य रूपमा डायलप्लानमा प्रयोग गरिन्छ, त्यहाँ पुस्तकालयहरू छन्। phpagi, PAGI

• AMI - पाठ TCP सकेट जसले घटनाहरूको सदस्यता लिने र पाठ आदेशहरू प्रविष्ट गर्ने सिद्धान्तमा काम गर्दछ, भित्रबाट SMTP जस्तो देखिन्छ, घटनाहरू ट्र्याक गर्न र कलहरू व्यवस्थापन गर्न सक्छ, त्यहाँ पुस्तकालय छ। PAMI - Asterisk संग जडान सिर्जना गर्न को लागी सबैभन्दा लोकप्रिय

AMI आउटपुट उदाहरण

कार्यक्रम: नयाँ च्यानल
विशेषाधिकार: कल, सबै
च्यानल: PJSIP/VMS_pjsip-0000078b
च्यानल स्थिति: 4
ChannelStateDesc: घण्टी
CallerIDNum: 111222
CallerIDName: 111222
ConnectedLineNum:
जोडिएको रेखानाम:
भाषा: en
खाता कोड:
सन्दर्भ: pstn बाट
विस्तार: एस
प्राथमिकता: १
अद्वितीय: 1599589046.5244
Linkedid: 1599589046.5244

• ARI दुबैको मिश्रण हो, REST, WebSocket मार्फत, JSON ढाँचामा - तर ताजा पुस्तकालयहरू र र्यापरहरूसँग, धेरै राम्रो छैन, अफह्यान्ड फेला पर्यो (phparia, phpari) जुन करिब ३ वर्ष अघि उनीहरुको विकासमा आएको थियो ।

कल सुरु हुँदा ARI आउटपुटको उदाहरण

{ "variable":"CallMeCallerIDName", "value":"111222", "type":"ChannelVarset", "timestamp":"2020-09-09T09:38:36.269+0000", "channel":{ "id »:»१५९९६४४३१५.५३३४″, «नाम»:»PJSIP/VMSpjsip-000007b6″, "state":"Ring", "caller":{ "name":"111222″, "number":"111222″ }, "connected":{ "name":"", "number" :"" }, "accountcode":"", "dialplan":{ "context":"from-pstn", "exten":"s", "priority":2, "appname":"स्टेसिस", "एपdata":"hello-world" }, "creativetime":"2020-09-09T09:38:35.926+0000", "language":"en" }, "तारांकनid":"48:5b:aa:aa:aa:aa", "application":"hello-world" }

सुविधा वा असुविधा, एक विशेष API सँग काम गर्ने सम्भावना वा असम्भवता समाधान गर्न आवश्यक कार्यहरू द्वारा निर्धारण गरिन्छ। CRM सँग एकीकरणका लागि कार्यहरू निम्नानुसार छन्:

• कलको शुरुवात ट्र्याक गर्नुहोस्, जहाँ यो स्थानान्तरण गरिएको थियो, कलरआईडी निकाल्नुहोस्, DID, सुरु र अन्त्य समय, हुनसक्छ डाइरेक्टरीबाट डाटा (फोन र CRM प्रयोगकर्ता बीचको जडान खोज्न)

• कलको रेकर्डिङ सुरु गर्नुहोस् र अन्त्य गर्नुहोस्, यसलाई इच्छित ढाँचामा बचत गर्नुहोस्, रेकर्डिङको अन्त्यमा सूचित गर्नुहोस् जहाँ फाइल अवस्थित छ।

• बाह्य घटना (कार्यक्रमबाट) मा कल सुरु गर्नुहोस्, आन्तरिक नम्बर, बाह्य नम्बर कल गर्नुहोस् र तिनीहरूलाई जडान गर्नुहोस्।

• वैकल्पिक: स्थानको अनुपस्थितिमा कलहरूको स्वचालित स्थानान्तरणको लागि CRM, डायलर समूहहरू र FollowME सँग एकीकृत गर्नुहोस् (सीआरएम अनुसार)

यी सबै कार्यहरू AMI वा ARI मार्फत समाधान गर्न सकिन्छ, तर ARI ले धेरै कम जानकारी प्रदान गर्दछ, त्यहाँ धेरै घटनाहरू छैनन्, AMI सँग अझै पनि धेरै चरहरू छन् (उदाहरणका लागि, म्याक्रो कलहरू, म्याक्रो भित्र भेरिएबलहरू सेट गर्ने, कल रेकर्डिङ सहित) ट्र्याक गरिएको छैन। त्यसकारण, सही र सही ट्र्याकिङको लागि, अहिलेको लागि AMI छनौट गरौं (तर पूर्ण रूपमा होइन)। थप रूपमा (राम्रो, यो बिना यो कहाँ हुनेछ, हामी अल्छी मानिसहरू हौं) - मूल काममा (habr मा लेख) PAMI प्रयोग गर्नुहोस्। *त्यसोभए तपाईंले एआरआईमा पुन: लेख्न प्रयास गर्न आवश्यक छ, तर यसले काम गर्नेछ भन्ने तथ्य होइन।

एकीकरण पुन: आविष्कार

हाम्रो 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

खाता कोड:

सन्दर्भ: pstn बाट

विस्तार: एस

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

अद्वितीय: 1599589046.5244

Linkedid: 1599589046.5244

आवेदन: सेट AppData:

कलस्टार्ट=१५९९५७१०४६

किनभने FreePBX ले extention.conf र extention_ फाइलहरूलाई ओभरराइट गर्छextra.conf, हामी फाइल प्रयोग गर्नेछौं विस्तार_अनुकूलन.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], बाहिर जाने [आउटबाउन्ड-सबै मार्ग-अनुकूल]

• नम्बरहरूमा कुनै बाध्यकारी छैन - फाइल विश्वव्यापी छ र केवल मार्ग र सर्भरमा लिङ्कको लागि कन्फिगर गर्न आवश्यक छ।

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

कल आउने बित्तिकै, NewExten घटना अभिभावक [from-pstn] सन्दर्भबाट सुरु हुन्छ, त्यसपछि सबै घटनाहरू सन्दर्भहरूमा लाइनहरूको क्रममा जान्छन्। जब _custom dialplan मा निर्दिष्ट CallMeCallerIDName र CallStart चरहरूबाट जानकारी प्राप्त हुन्छ,

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

2. Bitrix24 मा कल दर्ता प्रकार्य, जसले 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 वा सेवा मार्फत हुन्छ

# systemctl enable callme
# systemctl start callme

आवश्यकता अनुसार सेवा आफै पुन: सुरु हुनेछ (क्र्यासको अवस्थामा)। इनबक्स ट्र्याकिङ सेवालाई वेब सर्भर स्थापना गर्न आवश्यक पर्दैन, केवल php आवश्यक छ (जुन निश्चित रूपमा FeePBX सर्भरमा छ)। तर वेब सर्भर (https सहित) मार्फत कल रेकर्डहरूमा पहुँचको अभावमा, कल रेकर्डहरू सुन्न सम्भव हुनेछैन।

अब बहिर्गमन कलहरूको बारेमा कुरा गरौं। CallMeOut.php लिपिमा दुई प्रकार्यहरू छन्:

• php स्क्रिप्टको लागि अनुरोध प्राप्त हुँदा कलको प्रारम्भ (Bitrix मा "कल" ​​बटन प्रयोग गर्ने सहित)। यसले वेब सर्भर बिना काम गर्दैन, अनुरोध HTTP POST मार्फत प्राप्त हुन्छ, अनुरोधमा टोकन समावेश छ

• Bitrix मा कल, यसको प्यारामिटर र रेकर्ड बारे सन्देश। Asterisk द्वारा [sub-cal-internal-ended] डायलप्लानमा जब कल समाप्त हुन्छ

वेब सर्भर केवल दुई चीजहरूको लागि आवश्यक छ - Bitrix रेकर्ड फाइलहरू डाउनलोड गर्न (HTTPS मार्फत) र CallMeOut.php स्क्रिप्ट कल गर्दै। तपाइँ निर्मित FreePBX सर्भर प्रयोग गर्न सक्नुहुन्छ, फाइलहरू जसको लागि /var/www/html, तपाइँ अर्को सर्भर स्थापना गर्न वा फरक मार्ग निर्दिष्ट गर्न सक्नुहुन्छ।

वेब सर्भर

स्वतन्त्र अध्ययनको लागि वेब सर्भर सेटअप छोडौं (tyts, tyts, tyts)। यदि तपाइँसँग डोमेन छैन भने, तपाइँ FreeDomain ( https://www.freenom.com/ru/index.html), जसले तपाईंलाई तपाईंको सेतो आईपीको लागि नि:शुल्क नाम दिनेछ (यदि बाहिरी ठेगाना मात्र छ भने राउटर मार्फत पोर्टहरू 80, 443 फर्वार्ड गर्न नबिर्सनुहोस्)। यदि तपाईंले भर्खरै एउटा DNS डोमेन सिर्जना गर्नुभयो भने, तपाईंले सबै सर्भरहरू लोड नभएसम्म (१५ मिनेटदेखि ४८ घण्टासम्म) पर्खनुपर्छ। घरेलु प्रदायकहरूसँग काम गर्ने अनुभव अनुसार - 15 घण्टा देखि एक दिन।

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

स्थापना अझ सजिलो बनाउन github मा एक स्थापनाकर्ता विकसित गरिएको छ। तर यो कागजमा चिकनी थियो - जब हामी यो सबै म्यानुअल रूपमा स्थापना गर्दैछौं, किनकि यी सबैसँग टिंकर गरेपछि यो क्रिस्टल स्पष्ट भयो कि कोसँग साथीहरू छन्, को कहाँ जान्छ र कसरी डिबग गर्ने। अहिलेसम्म कुनै स्थापनाकर्ता छैन

डकर

यदि तपाइँ चाँडै समाधान प्रयास गर्न चाहनुहुन्छ भने - त्यहाँ डकरसँग विकल्प छ - द्रुत रूपमा कन्टेनर सिर्जना गर्नुहोस्, यसलाई बाहिर पोर्टहरू दिनुहोस्, सेटिङ फाइलहरू स्लिप गर्नुहोस् र प्रयास गर्नुहोस् (यो LetsEncrypt कन्टेनरको साथ विकल्प हो, यदि तपाइँसँग पहिले नै प्रमाणपत्र छ भने। , तपाईंले भर्खरै रिभर्स प्रोक्सीलाई FreePBX वेब सर्भरमा रिडिरेक्ट गर्न आवश्यक छ (हामीले यसलाई अर्को पोर्ट दियौं 88), LetsEncrypt in docker आधारित यो लेख

तपाईंले डाउनलोड गरिएको प्रोजेक्ट फोल्डरमा फाइल चलाउन आवश्यक छ (गिट क्लोन पछि), तर पहिले एस्टेरिस्क कन्फिगहरू (एस्टेरिस्क फोल्डर) मा जानुहोस् र रेकर्डहरूमा पथहरू र त्यहाँ तपाईंको साइटको 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 मा छ - https://github.com/CrezZ/bitrix24-freepbx-php

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

अस्वीकरण: वास्तविकतासँग कुनै पनि समानता काल्पनिक हो र यो म थिइनँ।

स्रोत: www.habr.com