शुरुआत करना
Integration overview
एक बैकएंड, हर प्लेटफ़ॉर्म — एक बार एम्बेड करें, और यह अपने आप अपडेट रहता है।
AskAIs Customer Service एक ही बैकएंड है जिसके साथ कई client SDK उपलब्ध हैं। आप अपना workspace एक बार सेट अप करते हैं, फिर चैट को कहीं भी एम्बेड कर सकते हैं — किसी वेबसाइट, मोबाइल ऐप, या किसी भी backend सेवा में। हर client उसी इनबॉक्स, AI एजेंट और नॉलेज बेस से जुड़ता है।
एक बैकएंड, हर प्लेटफ़ॉर्म
आप जो भी प्लेटफ़ॉर्म इस्तेमाल करें, इंस्टॉल करना संक्षिप्त है और बातचीत, संपर्क, AI जवाब तथा सेटिंग्स सभी साझा रहती हैं। यहाँ बताया गया है कि हर प्लेटफ़ॉर्म कैसे इंस्टॉल होता है और — सबसे ज़रूरी — उसे भविष्य के अपडेट कैसे मिलते हैं:
एक नज़र में प्लेटफ़ॉर्म
| प्लेटफ़ॉर्म | इंस्टॉल | यह कैसे अपडेट होता है |
|---|---|---|
| वेबसाइट | <script src="…/widget.js"> | स्वचालित — हर पेज लोड पर नवीनतम संस्करण लाया जाता है |
| iOS (Swift) | Swift Package / CocoaPods | SDK संस्करण बढ़ाएँ, नया ऐप बिल्ड रिलीज़ करें |
| Android (Kotlin) | Gradle | SDK संस्करण बढ़ाएँ, नया ऐप बिल्ड रिलीज़ करें |
| Flutter | pub | SDK संस्करण बढ़ाएँ, नया ऐप बिल्ड रिलीज़ करें |
| React Native | npm | SDK संस्करण बढ़ाएँ, नया ऐप बिल्ड रिलीज़ करें |
| कोई भी बैकएंड | REST API / OpenAPI | आपकी अपनी सेवा — जब भी आप डिप्लॉय करें |
क्या सभी SDK संगत हैं?
हाँ। ये एक ही AskAIs Customer Service workspace के अलग-अलग प्रवेश द्वार हैं, इसलिए ये पूरी तरह इंटरऑपरेबल हैं:
- एक ही बैकएंड, एक ही app-id: हर client आपके workspace में उसी इनबॉक्स से जुड़ता है।
- अलग-अलग डिवाइस पर एक ही विज़िटर: उन्हें उसी externalId से पहचानें, और वेब पर शुरू हुई चैट आपके ऐप में जारी रहती है।
- साझा कॉन्फ़िगरेशन: आपका AI एजेंट, नॉलेज बेस, व्यावसायिक घंटे, कीवर्ड जवाब और FAQ एक बार कॉन्फ़िगर किए जाते हैं और हर चैनल पर लागू होते हैं।
वेब — आधिकारिक एम्बेड (अनुशंसित)
इस एक लाइन को </body> से पहले डालें। बस इतना ही इंस्टॉलेशन है। app-id सार्वजनिक है और इसे शिप करना सुरक्षित है; इसे Settings → Inboxes से कॉपी करें।
<script src="https://cs.askais.com/widget.js"
data-app-id="YOUR_APP_ID"
data-base-url="https://cs.askais.com"
async></script>⚠️ widget.js को डाउनलोड या सेल्फ-होस्ट न करें
विजेट को हमेशा https://cs.askais.com/widget.js से लोड करें। अगर आप फ़ाइल को डाउनलोड करके खुद होस्ट करते हैं, या उसे अपने बंडल में कंपाइल कर लेते हैं, तो वह एक ही संस्करण पर जम जाता है — हमारे भविष्य के स्टाइल अपडेट, बग फ़िक्स और नई सुविधाएँ कभी आप तक नहीं पहुँचेंगी। cs.askais.com से लोड होने पर विजेट खुद-ब-खुद अपडेट होता रहता है; आपको कुछ भी बदलने की ज़रूरत नहीं।
इसे अपने पेज से नियंत्रित करें (वैकल्पिक)
स्क्रिप्ट लोड होने के बाद, एक ग्लोबल window.SingChat उपलब्ध हो जाता है:
// Open / close the widget
window.SingChat.open();
window.SingChat.close();
// Identify a logged-in user (so chats follow them across devices)
window.SingChat.identify({ externalId: "user_123", name: "Ada", email: "ada@acme.com" });मोबाइल ऐप (iOS / Android / Flutter / React Native)
नेटिव SDK आपके ऐप में कंपाइल किए जाते हैं, इसलिए वे वेब विजेट की तरह अपने आप अपडेट नहीं होते। नया संस्करण पाने के लिए, अपने पैकेज मैनेजर में SDK संस्करण बढ़ाएँ और नया ऐप बिल्ड रिलीज़ करें। हर जगह init का सिद्धांत एक जैसा है — https://cs.askais.com की ओर पॉइंट करें और अपने app-id से पहचानें:
// Swift Package Manager
.package(url: "https://github.com/singlink/singlink-ios", from: "0.1.0")
let client = SingChatClient(baseURL: "https://cs.askais.com")
try await client.identify(.deviceAnonymous(appId: "YOUR_APP_ID"))कोई भी बैकएंड या भाषा
किसी SDK की ज़रूरत नहीं — किसी संपर्क को पहचानने और संदेश भेजने/प्राप्त करने के लिए सीधे REST API कॉल करें। हम अपने OpenAPI स्पेक से 30+ भाषाओं के लिए जेनरेट किए गए SDK भी प्रकाशित करते हैं।
# Any backend / language — talk to the REST API directly
curl -X POST https://cs.askais.com/api/v1/auth/identify \
-H 'Content-Type: application/json' \
-d '{"appId":"YOUR_APP_ID","externalId":"user_123"}'