अपनी वेबसाइट में चैट जोड़ना /webchat/v1/widgets पर एक POST है, जो Top-Rated Team Website chat API में आता है: आपके संगठन की अपनी वेबसाइटों पर उसकी अपनी चैट, जिसका जवाब आपकी टीम या आपके AI एजेंट देते हैं। हर रिक्वेस्ट आपकी अपनी key को X-API-KEY हेडर में लेकर चलती है — वही key जो LinkedIn API की है — और सिर्फ़ आपकी अपनी चैट तक पहुँचती है।
यह चैट आपकी अपनी है, किसी दूसरी इनबॉक्स सेवा के पास नहीं बल्कि हमारे पास रखी जाती है: किसी विज़िटर की बातचीत सिर्फ़ आपकी key से ही पहुँच में आती है, और विज़िटरों को जवाब देने वाला AI एजेंट यह बिना किसी टूल के करता है।
रिक्वेस्ट
curl -X POST "https://top-rated.team/webchat/v1/widgets" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
न चलने पर क्या लौटता है
- 401 — key नहीं है, ग़लत है या रद्द कर दी गई है।
- 402 — प्लान का भुगतान नहीं हुआ। ट्रायल ख़त्म होने पर Top-Rated Team API योजना यही लौटाती है।
- 404 — या तो वह चीज़ है ही नहीं, या वह आपके संगठन की नहीं है। दोनों का जवाब जान-बूझकर एक ही है, ताकि id टटोली न जा सकें।
- 429 — बहुत ज़्यादा रिक्वेस्ट, या प्लेटफ़ॉर्म हमसे धीमे चलने को कह रहा है। दोबारा कोशिश करने से पहले थोड़ा इंतज़ार कीजिए।
- 502 या 503 — प्लेटफ़ॉर्म ने अभी जवाब नहीं दिया। थोड़ी देर में फिर कोशिश कीजिए।
हर एरर एक ही शक्ल का JSON है: {"type":"errors/<code>","status":<n>,"detail":"..."} — इसलिए एक ही हैंडलर सब संभाल लेता है, और detail इसी तरह लिखा गया है कि किसी इंसान को दिखाया जा सके।
इसके बजाय असिस्टेंट से कहिए
यह ऑपरेशन एक MCP टूल भी है। https://top-rated.team/webchat/mcp/<your API key> को Claude, ChatGPT या किसी भी MCP बोलने वाले असिस्टेंट में चिपकाइए और आम भाषा में जो चाहिए वह माँगिए — असिस्टेंट ख़ुद कॉल चुनेगा, id भरेगा और जवाब पढ़कर सुनाएगा। https://top-rated.team/mcp/<your API key> वाले ऑल-इन-वन एजेंट के पास भी यह है, LinkedIn API और बाकी हर चैनल के साथ।
प्रोजेक्ट रूम में
प्रोजेक्ट रूम में अपने किसी AI एजेंट के लिए “इस्तेमाल कर सकता है” के नीचे इस API के एजेंट पर टिक कीजिए, और जब भी बातचीत को ज़रूरत हो, वह “अपनी वेबसाइट में चैट जोड़ना” को टूल की तरह कॉल करता है। रूम में हर कोई देखता है कि उसने क्या माँगा और क्या लौटा। आम भाषा में कहिए; यहाँ एजेंट का नाम @scout है:
- @scout वेबसाइट चैट की वे बातचीत सूची में दीजिए जिनका अभी किसी ने जवाब नहीं दिया, और हर एक का जवाब ड्राफ़्ट कीजिए ताकि मैं उसे जाँच सकूँ।
अक्सर पूछे जाने वाले सवाल
क्या कोई AI एजेंट मेरे लिए “अपनी वेबसाइट में चैट जोड़ना” कॉल कर सकता है?
हाँ। MCP बोलने वाला कोई भी असिस्टेंट ऊपर के पते के ज़रिए कर सकता है, और प्रोजेक्ट रूम में इस API के एजेंट पर टिक वाला आपका अपना AI एजेंट भी। रूम के बिल्ट-इन एजेंट नहीं कर सकते: वे सलाह देते हैं, और उनके पास आपकी key नहीं होती।
क्या यह रूम के बाहर, मेरे अपने कोड से चलता है?
हाँ। ऊपर की रिक्वेस्ट वही ऑपरेशन है जिसे AI एजेंट के टूल कॉल करते हैं, उसी जवाब और उन्हीं एरर के साथ, और आप जिस रास्ते से भी आएँ, आपकी key उन्हीं चैनलों तक पहुँचती है।
क्या यह मेरे अपने ब्रांड वाले रूम में चलता है?
हाँ। व्हाइट-लेबल पते पर API, उसकी संदर्भिका और उसका AI एजेंट आपके प्रोडक्ट के नाम से चलते हैं, और उन्हीं नियमों के तहत उन्हीं चैनलों तक पहुँचते हैं।
क्या AI एजेंट के यह करने से पहले कोई व्यक्ति मंज़ूरी दे सकता है?
इसे AI एजेंट के निर्देशों में लिख दीजिए: वह बताए कि क्या भेजने वाला है, और रूम में किसी व्यक्ति के “जाइए” कहने तक रुके। रूम हर जवाब अपने सभी लोगों को दिखाता है, इसलिए शब्द बाहर के किसी तक पहुँचने से पहले ही दिख जाते हैं।
किस प्लान में है
Top-Rated Team API प्लान में शामिल, LinkedIn API वाली उसी key के साथ: $9 प्रति सीट प्रति माह, सौ सीट से $7। आपको उतनी सीट चाहिए जितनी इनमें से जिसकी संख्या सबसे ज़्यादा हो — LinkedIn अकाउंट, WhatsApp नंबर, X अकाउंट या इनबॉक्स अकाउंट — और 30 दिन का ट्रायल एक सीट को कवर करता है।