Bitrix24 प्लगइन

Bitrix24 प्लगइन आपके एजेंट को Bitrix24 से एक आंतरिक कर्मचारी तात्कालिक संदेश चैनल के रूप में जोड़ता है। स्टाफ एजेंट को उसी तरह संदेश भेजते हैं जैसे वे किसी सहकर्मी को संदेश भेजते हैं, और एजेंट Bitrix24 की चैट के अंदर जवाब देता है।

[!WARNING] बिट्रिक्स24 यहाँ एक है आंतरिक कर्मचारी आईएम चैनल — जैसे Telegram या Slack कर्मचारियों के लिए। यह है नहीं ग्राहक ऑमनिचैनल: कोई खुली लाइनें नहीं हैं, नहीं टिकट कतार और कोई ऑपरेटर वृद्धि नहीं। इस प्लगइन का उपयोग आगे करने के लिए न करें ग्राहक सहायता लाइन।

प्लगइन होस्ट-नेटिव पर चलता है और गेटवे से बात करता है aihummer.connector.v1 सहमति पत्र। अंतिम-उपयोगकर्ता चैनल का व्यवहार चैनल पृष्ठ पर है बिट्रिक्स24; यह पृष्ठ प्लगइन को ही कवर करता है।

नीचे दिया मीडिया और साझा OAuth व्यवहार हस्ताक्षरित Core 1.4.15 तथा कैटलॉग में अलग से प्रकाशित, हस्ताक्षरित और अपडेट किए गए कनेक्टर 1.1.1 पर निर्भर है। इंस्टॉल किया गया 1.1.0 इन सुविधाओं की उपलब्धता की पुष्टि नहीं करता।

तथ्य

मैदान	मूल्य
संस्करण	1.1.1
बंदरगाह	8810
रनटाइम	होस्ट-नेटिव

यह क्या है

Bitrix24 चैट और AiHummer के बीच एक दो-तरफ़ा पुल। एजेंट ऐसे दिखाई देता है जैसे मानव-समान पहचान Bitrix24 में — प्रत्येक एजेंट अपनी खुद की OAuth पहचान के साथ प्रमाणित होता है, किसी सामान्य बॉट खाते के बजाय — इसलिए बातचीत ऐसा लगता है जैसे किसी सहकर्मी से बात कर रहे हों। पहुँच संगठन के अनुसार होती है विभाग-ट्री ACL, इसलिए एक एजेंट की पहुँच आपके Bitrix24 संरचना का सम्मान करती है।

पोर्टल के समर्पित उपयोगकर्ता BITRIX24_AGENT_USER_IDS और पोर्टल BITRIX24_PORTAL में सेट करें। विभाग के अनुसार रूटिंग कर्मचारियों की पहुँच सीमित करती है; एजेंट का खाता कार्य आरंभ करने वाले व्यक्ति की जगह नहीं लेता। मौजूदा वैकल्पिक स्वचालित प्रावधान BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD इस्तेमाल करता है।

इन संस्करणों में BITRIX24_VAULT_CONNECTIONS मालिक के स्वामित्व वाला मौजूदा, वैध, स्वायत्त OAuth क्रेडेंशियल चुनता है। समर्थित नेटिव वॉल्ट/कनेक्शन प्रबंधन इस्तेमाल करें; टूल बाइंडिंग में उसी क्रेडेंशियल ID का पुनः उपयोग करें। वास्तविक मालिक चालू कनेक्टर को उसके कार्यक्षेत्र में समर्पित connection-token कुंजी से /v1/admin/connections/channel पर पंजीकृत करता है। एजेंट उपयोगकर्ता ID के अनुसार endpoint और apiKey को गोपनीय BITRIX24_VAULT_CONNECTIONS सेटिंग में रखें; एजेंट प्रोफ़ाइल या प्रॉम्प्ट में कभी न रखें। केवल वॉल्ट टोकन रीफ़्रेश करता है; टूल आरंभकर्ता और साझाकरण की जाँच करते हैं। देखें OAuth2।

यह कैसे इस्तेमाल किया जाता है

इनबाउंड: पोलर संदेश पढ़ता है। मीडिया वास्तविक बाइट के रूप में डाउनलोड होकर /v1/inbound/media से पंजीकृत होता है; एजेंट को केवल URL या फ़ाइल विवरण नहीं, media_id मिलता है।
आउटबाउंड: Deliver Markdown को BB-code में बदलकर वास्तविक बाइट im.v2.File.upload से अपलोड करता है। मीडिया पुष्टि के लिए वास्तविक FILE_ID और संदेश ID चाहिए; पाठ या लिंक फ़ाइल की रसीद नहीं है।

अपडेट के दौरान स्थायी डिलीवरी जर्नल रखें। पुष्ट ऑपरेशन दोहराने पर पिछली रसीद मिलती है। आंशिक या अज्ञात प्रभाव अपने आप दोबारा नहीं भेजे जाते; पुनः प्रयास से पहले जाँचें।

employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24

संपूर्ण सुविधाएँ

प्रतिक्रियाएँ और @-उल्लेख।
खाता और प्रदाता im.dialog.writing तथा REPLY_ID समर्थन करें तो टाइपिंग संकेत और जवाब।
ऊपर दिए संस्करणों की आवश्यकताओं के साथ आने वाले चित्र, ऑडियो, आवाज़ और फ़ाइलें।
संदेश संपादन/हटाना केवल अलग बॉट पहचान वाले पुराने एकीकरणों के लिए; सामान्य OAuth उपयोगकर्ताओं के लिए ये क्षमताएँ घोषित नहीं हैं।

सीमाएँ

[!WARNING] इंटरैक्टिव कीबोर्ड, बटन और थ्रेड समर्थित नहीं हैं।

बनी या तैयार फ़ाइल पुष्ट डिलीवरी नहीं है। आंशिक, विफल और अज्ञात परिणाम दिखाई देते रहने चाहिए।

स्थापना

व्यवस्थापक UI में मार्केटप्लेस से एक क्लिक में Bitrix24 इंस्टॉल करें। होस्ट-नेटिव डिप्लॉयर प्लगइन डाउनलोड करता है, इसका इंस्टॉल स्टेप चलाता है, एक सैंडबॉक्स्ड सिस्टमडी यूनिट रेंडर करता है और इसे तैयार घोषित करने से पहले स्वास्थ्य की प्रतीक्षा करता है — देखें स्थापित करें और अपडेट. फिर आप प्रत्येक एजेंट की OAuth पहचान को जोड़ते हैं और विभाग-ट्री ACL को मैप करते हैं।

सुरक्षा और सीमाएँ

केवल आंतरिक कर्मचारी IM — ग्राहक ओम्नीचैनल नहीं।
प्रति-एजेंट मानव-समान OAuth पहचान — एजेंट सामान्य बॉट खाते नहीं हैं।
विभाग-ट्री एसीएल — आपकी संगठन संरचना का सम्मान करता है।
होस्ट-नेटिव — सिस्टमड के अंतर्गत चलता है, कंटेनर में नहीं।