शुरुआत करना

Integration overview

एक बैकएंड, हर प्लेटफ़ॉर्म। एक बार एम्बेड करें, और यह अपने आप अपडेट रहता है।

AskAIs एक ही बैकएंड है जिसमें जुड़ने के कई तरीके हैं। आप अपना workspace एक बार सेट अप करते हैं, फिर चैट को कहीं भी एम्बेड कर सकते हैं, किसी वेबसाइट, मोबाइल ऐप, या किसी भी backend सेवा में। आपके ग्राहक Telegram और WhatsApp जैसे इनबाउंड चैनलों से भी आपसे संपर्क कर सकते हैं। हर client और हर चैनल उसी इनबॉक्स, AI एजेंट और नॉलेज बेस से जुड़ता है।

एक बैकएंड, हर प्लेटफ़ॉर्म

आप जो भी प्लेटफ़ॉर्म इस्तेमाल करें, इंस्टॉल करना संक्षिप्त है और बातचीत, संपर्क, AI जवाब तथा सेटिंग्स सभी साझा रहती हैं। यहाँ बताया गया है कि हर प्लेटफ़ॉर्म कैसे इंस्टॉल होता है और, सबसे ज़रूरी, उसे भविष्य के अपडेट कैसे मिलते हैं:

एक नज़र में प्लेटफ़ॉर्म

प्लेटफ़ॉर्म	इंस्टॉल	यह कैसे अपडेट होता है
वेबसाइट	`<script src="…/widget.js">`	स्वचालित, हर पेज लोड पर नवीनतम संस्करण लाया जाता है
iOS (WebView)	`WebView embed`	स्वचालित, WebView नवीनतम विजेट लोड करता है
Android (WebView)	`WebView embed`	स्वचालित, WebView नवीनतम विजेट लोड करता है
Flutter (नेटिव SDK)	`pub (local package)`	SDK संस्करण बढ़ाएँ, नया ऐप बिल्ड रिलीज़ करें
React Native (WebView)	`WebView / REST`	स्वचालित, WebView नवीनतम विजेट लोड करता है
कोई भी बैकएंड	`REST API / OpenAPI`	आपकी अपनी सेवा, जब भी आप डिप्लॉय करें

क्या सभी client और चैनल एक साथ काम करते हैं?

हाँ। ये एक ही AskAIs workspace के अलग-अलग प्रवेश द्वार हैं, इसलिए ये पूरी तरह इंटरऑपरेबल हैं:

एक ही बैकएंड, एक ही app-id: हर client आपके workspace में उसी इनबॉक्स से जुड़ता है।
अलग-अलग डिवाइस पर एक ही विज़िटर: उन्हें उसी externalId से पहचानें, और वेब पर शुरू हुई चैट आपके ऐप में जारी रहती है।
सिर्फ़ एम्बेड ही नहीं, इनबाउंड चैनल भी: वेब और ऐप के विजेट के अलावा, आपके ग्राहक Telegram और WhatsApp पर भी आपसे संपर्क कर सकते हैं (दोनों एंड-टू-एंड चालू हैं), और हर संदेश उसी इनबॉक्स में पहुँचता है; X के लिए जगह भी तैयार है।
साझा कॉन्फ़िगरेशन: आपका AI एजेंट (प्लेटफ़ॉर्म-होस्टेड या आपकी अपनी की), नॉलेज बेस, व्यावसायिक घंटे, कीवर्ड जवाब और FAQ एक बार कॉन्फ़िगर किए जाते हैं और हर चैनल पर लागू होते हैं।

वेब, आधिकारिक एम्बेड (अनुशंसित)

इस एक लाइन को </body> से पहले डालें। बस इतना ही इंस्टॉलेशन है। app-id सार्वजनिक है और इसे शिप करना सुरक्षित है; इसे Settings → Inboxes से कॉपी करें।

<script src="https://singchat.org/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://singchat.org"
        async></script>

⚠️ widget.js को डाउनलोड या सेल्फ-होस्ट न करें
विजेट को हमेशा https://singchat.org/widget.js से लोड करें। अगर आप फ़ाइल को डाउनलोड करके खुद होस्ट करते हैं, या उसे अपने बंडल में कंपाइल कर लेते हैं, तो वह एक ही संस्करण पर जम जाता है, हमारे भविष्य के स्टाइल अपडेट, बग फ़िक्स और नई सुविधाएँ कभी आप तक नहीं पहुँचेंगी। singchat.org से लोड होने पर विजेट खुद-ब-खुद अपडेट होता रहता है; आपको कुछ भी बदलने की ज़रूरत नहीं।

इसे अपने पेज से नियंत्रित करें (वैकल्पिक)

स्क्रिप्ट लोड होने के बाद, एक ग्लोबल 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" });

मोबाइल ऐप: Flutter SDK या WebView एम्बेड

मोबाइल के लिए आपके पास तीन असली विकल्प हैं। पहला, नेटिव Flutter विजेट SDK एक पूरा, थीम-योग्य चैट UI देता है (फ़्लोटिंग बबल और नेटिव चैट स्क्रीन, WebView नहीं); इसे अपने pubspec में जोड़ें और रिलीज़ करें। दूसरा, iOS और Android (तथा React Native) पर आप पूरे वेब विजेट को WebView के भीतर एम्बेड कर सकते हैं, वेबसाइट जैसा ही अनुभव, और यह खुद-ब-खुद अप-टू-डेट रहता है। तीसरा, REST API को हस्ताक्षरित webhooks के साथ चलाएँ और अपना UI खुद रेंडर करें। इंस्टॉल करने के लिए iOS, Android या React Native का कोई अलग नेटिव चैट SDK नहीं है; ये ही समर्थित रास्ते हैं।

# Flutter, native chat widget (floating bubble + native chat UI, not a WebView).
# In your app's pubspec.yaml (download and unzip the SDK package first):
dependencies:
  singchat_widget:
    path: ../singchat_widget

# iOS / Android / React Native without Flutter: load the hosted web widget in a
# WKWebView / WebView (same experience as the website), or drive the REST API
# with signed webhooks and render your own chat UI.

कोई भी बैकएंड या भाषा

किसी SDK की ज़रूरत नहीं, किसी संपर्क को पहचानने और संदेश भेजने/प्राप्त करने के लिए सीधे REST API कॉल करें, और इनबाउंड इवेंट को हस्ताक्षरित webhooks से सत्यापित करें। पूरा API एक प्रकाशित OpenAPI स्पेक का पालन करता है, इसलिए आप अपनी भाषा में क्लाइंट जेनरेट कर सकते हैं या एंडपॉइंट सीधे कॉल कर सकते हैं।

# Any backend / language, talk to the REST API directly
curl -X POST https://singchat.org/api/v1/auth/identify \
  -H 'Content-Type: application/json' \
  -d '{"appId":"YOUR_APP_ID","externalId":"user_123"}'

और गहराई में जाएँ

पिछलाक्विकस्टार्ट अगलाMCP server (AI agents)