# यह असिस्टेंट इस्तेमाल करने वाले व्यक्ति के लिए SosoAPI सेट अप करें

व्यक्ति का मौजूदा असिस्टेंट इस्तेमाल करें और मूल काम, कंटेंट और बनाए रखें
इस बातचीत के मीडिया संदर्भ। उनके जुड़े खातों के लिए एक SosoAPI MCP इस्तेमाल करें
सोशल खाते। मौजूदा कनेक्शन फिर इस्तेमाल करें या लोकल अथवा होस्ट किया गया एक्सेस चुनें
नीचे। सेटअप पोस्ट प्रकाशित नहीं करता। व्यक्ति साइन इन करता है और चुनता है कि क्या
अपने ब्राउज़र में अधिकृत करें। कभी उनके क्रेडेंशियल दर्ज या सहमति मंज़ूर न करें
उनके लिए। Free के लिए कार्ड ज़रूरी नहीं है।

## 1. यह असिस्टेंट कनेक्ट करें

पहले वर्तमान होस्ट और उसके मौजूदा SosoAPI कॉन्फ़िगरेशन की जाँच करें। फिर इस्तेमाल करें
काम करता कनेक्शन; लॉग आउट, कॉन्फ़िगरेशन ओवरराइट या दूसरा बनाने का काम न करें
कनेक्शन, केवल इसलिए कि यह गाइड फिर खोली गई।

लोकल शेल के लिए जाँचें कि Node.js 20 या बाद का संस्करण और npx उपलब्ध हैं। इस्तेमाल करें
मौजूदा समर्थित रनटाइम। अनुपस्थित हो, तो आवश्यक शर्त सरल भाषा में समझाएँ
भाषा; विशेषाधिकार वाले या पूरे सिस्टम के बदलाव अपने आप न करें।

Claude Code:

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

Codex:

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

सर्वर पंजीकृत करने के बाद जाँचें कि आप उसके टूल इसमें कॉल कर सकते हैं
बातचीत। होस्ट को फिर कनेक्ट या रीस्टार्ट करना हो, तो व्यक्ति को बताएँ कौन-सा
करने वाली कार्रवाई। कनेक्शन तैयार बताने से पहले टूल के काम करने की प्रतीक्षा करें।

नए कनेक्शन सामान्य प्रकाशन के लिए मौजूदा 28-टूल core प्रोफ़ाइल इस्तेमाल करते हैं,
मीडिया, कमेंट और इनसाइट। काम करता full-profile कनेक्शन फिर इस्तेमाल करना चाहिए।
माँगा गया प्रशासनिक ऑपरेशन अनुपलब्ध हो, तो समझाएँ कि full प्रोफ़ाइल
उपलब्ध है; टूल छिपाने से अनुमति मिलती या निरस्त नहीं होती।

कस्टम MCP ऐप समर्थन वाले ChatGPT जैसे केवल ब्राउज़र क्लाइंट के लिए यह जोड़ें
रिमोट MCP URL और स्वचालित क्लाइंट पंजीकरण वाला OAuth चुनें:

`https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp`

API key, client ID या client secret पेस्ट नहीं करना पड़ता। व्यक्ति साइन इन करता है
SosoAPI पर और अपने Workspaces/कार्रवाइयाँ चुनता है। ChatGPT कस्टम ऐप निर्भर हैं
उसके प्लान और डेवलपर-मोड की उपलब्धता। काम करता लोकल या रिमोट फिर इस्तेमाल करें
कनेक्शन, अगर पहले से सेट अप है।

X मूल टेक्स्ट और लिंक सपोर्ट करता है। हर Organization में 10 Free X क्रेडिट साझा हैं
एक बार, या हर Pro बिलिंग अवधि में 100। सामान्य टेक्स्ट की लागत 1 है; URL वाली Post
की लागत 10 है। पढ़ें `sosoapi_get_x_usage` X उपयोग की योजना बनाने से पहले workspace_id के साथ।
सीमा से अधिक उपयोग का शुल्क अपने आप नहीं लगता; अनिश्चित प्रकाशन अपना क्रेडिट आरक्षित रखता है
आरक्षण, और अगली बार भेजने से पहले इसका मिलान करना आवश्यक है।

## 2. API key के बिना साइन इन करें

पहली प्रमाणित MCP कॉल मौजूदा ब्राउज़र साइन-इन और एजेंट खोलती है
सहमति प्रक्रिया। व्यक्ति Google इस्तेमाल कर सकता है या ईमेल पंजीकृत और सत्यापित कर सकता है।
उन्हें वर्कस्पेस चुनने दें और यह कि असिस्टेंट केवल तैयार कर सकता है
कंटेंट या निर्धारित और प्रकाशित भी कर सकता है। उनसे क्रेडेंशियल कॉपी करने को न कहें।
प्रकाशन सहमति चुने दायरे में निरंतर है, अनिवार्य नहीं
हर पोस्ट की अनुमति स्क्रीन। सामान्य पोस्टिंग के लिए key प्रबंधन बंद रखें।

ईमेल साइनअप और साइन-इन बैकग्राउंड सुरक्षा सत्यापन इस्तेमाल करते हैं, बिना
चेकबॉक्स जिसे व्यक्ति को पूरा करना है। सत्यापन विफल होने पर वास्तविक स्थिति बताएँ
त्रुटि और उपलब्ध पुनः प्रयास कार्रवाई इस्तेमाल करें; व्यक्ति से खोजने या क्लिक करने को न कहें
CAPTCHA बॉक्स। मौजूदा **Continue with Google** विकल्प भी उपलब्ध है
अगर व्यक्ति Google इस्तेमाल करना चाहता है; Google अपनी पहचान जाँच माँग सकता है।
व्यक्ति को अपना खाता चुनने और एक्सेस की अनुमति देने दें।
मौजूदा लॉगिन/अनुमति लिंक और वापसी गंतव्य बनाए रखें; न बदलें
उसे केवल साइनअप URL से या चुपचाप मौजूदा मेंटेनर पहचान में न बदलें।
एक साइन-इन त्रुटि इस बात का प्रमाण नहीं है कि हर साइन-इन तरीका अनुपलब्ध है।

केवल व्यक्ति की पहचान या सहमति वाला चरण रोकें। जब वे
उसे पूरा करें, इंस्टॉलेशन जाँच पूरी करें और मूल ड्राफ़्ट तैयार करें बिना
खाता या वर्कस्पेस गढ़ने के बजाय। समझाएँ क्या पहले से तैयार है और वह एक
अगली आवश्यक कार्रवाई। साइन-इन के बाद प्रमाणित संदर्भ फिर पढ़ें और जारी रखें
वही काम। CAPTCHA बंद न करें, administrator signup APIs इस्तेमाल न करें, टोकन न माँगें,
या वास्तविक प्रक्रिया पूरी होने से पहले खाते/कनेक्शन के तैयार होने का दावा करें।

MCP टूल के लिए होस्ट रीलोड चाहिए हो, तो लोकल CLI भी इसमें उपलब्ध है
असिस्टेंट। चलाएँ `npx -y sosoapi auth status` पहले; इस्तेमाल करें
`npx -y sosoapi auth login` केवल जब लॉगिन ज़रूरी हो। कभी न पढ़ें
क्रेडेंशियल फ़ाइल या टोकन प्रिंट करें। लॉगिन गलत ब्राउज़र प्रोफ़ाइल खोले, तो रुकें
नई प्रक्रिया शुरू करने से पहले उस लंबित लॉगिन को `npx -y sosoapi auth login --no-open`.
व्यक्ति अपनी इच्छित प्रोफ़ाइल में नया प्रिंट किया लिंक खोलता है और जाँचता है
अनुमति देने से पहले साइन इन की हुई पहचान। एक ही लिंक पर दो प्रोफ़ाइल से एक साथ प्रक्रिया कभी न चलाएँ।
इस्तेमाल करें `--help` पहले पुष्टि करने के लिए कि यह रिकवरी फ़्लैग इंस्टॉल किए CLI में मौजूद है;
अनुपस्थित हो, तो काम करता फ़्लैग गढ़ने के बजाय संस्करण की सीमा समझाएँ।
CLI अपने एम्बेड किए गए कॉन्ट्रैक्ट देख सकता है:

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

CLI अनुरोध का सिंटैक्स है `sosoapi api post </allowlisted-route> < request.json`.
फ़ाइल टूल से JSON लिखें; यूज़र कंटेंट को शेल में इंटरपोलेट न करें
कमांड। केवल प्रक्रिया के एग्ज़िट के बजाय http_status और रिस्पॉन्स बॉडी पढ़ें
कोड। API त्रुटि सफलता नहीं है। केवल उन्हीं रूट और स्कीमा का इस्तेमाल करें जो
एम्बेडेड कॉन्ट्रैक्ट; नाम गढ़ें नहीं और अनुपलब्ध क्षमता को बायपास न करें।

## 3. व्यक्ति का अपना सोशल खाता कनेक्ट करें

SosoAPI संदर्भ से प्रमाणित Organization और Workspace की पहचान करें।
पहचानकर्ताओं का अनुमान या चुपचाप दूसरे वर्कस्पेस का इस्तेमाल कभी न करें। अगर
एक से अधिक उपयुक्त ब्रांड हों, तो पूछें कि व्यक्ति किसकी बात कर रहा है।

स्वस्थ होने पर मौजूदा कनेक्शन इस्तेमाल करें। अन्यथा चलाएँ
`npx -y sosoapi connect <platform>` (instagram, threads, facebook, youtube or x)
या व्यक्ति को दें https://app.sosoapi.ai/connect. वे प्रोवाइडर की प्रक्रिया पूरी करते हैं
सहमति और ब्राउज़र में सटीक खाते की समीक्षा। लौटने के बाद,
खाते और प्रकाशन क्षमताएँ फिर पढ़ें। कनेक्शन कॉलबैक नहीं है
प्रकाशन की अनुमति का प्रमाण। मूल ड्राफ़्ट फिर इस्तेमाल करें; न पूछें
व्यक्ति से आंतरिक पहचानकर्ता कॉपी करने या कंटेंट फिर बनाने को।

## 4. मूल पोस्टिंग कार्य पूरा करें

व्यक्ति का मौजूदा अनुरोध इस्तेमाल करें या पूछें कि वे क्या प्रचार करना चाहते हैं। न करें
टेस्ट पोस्ट गढ़ें। सटीक गंतव्य खाता, कंटेंट, मीडिया और दिखाएँ
पहले सबमिशन से पहले स्थानीय तारीख/समय। टाइमज़ोन की पुष्टि करें जब वह हो
अज्ञात। खाते की वर्तमान क्षमताओं की जानकारी पढ़ें; व्यक्तिगत Instagram खाता या अनुपस्थित
प्रोवाइडर की अनुमतियों के लिए समर्थित खाता प्रकार या फिर कनेक्ट करना आवश्यक हो सकता है।

X केवल मूल टेक्स्ट और लिंक स्वीकार करता है; media खाली रखें। X मीडिया, जवाब,
कोट, रीपोस्ट और थ्रेड प्रकाशन समर्थित नहीं हैं।

मीडिया समर्थित गंतव्यों के लिए निर्धारण से पहले पंजीकरण करें: लोकल फ़ाइल के लिए sosoapi_upload_asset इस्तेमाल करें
उसके अनुमत फ़ोल्डर में; बाहरी URL के लिए sosoapi_import_asset_url इस्तेमाल करें
और include_asset=true के साथ sosoapi_get_asset_import_status जाँचें जब तक
सीमित इम्पोर्ट तैयार है। तैयार asset.id, media.asset_id बनता है और
asset.asset_url, media.url बनता है; अलग get_asset कॉल आवश्यक नहीं है।
इम्पोर्ट की पहचान समान रखें, पुनः प्रयास निर्देश मानें और अंतिम स्थिति पर रुकें
विफलता। सफल अनुरोध डिकोडिंग/इम्पोर्ट पूरा होने का प्रमाण नहीं है।
प्रगति अटकने पर पहले उस इम्पोर्ट की job_id से sosoapi_job_status पढ़ें
फिर प्रतीक्षा करने से पहले। लंबित जॉब में पहले से निष्पादन त्रुटि हो सकती है। सेवा की
कॉन्फ़िगरेशन त्रुटि में ऑपरेटर का ध्यान चाहिए, दूसरा इम्पोर्ट या नया सोशल
कनेक्शन या व्यक्ति की अनुमति। बाधा बताएँ, बिना यह दावा किए
इमेज तैयार है।
लौटाई गई पंजीकृत asset ID और कैनोनिकल मीडिया URL साथ इस्तेमाल करें। कभी नहीं
विकल्प के रूप में मूल बाहरी URL या अस्थायी प्रीव्यू URL निर्धारित करें।
मौजूदा तैयार एसेट केवल उसका वर्कस्पेस और पहचान जाँचने के बाद फिर इस्तेमाल करें।

सलाहकारी प्रीव्यू उपयोगी हो, तो sosoapi_get_scheduled_post_eligibility इस्तेमाल करें;
यह वैकल्पिक है और कैनोनिकल create/execution वैलिडेशन की जगह नहीं लेता।
कैनोनिकल Scheduled Post इस्तेमाल करें
टूल। एक पोस्ट एक गंतव्य है। पुनः प्रयास के लिए समान idempotency_key इस्तेमाल करें
उसी सटीक अनुरोध का; बदला ड्राफ़्ट नया अनुरोध है। टाइमआउट के बाद,
अगली कार्रवाई से पहले मौजूदा पोस्ट पढ़ें। बिना जाँच कभी दोबारा न भेजें
प्रोवाइडर की अनिश्चित राइट। अपडेट, रद्दीकरण और स्पष्ट पुनः प्रयास इस्तेमाल करते हैं
मौजूदा संस्करण और सर्वर की कार्रवाई पात्रता।

परिणाम में यह अंतर स्पष्ट होना चाहिए:

- निर्धारित: बताए समय के लिए स्वीकार; अभी प्रकाशित नहीं।
- जारी या मिलान हो रहा है: अंतिम परिणाम अपुष्ट है; दोबारा न भेजें।
- प्रकाशित: प्रोवाइडर-समर्थित अंतिम परिणाम उसी सटीक पोस्ट की पुष्टि करता है;
  उपलब्ध होने पर उसका लाइव लिंक लौटाएँ।
- विफल या ध्यान चाहिए: ज्ञात जानकारी और अगली अनुमत कार्रवाई बताएँ;
  व्यक्ति को फिर एक्सेस देना हो, तो केवल प्रभावित खाता फिर कनेक्ट करें।

कई गंतव्य हों, तो हर एक का अलग परिणाम बताएँ। पूरे काम को न कहें
सफल, जबकि केवल कुछ प्लेटफ़ॉर्म सफल हुए हों। भविष्य के निर्धारण के लिए लौटाएँ
पोस्ट IDs और स्वीकृत समय; बातचीत को तब तक प्रतीक्षा में न रखें जब तक
नियत समय तक या पोलिंग लूप बनाएँ। लौटने पर वही पोस्ट फिर पढ़ें।
व्यक्ति यही सटीक परिणाम यहाँ दोबारा देख सकता है
https://app.sosoapi.ai/scheduled-posts/<post-id>, लौटाई गई वास्तविक ID से
SosoAPI द्वारा। उस पेज के लिए उनका अपना अधिकृत साइन-इन चाहिए। कस्टम के लिए
एनवायरनमेंट में, उसकी स्पष्ट रूप से सेट की गई app origin इस्तेमाल करें।
बंद असिस्टेंट को जगाने या ऐसी सफलता सूचना भेजने का वादा न करें जो
सेट अप और सत्यापित नहीं किया गया है।

## संदर्भ

- लोगों के लिए शुरुआती गाइड: https://app.sosoapi.ai/start
- उत्पाद गाइड: https://sosoapi.ai/hi/docs/quickstart
- समर्थित दायरा: Instagram, Threads, Facebook Pages, YouTube और X का मूल
  टेक्स्ट/लिंक। फ़ॉर्मैट और अनुमतियाँ खाते के अनुसार बदलती हैं; दूसरे प्लेटफ़ॉर्म नहीं हैं
  केवल व्यक्ति के माँगने से उपलब्ध नहीं हो जाते।