बिट्रिक्स में ऐलिस

आज हम:

1. आइए नई (अक्टूबर 2019) यांडेक्स क्लाउड फ़ंक्शंस सेवा का उपयोग करके ऐलिस एप्लिकेशन (कौशल) बनाएं।
   
2. हम अपने एप्लिकेशन को कॉन्फ़िगर करेंगे ताकि यह बिट्रिक्स 24 सीआरएम को ग्राहक के आदेश (तथाकथित लीड) भेजता है ।
   

हमारी परियोजना Node.js (संस्करण 10.xx) का उपयोग करेगी - यह आपके स्थानीय मशीन पर npm के साथ स्थापित होना चाहिए (डिफ़ॉल्ट रूप से, Npm को Node.js की स्थापना के साथ स्थापित किया गया है, इसलिए सबसे अधिक संभावना है कि आपको अलग से इंस्टॉल नहीं करना होगा)।

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

दूसरा बिंदु एलिस के साथ पैसा कमाने के कुछ तरीकों में से एक है। आज प्राप्त ज्ञान के आधार पर, यह संभव होगा: ए) व्यापार ग्राहकों के लिए कस्टम-निर्मित एप्लिकेशन बनाने के लिए; ख) अपने दम पर अपना खुद का व्यवसाय खोलें (इस मामले में आप अग्रदूतों में से होंगे और इसलिए fabulously अमीर हैं)।

लेकिन अगर आपने ऐलिस के लिए कौशल नहीं बनाया है, या आपके पास बहुत कम अनुभव है - तो मैं आपको इस श्रृंखला के अपने पहले लेख का उल्लेख करता हूं: "ऐलिस गेट्स ए स्किल" - उसकी मदद से आप एक साधारण एप्लिकेशन बनाएंगे जो स्मार्ट लोगों को उद्धृत करता है और इकट्ठा करने के लिए एक बटन भी है। अपने स्मार्ट विचारों को प्रोत्साहित करने के लिए दान।

आज हम एक साधारण आवेदन भी करेंगे - यहाँ इसके कार्य का परिदृश्य है। एक सुपर सेलर ग्राहक के नाम और उपनाम को बेचता है, और जब बाद वाला कबूल करता है (या धोखा देता है) - इस डेटा को Bitrix24 वाले एक ऑर्डर (लीड) भेजता है। सब कुछ नीचे दी गई तस्वीरों में दिखाया गया है।

यहां बिट्रिक्स विक्रेता कौशल है (यह ऐलिस कौशल सूची में नहीं है, लेकिन यह जीवित है और आप इसे वाक्यांश के साथ कह सकते हैं: "ऐलिस, बिट्रिक्स विक्रेता कौशल लॉन्च करें" - मैं आपको इसे परीक्षण करने के लिए आमंत्रित करता हूं)। पहली स्क्रीन (बाएं) पर, हमारा विक्रेता खुश नहीं था कि उपयोगकर्ता ने केवल नाम दिया और उसने फिर से पूछा। दूसरी स्क्रीन पर (दाईं ओर) - सब कुछ ठीक है, और आदेश Bitrix24 के लिए "उड़ गया":



लेकिन लीड हमारे विक्रेता से पहले ही प्राप्त हो चुकी है, और इसे बिट्रिक्स 24 सीआरएम कंसोल में देखा जा सकता है:



अब जब हमारे काम का उद्देश्य स्पष्ट है, तो चलिए शुरू करते हैं।

यैंडेक्स क्लाउड

हालांकि Yandex.Cloud प्लेटफॉर्म के साथ काम करने के लिए प्रशिक्षण इस लेख का उद्देश्य नहीं है (लेकिन मैं भविष्य में ऐसे लेखों की योजना बना रहा हूं), हमें आगे बढ़ने के लिए, हम प्रमुख बिंदु पर ध्यान केंद्रित करेंगे - Yandex.Cloud में एक खाता बनाना। यदि आप पहले ही इस चरण को पार कर चुके हैं, तो आप हमारे आज के पाठ के लिए इस खंड को बिना किसी नकारात्मक परिणाम के छोड़ सकते हैं। वास्तव में, यह सब बहुत सरल है।

अपने यैंडेक्स खाते के तहत, Yandex.Cloud वेबसाइट पर जाएं और " कंसोल " बटन पर क्लिक करें।



सिस्टम आपके लिए डिफॉल्ट नामक क्लाउड में एक कार्यशील निर्देशिका बनाएगा (यदि आप इस नाम से सहमत हैं):



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



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



नेटवर्क ( डिफ़ॉल्ट ) के नाम पर क्लिक करके, हम इसके गुणों को देखेंगे, जिसमें यह तथ्य भी शामिल है कि (फिलहाल) नेटवर्क में तीन सबनेट शामिल हैं: आरयू- Central1-a , ru-central1-b और ru-central1-c ।



इसके मूल में, सबनेट तथाकथित हैं। डेटा केंद्र, अर्थात मंच के निर्बाध संचालन की गारंटी के लिए रूसी संघ (तथाकथित क्षेत्रों) के विभिन्न शहरों में स्थित सर्वरों के साथ भौतिक रैंप, और उपयोगकर्ता डेटा की अखंडता (यानी, अखंडता और सुरक्षा) को संरक्षित करना। पूर्ण संचालन में लगने वाले समय को कम करने के लिए, यह अनुशंसा की जाती है कि सभी संबंधित संसाधनों को एक ही सबनेट पर संग्रहीत किया जाए (यानी, एक ही डेटा सेंटर में)। इसके बाद, हम ru-central1-b सबनेट का उपयोग करेंगे, लेकिन जब आप चुनने का समय आएगा तो आप कोई अन्य चुन सकते हैं। अच्छी खबर है! यह हम सभी को नेटवर्क, सबनेट और ज़ोन के बारे में जानना है, और आज हम यहाँ नहीं लौटेंगे!

अब यह बैंक कार्ड को Yandex.Cloud खाते में संलग्न करना बाकी है ताकि इसकी सभी सेवाएं हमारे लिए उपलब्ध हो जाएं। यहां मुझे यह कहना होगा कि Yandex.Cloud 60 दिनों और 4 हजार रूबल की परीक्षण अवधि के साथ सभी को प्रदान करता है - अर्थात। जब इनमें से कोई पहले समाप्त होता है। लेकिन परीक्षण अवधि समाप्त होने के बाद भी, आपके फंड्स को स्वचालित रूप से लिंक किए गए बैंक कार्ड से डेबिट नहीं किया जाएगा, जब तक कि आप " स्विच टू पेड वर्जन " बटन पर क्लिक करके स्पष्ट रूप से इसकी पुष्टि नहीं कर लेते।


इसलिए, बैंक कार्ड संलग्न करने के लिए, आपको बाईं ओर मेनू में बिलिंग आइटम का चयन करना होगा:



वहां, "खाता बनाएं" बटन पर क्लिक करें, और निर्देशों का पालन करें: उपयोग की शर्तों को स्वीकार करें, अपना बैंक कार्ड विवरण दर्ज करें, क्रियाओं की पुष्टि करें, आदि। जब भुगतान खाता बन जाएगा, तो सभी Yandex.Cloud सेवाएं उपलब्ध हो जाएंगी, और हम आगे बढ़ पाएंगे।

Bitriks24

यदि आपके पास अभी तक Bitrix24 में खाता नहीं है - तो यह एक बनाने का समय है। यहां सब कुछ सरल और स्पष्ट है: Bitrix24 वेबसाइट पर जाएं और वहां अपने लिए एक खाता बनाएं। उनके पास किसी भी समय सीमा के बिना एक उदार उदार स्तर है, इसलिए हमारे उद्देश्यों के लिए कुछ भुगतान करने के लिए पूरी तरह से वैकल्पिक है (हालांकि यह संभव है)।

अगला, हमें एक आने वाले वेबहूक बनाने की आवश्यकता है। ऐसा करने के लिए, बाएं मेनू में चयन करें: एप्लिकेशन (शायद यह आइटम "अधिक" सूची में छिपा हुआ है) -> "वेबहुक" टैब -> "वेबहुक जोड़ें" बटन , जैसा कि स्क्रीनशॉट में दिखाया गया है:



जब आप " वेबहुक जोड़ें " बटन पर क्लिक करते हैं, तो सूची से " इनकमिंग वेबहूक " चुनें, फिर निर्माण पृष्ठ पर, नए आने वाले वेबहूक के लिए एक उचित नाम और विवरण दर्ज करें, और सीआरएम (सीआरएम) चेकबॉक्स भी चुनें।



उसके बाद, पृष्ठ के निचले भाग में, " सहेजें " बटन पर क्लिक करें। नतीजतन, सिस्टम आपको अपने webhook के साथ एक नमूना URL देगा, कुछ इस तरह से:

 URL   REST: https://12345.bitrix24.ru/rest/1/xxxxxxx/profile/ 

जहां xxxxxxx के बजाय आपका वर्तमान वेबहूक होगा (और 12345 के बजाय - आपका वास्तविक उपडोमेन)।
याद रखें कि webhook को गुप्त रखा जाना चाहिए, क्योंकि इसका उपयोग आपके Bitrix24 खाते में अनुरोध करने के लिए किया जा सकता है।

लेकिन हमें इस webhook के मापदंडों को थोड़ा बदलना होगा - चलो इसे तुरंत करें, ताकि अब यहां वापस न आएं, और संपादित किए गए webhook URL को (सुरक्षित स्थान पर) सहेज सकें। आपको बस इतना करना है कि प्रोफ़ाइल को रास्ते में crm.lead.add.json से बदल दें , और इसलिए हमारे कौशल को इस तरह एक URL की आवश्यकता होगी:

 https://12345.bitrix24.ru/rest/1/xxxxxxx/crm.lead.add.json 

वह सब है। हम ऐलिस के लिए अपने कौशल के कोड को पास करते हैं।

प्रोजेक्ट के साथ काम करें

अब हमारी परियोजना के साथ काम करना शुरू करने का समय है - ऐलिस के लिए एक कौशल, जिसका नाम " बिट्रिक्स सेलर " है। हम क्लोन (या जिप संग्रह को डाउनलोड करते हैं) GitHub रिपॉजिटरी: alice-tutorial-bitrix24 । भंडार इस लेख का एक अभिन्न अंग है। कमांड लाइन या टर्मिनल में, आवश्यक निर्भरताएं स्थापित करें:

 cd alice-tutorial-bitrix24 npm install 

अब इस फ़ोल्डर की सामग्री इस तरह दिखनी चाहिए:



मुख्य परियोजना फ़ाइल, index.js , हमारे सभी कोड शामिल हैं। चित्र निर्देशिका से, ऐलिस के डेवलपर कंसोल में आपके कौशल के लिए तीन चित्र अपलोड करें - संसाधन टैब -> चित्र । इस तरह:



लाल फ्रेम उन छवियों के पहचानकर्ताओं को उजागर करता है जिन्हें हमें अपने कोड में सम्मिलित करना होगा। लेकिन यह और भी बेहतर होगा यदि आप इस सादृश्य का उपयोग करके अपनी खुद की तस्वीरें तैयार करते हैं। मैं 512 x 230 पिक्सल के आकार की सलाह देता हूं। आवश्यक फ़ाइल प्रारूप: जेपीईजी, जेपीजी, पीएनजी । पहले कुछ उपयोगिता का उपयोग करके उन्हें कम से कम करना भी उपयोगी है - उदाहरण के लिए, मैंने ऑनलाइन ऑप्टिमिज़िला कंप्रेसर का उपयोग किया।

अब कुछ एडिटर में index.js फ़ाइल खोलें (मेरे पास विजुअल स्टूडियो कोड है ):



Xxx के बजाय ... अपने वास्तविक मूल्यों को स्थानापन्न करें: बिट्रिक्स 24 सबडोमेन और वेबहुक हमें पिछले चरण में मिला था, और चित्र पहचानकर्ताओं को अभी प्राप्त हुआ। जैसा कि आप देख सकते हैं, कोड टिप्पणियों से भरा है - बस इसे स्कोर कंडक्टर की तरह पढ़ें!

क्लाउड फ़ंक्शंस और ऑब्जेक्ट स्टोरेज

अब आपको हमारे एप्लिकेशन को क्लाउड फ़ंक्शंस में रखने की आवश्यकता है - Yandex.Cloud से एक सेवा। ऐसा करने के लिए, आपको पहले एक ज़िप संग्रह तैयार करना होगा जिसमें निर्देशिका को नोड_मॉड्यूल्स निर्भरता पैकेजों के साथ शामिल किया जाएगा और इंडेक्स । जेएस फ़ाइल जो आपने अभी संपादित की है। अब हमारी परियोजना का फ़ोल्डर (स्पष्टता के लिए खुले ज़िप संग्रह के साथ) इस तरह दिखाई देगा:



लेकिन अगर आप हमारे ज़िप आर्काइव के गुणों को देखते हैं, तो यह पता चलता है कि इसमें डायरेक्टरी की मौजूदगी के कारण नोड_मॉड्यूल निर्भरता के साथ, आर्काइव का आकार लगभग 6 एमबी तक पहुंच जाता है। दस्तावेज़ के अनुसार, क्लाउड फ़ंक्शंस में स्थानीय मशीन से सीधे आप 4 एमबी से बड़े आकार में अभिलेखागार अपलोड कर सकते हैं। इसलिए, हमें इस संग्रह को पहले किसी अन्य Yandex.Cloud सेवा - Yandex ऑब्जेक्ट संग्रहण पर अपलोड करना होगा, और वहां से - इसे क्लाउड फ़ंक्शंस में आयात करना होगा। नीचे स्क्रीनशॉट Yandex.Cloud कंसोल के नेविगेशन मेनू में इन दोनों सेवाओं का स्थान दिखाता है:



हम ऑब्जेक्ट स्टोरेज में जाते हैं , और फाइलों को स्टोर करने के लिए वहां एक बाल्टी (यानी एक बाल्टी, अगर रूसी में) बनाते हैं। मैंने अपना बकेट ऐप-बकेट कहा , आपका - आप जो चाहें नाम दे सकते हैं। अन्य सेटिंग्स को अपरिवर्तित छोड़ दें:



हम अपने ज़िप संग्रह को नई बनाई गई बाल्टी में लोड करते हैं:



अब बाएं नेविगेशन मेनू में, क्लाउड फ़ंक्शंस सेवा पर जाएं, और वहां हम एक ही नाम के बटन को दबाकर एक नया फ़ंक्शन बनाते हैं। हम फ़ंक्शन को कोई भी उचित नाम देते हैं, संक्षिप्त विवरण देते हैं, और " बनाएँ " बटन पर क्लिक करते हैं:



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



कृपया ध्यान दें कि हमें ऑब्जेक्ट स्टोरेज टैब पर स्विच करने की आवश्यकता है और यह विशुद्ध रूप से मैनुअल है, किसी भी कारण से बिना किसी ड्रॉप-डाउन सूचियों और टूलटिप्स (दोष यह है कि आपको यैंडेक्स.क्लाउड के समर्थन में लिखने की आवश्यकता होगी), भरें: " बकेट " - हमारे हाल ही के नाम बनाई गई बाल्टी; " वस्तु " - हमारे प्रोजेक्ट का ज़िप-संग्रह, इस बाल्टी में पड़ा हुआ; " प्रवेश बिंदु " - योजना के अनुसार: main_file_name (dot) मॉड्यूल_name । हमारा प्रवेश बिंदु index.skill होगा। और क्यों वास्तव में - इस तस्वीर से लगता है:



शेष फ़ील्ड में मान न बदलें, लेकिन इसके बजाय संस्करण बनाएँ बटन पर क्लिक करें। कुछ सेकंड में, ऑब्जेक्ट स्टोरेज से हमारा कोड यहां आयात किया जाएगा, और फ़ंक्शन बनाया जाएगा (वैसे, अब ऑब्जेक्ट स्टोरेज से ज़िप संग्रह को सुरक्षित रूप से हटाया जा सकता है, लेकिन आप इसे प्रोजेक्ट की बैकअप प्रति के रूप में भी छोड़ सकते हैं - भंडारण लागत प्रतीकात्मक है), और हम स्वचालित रूप से ब्राउज़ पृष्ठ पर पुनर्निर्देशित:



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

Yandeks.Dialogi

हम Yandex.Dialogs डेवलपर के कंसोल पर जाते हैं , एक नया कौशल बनाते हैं (लेकिन एक अलग नाम के साथ - " Bitrix विक्रेता " पहले से ही मौजूद है!), और " सेटिंग्स " टैब पर, " बैकएंड " अनुभाग में, " Yandex.Cloud " में फ़ंक्शन का चयन करें, और से ड्रॉप-डाउन सूची में, हमारे फ़ंक्शन के पहचानकर्ता का चयन करें:



हम अन्य सभी फ़ील्ड भरते हैं, सहेजते हैं, और परीक्षण टैब पर जाते हैं। यह कुछ इस तरह दिखना चाहिए:



हम अपने कौशल को मॉडरेशन के लिए भेजते हैं, फिर प्रकाशित करते हैं और इसका उपयोग करते हैं: इसे दोस्तों और संभावित ग्राहकों को दिखाएं, और सबसे महत्वपूर्ण बात - हम इस दिशा में परियोजना को और विकसित करते हैं।

निष्कर्ष

यद्यपि हमारा कौशल खुद को एक सुपर-विक्रेता कहता है, वास्तव में, विक्रेता बल्कि बेवकूफ है। उसे एक नाम दें - वह अपना अंतिम नाम पूछेगा (यह ठीक है)। आप उसे अंतिम नाम देंगे - अब वह नाम के लिए पूछेगा (लेकिन मुझे माफ कर दो, मेरे प्रिय, मैंने आपको सिर्फ आपको बुलाया है!)। यह सब इसलिए है क्योंकि वह उपयोगकर्ता से प्राप्त मध्यवर्ती जानकारी (जो कि बिट्रिक्स 24 पर भेजने से पहले), साथ ही बातचीत के संदर्भ से नहीं बचाता है । यह मेरा अगला लेख होगा। यदि दिलचस्पी है, तो साइन अप करें ताकि आप कुछ भी याद न करें। आप यहां या टेलीग्राम में सदस्यता ले सकते हैं। और मैं अपनी छुट्टी लेता हूं।

25 दिसंबर, 2019 तक अपडेट करें: लेख " एलिस को सब कुछ याद है " प्रकाशित किया गया था, जो जानकारी को संरक्षित करने और बातचीत के संदर्भ के मुद्दों को संबोधित करता है।

डोनाटा