👐🏾 ➕ ☮️ 1C: CRM-Asterisk एकीकरण PHP-AGI और 1C वेब सेवाओं का उपयोग कर रहा है 🐟 👨🏿‍🏫 🥧

हम Askozia को एक IP PBX के रूप में उपयोग करते हैं - यह प्रसिद्ध तारांकन के वितरण में से एक है, मैंने इस पोस्ट में Askozia के बारे में लिखा था ।
CRM सिस्टम के रूप में, उत्पाद 1C: व्यापार और ग्राहक संबंध प्रबंधन 8 क्लाइंट-सर्वर मोड में उपयोग किया जाता है। प्रश्न लंबे समय से पका हुआ है: क्या 1C: CRM सिस्टम को Asterisk dialplan में किसी भी नियंत्रण क्रिया को करने के लिए कॉल करना संभव है और क्या IP PBX को 1C से नियंत्रित किया जा सकता है?

काम करने का सबसे सरल तरीका 1 सी से पूछना है कि एक इनकमिंग कॉल के साथ क्या करना है, और यदि 1 सी ने उत्तर दिया, तो एक कमांड निष्पादित करें या कॉल रूट के मानक निष्पादन को जारी रखें।
आइए सरलतम क्रिया करने की कोशिश करें - CRM सिस्टम से फोन नंबर द्वारा क्लाइंट नाम सेट करें और इस मान को Asterisk CDR डेटाबेस में लिखें।

स्रोत डेटा

1 सी: एंटरप्राइज 8.2 (8.2.17.143)
"व्यापार और ग्राहक संबंध प्रबंधन" (CRM + UT)
लगभग 10,000 ठेकेदार।
DBMS एमएस एसक्यूएल
IIS वेब सर्वर

स्वचालित टेलीफोन एक्सचेंज अस्कोज़िया CFE 2.1:
तारांकन 1.8.4.4
PHP 4.4.9
एजीआई phpagi.php, वी 2.14

आस्कोज़िया में पहले से ही Asterisk आंतरिक डेटाबेस में "नोटबुक" डेटा के आधार पर एक CallerID स्थापना तंत्र है। इस विकल्प को लागू करने के लिए, हमने “ SDK संचार घटक 1C और तारांकन ” का उपयोग किया।

फ़ंक्शन का एक उदाहरण जो आपको AstDB के लिए डेटा लिखने की अनुमति देता है:

//     Asterisk   //  (dbFamily, dbKey, dbValue)    =   ActionID = ();  = "";   .DBPut(dbFamily, dbKey, dbValue, ActionID, )   ; ;  ("   "); ;  ("  "); ;  ;  //

फ़ंक्शन कॉल का एक उदाहरण, वर्तमान कार्य पर लागू होता है:

 // dbFamily - “cidname” //  “ ” // dbKey -     ,   ,    // dbValue -     ("cidname", “74952293042”, “OOO MIKO”);

यह पहला कार्यान्वयन विकल्प है। हमने इसे अपने संगठन में काम में लॉन्च किया। कॉल के दौरान सभी कार्यालय फोन पर संपर्कों को सिंक्रनाइज़ करने के बाद, आप देख सकते हैं कि हम किससे बात कर रहे हैं (बेशक, अगर डेटाबेस में एक नंबर है)।
बेशक, CallerID को केवल डिस्प्ले वाले फोन पर ही देखा जा सकता है :)।

नुकसान:
AstDB और 1C डेटा के आवधिक तुल्यकालन की आवश्यकता है। डेटा पुराना है।
आस्कोज़िया - रीडऑनली सिस्टम। यह इसका फायदा और नुकसान है। रिबूट के बाद, 1C से ग्राहकों की सूची लिखने से पहले, AstDB को अपनी "प्रारंभिक" स्थिति में वापस लाया जाता है।

इन कमियों के कारण, हमने इस कार्यान्वयन विकल्प को छोड़ दिया। लेकिन नग्न तारांकन के लिए, यह विकल्प काफी काम कर रहा है।

एजीआई और वेब सेवाओं 1 सी के माध्यम से ऑनलाइन इंटरैक्शन के वेरिएंट: एंटरप्राइज 8

हम 1C वेब सेवा बनाते हैं

जब तारांकन कॉल मार्ग में हमारे बाहरी नंबर पर कॉल आती है, तो एजीआई स्क्रिप्ट को कॉल करना संभव है। स्क्रिप्ट में, 1C वेब सेवा तक पहुँचें और CallerID (नाम) का मान सेट करें।

एक साधारण 1 सी वेब सेवा विकसित की गई है:
नाम - MIKO_identify_number

नामस्थान: wiki.miko.ru/doc : 1cajam : आइडेंटिनंबर
प्रकाशन फ़ाइल नाम: 1C_MIKO_identify_number.1cws

सेवा में केवल एक सरल ऑपरेशन (फ़ंक्शन) होगा,

ऑपरेशन गुण:

इसमें एक इनपुट पैरामीटर "नंबर" होता है, वास्तव में कॉलिंग क्लाइंट की संख्या इसे प्रेषित की जाएगी।

पैरामीटर और वापसी मान के प्रकार " स्ट्रिंग (http://www.w3.org/2001/XMLSchema) "

हम एक वेब सेवा प्रकाशित करते हैं (यह कैसे करना है पर एक अलग विषय, हम उस पर ध्यान नहीं देंगे, आप यहां पढ़ सकते हैं)। प्रकाशन के बाद, हम वेब ब्राउज़र का उपयोग करके सेवा की जांच करेंगे, लिंक पर wsdl विवरण खोलें:

IP_WEB_SERVER_1C/TestComponenta/ws/1C_MIKO_identify_number.1cws?wsdl

यदि सब कुछ सही है, तो परिणाम निम्नानुसार होगा:

सेवा ऑब्जेक्ट के मॉड्यूल में, हम सबसे सरल ऑपरेशन हैंडलर लिखते हैं:

  identify(Number)  = "";  (Number);  //     , //         (Number)  = "OOO MIKO " + Number+ "";  ;

CURL लें और हमारी WEB सेवा "हेड-ऑन" के संचालन की जांच करें।

सामान्य तौर पर, कमांड इस तरह दिखाई देगी:
curl --header <> -d '<XML >' < >

हम एक अनुरोध भेजते हैं:

curl --header "Content-Type: text/xml; charset=utf-8" -d '<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Body><m:identify xmlns:m="http://wiki.miko.ru/doc:1cajam:identifynumber"><m:Number>74952293042</m:Number></m:identify></soap:Body></soap:Envelope>' IP_WEB_SERVER_1C/TestComponenta/ws/1C_MIKO_identify_number.1cws

इस उदाहरण में, प्रमाणीकरण का उपयोग नहीं किया गया है (1 सी डेटाबेस में कोई उपयोगकर्ता नहीं है)।

उदाहरण सर्वर प्रतिक्रिया:

 <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Header/> <soap:Body> <m:identifyResponse xmlns:m="http://wiki.miko.ru/doc:1cajam:identifynumber"> <m:return xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">OOO MIKO 74952293042</m:return> </m:identifyResponse> </soap:Body> </soap:Envelope>

यह काम करता है!

एक AGI स्क्रिप्ट बनाएं

दुर्भाग्य से, Askozia में बहुत ही आदिम PHP विशेषताएं हैं, यहां तक कि एक CURL विस्तार भी नहीं है, और PHP एक प्राचीन 4.4.9 संस्करण का उपयोग करता है। फिर भी, हमने सभी प्रतिबंधों को विफल करने की कोशिश की, इसलिए कृपया नीचे वर्णित कोड पर ज्यादा कसम न खाएं।

कोड का विस्तार करें

 #!/usr/bin/php -f <?php require('phpagi.php'); //    // AGI phpagi.php,v 2.14 get_variable        $start_found = false; $end_found = false; $ret_value = ''; function tagStart($parse, $name, $attribs){ global $start_found; if($name == 'M:RETURN'){ // echo($name); $start_found = true; } } function tagEnd($parser, $name){ global $start_found; global $end_found; if($name == 'M:RETURN'){ $end_found = true; } } function dataGet($parser, $data){ global $start_found; global $ret_value; global $end_found; if($start_found&&!$end_found){ $ret_value = ''.$data; } } function parse_response($response){ //  xml  $xml_parse = xml_parser_create(); xml_set_element_handler($xml_parse, 'tagStart', 'tagEnd'); xml_set_character_data_handler ($xml_parse, 'dataGet'); xml_parse($xml_parse, $response); //  ,   xml_parser_free($xml_parse); } function GetVarChannnel($agi, $_varName){ $v = $agi->get_variable($_varName); if(!$v['result'] == 0){ $agi->verbose($_varName.' ---> '.$v['data'], 10); return $v['data']; } else{ $agi->verbose($_varName.' not set', 10); return ""; } } // GetVarChannnel($_agi, $_varName) //   agi,     phpagi.php $agi = new AGI(); //  ,     $path = '/TestComponenta/ws/1C_MIKO_identify_number.1cws'; $server = 'IP_WEB_SERVER_1C'; $port = 80; $number = GetVarChannnel($agi, "CALLERID(num)");; $user_1c= "1C_USERNAME"; $pass_1c= '1C_PASSWORD'; $auth = base64_encode($user_1c.':'.$pass_1c); $crlf = "\r\n"; //    -   SOAP  $xmlDocument = ( '<?xml version="1.0" encoding="UTF-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <m:identify xmlns:m="http://wiki.miko.ru/doc:1cajam:identifynumber"> <m:Number>'.$number.'</m:Number> </m:identify> </soap:Body> </soap:Envelope>'); $contentLength = strlen($xmlDocument); //   if (($http_soket = @fsockopen($server, $port, $errno, $errstr,1.5)) == false) return; $query = "POST $path HTTP/1.1" .$crlf; $query .= "Host: $server" .$crlf; $query .= "Content-Type: text/xml; charset=utf-8" .$crlf; $query .= "Authorization: Basic $auth" .$crlf; $query .= "Content-Length: $contentLength" .$crlf; $query .= $crlf; $query .= $xmlDocument; //     1 stream_set_timeout($http_soket, 1, 0); //   fputs($http_soket, $query); $result = ''; //   while ($line = fgets($http_soket)) $result .= $line; //    $result = substr($result, strpos($result, $crlf.$crlf) + 4); fclose($http_soket); //   parse_response($result); if($ret_value != ''){ $agi->set_variable('CALLERID(name)', $ret_value); //  1  ,       CDR } ?>

हम स्क्रिप्ट को Askozia से जोड़ेंगे, इसके लिए वेब इंटरफ़ेस में, एप्लिकेशन टैब पर जाएं और एक नया PHP एप्लिकेशन जोड़ें।

"एप्लिकेशन लॉजिक" फ़ील्ड में, स्क्रिप्ट टेक्स्ट सेट करें।
"#! / Usr / bin / php -f" पर ध्यान दें - लाइन को छोड़ दिया जाना चाहिए। खुद अस्कोजिया इसे जोड़ देगा। आवेदन के लिए नाम और संख्या निर्धारित करें।
अब आपको स्क्रिप्ट फ़ाइल का नाम पता करने की आवश्यकता है। इस तारांकन कमांड कंसोल (CLI) के लिए, कमांड निष्पादित करें:

 # dialplan show 1334444@internal [ Context 'internal' created by 'pbx_config' ] '1334444' => 1. NoOp(internal calling application: AGI_App_CallerID) [pbx_config] 2. Set(CDR(InternalCalleridNum)=1334444) [pbx_config] 3. Goto(DIALPLAN-APPLICATION-176239923050fac4c5678b9,${EXTEN},1) [pbx_config] -= 1 extension (3 priorities) in 1 context. =-

हमें पता चला कि DIALPLAN-APPLICATION-176239923050fac4c5678b9 का संदर्भ संख्या 13344 में है

हम इस संदर्भ को यह समझने के लिए प्राप्त करेंगे कि हमारी PHP फ़ाइल को क्या कहा जाता है:

 # dialplan show DIALPLAN-APPLICATION-176239923050fac4c5678b9 [ Context 'DIALPLAN-APPLICATION-176239923050fac4c5678b9' created by 'pbx_config' ] 'h' => 1. Hangup() 's' => 1. AGI(DIALPLAN-APPLICATION-176239923050fac4c5678b9.php) 2. Hangup() '_[0-9a-zA-Z*#]!' =>1. AGI(DIALPLAN-APPLICATION-176239923050fac4c5678b9.php) 2. Hangup() -= 3 extensions (5 priorities) in 1 context. =-

खोज की गई फ़ाइल मिली: DIALPLAN-APPLICATION-176239923050fac4c5678b9..tp

हम आने वाले कॉल मार्ग को संपादित करने के लिए आगे बढ़ते हैं और मार्ग की शुरुआत में सार्वभौमिक कमांड के ब्लॉक को जोड़ते हैं:

कमांड क्षेत्र में AGI स्थापित करें (DIALPLAN-APPLICATION-176239923050fac4c5678b9.php)
अंत में, मेरा कॉल रूट निम्नानुसार है:

इस मार्ग के लिए आने वाली कॉल के साथ, एक AGI स्क्रिप्ट को 1C सर्वर तक पहुंच के साथ निष्पादित किया जाता है, सर्वर प्रतिरूपित नाम को प्रेषित संख्या में लौटाता है, और यह नाम CallerID फ़ील्ड में दर्ज किया जाता है।

परिणामस्वरूप, परिचय से पहले, कहानी इस तरह दिखती है:

वेब-सेवा शुरू करने के बाद, 1 सी से ग्राहकों के नाम: सीआरएम सिस्टम इतिहास में दिखाई दिए:

इसके अलावा, मिस्ड कॉल या प्राप्त किए गए ईमेल के बारे में सभी Askozia नोटिफिकेशन अधिक जानकारीपूर्ण हो गए हैं, पत्र के हेडर में क्लाइंट का नाम होता है, इससे पहले सिर्फ एक नंबर था।

निष्कर्ष

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

उपयोगी लिंक:

आप इस पोस्ट में या वेबसाइट www.askozia.ru पर Askozia के बारे में अधिक पढ़ सकते हैं
वेबसाइट www.telefon1c.ru पर 1C और Asterisk के एकीकरण के बारे में
आप PHP-AGI के बारे में यहाँ phpagi.sourceforge.net पर पढ़ सकते हैं
आधिकारिक वेबसाइट पर लगभग 1 सी वेब सेवाएं।

1C: CRM-Asterisk एकीकरण PHP-AGI और 1C वेब सेवाओं का उपयोग कर रहा है

स्रोत डेटा

एजीआई और वेब सेवाओं 1 सी के माध्यम से ऑनलाइन इंटरैक्शन के वेरिएंट: एंटरप्राइज 8

हम 1C वेब सेवा बनाते हैं

एक AGI स्क्रिप्ट बनाएं

निष्कर्ष

More articles: