ChatWoot इनबॉक्स की सूची /chatwoot/v1/connections/{connection_id}/inboxes पर एक GET है, जो Top-Rated Team ChatWoot API में आता है: वह ChatWoot जिससे आपका संगठन पहले से अपने ग्राहकों को जवाब देता है, अपने सर्वर या अपने क्लाउड खाते पर। हर रिक्वेस्ट आपकी अपनी key को X-API-KEY हेडर में लेकर चलती है — वही key जो LinkedIn API की है — और सिर्फ़ उसी ChatWoot तक पहुँचती है जिसे आपके संगठन ने जोड़ा है।
यह आपका अपना ChatWoot है, उस पते पर जो किसी सदस्य ने लिखा था, और कॉल उस टोकन से की जाती हैं जो उसने पेस्ट किया था — इसलिए ChatWoot सब कुछ उसी उपयोगकर्ता के नाम से दर्ज करता है, और प्रोजेक्ट रूम भी इसी कनेक्शन से बोलता है।
रिक्वेस्ट
curl -X GET "https://top-rated.team/chatwoot/v1/connections/$CONNECTION_ID/inboxes" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
पाथ में क्या जाता है
- connection_id — इसी परिवार की किसी पिछली कॉल से लौटी हुई id।
न चलने पर क्या लौटता है
- 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/chatwoot/mcp/<your API key> को Claude, ChatGPT या किसी भी MCP बोलने वाले असिस्टेंट में चिपकाइए और आम भाषा में जो चाहिए वह माँगिए — असिस्टेंट ख़ुद कॉल चुनेगा, id भरेगा और जवाब पढ़कर सुनाएगा। https://top-rated.team/mcp/<your API key> वाले ऑल-इन-वन एजेंट के पास भी यह है, LinkedIn API और बाकी हर चैनल के साथ।
प्रोजेक्ट रूम में
प्रोजेक्ट रूम में अपने किसी AI एजेंट के लिए “इस्तेमाल कर सकता है” के नीचे इस API के एजेंट पर टिक कीजिए, और जब भी बातचीत को ज़रूरत हो, वह “ChatWoot इनबॉक्स की सूची” को टूल की तरह कॉल करता है। रूम में हर कोई देखता है कि उसने क्या माँगा और क्या लौटा। आम भाषा में कहिए; यहाँ एजेंट का नाम @scout है:
- @scout कल की वे ChatWoot बातचीतें बताइए जो अब भी खुली हैं, और हर एक के लिए जवाब का मसौदा बनाइए ताकि मैं उसे जाँच सकूँ।
अक्सर पूछे जाने वाले सवाल
क्या कोई AI एजेंट मेरे लिए “ChatWoot इनबॉक्स की सूची” कॉल कर सकता है?
हाँ। MCP बोलने वाला कोई भी असिस्टेंट ऊपर के पते के ज़रिए कर सकता है, और प्रोजेक्ट रूम में इस API के एजेंट पर टिक वाला आपका अपना AI एजेंट भी। रूम के बिल्ट-इन एजेंट नहीं कर सकते: वे सलाह देते हैं, और उनके पास आपकी key नहीं होती।
क्या यह रूम के बाहर, मेरे अपने कोड से चलता है?
हाँ। ऊपर की रिक्वेस्ट वही ऑपरेशन है जिसे AI एजेंट के टूल कॉल करते हैं, उसी जवाब और उन्हीं एरर के साथ, और आप जिस रास्ते से भी आएँ, आपकी key उन्हीं चैनलों तक पहुँचती है।
क्या यह मेरे अपने ब्रांड वाले रूम में चलता है?
हाँ। व्हाइट-लेबल पते पर API, उसकी संदर्भिका और उसका AI एजेंट आपके प्रोडक्ट के नाम से चलते हैं, और उन्हीं नियमों के तहत उन्हीं चैनलों तक पहुँचते हैं।
किस प्लान में है
Top-Rated Team API प्लान में शामिल, LinkedIn API वाली उसी key के साथ: $9 प्रति सीट प्रति माह, सौ सीट से $7। आपको उतनी सीट चाहिए जितनी इनमें से जिसकी संख्या सबसे ज़्यादा हो — LinkedIn अकाउंट, WhatsApp नंबर, X अकाउंट या इनबॉक्स अकाउंट — और 30 दिन का ट्रायल एक सीट को कवर करता है।