तकनीकी दस्तावेज़

आर्किटेक्चर ओवरव्यू

• क्रॉल — sitemap और आंतरिक लिंक का पालन करते हुए आपके डोमेन के पेज लाता है
• रेंडर — JavaScript‑heavy पेजों को एक्सट्रैक्शन से पहले रेंडर करता है
• एक्सट्रैक्ट — स्ट्रक्चर्ड डेटा सहित कंटेंट निकालता है
• चंक — कंटेंट को अर्थपूर्ण चंक्स में विभाजित करता है
• एम्बेड — चंक्स को वेक्टर एम्बेडिंग्स में बदलता है
• इंडेक्स — रिट्रीवल के लिए एम्बेडिंग्स स्टोर करता है
• रिट्रीव — सेमांटिक समानता से प्रासंगिक चंक्स लाता है
• जेनरेट — रिट्रीव्ड कंटेंट से उत्तर बनाता है
• साइट — संबंधित कंटेंट मिलने पर स्रोत पेज लिंक करता है

क्रॉलिंग

हम क्या क्रॉल करते हैं

• sitemap या आंतरिक लिंक से HTML पेज
• स्ट्रक्चर्ड डेटा (JSON‑LD, schema.org)
• मैन्युअल अपलोड किए गए डॉक्यूमेंट (PDF, HTML, DOCX)

क्रॉल व्यवहार

• robots.txt का सम्मान करता है
• User‑Agent पहचाना गया है
• सर्वर लोड से बचने के लिए रेट‑लिमिट
• 429 या 5xx पर बैक‑ऑफ

JavaScript रेंडरिंग — SPA और डायनेमिक कंटेंट के लिए एक्सट्रैक्शन से पहले हेडलेस ब्राउज़र से रेंडर।

री‑इंडेक्सिंग

• sitemap मॉनिटरिंग ऑटो री‑इंडेक्स ट्रिगर करती है
• मैन्युअल री‑इंडेक्स कभी भी उपलब्ध
• प्लान के अनुसार शेड्यूल्ड री‑इंडेक्सिंग

रिट्रीवल

सेमांटिक सर्च क्वेरीज़ को एम्बेडिंग्स में बदला जाता है और कीवर्ड्स के बजाय सेमांटिक समानता से मैच किया जाता है।

रिलेवेंस थ्रेशहोल्ड्स कॉन्फ़िगरेबल। ऊँचा थ्रेशहोल्ड = कम लेकिन अधिक भरोसेमंद जवाब। नीचा थ्रेशहोल्ड = अधिक कवरेज और अधिक स्पष्टता सवाल।

उत्तर निर्माण

रिट्रीव्ड कंटेंट को मॉडल के संदर्भ के रूप में दिया जाता है। जवाब केवल उसी संदर्भ से बनाए जाते हैं।

स्रोत उद्धरण — संबंधित कंटेंट मिलने पर जवाब में स्रोत पेज का लिंक होता है। अनिश्चितता मानने पर स्रोत न होने से उद्धरण नहीं हो सकता।

सीमा व्यवहार

• जो नहीं जानता, उसे स्वीकार करता है
• स्पष्टीकरण के लिए सवाल पूछता है
• संबंधित विषय सुझाता है

एंबेड इंटीग्रेशन

इंस्टॉलेशन एक सिंगल स्क्रिप्ट स्निपेट। असिंक लोड होता है।

अनुकूलता

• WordPress
• Webflow
• Shopify
• Squarespace
• कस्टम बिल्ड्स
• SPA (React, Vue, Angular)

डैशबोर्ड के जरिए कॉन्फ़िगरेशन

• रंग, लोगो, प्लेसमेंट
• स्वागत संदेश, टोन
• भाषा सेटिंग्स
• रिलेवेंस थ्रेशहोल्ड्स

पब्लिक API

टिकट और एक्शन के लिए सुरक्षित, टेनेंट‑स्कोप्ड API एक्सेस।

प्रमाणीकरण और एक्सेस

• `X-Api-Key` हेडर में API key भेजें।
• Admin → API keys में keys बनाएं/रद्द करें; प्रति इंटीग्रेशन एक key रखें।
• Keys टेनेंट‑स्कोप्ड होती हैं और scopes के जरिए least‑privilege लागू होता है।

Scopes

• `support.read` — tickets, messages, actions सूची/प्राप्त करें।
• `support.write` — tickets create/update करें और messages जोड़ें।
• `support.actions` — actions चलाएं और status देखें।

मुख्य endpoints

• `/api/v1/public/tickets` — tickets सूची/बनाएं।
• `/api/v1/public/tickets/{ticket_id}` — ticket विवरण लें/अपडेट करें।
• `/api/v1/public/tickets/{ticket_id}/messages` — messages सूची/जोड़ें।
• `/api/v1/public/tickets/{ticket_id}/actions` — ticket पर action चलाएं।
• `/api/v1/public/actions` — actions सूची/स्टेटस देखें।

Response फॉर्मेट

• JSON responses; timestamps RFC 3339 में।
• Errors `{ error: { type, message, code } }` लौटाते हैं।
• List endpoints `limit` और `page_token` स्वीकारते हैं।

Channel values

• `web`, `email`, `sms`, `whatsapp`, `social`, `voice`, `custom`.
• External conversations के लिए `channel_id` और `channel_thread_id` का उपयोग करें।
• Message writes को de-duplicate करने के लिए `external_message_id` उपयोग करें।

Zapier सेटअप

Controlled surface के साथ Zapier से no-code automation जोड़ें।

Outbound automation (Threada → Zapier)

• Webhooks by Zapier का “Catch Hook” trigger वाला Zap बनाएं और hook URL कॉपी करें।
• Admin → Support → Integrations में Zapier integration जोड़ें, webhook URL और optional secret header सेट करें।
• Payloads भेजने के लिए Custom HTTP action उपयोग करें; यदि Custom HTTP integration चयनित नहीं है, तो डिफ़ॉल्ट रूप से Zapier उपयोग होता है।

Inbound automation (Zapier → Threada)

• Zapier के लिए scoped API key बनाएं (least privilege)।
• Tickets और actions के Public API endpoints कॉल करने के लिए Webhooks by Zapier इस्तेमाल करें।
• Key को Zapier में सुरक्षित रूप से रखें और नियमित रूप से rotate करें।

Enterprise hygiene

• Environment के हिसाब से keys अलग रखें (production vs. sandbox)।
• Zap disable होने या ownership बदलने पर keys revoke करें।
• जब तक automation को write न करना हो, read-only scopes prefer करें।

सुरक्षा

होस्टिंग: GCP, डिफ़ॉल्ट US‑Central1। एन्क्रिप्शन: ट्रांज़िट में TLS 1.2+, रेस्ट में AES‑256। ऑथेंटिकेशन: Enterprise में OIDC/SAML SSO। कंप्लायंस: GDPR‑aligned, कॉन्फ़िगरेबल रिटेंशन, ऑडिट लॉग्स। थ्रेट मॉडल prompt injection, XSS, SSRF और डेटा एक्सफ़िल्ट्रेशन कवर करता है।

डेटा हैंडलिंग

स्टोर किया जाता है

• इंडेक्स्ड कंटेंट
• एम्बेडिंग्स
• चैट लॉग्स
• एनालिटिक्स
• कॉन्फ़िगरेशन

स्टोर नहीं किया जाता

• पेमेंट जानकारी (प्रोसेसर द्वारा हैंडल होती है)
• सादा‑टेक्स्ट क्रेडेंशियल्स

रिटेंशन टेनेंट के अनुसार कॉन्फ़िगरेबल। रिक्वेस्ट पर डिलीशन उपलब्ध।

ट्रेनिंग आपका कंटेंट AI मॉडल्स को ट्रेन करने के लिए इस्तेमाल नहीं होता।