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