Integration overview

AskAIs Customer Service ایک ہی بیک اینڈ ہے جس کے ساتھ کئی کلائنٹ SDK جُڑے ہیں۔ آپ اپنا ورک اسپیس ایک بار سیٹ اپ کرتے ہیں، پھر چیٹ کو کہیں بھی ایمبیڈ کر سکتے ہیں — کسی ویب سائٹ، موبائل ایپ، یا کسی بھی بیک اینڈ سروس میں۔ ہر کلائنٹ اسی ایک inbox، AI ایجنٹ، اور نالج بیس سے بات کرتا ہے۔

ایک بیک اینڈ، ہر پلیٹ فارم

آپ جو بھی پلیٹ فارم استعمال کریں، انسٹال مختصر ہوتا ہے اور گفتگو، کانٹیکٹ، AI جوابات، اور سیٹنگز سب کے درمیان مشترک رہتی ہیں۔ یہاں دیکھیں کہ ہر پلیٹ فارم کیسے انسٹال ہوتا ہے اور — جو اہم بات ہے — مستقبل کے اپڈیٹس اسے کیسے ملتے ہیں:

پلیٹ فارمز ایک نظر میں

کیا تمام SDK ایک دوسرے کے ساتھ ہم آہنگ ہیں؟

جی ہاں۔ یہ ایک ہی AskAIs Customer Service ورک اسپیس کے مختلف دروازے ہیں، اس لیے یہ مکمل طور پر باہم قابلِ عمل ہیں:

• ایک ہی بیک اینڈ، ایک ہی app-id: ہر کلائنٹ آپ کے ورک اسپیس کے اسی inbox سے جُڑتا ہے۔
• متعدد ڈیوائسز پر ایک ہی وزیٹر: انہیں اسی externalId سے شناخت کریں، اور ویب پر شروع ہونے والی چیٹ آپ کی ایپ میں جاری رہتی ہے۔
• مشترکہ کنفیگریشن: آپ کا AI ایجنٹ، نالج بیس، کاروباری اوقات، کی ورڈ جوابات اور FAQs ایک بار کنفیگر کیے جاتے ہیں اور ہر چینل پر لاگو ہوتے ہیں۔

ویب — آفیشل ایمبیڈ (تجویز کردہ)

یہ ایک لائن </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"}'

مزید گہرائی میں جائیں

• ویب ویجٹ — مکمل ریفرنس (ایونٹس، تھیمنگ، سیکیورٹی)
• موبائل SDK — iOS، Android، Flutter، React Native
• تمام SDK اور کوڈ جنریشن
• REST API ریفرنس