दस्तावेज़

ऐप्स और इंटीग्रेशन

उन टूल्स को कनेक्ट करें जिन्हें आपकी टीम पहले से इस्तेमाल करती है — Stripe, Shopify, Mailchimp, MailerLite, Jira और Tracio। इंस्टॉल किए गए ऐप्स इनबॉक्स के बातचीत पैनल में, चैट के ठीक बगल में, लाइव ग्राहक डेटा कार्ड के रूप में दिखाते हैं।

अवलोकन#

ऐप मार्केटप्लेस Settings → Apps पर है। ऐप्स एक बार, पूरे वर्कस्पेस के लिए इंस्टॉल होते हैं: एक एडमिन सेवा को वर्कस्पेस के अपने क्रेडेंशियल से कनेक्ट करता है, और इनबॉक्स पहुँच वाला हर टीम-मेंबर बातचीत पैनल में परिणामी कार्ड देखता है। एजेंट खुद कुछ भी इंस्टॉल नहीं करते — और AI एजेंट भी कभी कुछ इंस्टॉल नहीं करते।

वर्कस्पेस-स्तरीय इंस्टॉल

प्रति वर्कस्पेस क्रेडेंशियल का एक सेट। ऐप को इंस्टॉल, संपादित या हटाने का असर सब पर एक साथ पड़ता है।

इनबॉक्स में कार्ड

हर इंस्टॉल किया गया ऐप बातचीत पैनल में उस व्यक्ति के लाइव डेटा वाला एक कार्ड बनाता है जिससे आप बात कर रहे हैं।

कोई फ़िलर नहीं

कैटलॉग में सूचीबद्ध हर चीज़ आज ही इंस्टॉल की जा सकती है — कोई "जल्द आ रहा है" सेक्शन नहीं है। एक रिक्वेस्ट टाइल से आप बता सकते हैं कि कौन-सी सेवा गायब है।

ऐप्स प्रबंधित करने के लिए Install and configure apps अनुमति चाहिए (डिफ़ॉल्ट रूप से Owner और Admin भूमिकाओं में शामिल, और कस्टम भूमिकाओं को दी जा सकती है)। इसके बिना टीम-मेंबर बातचीत में ऐप कार्ड फिर भी देखते हैं — बस वे कुछ इंस्टॉल या रीकॉन्फ़िगर नहीं कर सकते।

ऐप कैटलॉग#

आज छह ऐप्स उपलब्ध हैं:

ऐपश्रेणीएजेंट बातचीत में क्या देखते हैं
Stripeपेमेंटजिस व्यक्ति से आप बात कर रहे हैं उसकी सब्सक्रिप्शन और हाल की पेमेंट
Shopifyकॉमर्सपेमेंट और फ़ुलफ़िलमेंट स्थिति के साथ हाल के ऑर्डर
Mailchimpमार्केटिंगजिस व्यक्ति से आप बात कर रहे हैं उसकी सब्सक्रिप्शन स्थिति, ऑडियंस और टैग
MailerLiteमार्केटिंगजिस व्यक्ति से आप बात कर रहे हैं उसकी सब्सक्रिप्शन स्थिति, ग्रुप और साइनअप तारीख़
Jiraइश्यू ट्रैकिंगइस बातचीत से जुड़े इश्यू, और एक क्लिक में नया इश्यू बनाना
Tracioसुरक्षाइंसान या बॉट: चैट-विजेट विज़िटर पर Tracio का फ़ैसला

अपने बैक-ऑफ़िस में सिर्फ़ एक सादा लिंक चाहिए? उसके लिए न अकाउंट चाहिए न टोकन, इसलिए वह ऐप कैटलॉग की बजाय Settings → General → Links to your systems में रहता है।

ऐप इंस्टॉल करना#

Settings → Apps खोलें, एक टाइल चुनें, और ऐप जो क्रेडेंशियल माँगे उन्हें भरें। हर फ़ील्ड वेंडर के डैशबोर्ड में ठीक उसी पेज से लिंक होता है जहाँ वह मान बनाया या पाया जाता है।

चरणविवरण
1. प्रीव्यू देखेंकुछ भी पेस्ट करने से पहले, कॉन्फ़िगरेशन पेज ठीक उसी कार्ड का नमूना दिखाता है जो आपके एजेंट देखेंगे — काल्पनिक डेटा से बना, ताकि क्रेडेंशियल सेव होने से पहले ही आपको पता हो कि आप वर्कस्पेस के साथ क्या साझा कर रहे हैं।
2. क्रेडेंशियल दर्ज करेंAPI कुंजी या टोकन पेस्ट करें। मान अपने आप ट्रिम हो जाते हैं — कॉपी-पेस्ट से आया आख़िरी स्पेस या न्यूलाइन इंस्टॉल नहीं तोड़ेगा।
3. सेव और टेस्टसेव करने से कॉन्फ़िगरेशन संग्रहीत होता है; कनेक्शन टेस्ट करने से वेंडर को असली कॉल जाती है और यही स्टेटस चिप को हरा करता है।

हर ऐप टाइल पर एक स्टेटस चिप होती है जो बताती है कि इंस्टॉलेशन किस स्थिति में है:

स्थितिअर्थ
Not testedक्रेडेंशियल सेव हैं, लेकिन ऐप ने अभी किसी असली अनुरोध का जवाब नहीं दिया।
Connectedवेंडर ने वास्तव में जवाब दिया है — कनेक्शन सत्यापित है, सिर्फ़ सेव नहीं।
Needs attentionवेंडर ने सेव किए गए क्रेडेंशियल अस्वीकार कर दिए (रद्द या एक्सपायर्ड कुंजी)। जब तक कोई एडमिन ऐप को सेव या री-टेस्ट नहीं करता, कार्ड वेंडर को कॉल करना बंद कर देते हैं।
Errorकुछ और विफल हुआ — टूलटिप देखें।
Disabledकिसी एडमिन ने ऐप बंद कर दिया। कार्ड इनबॉक्स से ग़ायब हो जाता है, क्रेडेंशियल डिलीट नहीं होते।

क्रेडेंशियल और सुरक्षा#

ऐप क्रेडेंशियल वर्कस्पेस के होते हैं, और कुछ नियम उन्हें सुरक्षित रखते हैं:

  • स्टोरेज में एन्क्रिप्टेड। गुप्त फ़ील्ड (API कुंजियाँ, टोकन) स्टोरेज में प्रति-कुंजी एन्क्रिप्ट होते हैं और सेव होने के बाद कभी वापस नहीं दिखाए जाते।
  • जहाँ वेंडर अनुमति दे, वहाँ न्यूनतम विशेषाधिकार। Stripe को एक प्रतिबंधित कुंजी से कनेक्ट करना चाहिए जो Customers, Subscriptions, Charges और Invoices पढ़ सके — और Refunds पर write एक्सेस केवल तभी जब एजेंटों को बातचीत से रिफ़ंड करना हो। फ़ुल-एक्सेस कुंजी पेस्ट करने पर भी सब चलेगा, लेकिन सेटिंग्स पेज उसे बदलने की सलाह देगा।
  • गंतव्य बदलने पर सीक्रेट दोबारा माँगा जाता है। जिस फ़ील्ड से क्रेडेंशियल बंधा है — Shopify स्टोर डोमेन, Jira साइट URL — उसे संपादित करने पर टोकन फिर से दर्ज करना पड़ता है, ताकि सेव किया गया क्रेडेंशियल कभी ऐसे होस्ट पर न मोड़ा जा सके जिसके लिए वह नहीं था।
  • रद्द करने का असर पूरे वर्कस्पेस पर। प्रति ऐप प्रति वर्कस्पेस एक ही इंस्टॉलेशन है: वेंडर पर कुंजी रोटेट या रद्द करने पर हर टीम-मेंबर का कार्ड तब तक काम करना बंद कर देता है जब तक कोई एडमिन Settings → Apps में उसे अपडेट नहीं करता।

इनबॉक्स में ऐप कार्ड#

इंस्टॉल होने के बाद हर ऐप इनबॉक्स के बातचीत विवरण पैनल में एक विजेट के रूप में दिखता है। बातचीत खोलने पर वेंडर से एक लाइव कार्ड आता है: Stripe में यह ग्राहक कौन है, उसके हाल के Shopify ऑर्डर, उसकी न्यूज़लेटर स्थिति, थ्रेड से जुड़े Jira इश्यू, या विज़िटर पर Tracio का फ़ैसला। अधिकांश कार्ड वेंडर के अपने डैशबोर्ड में मिलते-जुलते रिकॉर्ड से भी लिंक करते हैं — Tracio का फ़ैसला पूरी तरह पैनल में ही रहता है।

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

कार्ड सत्यापित पहचान का पालन करते हैं#

Stripe, Shopify, Mailchimp और MailerLite ग्राहक को ईमेल पते से खोजते हैं — और केवल ऐसे पते से जो वास्तव में सत्यापित हो: विजेट की हस्ताक्षरित पहचान (पहचान सत्यापन) से कवर किया गया पता, या ईमेल-चैनल बातचीत का From पता। विज़िटर द्वारा चैट में सिर्फ़ टाइप किया गया पता खोज के लिए बिल्कुल इस्तेमाल नहीं होता — वरना कोई भी किसी असली ग्राहक का ईमेल टाइप करके उसका पेमेंट इतिहास देख सकता। उस स्थिति में कार्ड समझाता है कि पता किसी सत्यापित पहचान से समर्थित नहीं है।

Jira और Tracio ईमेल पर आधारित नहीं हैं — Jira कार्ड बातचीत से लिंक किए गए इश्यू के होते हैं, और Tracio विजेट विज़िटर का — इसलिए वे तब भी काम करते हैं जब कोई सत्यापित पता मौजूद न हो।

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

हर ऐप क्या दिखाता है#

Stripe#

ग्राहक की बिलिंग में केवल-पढ़ने वाली खिड़की: नाम, ईमेल, अकाउंट बैलेंस, कॉपी करने योग्य ग्राहक ID, साथ ही सब्सक्रिप्शन — स्टेटस बैज, प्लान, मासिक राशि और शुरुआत की तारीख़ — और इनवॉइस नंबरों के साथ हाल की पेमेंट। रिफ़ंड इकलौता वैकल्पिक write है: एडमिन को ऐप की सेटिंग्स में Allow refunds from the conversation panel चालू करना होता है (डिफ़ॉल्ट रूप से बंद), ऑपरेटर के पास Run refunds and cancellations अनुमति होनी चाहिए, और हर रिफ़ंड की पुष्टि REFUND टाइप करके करनी होती है — भेजा गया रिफ़ंड Stripe वापस नहीं ले सकता।

Shopify#

केवल-पढ़ने योग्य हाल के ऑर्डर — ऑर्डर नंबर, तारीख़, कुल राशि, पेमेंट और फ़ुलफ़िलमेंट स्थिति — हर ऑर्डर और आपके Shopify एडमिन में ग्राहक रिकॉर्ड के लिंक के साथ। आपके स्टोर डोमेन और read_customers तथा read_orders स्कोप वाले कस्टम ऐप के Admin API टोकन से कनेक्ट होता है।

Mailchimp#

सब्सक्राइबर वैसा जैसा Mailchimp उसे देखता है: स्टेटस बैज, ऑडियंस, टैग, एंगेजमेंट और हाल की कैंपेन गतिविधि (भेजे गए, खोले गए, क्लिक)। एक ही एक्शन उपलब्ध है: Unsubscribe, बातचीत छोड़े बिना "मुझे ईमेल भेजना बंद करो" अनुरोध पूरा करने के लिए। API के ज़रिए यह अपरिवर्तनीय है — Mailchimp व्यक्ति को केवल खुद साइनअप फ़ॉर्म से वापस ऑप्ट-इन करने देता है — इसलिए इसके लिए टाइप की गई पुष्टि चाहिए। ध्यान दें कि Mailchimp API कुंजियाँ स्कोप्ड नहीं हैं: जो कुंजी आप कनेक्ट करते हैं वह अकाउंट में सब कुछ पढ़-लिख सकती है।

MailerLite#

सब्सक्रिप्शन स्थिति, ग्रुप, साइनअप तारीख़, एंगेजमेंट और हाल की कैंपेन गतिविधि। दो एक्शन: Unsubscribe (पूर्ववत करने योग्य — MailerLite का API री-सब्सक्राइब करना सपोर्ट करता है) और Resubscribe, किसी को उसके अपने अनुरोध पर सूची में वापस डालने के लिए।

Jira#

बातचीत और Jira Cloud इश्यू के बीच दो-तरफ़ा लिंक। कार्ड इस बातचीत से जुड़े इश्यू उनकी वर्तमान स्थिति के साथ सूचीबद्ध करता है, और Create issue (आपके चुने प्रोजेक्ट में दर्ज, अपने आप लिंक) तथा पहले से मौजूद इश्यू के लिए Link existing / Unlink देता है। Jira में किए गए स्टेटस बदलाव वेबहुक से वापस आते हैं: ऐप का सेटिंग्स पेज एक गुप्त वेबहुक पता दिखाता है जिसे आपकी Jira साइट में पेस्ट करना है, और उसके बाद कार्ड इश्यू की लाइव स्थिति दिखाता है। इश्यू उसी Atlassian अकाउंट के नाम से बनते हैं जिसे आप कनेक्ट करते हैं, और कार्ड ठीक वही देखता है जो वह अकाउंट देखता है।

पैनल से चलाया गया हर एक्शन भूमिका अनुमतियों से नियंत्रित है — unsubscribe, resubscribe और Jira इश्यू के लिए Use app actions, और रिफ़ंड के लिए Run refunds and cancellations। जहाँ ऐप वर्कस्पेस-स्तरीय क्षमता टॉगल भी देता है — आज वह Stripe का Allow refunds from the conversation panel है — वहाँ टॉगल तय करता है कि क्षमता मौजूद है या नहीं, और उसे बंद करने पर सब ब्लॉक हो जाते हैं, वर्कस्पेस Owner भी।

Tracio: इंसान या बॉट#

Tracio चैट-विजेट विज़िटर के बारे में एक सवाल का जवाब देता है: यह इंसान है या बॉट? ऐप इंस्टॉल करने से आपके Respondo चैट विजेट के अंदर Tracio का डिटेक्शन SDK सक्रिय हो जाता है — नई विजेट बातचीतों को अपने आप फ़ैसला मिलता है, जो बातचीत पैनल के Tracio कार्ड पर चिप के रूप में दिखता है।

चिपअर्थ
HumanTracio की सर्वर-साइड जाँच को इस विज़िटर के लिए कोई बॉट संकेत नहीं मिले।
Bot · 93%बॉट का पता चला, Tracio के आत्मविश्वास के साथ। कार्ड फ़ैसले के पीछे के संकेत भी सूचीबद्ध करता है।
UncheckedTracio की सर्वर-साइड जाँच अभी उपलब्ध नहीं है — कार्ड ब्राउज़र द्वारा बताए फ़ैसले पर लौट आता है और यह बात कहता है।
Forged IDब्राउज़र ने जो विज़िटर ID भेजा वह Tracio के लिए अज्ञात है — दावा जाली लगता है।

दो कुंजियाँ कनेक्ट होती हैं: एक सार्वजनिक कुंजी जो विजेट में SDK सक्रिय करती है, और एक गुप्त Data API कुंजी जो फ़ैसले की सर्वर-साइड जाँच के लिए है। सर्वर-साइड जाँच के बिना ब्राउज़र के "बॉट नहीं है" दावे पर अकेले भरोसा नहीं किया जा सकता — और जब ब्राउज़र का दावा सर्वर के फ़ैसले से असहमत होता है, तो कार्ड दोनों दिखाता है।

Tracio केवल चैट-विजेट बातचीतों के लिए काम करता है। ईमेल, Telegram और अन्य चैनलों में जाँचने के लिए कोई विज़िटर नहीं है, इसलिए उनका Tracio कार्ड समझाता है कि जाँचने को कुछ नहीं है। फ़ैसले का न होना संदेह नहीं है: विज्ञापन ब्लॉकर असली इंसानों के लिए SDK हमेशा काटते रहते हैं, और Tracio कनेक्ट होने से पहले शुरू हुई पुरानी बातचीतों में भी कोई फ़ैसला नहीं होता।
Tracio SDK आपकी साइट के विज़िटर्स का फ़िंगरप्रिंट बनाता है। विज़िटर की सहमति (आपके CMP / कुकी बैनर के ज़रिए) लेना साइट मालिक के तौर पर आपकी ज़िम्मेदारी है।

सीमाएँ#

  • Stripe और Shopify कार्ड केवल-पढ़ने योग्य हैं — Stripe ऐप में कहीं भी इकलौता write वैकल्पिक, स्पष्ट रूप से सक्षम किया गया रिफ़ंड एक्शन है।
  • ईमेल-आधारित ऐप्स (Stripe, Shopify, Mailchimp, MailerLite) को सत्यापित ईमेल पता चाहिए। अनाम विजेट विज़िटर्स या बिना पते वाले चैनलों की बातचीतों में ईमानदार "खोजने को कुछ नहीं" कार्ड दिखता है।
  • Jira सपोर्ट केवल Jira Cloud को कवर करता है।
  • Mailchimp में resubscribe नहीं है: एक बार अनसब्सक्राइब होने पर केवल व्यक्ति खुद साइनअप फ़ॉर्म से वापस ऑप्ट-इन कर सकता है। अगर यह फ़्लो आपके लिए मायने रखता है तो MailerLite का resubscribe इस्तेमाल करें।
  • Tracio के फ़ैसले केवल SDK लोड हुई विजेट बातचीतों के लिए मौजूद हैं — ईमेल या मैसेंजर चैनलों के लिए कभी नहीं।