SosoAPI सेटअप गाइड

शुरुआती बिंदु चुनें

SosoAPI आपके मौजूदा एजेंट को सोशल खातों का एक कनेक्शन देता है। एजेंट सामग्री लिखने और समीक्षा में मदद करता है; SosoAPI समर्थित खाता ऑपरेशन, शेड्यूलिंग और प्रकाशन परिणाम संभालता है। वही पोस्ट ऐप में जाँच सकते हैं या अपने कोड से API उपयोग कर सकते हैं।

यह गाइड एक व्यक्ति और एक सोशल खाते से शुरू होती है। आप स्थानीय या होस्टेड MCP क्लाइंट जोड़ेंगे, पहुँच चुनेंगे, सोशल खाता जाँचेंगे, पोस्ट तैयार और मंज़ूर करके उसका वास्तविक परिणाम पढ़ेंगे। उन्नत मार्गदर्शन में CLI और HTTP API हैं। सेटअप के लिए टेस्ट पोस्ट ज़रूरी नहीं।

• Claude Code या Codex से सेटअप कराएँ: चरण 1
• MCP क्लाइंट खुद कॉन्फ़िगर करें: चरण 3
• टर्मिनल या बैकएंड उपयोग करें: चरण 9
• कनेक्शन सुधारें: चरण 10

शुरू करने से पहले

आपको MCP-संगत AI क्लाइंट, SosoAPI खाता और प्रबंधन की अनुमति वाला सोशल खाता चाहिए। साइन-इन खुलने पर SosoAPI खाता बना सकते हैं। वास्तविक सामग्री का एक विचार तैयार रखें।

स्थानीय MCP को npm/npx सहित Node.js 20 या नया और चुना AI क्लाइंट चाहिए। होस्टेड MCP को रिमोट MCP, OAuth और स्वचालित क्लाइंट पंजीकरण समर्थित क्लाइंट चाहिए; स्थानीय Node.js इंस्टॉलेशन नहीं। क्लाइंट सुविधाएँ उसके प्लान और प्रशासक सेटिंग पर निर्भर हो सकती हैं।

SosoAPI, Instagram, Threads, Facebook Pages, YouTube और X जोड़ता है। ऐसा खाता चुनें जिसका प्रकार, अनुमतियाँ और पोस्ट फ़ॉर्मैट आपके काम से मेल खाएँ। पात्र Threads खाता केवल टेक्स्ट का पहला उपयोगी उदाहरण है। Instagram और YouTube को अपने समर्थित प्रकाशन फ़ॉर्मैट के लिए उचित मीडिया चाहिए। कनेक्शन मेनू में प्लेटफ़ॉर्म होने से हर खाते पर हर कार्रवाई उपलब्ध नहीं हो जाती।

सेटअप में खाते-विशिष्ट क्षमताएँ जाँचें। बैच शेड्यूल करने से पहले ऐप में वर्तमान प्लान और कोटा पढ़ें; X का अलग Organization क्रेडिट भत्ता है। एक प्लेटफ़ॉर्म का उदाहरण दूसरे पर समर्थन सिद्ध नहीं करता।

• समर्थित प्लेटफ़ॉर्म
• प्रकाशन क्षमताएँ और खाते की आवश्यकताएँ

1. एजेंट को सेटअप अनुरोध दें

इसे अपनी मौजूदा Claude Code या Codex बातचीत में पेस्ट करें।

एजेंट को पहले काम कर रहा SosoAPI कनेक्शन जाँचकर फिर उपयोग करना चाहिए। अन्यथा सेटअप विधि अपनाकर बताए कि ब्राउज़र साइन-इन या क्लाइंट रीस्टार्ट कब चाहिए। अपेक्षित परिणाम: इस बातचीत में SosoAPI टूल उपयोग योग्य हों। इंस्टॉलेशन संदेश अकेले प्रमाण नहीं है। साइन-इन और खाता जाँच जारी रखें या मैन्युअल कॉन्फ़िगरेशन के लिए चरण 3 लें।

https://sosoapi.ai/setup.md से SosoAPI सेट अप करो। मेरा मौजूदा कंटेंट और काम बनाए रखो। कहे जाने पर मैं साइन इन करके एक्सेस की अनुमति दूँगा। सेटअप के दौरान कुछ भी प्रकाशित मत करो।

2. साइन इन करें और अपने एजेंट की पहुँच चुनें

इच्छित खाता उपयोग करें: Google से जारी रखें या ईमेल से पंजीकरण और सत्यापन पूरा करें। दिखने वाला खाता या Workspace सेटअप पूरा करें। कई Workspaces के सदस्य हों तो इच्छित ब्रांड या परियोजना चुनें। मंज़ूरी से पहले माँगे Workspaces और कार्रवाइयाँ जाँचें, फिर उसी बातचीत में लौटें।

एजेंट का दिया साइन-इन लिंक रखें ताकि ब्राउज़र लंबित अनुमति पर लौट सके। पहले ऐप में शुरू करके फिर एजेंट पर लौट सकते हैं। लंबित मंज़ूरी लिंक को अलग साइन-इन लिंक से न बदलें।

Workspace भूमिकाएँ और प्लेटफ़ॉर्म अनुमतियाँ लागू रहती हैं: एजेंट की प्रकाशन पहुँच से दर्शक संपादक नहीं बनता। प्रकाशन पहुँच आपके दिए दायरे में जारी रहती है; SosoAPI हर पोस्ट के लिए नई ब्राउज़र मंज़ूरी नहीं माँगता। एजेंट को बताएँ कि सामग्री समीक्षा के लिए कब रुकना है। सामान्य OAuth सेटअप में सोशल पासवर्ड या API कुंजी एजेंट में पेस्ट नहीं करनी पड़ती।

अपेक्षित परिणाम: इच्छित पहचान से साइन-इन पूरा हो और एजेंट आपके अधिकृत Workspaces प्राप्त कर सके। गलत ब्राउज़र प्रोफ़ाइल खुलने पर समस्या-निवारण देखें।

• SosoAPI ऐप से शुरू करें

3. ज़रूरत हो तो अपना एजेंट मैन्युअली जोड़ें

एक कनेक्शन तरीका चुनें। एजेंट ने पहले से काम कर रहा कनेक्शन सेट किया हो तो यह भाग छोड़ें। स्थानीय MCP के लिए पहले Node.js और npx जाँचें। Node.js वर्शन 20 या बाद का होना चाहिए।

node --version
npx --version

स्थानीय MCP: Claude Code या Codex

केवल अपने क्लाइंट की कमांड चलाएँ: पहली Claude Code और दूसरी Codex के लिए है। core प्रोफ़ाइल दैनिक प्रकाशन के लिए है। प्रोफ़ाइल दिखने वाले टूल बदलती हैं; अनुमतियाँ नहीं देतीं। पहले से काम कर रहा full-profile कनेक्शन हो तो उसे रखें।

क्लाइंट कहे तो फिर जुड़ें या रीस्टार्ट करें, फिर वर्तमान बातचीत में SosoAPI टूल उपलब्ध होने की जाँच करें। पहली प्रमाणित कॉल ज़रूरत होने पर ब्राउज़र साइन-इन शुरू करती है।

claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

अन्य स्थानीय MCP क्लाइंट

mcpServers JSON वाले क्लाइंट में मौजूदा कॉन्फ़िगरेशन में यह एंट्री जोड़ें और बाकी सर्वर रखें। अन्य कॉन्फ़िगरेशन फ़ॉर्मैट में क्लाइंट की अपनी MCP सेटिंग से वही कमांड, आर्ग्युमेंट और परिवेश वैरिएबल दें।

{
  "mcpServers": {
    "sosoapi": {
      "command": "npx",
      "args": [
        "-y",
        "sosoapi"
      ],
      "env": {
        "SOSOAPI_TOOL_PROFILE": "core"
      }
    }
  }
}

• इंस्टॉलेशन संदर्भ और पैकेज विकल्प

होस्टेड MCP: संगत ब्राउज़र या रिमोट क्लाइंट

क्लाइंट के कस्टम कनेक्टर या रिमोट MCP सेटिंग में नीचे के सर्वर URL से SosoAPI नाम का कनेक्शन जोड़ें। उपलब्ध हो तो स्वचालित क्लाइंट पंजीकरण वाला OAuth चुनें। SosoAPI में साइन इन करें, अनुमत Workspaces और कार्रवाइयाँ चुनें, बातचीत में लौटें और ज़रूरत पर कनेक्शन सक्षम करें। एजेंट से अधिकृत खाते जाँचने को कहें।

नए होस्टेड कनेक्शन के लिए https://sosoapi.ai उपयोग करें। पुराना एंडपॉइंट https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp समर्थित रहता है। काम कर रहा स्थानीय या होस्टेड कनेक्शन बनाए रखें; केवल उसका URL बदलने के लिए उसे बदलने की ज़रूरत नहीं है।

API कुंजी, क्लाइंट ID या क्लाइंट सीक्रेट पेस्ट नहीं करना है। ChatGPT कस्टम MCP ऐप क्लाइंट के प्लान, डेवलपर मोड और प्रशासक सेटिंग पर निर्भर हैं। ये निर्देश कस्टम कनेक्शन बताते हैं, ऐप-डायरेक्टरी सूचीकरण नहीं। होस्टेड MCP स्थानीय फ़ाइल नहीं पढ़ सकता; सार्वजनिक URL आयात या स्थानीय फ़ाइल अपलोड के लिए स्थानीय MCP उपयोग करें।

https://sosoapi.ai

• कस्टम OAuth क्लाइंट पंजीकरण और टोकन विधि

वैकल्पिक टर्मिनल साइन-इन जाँच

स्थानीय कनेक्शन के लिए पहले auth status चलाएँ। साइन इन नहीं होने की सूचना दे तभी auth login चलाएँ। ब्राउज़र प्रक्रिया पूरी करके स्थिति फिर जाँचें। टोकन प्रिंट नहीं होते। यह स्थानीय CLI प्रमाणीकरण जाँचता है, अलग होस्टेड कनेक्टर का लॉगिन नहीं।

npx -y sosoapi auth status

npx -y sosoapi auth login

4. अपना सोशल खाता जोड़ें

खाते जोड़ें खोलें या नीचे की स्थानीय कमांड उपयोग करें। उपयुक्त होने पर threads को instagram, facebook, youtube या x से बदलें। यह कनेक्शन प्रक्रिया खोलता है; सामग्री प्रकाशित नहीं करता।

दिख रहे Organization और Workspace जाँचें। प्लेटफ़ॉर्म चुनें, उसके अनुमति पेज से साइन इन करें और सटीक खाता, Page या चैनल चुनें। लौटने पर सहमति और खाता-चयन पुष्टि पूरी करें। फिर एजेंट से इच्छित Workspace के जुड़े खाते रिफ़्रेश करने को कहें।

मौजूदा स्वस्थ कनेक्शन फिर उपयोग करें। यदि वह किसी अन्य Organization या Workspace का है, ऐप में चयन स्पष्ट करें; सामान्य सेटअप उसे डिस्कनेक्ट या स्थानांतरित न करे। अपेक्षित परिणाम: सही खाता इच्छित Workspace में वर्तमान स्वास्थ्य और क्षमता जानकारी के साथ दिखे। सफल कॉलबैक अकेले प्रकाशन अनुमति सिद्ध नहीं करता।

npx -y sosoapi connect threads

• खाते जोड़ें

5. बिना प्रकाशित किए पहुँच सत्यापित करें

निम्न को जुड़े एजेंट की बातचीत में पेस्ट करें।

एजेंट sosoapi_get_workspace_context और sosoapi_list_connected_accounts उपयोग कर सकता है, ज्ञात संदर्भ फिर इस्तेमाल कर सकता है और चुना workspace_id स्पष्ट दे सकता है। खाता आरंभ करते समय आपका पहला Workspace बन सकता है; यह सेटअप जाँच सोशल पोस्ट नहीं बनाती।

आगे बढ़ने से पहले Workspace और गंतव्य, अपनी भूमिका और एजेंट पहुँच, तथा प्रस्तावित फ़ॉर्मैट का गंतव्य समर्थन पक्का करें। जाँच विफल हो तो समस्या-निवारण देखें। पैकेज फिर इंस्टॉल करने से गायब प्लेटफ़ॉर्म अनुमति नहीं मिलती।

बिना कुछ प्रकाशित या शेड्यूल किए मेरा SosoAPI सेटअप जाँचें।
मेरे उपयोग योग्य Workspaces और मेरे चुने Workspace के सोशल खाते दिखाएँ।
मेरे चुने खाते के लिए प्लेटफ़ॉर्म, खाता लेबल, कनेक्शन स्वास्थ्य और प्रस्तावित फ़ॉर्मैट की प्रकाशन क्षमताएँ दिखाएँ।
कई Workspaces या खाते मेल खा सकते हों तो मुझसे पूछें कि किसका उपयोग करना है।
आंतरिक ID टूल कॉल के लिए रखें; मुझे उन्हें खोजने या गढ़ने को न कहें।

6. अपनी पहली पोस्ट तैयार करके मंज़ूर करें

एक वास्तविक पोस्ट और एक गंतव्य से शुरू करें। इस ड्राफ़्ट प्रॉम्प्ट के कोष्ठक वाले फ़ील्ड बदलें। एजेंट लिखता है; SosoAPI कनेक्शन और प्रकाशन ऑपरेशन देता है। दावे, वर्तनी, लिंक और मीडिया खुद जाँचें।

भविष्य की पोस्ट के लिए स्पष्ट तारीख, स्थानीय समय और IANA समय क्षेत्र दें। डेलाइट सेविंग से स्थानीय समय अस्पष्ट हो तो सबमिट करने से पहले इच्छित घटना चुनें। इस चरण का अपेक्षित परिणाम: समीक्षा के लिए सटीक ड्राफ़्ट, बिना प्रकाशन अनुरोध भेजे।

SosoAPI से एक उत्पाद घोषणा तैयार करने में मदद करें।

उत्पाद: [सार्वजनिक उत्पाद नाम]
सत्यापित तथ्य: [आज क्या उपलब्ध है]
दर्शक: [यह किनके काम आता है]
गंतव्य: [खाता लेबल और प्लेटफ़ॉर्म]
भाषा: [भाषा]
पसंदीदा स्थानीय तारीख और समय: [YYYY-MM-DD HH:mm]
समय क्षेत्र: [IANA समय क्षेत्र, जैसे Asia/Hong_Kong]
मीडिया: [कोई नहीं, स्थानीय फ़ाइल या सार्वजनिक मीडिया URL]

केवल मेरे दिए तथ्य उपयोग करें। गंतव्य की फ़ॉर्मैट आवश्यकताएँ जाँचें।
समीक्षा के लिए सटीक ड्राफ़्ट, मीडिया, गंतव्य, तारीख, समय और समय क्षेत्र दिखाएँ।
अभी शेड्यूल या प्रकाशित न करें।

शेड्यूल से पहले सटीक पोस्ट मंज़ूर करें

सभी विवरण सही हों तो नीचे के प्रॉम्प्ट से विशिष्ट निर्देश दें। इससे वास्तविक शेड्यूल बनता है जो सार्वजनिक रूप से प्रकाशित हो सकता है। वही सामग्री और खाता उपयोग करें जहाँ सच में प्रकाशित करना है। तत्काल प्रकाशन को भी वही विवरण जाँचने के बाद स्पष्ट निर्देश चाहिए।

अपेक्षित परिणाम: Scheduled Post ID, इच्छित गंतव्य, स्वीकार किया समय और वर्तमान स्थिति। शेड्यूल स्वीकार होने का मतलब प्रदाता ने प्रकाशित कर दिया नहीं है।

नीचे की सटीक मंज़ूर पोस्ट को बताए खाते पर निर्दिष्ट तारीख, समय और समय क्षेत्र में शेड्यूल करें।

[अंतिम सामग्री, मीडिया, गंतव्य, तारीख, समय और समय क्षेत्र पेस्ट करें।]

पहले मौजूदा मेल खाते शेड्यूल की जाँच करें। यह पोस्ट एक बार भेजें और सेव परिणाम पढ़ें। उसका ID, गंतव्य, स्वीकार किया समय और वर्तमान स्थिति लौटाएँ। परिणाम अनिश्चित हो तो दूसरी कार्रवाई से पहले मौजूदा अनुरोध जाँचें।

7. परिणाम जाँचें, फिर शेड्यूल या रद्द करें

एजेंट से sosoapi_get_scheduled_post द्वारा वही Scheduled Post पढ़ने को कहें। अधिकृत खाते से साइन इन करने के बाद https://app.sosoapi.ai/scheduled-posts/<post-id> भी खोल सकते हैं। अनुरोध में कई खाते हों तो हर गंतव्य अलग जाँचें; कुछ सफल हो सकते हैं और कुछ को ध्यान चाहिए।

Scheduled Post [लौटा ID] का वर्तमान परिणाम पढ़ें।
उसका गंतव्य, निर्धारित समय, मौजूदा स्थिति और प्रकाशन परिणाम दिखाएँ।
प्रकाशन की पुष्टि हो तो उपलब्ध लाइव लिंक शामिल करें।
फिर प्रयास, पुनर्निर्धारण या दूसरी पोस्ट न बनाएँ।

लंबित पोस्ट प्रबंधित करें और बाद में लौटें

लंबित पोस्ट बदलने के लिए उसका ID और नए विवरण दें। समर्थित अपडेट या रद्द करने से पहले एजेंट को वर्तमान वर्शन और उपलब्ध कार्रवाइयाँ पढ़नी होंगी। रद्द करना डिलीवरी चरण पर निर्भर है और डिलीवरी शुरू होने पर अनुपलब्ध हो सकता है। शेड्यूल रद्द करने से पहले से प्रकाशित प्रदाता पोस्ट नहीं हटती।

भविष्य के शेड्यूल के सेव विवरण मिलने के बाद बातचीत छोड़कर बाद में उसी पोस्ट पर लौट सकते हैं। बंद एजेंट बातचीत के अपने आप सक्रिय होने या सूचना देने का वादा नहीं है, जब तक यह अलग से कॉन्फ़िगर न हो।

8. चित्र या वीडियो जोड़ें, फिर प्रक्रिया दोबारा उपयोग करें

बड़ा बैच तैयार करने से पहले एक-पोस्ट प्रक्रिया चलाएँ। एजेंट को बताएँ कि मीडिया स्थानीय फ़ाइल, सार्वजनिक URL या मौजूदा SosoAPI एसेट है।

स्थानीय फ़ाइलें: स्थानीय MCP, sosoapi_upload_asset उपयोग कर सकता है। फ़ाइल अनुमत अपलोड फ़ोल्डर में होनी चाहिए; पाथ सीमा से बाहर होने पर टूल अनुमत स्थान बताता है। होस्टेड MCP आपके कंप्यूटर की फ़ाइलें नहीं पढ़ सकता।

सार्वजनिक URL: sosoapi_import_asset_url उपयोग करें, फिर include_asset=true के साथ sosoapi_get_asset_import_status। एसेट तैयार होने तक रुकें। मौजूदा एसेट के लिए सत्यापित करें कि वह इच्छित Workspace का है और चुने फ़ॉर्मैट के लिए तैयार है।

सामान्य शेड्यूल अनुरोध में पंजीकृत एसेट ID और कैनोनिकल एसेट URL साथ उपयोग होते हैं। अस्थायी प्रीव्यू URL या मूल बाहरी स्रोत URL उनका विकल्प नहीं है। समर्थित एक-इमेज-URL प्रक्रिया में sosoapi_post_image_url आयात और सबमिशन जोड़ता है। यह प्रकाशन कार्रवाई है: पहले पूरी पोस्ट मंज़ूर करें। प्रोसेसिंग के दौरान स्वीकृत पोस्ट ID रखें; उसे आगे बढ़ाने के लिए दूसरा आयात शुरू न करें।

X बिना मीडिया की मूल TEXT Post या ठीक एक तैयार पंजीकृत MP4 वीडियो एसेट के साथ VIDEO सपोर्ट करता है, जिसकी लंबाई कम से कम 0.5 सेकंड और अपलोड सीमा 500 MiB के भीतर हो। वीडियो को उसी खाते के लिए सत्यापित can_publish_video चाहिए; केवल टेक्स्ट पहुँच पर्याप्त नहीं है। पुराने कनेक्शन को वीडियो-अपलोड अनुमति सहित फिर जोड़ने की आपकी मंज़ूरी चाहिए हो सकती है। सभी टेक्स्ट, हैशटैग और लिंक X की भारित टेक्स्ट सीमा में हों। फ़ोटो, जवाब, कोट, रीपोस्ट और थ्रेड प्रकाशन समर्थित नहीं हैं। अपलोड या वीडियो प्रोसेसिंग स्वीकार होना प्रकाशित परिणाम नहीं है।

X सबमिशन से पहले इच्छित workspace_id और अंतिम टेक्स्ट के लिए sosoapi_get_x_usage पढ़ें। उसका भत्ता और लागत सामान्य प्लान कोटे से अलग हैं। बार-बार सबमिट करके क्रेडिट सीमा न लाँघें; दूसरे सेंड से पहले अनिश्चित प्रकाशन का मिलान करें।

समीक्षित बैच तैयार करें और प्रदर्शन ईमानदारी से पढ़ें

पहली सफल पोस्ट के बाद नीचे का उत्पाद-लॉन्च प्रॉम्प्ट आज़माएँ। सटीक तालिका मंज़ूर करने के बाद बैच को प्लान की सीमाओं से जाँचें। स्वीकृत और अस्वीकृत गंतव्य अलग बताएँ और हर स्वीकृत पोस्ट की पहचान रखें।

प्रकाशन और विश्लेषिकी की पहुँच अलग हो सकती है। बाद में प्रदर्शन समीक्षा माँगने पर अनुपलब्ध मेट्रिक्स को अनुपलब्ध ही बताया जाए। शून्य न गढ़ें और पोस्ट प्रकाशित होने से हर मेट्रिक पढ़ने योग्य न मानें।

उसी सत्यापित सेटअप से मेरे दिए सार्वजनिक तथ्यों पर सात उत्पाद-घोषणा ड्राफ़्ट बनाएँ, रोज़ एक। हर पंक्ति में ड्राफ़्ट, गंतव्य, मीडिया, स्थानीय तारीख, समय और समय क्षेत्र वाली समीक्षा तालिका दिखाएँ। सटीक तालिका मेरी मंज़ूरी तक सातों को ड्राफ़्ट रखें।

9. CLI और API मार्गदर्शन

स्पष्ट अनुरोध फ़ाइलों या बैकएंड एकीकरण के लिए यह वैकल्पिक मार्ग उपयोग करें। एजेंट उपयोगकर्ता छोड़ सकते हैं। उदाहरण MCP वाली ही खाता, Workspace और प्रकाशन अनुमतियाँ उपयोग करते हैं।

पहले इंस्टॉल पैकेज की सहायता और अंतर्निहित अनुबंध जाँचें; अनुबंध जाँचने के लिए लॉगिन नहीं चाहिए। वह पैकेज में शामिल ऑपरेशन और स्कीमा दिखाता है। दूसरे प्रदाता के अनुरोध फ़ॉर्मैट के बजाय वही फ़ील्ड नाम उपयोग करें।

npx -y sosoapi --help
npx -y sosoapi api contract --summary
npx -y sosoapi api contract --route /studio-api/scheduled-posts/

CLI: पहला प्रमाणित संदर्भ अनुरोध करें

auth login पूरा करें। टेक्स्ट एडिटर से नीचे का JSON वाला workspaces.json सेव करें, फिर कमांड चलाएँ। सामग्री शेल कमांड में डालने के बजाय अनुरोध बॉडी के लिए फ़ाइलें उपयोग करें।

CLI, schema_version, http_status और body लौटाता है। सफल जवाब में body.active_workspace_id और body.workspaces होते हैं। उसी जवाब से इच्छित Workspace चुनें; सक्रिय Workspace चुपचाप नए कार्य का गंतव्य तय नहीं करता। नए खाते की पहली कॉल उसका पहला Workspace शुरू कर सकती है।

केवल शेल एग्ज़िट कोड नहीं, http_status और body जाँचें। कमांड API ऑपरेशन सफल हुए बिना HTTP त्रुटि एनवलप लौटा सकती है।

{}

npx -y sosoapi api post /identity-api/workspace/list < workspaces.json

CLI: जुड़ा सोशल खाता चुनें

अपने खाते के लिए लौटे Workspace ID से accounts.json सेव करें, फिर कमांड चलाएँ। body.accounts में इच्छित खाता चुनें। उसका SosoAPI खाता ID ही शेड्यूलिंग में प्रयुक्त social_account_id है; यूज़रनेम या प्रदाता Page ID उसका विकल्प नहीं है।

{
  "workspace_id": "<YOUR_WORKSPACE_ID>"
}

npx -y sosoapi api post /identity-api/user/social-accounts/list < accounts.json

CLI: एक मंज़ूर Threads टेक्स्ट शेड्यूल बनाएँ

यह अनुरोध टेम्पलेट है, चलाने को तैयार पोस्ट नहीं। फ़ाइल एडिटर से post.json सेव करके कोष्ठकों के सभी मान अपने अधिकृत मानों से बदलें। स्पष्ट UTC ऑफ़सेट वाला भविष्य का ISO टाइमस्टैम्प चुनें, या UTC के लिए Z। display_timezone प्रदर्शन हेतु IANA समय क्षेत्र है; यह अस्पष्ट स्थानीय टाइमस्टैम्प को पूरा नहीं करता।

एक अनोखा idempotency_key बनाएँ, जैसे UUID, और उसे अनुरोध के सटीक बॉडी के साथ रखें। समान अनुरोध फिर उसी कुंजी से करें; देर से जवाब आना दूसरी कुंजी बनाने की वजह नहीं है। बदली पोस्ट अलग अनुरोध है: नई पहचान चुनने से पहले मूल परिणाम जाँचें।

सामग्री, खाता, समय, अनुमतियाँ और वर्तमान कोटा पक्का करने के बाद create कमांड चलाएँ। इससे वास्तविक पोस्ट शेड्यूल होती है। स्वीकृति पर body.post.id रखें और body.post.status, body.post.scheduled_at तथा body.post.destination पढ़ें। body.deduped बताता है कि मौजूदा अनुरोध फिर इस्तेमाल हुआ या नहीं। स्वीकृति, प्रदाता द्वारा पुष्टि किया गया प्रकाशन नहीं है।

{
  "workspace_id": "<YOUR_WORKSPACE_ID>",
  "social_account_id": "<YOUR_THREADS_ACCOUNT_ID>",
  "caption": "<YOUR_APPROVED_POST_TEXT>",
  "hashtags": [],
  "media": [],
  "provider_payload": {
    "platform": "threads",
    "publish_options": {
      "post_type": "TEXT"
    }
  },
  "scheduled_at": "<FUTURE_ISO_8601_TIME_WITH_OFFSET>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<NEW_STABLE_REQUEST_KEY>"
}

npx -y sosoapi api post /studio-api/scheduled-posts/create < post.json

CLI: सेव पोस्ट और उसका परिणाम पढ़ें

लौटे ID से post-status.json सेव करें। body.post, body.delivery, body.actions और body.outcomes पढ़ें। सफलता बताने से पहले प्रकाशित परिणाम की पुष्टि करें। create जवाब खो गया हो तो सेव पहचान से मूल अनुरोध रिकवर करें; नई कुंजी से दूसरा शेड्यूल न बनाएँ।

{
  "id": "<RETURNED_POST_ID>"
}

npx -y sosoapi api post /studio-api/scheduled-posts/get < post-status.json

CLI: वर्तमान परिणाम अनुमति दे तभी रद्द करें

नवीनतम रीड रद्द करने की अनुमति दे और आप रद्द करना चाहें, तो लौटे ID और वर्तमान संख्यात्मक body.post.version से cancel.json सेव करें। उदाहरण 1 केवल समझाने के लिए है: अभी पढ़े वर्शन से बदलें। फिर कमांड चलाकर परिणाम पक्का करें।

वर्शन बदल गया या रद्द करना अनुपलब्ध हो तो वही पोस्ट फिर पढ़कर उसकी वास्तविक उपलब्ध कार्रवाइयाँ उपयोग करें। वर्शन टकराव न लाँघें और रद्द करने को पहले से प्रकाशित पोस्ट हटाने जैसा न मानें।

{
  "id": "<RETURNED_POST_ID>",
  "expected_version": 1
}

npx -y sosoapi api post /studio-api/scheduled-posts/cancel < cancel.json

HTTP: अपने बैकएंड से कॉल करें

सर्वर-साइड एकीकरण के लिए Connection → API में API कुंजी बनाएँ और सीक्रेट अपने सर्वर के सीक्रेट कॉन्फ़िगरेशन में रखें। वर्तमान स्क्रीन नाम पूछती है; Workspace या क्षमता चयन नहीं देती। उपयोगकर्ता-निर्मित कुंजी डिफ़ॉल्ट रूप से उस उपयोगकर्ता के पहुँच योग्य Workspaces में operate, publish और engage देती है। जाँचें कि यह अधिकार आपके एकीकरण के अनुरूप है। API अनुबंध सीमित कुंजी के लिए स्पष्ट रूप से सीमित क्षमताएँ और workspace_ids सपोर्ट करता है।

सामान्य एजेंट सेटअप OAuth उपयोग करता है और यह API-कुंजी चरण नहीं चाहता। उदाहरण में SOSOAPI_ACCESS_TOKEN आपकी सर्वर-साइड उदाहरण वैरिएबल है जिसमें कुंजी है; यह SosoAPI CLI सेटिंग नहीं है। CLI की वैकल्पिक व्यक्तिगत पहुँच टोकन वैरिएबल VICKY_API_KEY है।

ऊपर की workspaces.json फ़ाइल उपयोग करें। सीधा HTTP, CLI के http_status/body एनवलप के बिना एंडपॉइंट बॉडी लौटाता है; वास्तविक HTTP स्थिति और JSON पढ़ें। क्रेडेंशियल बैकएंड पर रखें, ब्राउज़र कोड, प्रॉम्प्ट, स्क्रीनशॉट और साझा अनुरोध फ़ाइलों से बाहर।

अपने ग्राहकों के उत्पाद में सोशल कनेक्शन जोड़ना अलग एकीकरण कार्य है। यह एकल-खाता मार्गदर्शन ग्राहक ऑनबोर्डिंग प्रक्रिया तैयार होना सिद्ध नहीं करता।

curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer ${SOSOAPI_ACCESS_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data-binary @workspaces.json \
  'https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/workspace/list'

• API कुंजियाँ प्रबंधित करें: Connection → API
• API संदर्भ
• API-कुंजी निर्माण और स्पष्ट अधिकार
• प्रमाणीकरण और अनुमतियाँ
• CLI संदर्भ

10. समस्या-निवारण

वास्तविक त्रुटि और जिस कनेक्शन का निदान कर रहे हैं वही उपयोग करें। अनुमतियाँ बढ़ाना या सबमिशन दोहराना हर विफलता ठीक नहीं करता।

अपडेट करें, पहुँच वापस लें या मदद माँगें

नीचे की पहली कमांड MCP सर्वर शुरू किए बिना नवीनतम पैकेज सहायता जाँचती है। क्लाइंट की सेव कमांड में वर्शन पिन हो तो उसी कमांड को जानबूझकर अपडेट करें। अलग ग्लोबल इंस्टॉलेशन अपडेट करने से क्लाइंट की पिन कॉपी अपडेट नहीं होती।

स्थानीय डिवाइस की पहुँच हटाने के लिए Connection → Agent या नीचे की auth logout कमांड उपयोग करें। होस्टेड कनेक्टर के लिए Connection → Agent में संबंधित होस्टेड अनुमति हटाएँ। API कुंजियाँ अलग Connection → API में प्रबंधित हैं। एजेंट पहुँच हटाने से पहले से स्वीकृत शेड्यूल रद्द नहीं होते; वे पोस्ट अलग प्रबंधित करें।

मदद के लिए क्लाइंट और पैकेज वर्शन, विफल चरण, दिखाई त्रुटि और समय/समय क्षेत्र बताएँ। ज़रूरत पर संबंधित अनुरोध या पोस्ट ID निजी रूप से सपोर्ट को दें। क्रेडेंशियल, अनुमति लिंक या टोकन वाले कच्चे लॉग न भेजें।

npx -y sosoapi@latest --help

npx -y sosoapi auth logout

• एजेंट क्लाइंट प्रबंधित करें: Connection → Agent
• API कुंजियाँ प्रबंधित करें: Connection → API
• समस्या-निवारण संदर्भ
• SosoAPI सपोर्ट से संपर्क करें

सेटअप पूर्णता चेकलिस्ट

बिना पोस्ट भेजे कनेक्शन सेटअप पूरा कर सकते हैं। प्रकाशित करें तो अलग परिणाम जाँच से उस पहली प्रकाशन प्रक्रिया की पुष्टि करें।

• मेरा क्लाइंट SosoAPI टूल उपयोग कर सकता है या मेरा CLI/API अधिकृत अनुरोध कर सकता है।
• मैंने इच्छित खाते से साइन इन करके सही Workspace चुना।
• मेरा सोशल खाता कार्य के लिए आवश्यक क्षमताओं सहित दिखता है।
• मैं समझता हूँ कि एजेंट केवल काम तैयार कर सकता है या शेड्यूल और प्रकाशित भी कर सकता है।
• मैं ड्राफ़्ट तैयार करके सटीक गंतव्य, सामग्री और समय की समीक्षा कर सकता हूँ।
• यदि मैंने पोस्ट भेजी है, तो उसका ID रखा है और स्वीकृति को पुष्ट प्रकाशन से अलग पहचान सकता हूँ।
• मैं जानता हूँ कि विफलता कैसे जाँचनी है, लंबित शेड्यूल कैसे प्रबंधित करना है और पहुँच कैसे वापस लेनी है।