डॉक्युमेंटेशन

ॲप्स आणि इंटिग्रेशन

तुमची टीम आधीच वापरत असलेली साधने जोडा — 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 की किंवा टोकन पेस्ट करा. मूल्ये आपोआप trim होतात — कॉपी-पेस्टमधून आलेला शेवटचा स्पेस किंवा नवी ओळ इन्स्टॉल बिघडवणार नाही.
3. जतन करा आणि चाचणी घ्याजतन केल्याने कॉन्फिगरेशन साठवले जाते; कनेक्शनची चाचणी व्हेंडरला खरा कॉल करते आणि त्यानेच स्टेटस-चिप हिरवी होते.

प्रत्येक ॲप टाइलवर इन्स्टॉलेशन कुठे आहे हे सांगणारी स्टेटस-चिप असते:

स्थितीअर्थ
Not testedक्रेडेन्शियल साठवली आहेत, पण ॲपने अजून एकाही खऱ्या रिक्वेस्टला उत्तर दिलेले नाही.
Connectedव्हेंडरने प्रत्यक्ष उत्तर दिले आहे — कनेक्शन केवळ जतन केलेले नाही, तर पडताळलेले आहे.
Needs attentionव्हेंडरने साठवलेली क्रेडेन्शियल नाकारली (रद्द केलेली किंवा कालबाह्य की). ॲडमिन ॲप जतन किंवा पुन्हा चाचणी करेपर्यंत कार्डे व्हेंडरला कॉल करणे थांबवतात.
Errorदुसरे काहीतरी बिघडले — टूलटिप पाहा.
Disabledॲडमिनने ॲप बंद केले. क्रेडेन्शियल न पुसता कार्ड इनबॉक्समधून नाहीसे होते.

क्रेडेन्शियल आणि सुरक्षा#

ॲप क्रेडेन्शियल वर्कस्पेसची असतात, आणि काही नियम ती सुरक्षित ठेवतात:

  • साठवणीत एन्क्रिप्टेड. गुप्त फील्ड (API की, टोकन) साठवणीत प्रति-की एन्क्रिप्ट होतात आणि जतन केल्यानंतर पुन्हा कधीही दाखवली जात नाहीत.
  • व्हेंडर परवानगी देतो तिथे किमान अधिकार. Stripe ला Customers, Subscriptions, Charges आणि Invoices वाचू शकणाऱ्या restricted की-ने जोडावे — आणि ऑपरेटरना संभाषणातून रिफंड करता यावेत तेव्हाच Refunds ची write-परवानगी द्यावी. पूर्ण अधिकाराची की पेस्ट केली तरी ती चालते, पण सेटिंग्ज पान ती बदलण्याचा सल्ला देईल.
  • गंतव्य बदलल्यास सीक्रेट पुन्हा मागितले जाते. क्रेडेन्शियल ज्याच्याशी बांधलेले आहे ते फील्ड — Shopify स्टोअरचे डोमेन, Jira साइटची URL — संपादित करताना टोकन पुन्हा टाकावे लागते, म्हणजे जतन केलेले क्रेडेन्शियल कधीही भलत्याच होस्टकडे वळवता येत नाही.
  • रद्द करण्याचा परिणाम संपूर्ण वर्कस्पेसवर होतो. प्रति ॲप प्रति वर्कस्पेस एकच इन्स्टॉलेशन असते: व्हेंडरकडे की फिरवली किंवा रद्द केली, तर ॲडमिन ती Settings → Apps मध्ये अपडेट करेपर्यंत प्रत्येक सहकाऱ्याचे कार्ड बंद पडते.

इनबॉक्समधली ॲप कार्डे#

इन्स्टॉल झाल्यावर प्रत्येक ॲप इनबॉक्सच्या संभाषण-तपशील पॅनेलमध्ये विजेट म्हणून दिसते. संभाषण उघडताच व्हेंडरकडून लाइव्ह कार्ड आणले जाते: हा ग्राहक Stripe मध्ये कोण आहे, त्याच्या अलीकडच्या Shopify ऑर्डर, त्याची न्यूजलेटर स्थिती, थ्रेडशी जोडलेले Jira इश्यू, किंवा अभ्यागताबद्दल Tracio चा निर्णय. बहुतेक कार्डे व्हेंडरच्या स्वतःच्या डॅशबोर्डमधल्या संबंधित नोंदीची लिंकही देतात — Tracio चा निर्णय मात्र पूर्णपणे पॅनेलमध्येच राहतो.

दाखवण्यासारखे काही नसेल तर कार्डे ते प्रामाणिकपणे सांगतात. ग्राहक सापडला नाही — किंवा संभाषणाला वापरण्याजोगी ओळख नाही — तर रिकामा चौकोन दाखवण्याऐवजी कार्ड तसे का ते स्पष्ट करते. प्रतिसाद थोडा वेळ कॅश होतात आणि प्रति ॲप रेट-बजेट असते, त्यामुळे उघडा इनबॉक्स व्हेंडरच्या API मर्यादा संपवत नाही.

कार्डे पडताळलेल्या ओळखीलाच धरून चालतात#

Stripe, Shopify, Mailchimp आणि MailerLite ग्राहकाला ईमेल पत्त्यावरून शोधतात — आणि तोही प्रत्यक्ष पडताळलेला पत्ताच: विजेटच्या सही केलेल्या ओळखीने (ओळख पडताळणी) कव्हर केलेला, किंवा ईमेल-चॅनेल संभाषणाचा From पत्ता. अभ्यागताने चॅटमध्ये नुसता टाइप केलेला पत्ता शोधासाठी अजिबात वापरला जात नाही — नाहीतर कोणीही खऱ्या ग्राहकाचा ईमेल टाइप करून त्याचा पेमेंट इतिहास पाहू शकले असते. अशा वेळी कार्ड सांगते की या पत्त्यामागे पडताळलेली ओळख नाही.

Jira आणि Tracio ईमेलवर अवलंबून नाहीत — Jira कार्डे संभाषणाशी जोडलेल्या इश्यूंची असतात, आणि Tracio विजेट-अभ्यागताचे — त्यामुळे पडताळलेला पत्ता नसतानाही ती चालतात.

संभाषणाच्या स्वतःच्या पत्त्यावर काही सापडले नाही, तर Respondo संपर्काचा दुसरा ज्ञात पत्ताही वापरून पाहते (उदा. संपर्क विलीन झाल्यानंतर), आणि कोणता पत्ता वापरला ते कार्डावर नोंदवते.

प्रत्येक ॲप काय दाखवते#

Stripe#

ग्राहकाच्या बिलिंगमध्ये फक्त-वाचनाची खिडकी: नाव, ईमेल, खात्याची शिल्लक आणि कॉपी करता येणारा customer 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 आहे — तिथे ती क्षमता मुळात अस्तित्वात आहे की नाही हे टॉगल ठरवतो, आणि तो बंद केल्यावर वर्कस्पेसच्या मालकासह सर्वांना ती बंद होते.

Tracio: माणूस की बॉट#

Tracio चॅट-विजेटच्या अभ्यागताबद्दल एकाच प्रश्नाचे उत्तर देते: हा माणूस आहे की बॉट? ॲप इन्स्टॉल केल्याने तुमच्या Respondo चॅट विजेटमध्ये Tracio चे डिटेक्शन SDK सक्रिय होते — नव्या विजेट-संभाषणांना आपोआप निर्णय मिळतो, जो संभाषण पॅनेलमधल्या Tracio कार्डावर चिप म्हणून दिसतो.

चिपअर्थ
HumanTracio च्या सर्व्हर-साइड तपासणीला या अभ्यागतासाठी बॉटची कोणतीही चिन्हे आढळली नाहीत.
Bot · 93%बॉट आढळला, Tracio च्या विश्वासार्हतेसह. निर्णयामागची चिन्हेही कार्ड दाखवते.
UncheckedTracio ची सर्व्हर-साइड तपासणी सध्या उपलब्ध नाही — कार्ड ब्राउझरने कळवलेल्या निर्णयावर परतते आणि तसे सांगते.
Forged IDब्राउझरने पाठवलेला visitor 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 नाही: एकदा unsubscribe झाल्यावर फक्त ती व्यक्ती स्वतःच साइनअप फॉर्मद्वारे परत येऊ शकते. तो प्रवाह महत्त्वाचा असेल तर MailerLite चे resubscribe वापरा.
  • Tracio चे निर्णय फक्त SDK लोड झालेल्या विजेट-संभाषणांसाठी असतात — ईमेल किंवा मेसेंजर चॅनेलसाठी कधीही नाही.