Integrations

Gmail / Outlook (OAuth) कनेक्ट करें और ईमेल सिंक करें

OAuth के माध्यम से अपने Google Workspace (Gmail) या Microsoft 365 (Outlook) खाते को कनेक्ट करें, अपने ही संगठन के OAuth ऐप का उपयोग करके, और स्वचालित रूप से ईमेल को अपने संपर्कों पर गतिविधियों के रूप में लॉग करें।

💡 पुराने ईमेल कटे हुए दिख रहे थे? कनेक्ट करने के बाद, कार्ड पर "पूरा इतिहास प्राप्त करें" पर क्लिक करें: CRM उन पुराने संदेशों का पूरा टेक्स्ट फिर से प्राप्त करता है जिनमें केवल पूर्वावलोकन रह गया था। इसे दोहराना सुरक्षित है (जो पहले से पूर्ण है उसे कभी छोटा नहीं करता)। ईमेल के अनुलग्नक भी डाउनलोड करके संग्रहित किए जाते हैं।

आप अपने Google Workspace (Gmail) या Microsoft 365 (Outlook) मेलबॉक्स को CRM से कनेक्ट कर सकते हैं। एक बार कनेक्ट होने पर, CRM आपके हाल के ईमेल पढ़ता है और, हर उस संदेश के लिए जिसका प्रेषक या प्राप्तकर्ता किसी संपर्क या लीड (ईमेल के आधार पर) से मेल खाता है, उस रिकॉर्ड की टाइमलाइन पर एक "ईमेल" गतिविधि लॉग करता है।

मॉडल BYO ("अपना खुद लाएं") है: आप अपने संगठन के अपने OAuth ऐप का उपयोग करते हैं। हम कभी भी आपके क्रेडेंशियल्स नहीं देखते और हमारी ओर से कोई लागत नहीं है। इंटीग्रेशन निष्क्रिय शुरू होता है: जब तक आप OAuth ऐप सेट अप नहीं करते और खाता कनेक्ट नहीं करते, तब तक कुछ नहीं होता।

पूर्वापेक्षाएं

एक Google Workspace (Gmail) या Microsoft 365 (Outlook) खाता। आपका सामान्य कार्य खाता ठीक है।
अपने संगठन में एक OAuth ऐप बनाने की अनुमति: Google Cloud Console (Gmail) या Azure Portal / Microsoft Entra ID (Outlook) तक पहुंच। कंपनियों में, इसके लिए आमतौर पर एक IT प्रशासक की आवश्यकता होती है।
Sellio में, सेटिंग्स → इंटीग्रेशन में ऐप क्रेडेंशियल्स सेव करने के लिए प्रशासक पहुंच (सेटिंग्स प्रबंधित करने की अनुमति)। मेलबॉक्स को स्वयं कनेक्ट करना (चरण 3) प्रत्येक उपयोगकर्ता अपने ही खाते के लिए करता है।

चरण 1: अपने संगठन का OAuth ऐप बनाएं

Google Workspace (Gmail): Google Cloud Console में, एक प्रोजेक्ट बनाएं, OAuth सहमति स्क्रीन कॉन्फ़िगर करें, Gmail API सक्षम करें और एक "OAuth client ID" क्रेडेंशियल (Web application) बनाएं। Client ID और Client Secret कॉपी करें।

Microsoft 365 (Outlook): Azure Portal में, Microsoft Entra ID → App registrations → New registration पर जाएं। "Certificates & secrets" के तहत, एक Client Secret जनरेट करें। "API permissions" के तहत, Mail.Read और User.Read डेलिगेटेड अनुमतियों के साथ Microsoft Graph जोड़ें। Client ID (Application ID) और Client Secret कॉपी करें।

💡 दोनों प्रोवाइडरों के लिए, इंटीग्रेशन कार्ड पर दिखाया गया रीडायरेक्ट URI बिल्कुल वैसा ही रजिस्टर करें (यह /api/oauth/google/callback या /api/oauth/microsoft/callback पर खत्म होता है)। यह बिल्कुल समान होना चाहिए, अन्यथा प्रोवाइडर कनेक्शन को अस्वीकार कर देगा।

चरण 2: क्रेडेंशियल्स को CRM में पेस्ट करें

सेटिंग्स → इंटीग्रेशन खोलें और "Google Workspace (Gmail)" या "Microsoft 365 (Outlook)" कार्ड ढूंढें।
दिखाया गया रीडायरेक्ट URI कॉपी करें और उसे अपने OAuth ऐप (चरण 1) में रजिस्टर करें।
Client ID और Client Secret पेस्ट करें और "ऐप क्रेडेंशियल्स सेव करें" पर क्लिक करें। Client Secret एन्क्रिप्टेड संग्रहीत होता है और कभी वापस नहीं दिखाया जाता।

चरण 3: अपना खाता कनेक्ट करें

कार्ड पर ही, "कनेक्ट करें" पर क्लिक करें। आपको प्रोवाइडर की सहमति स्क्रीन पर ले जाया जाएगा, जो पहले से ही आपके खाते में साइन इन है।
ईमेल तक पढ़ने की पहुंच को अधिकृत करें। आप CRM पर वापस लौटते हैं और अब कार्ड खाता पते के साथ "इस रूप में कनेक्टेड" दिखाता है।
अभी हाल के ईमेल खींचने के लिए "ईमेल सिंक करें" पर क्लिक करें। CRM आपको बताता है कि उसने कितने ईमेल पढ़े और कितनी गतिविधियां बनाईं।

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

सुरक्षा और गोपनीयता

एक्सेस और रीफ्रेश टोकन एन्क्रिप्टेड संग्रहीत होते हैं और कभी नहीं दिखाए जाते। एक्सेस टोकन समाप्त होने पर बिना नए लॉगिन के स्वचालित रूप से नवीनीकृत हो जाता है। ईमेल कनेक्शन आपके CRM लॉगिन से पूरी तरह अलग है: यहां कनेक्ट या डिस्कनेक्ट करने से सिस्टम में आपके साइन इन करने के तरीके में कोई बदलाव नहीं होता।

💡 पहुंच रद्द करने के लिए, कार्ड पर "डिस्कनेक्ट करें" पर क्लिक करें, और संग्रहीत टोकन हटा दिए जाते हैं। आप किसी भी समय फिर से कनेक्ट कर सकते हैं। यदि कनेक्शन समाप्त हो जाता है (उदाहरण के लिए, खाता पासवर्ड बदलने के बाद), "फिर से कनेक्ट करें" का उपयोग करें।

Example: रजिस्टर करने के लिए रीडायरेक्ट URI: https://app.yourcompany.com/api/oauth/google/callback (Google) या https://app.yourcompany.com/api/oauth/microsoft/callback (Microsoft)।

कैसे परीक्षण करें

कनेक्ट करने के बाद (चरण 3), पुष्टि करें कि कार्ड सही पते के साथ "इस रूप में कनेक्टेड" दिखाता है।
"ईमेल सिंक करें" पर क्लिक करें। CRM आपको बताता है कि उसने कितने ईमेल पढ़े और कितनी गतिविधियां बनाईं।
एक ऐसा संपर्क या लीड खोलें जिसके साथ आपने हाल ही में ईमेल का आदान-प्रदान किया है और टाइमलाइन जांचें: "ईमेल" प्रकार की एक गतिविधि दिखाई देनी चाहिए।

समस्या निवारण

"redirect_uri_mismatch" त्रुटि या प्रोवाइडर कनेक्शन अस्वीकार करता है: OAuth ऐप में रजिस्टर किया गया रीडायरेक्ट URI कार्ड पर दिखाए गए से अलग है। इसे फिर से कॉपी करें और बिल्कुल वैसा ही पेस्ट करें (समान डोमेन, समान ट्रेलिंग स्लैश)।
कनेक्ट करते समय 401/invalid_client: गलत Client ID या Client Secret। कार्ड पर क्रेडेंशियल्स फिर से दर्ज करें (Secret सर्वर से कभी वापस नहीं आता, इसलिए इसे पूरा फिर से पेस्ट करें)।
कनेक्ट होता है, लेकिन गतिविधियां नहीं बनाता: ईमेल तभी गतिविधियां बनते हैं जब प्रेषक/प्राप्तकर्ता ईमेल फ़ील्ड के आधार पर किसी संपर्क या लीड से मेल खाता है। बिना मिलान वाले ईमेल अनदेखा कर दिए जाते हैं, इसलिए ईमेल को रिकॉर्ड में जोड़ें।
"पहुंच अस्वीकृत" / सहमति स्क्रीन अवरुद्ध: Google पर, OAuth सहमति स्क्रीन प्रकाशित करें (या उपयोगकर्ता को टेस्टर के रूप में जोड़ें); Azure पर, अनुमतियों को एडमिन सहमति दें।
कनेक्शन काम करना बंद हो गया (उदाहरण के लिए, खाता पासवर्ड बदलने के बाद): सहमति फिर से करने और टोकन नवीनीकृत करने के लिए कार्ड पर "फिर से कनेक्ट करें" पर क्लिक करें।

Open this article inside the system →