सामग्री पर जाएँ
AI-SNS.IO — CHAT SUPPORTAI-SNS.IO — CHAT SUPPORT
AI SNS CHAT का उपयोग

REST API से AI SNS CHAT को अपने सिस्टम से जोड़ें

AI SNS CHAT संपादकीय टीमप्रकाशित 7 मिनट में पढ़ें

REST API कब चुनें, API key और webhook कैसे सुरक्षित रखें, rate limits का ध्यान कैसे रखें और live करने से पहले क्या जाँचें, सब सरल भाषा में।

मान लीजिए आपका अपना ऑर्डर सिस्टम, CRM या मोबाइल ऐप है और आप चाहते हैं कि AI agent उससे सीधे बात करे। कई टीमें ऐसे में कस्टम कोड लिखने बैठ जाती हैं, जबकि कई बार बिना कोड वाला रास्ता पहले से मौजूद होता है। इस लेख में आप समझेंगे कि REST API कब सही चुनाव है, उसके मुख्य हिस्से कौन से हैं, और live करने से पहले किन बातों की जाँच ज़रूरी है।

API कब सही औज़ार है (और कब नहीं)

API एक "कस्टम रास्ता" है। यह तब काम आता है जब तैयार चैनल या इंटीग्रेशन आपकी ज़रूरत पूरी न करें। हर समस्या के लिए इसे उठाना ज़रूरी नहीं है।

API तब चुनें जब:

  • आपको अपने ही ऐप या पोर्टल के अंदर चैट का अपना इंटरफ़ेस बनाना हो।
  • आपके आंतरिक सिस्टम (जैसे ERP या अपना बनाया CRM) के साथ चैट डेटा का लेन-देन करना हो।
  • किसी चैट घटना पर आपके सर्वर को तुरंत सूचना चाहिए, यानी webhook।
  • जवाब को शब्द-दर-शब्द अपनी स्क्रीन पर दिखाना हो।

API की ज़रूरत नहीं जब:

  • आप बस वेबसाइट पर chat widget लगाना चाहते हैं।
  • आपको WhatsApp, Instagram या Messenger पर agent चलाना है। ये चैनल पहले से बने हैं।
  • आपको Shopify, Slack, Google Sheets जैसे टूल से जोड़ना है। इनके लिए बने-बनाए Actions और connectors हैं।
बिल्ट-इन चैनल / Actions
कस्टम REST API
WhatsApp, Instagram, वेबसाइट widget
अपने ऐप में अपना चैट इंटरफ़ेस
Shopify, Slack, Google Sheets जैसे टूल
अपने आंतरिक सिस्टम से सीधा लेन-देन
डैशबोर्ड से सेटअप, कोड की ज़रूरत नहीं
डेवलपर चाहिए, टेस्टिंग आपकी ज़िम्मेदारी
जल्दी live, कम रखरखाव
ज़्यादा लचीलापन, ज़्यादा ज़िम्मेदारी
बिल्ट-इन रास्ता या कस्टम API?उदाहरण के लिए

बुनियादी हिस्से

AI SNS CHAT का public API JSON पर चलने वाला REST API है। इसके तीन मुख्य हिस्से समझ लेना काफ़ी है।

1. API key

Key आपकी पहचान है। यह Workspace settings → API keys में बनती है। ध्यान रखें:

  • Key बनते समय सिर्फ़ एक बार दिखती है, इसलिए तुरंत सुरक्षित जगह पर रख लें।
  • ज़रूरत पड़ने पर key को revoke (रद्द) किया जा सकता है।
  • API keys के लिए Hobby या उससे ऊपर का प्लान चाहिए।

2. JSON अनुरोध और SSE streaming

अनुरोध और जवाब JSON में होते हैं। जब आप stream=1 देते हैं, तो जवाब SSE (Server-Sent Events) के रूप में टुकड़ों में आता है। इससे आपके ऐप में टेक्स्ट वैसे ही उभरता है जैसे ChatGPT जैसे इंटरफ़ेस में। लंबे जवाबों में यूज़र को खाली स्क्रीन नहीं देखनी पड़ती।

3. Webhook और delivery log

जब कुछ होता है, तो AI SNS CHAT आपके सर्वर को सूचना भेज सकता है। ये webhooks HMAC से signed होते हैं, यानी आप जाँच सकते हैं कि संदेश सच में हमारी तरफ़ से आया है। एक delivery log भी मिलता है, जिसमें देख सकते हैं कि कौन सा webhook गया और कैसा रहा। endpoints और fields की पूरी जानकारी API reference पेज पर है। उसी को अंतिम स्रोत मानें।

Published rate limits का सम्मान करें

API reference में ये सीमाएँ प्रकाशित हैं:

क्षेत्रसीमा
Auth20 अनुरोध प्रति 5 मिनट, प्रति IP
Public chat30 प्रति मिनट, प्रति IP
Poll120 प्रति मिनट

इनसे जुड़ी कुछ व्यावहारिक बातें:

  • सीमा IP के हिसाब से है। अगर आपके सारे यूज़र का ट्रैफ़िक एक ही सर्वर से गुज़रता है, तो वे सब एक ही IP की सीमा साझा कर सकते हैं। डिज़ाइन करते समय यह ध्यान रखें।
  • बार-बार login न करें। एक बार authenticate करके उसका दोबारा इस्तेमाल करें, ताकि 20 प्रति 5 मिनट की सीमा न टूटे।
  • Polling की जगह जहाँ हो सके webhook या streaming लें। हर सेकंड पूछते रहने से सीमा जल्दी भरती है।
  • सीमा पार होने पर retry धीरे-धीरे करें। तुरंत दोबारा भेजने से हालत और बिगड़ती है। हर बार थोड़ा ज़्यादा इंतज़ार करें (exponential backoff)।

एक काल्पनिक उदाहरण: अगर आपकी साइट पर एक साथ 50 लोग चैट शुरू करें और सब अनुरोध एक ही सर्वर IP से जाएँ, तो 30 प्रति मिनट की सीमा जल्दी छू जाएगी। ऐसे में अनुरोधों को कतार (queue) में लगाना बेहतर रहता है।

डिज़ाइन पैटर्न जो काम करते हैं

पैटर्न 1: अपना चैट इंटरफ़ेस

आपका ऐप यूज़र का संदेश आपके बैकएंड को भेजता है। बैकएंड API key के साथ AI SNS CHAT को अनुरोध करता है और stream=1 से जवाब को वापस ऐप तक पहुँचाता है।

पैटर्न 2: घटना पर कार्रवाई

कोई चैट घटना होती है, AI SNS CHAT आपके endpoint पर webhook भेजता है, आपका सर्वर signature जाँचता है और फिर आपके सिस्टम में रिकॉर्ड बनाता या अपडेट करता है।

  1. 01आपका ऐप या वेबसाइट
  2. 02आपका बैकएंड (API key यहीं रहती है)
  3. 03AI SNS CHAT REST API
  4. 04Webhook से आपके सिस्टम में अपडेट
कस्टम इंटीग्रेशन कैसे जुड़ता हैउदाहरण के लिए

पैटर्न 3: key कभी ब्राउज़र में नहीं

API key हमेशा सर्वर पर रखें। अगर key ब्राउज़र या मोबाइल ऐप के कोड में डाल दी, तो कोई भी उसे निकाल सकता है। बीच में अपना छोटा बैकएंड रखें, चाहे वह कितना भी सरल हो।

पैटर्न 4: Idempotent हैंडलर

Webhook कभी-कभी दोबारा आ सकता है, जैसे नेटवर्क की गड़बड़ी के बाद retry में। आपका कोड ऐसा हो कि एक ही घटना दो बार आने पर दो ऑर्डर या दो लीड न बनें। हर घटना की पहचान सहेजें और देख लें कि पहले प्रोसेस हुई है या नहीं।

Live करने से पहले सुरक्षा की जाँच-सूची

  • [ ] API key सिर्फ़ सर्वर-साइड secret manager या environment variable में है, कोड या Git में नहीं।
  • [ ] हर environment (टेस्ट और प्रोडक्शन) के लिए अलग key है।
  • [ ] हर webhook पर HMAC signature जाँचा जाता है। गलत signature वाला अनुरोध तुरंत अस्वीकार हो।
  • [ ] Webhook endpoint सिर्फ़ HTTPS पर है।
  • [ ] लॉग में key या ग्राहक की निजी जानकारी (फ़ोन नंबर, पता) सीधे नहीं छपती।
  • [ ] Key लीक होने का शक हो तो उसे तुरंत revoke करने और नई बनाने की प्रक्रिया तय है।
  • [ ] टीम छोड़ चुके लोगों की पहुँच हटाई जा चुकी है। Workspace settings → Activity में देखा जा सकता है कि किसने क्या बदला।
  • [ ] सारे अनुरोध rate limits के भीतर रहने के लिए retry और queue की व्यवस्था है।

कंपनी की सुरक्षा पद्धतियों की जानकारी सुरक्षा पेज पर है। हमारी पद्धतियाँ GDPR और APPI को ध्यान में रखकर बनाई गई हैं। साइट साफ़ बताती है कि हमारे पास SOC 2, ISO 27001 या HIPAA प्रमाणन नहीं है। अगर आपके ग्राहक को इनमें से कोई प्रमाणन चाहिए, तो यह पहले ही जान लें।

टेस्टिंग और रोलआउट

सीधे सारे ग्राहकों पर चालू करने से बचें। यह क्रम आज़माएँ:

  1. पहले Playground में agent का व्यवहार परखें। जवाब ठीक न हों तो API जोड़ने से कुछ नहीं सुधरेगा।
  2. अलग टेस्ट key बनाएँ और सिर्फ़ अपनी टीम के लोगों के साथ जाँचें।
  3. Webhook का पूरा रास्ता टेस्ट करें, यानी सही signature, गलत signature और दोबारा आया हुआ संदेश। Delivery log में हर बार देखें कि क्या हुआ।
  4. Rate limit की स्थिति बनाकर देखें: जानबूझकर ज़्यादा अनुरोध भेजें और देखें कि आपका कोड चुपचाप फेल होता है या ठीक से retry करता है।
  5. छोटे हिस्से से शुरू करें, जैसे सिर्फ़ 10% यूज़र या एक ही पेज, फिर धीरे-धीरे बढ़ाएँ।
  6. पहले हफ़्ते Activity → Chat logs देखते रहें। वहाँ ग्राहकों की बातचीत, ratings और flag किए गए चैट दिखते हैं।

एक काल्पनिक उदाहरण: अगर एक छोटी दुकान को महीने में 300 चैट मिलती हैं, तो रोलआउट के पहले हफ़्ते में लगभग 70 चैट आएँगी। इतनी संख्या हाथ से पढ़कर देखी जा सकती है। इसलिए शुरुआत में हर चैट पढ़ना व्यावहारिक है।

AI SNS CHAT में यह कैसे करें

चरण 1: प्लान जाँचें। API keys के लिए Hobby या उससे ऊपर का प्लान चाहिए। Free प्लान पर key नहीं बनेगी। प्लान की तुलना कीमत पेज पर देखें।

चरण 2: key बनाएँ। Workspace settings → API keys पर जाएँ और नई key बनाएँ। वह सिर्फ़ एक बार दिखेगी, इसलिए तुरंत सुरक्षित जगह रखें। बाद में ज़रूरत हो तो इसी जगह से उसे revoke कर सकते हैं।

चरण 3: API reference पढ़ें। endpoints, अनुरोध का रूप, stream=1 से streaming और webhook के signature की जाँच का तरीका वहीं दिया है। इस लेख में जानबूझकर विवरण नहीं दोहराए गए, ताकि आप हमेशा ताज़ा दस्तावेज़ देखें।

चरण 4: पहले बिना कोड वाले रास्ते देखें। Sidebar → Channels में Chat widget, WhatsApp, Instagram, Messenger, Slack, Telegram, Zapier और कई अन्य विकल्प हैं, और एक "API" विकल्प भी है। सभी चैनलों की सूची connections पेज और features पेज पर है। अगर आपका काम इनसे हो जाए, तो कस्टम कोड की ज़रूरत नहीं।

चरण 5: ज़रूरत हो तो Actions आज़माएँ। Integrations में Custom actions, Collect leads, Stripe, Shopify, Slack, Cal, Calendly जैसे तैयार Actions हैं। साथ में लगभग 50 read-only lookup tools हैं, जैसे HubSpot, Google Sheets, Zoho CRM और WooCommerce। ये भी Hobby या उससे ऊपर के प्लान पर मिलते हैं, और हर प्लान पर प्रति agent Actions की सीमा अलग है।

चरण 6: अपने डोमेन पर चलाएँ। अगर चैट आपके ब्रांड के डोमेन पर दिखानी हो, तो Agent → Settings → Custom domains में subdomain का CNAME जोड़ें। DNS जाँच से यह verify होता है और embed script, iframe और agent link, तीनों पर लागू होता है। इसके लिए भी Hobby या उससे ऊपर का प्लान चाहिए।

चरण 7: Synthia से मदद लें। डैशबोर्ड में कहीं अटकें तो Synthia से पूछ सकते हैं। वह स्क्रीन तक ले जाकर सही बटन को highlight कर देती है।

अक्सर पूछे जाने वाले प्रश्न

REST API इस्तेमाल करने के लिए कौन सा प्लान चाहिए?

API keys Hobby या उससे ऊपर के प्लान पर मिलती हैं। Free प्लान पर key नहीं बनती। Key Workspace settings → API keys में बनती है, सिर्फ़ एक बार दिखती है और revoke की जा सकती है।

क्या मैं जवाब को अपने इंटरफ़ेस में streaming से दिखा सकता हूँ?

हाँ। API में stream=1 देने पर जवाब SSE के रूप में टुकड़ों में आता है, जिसे आप अपने ऐप में शब्द-दर-शब्द दिखा सकते हैं। अपनी key को ब्राउज़र में न रखें, बीच में अपना बैकएंड रखें।

कैसे पता चले कि webhook सच में AI SNS CHAT से आया है?

Webhooks HMAC से signed होते हैं। आपके सर्वर को हर अनुरोध पर signature जाँचना चाहिए और गलत signature वाले अनुरोध अस्वीकार करने चाहिए। जाँच का सही तरीका API reference में है, और delivery log में देख सकते हैं कि कौन से webhook भेजे गए।

Rate limits क्या हैं?

प्रकाशित सीमाएँ ये हैं: auth के लिए प्रति IP 5 मिनट में 20 अनुरोध, public chat के लिए प्रति IP 30 प्रति मिनट, और poll के लिए 120 प्रति मिनट। अनुरोधों को queue में रखें और सीमा पार होने पर धीरे-धीरे retry करें।

क्या WhatsApp या Messenger पर agent लगाने के लिए API ज़रूरी है?

नहीं। WhatsApp, Messenger और Instagram Sidebar → Channels में बने-बनाए चैनल हैं। API की ज़रूरत तब पड़ती है जब आपको अपना खुद का इंटरफ़ेस या अपने सिस्टम से सीधा जुड़ाव बनाना हो।

#REST API#webhook#इंटीग्रेशन#AI chatbot#ऑटोमेशन

AI SNS CHAT के साथ इसे आज़माएँ

अपनी सामग्री पर प्रशिक्षित AI एजेंट बनाएँ और उसे अपनी वेबसाइट, WhatsApp, LINE और अन्य चैनलों से जोड़ें। शुरुआत मुफ़्त, क्रेडिट कार्ड की ज़रूरत नहीं।