Notiamo

AI एजेंट के लिए Notiamo

वह सब कुछ जो किसी AI एजेंट को अपने मालिक के लिए मुफ़्त खाता खोलने, वेबसाइट पर विजेट लगाने और टिप्पणियां व काम संभालने के लिए चाहिए, बिना ब्राउज़र के।

प्रक्रिया

  1. अपने मालिक के लिए खाता मांगें: email, name, agent, locale और, अगर आपके पास हों, company, projectUrl (वेबसाइट का पता) और referral के साथ POST https://my.notiamo.com/api/agent/signup भेजें। जवाब में requestId, pollSecret और pollAfterSeconds होते हैं।
  2. मालिक से कहें कि Notiamo जो पुष्टि का ईमेल भेजता है उसे खोलकर पुष्टि करे। जब तक वे ऐसा नहीं करते, कुछ नहीं होता।
  3. हर pollAfterSeconds सेकंड पर Authorization: Bearer <pollSecret> के साथ GET https://my.notiamo.com/api/agent/signup/{requestId} पोल करें। स्टेटस pending, confirmed, expired या reported होता है।
  4. जब स्टेटस confirmed हो, तो जवाब में आपकी कुंजी (token, जो ntm_ से शुरू होती है) और mcpUrl एक बार आते हैं। कुंजी को तुरंत सहेजें: बाद के पोल उसे नहीं लौटाते। पुष्टि के 7 दिन के भीतर उसे ले लें।
  5. https://my.notiamo.com/api/mcp पर MCP सर्वर से हेडर Authorization: Bearer ntm_… के साथ जुड़ें। अगर आपका ऐप MCP साइन-इन सपोर्ट करता है, तो वह कुंजी की जगह Notiamo से साइन इन इस्तेमाल कर सकता है (नीचे देखें)।
  6. अपने लिए बना प्रोजेक्ट ढूंढने के लिए list_projects (या find_project) कॉल करें: उसके पते के रूप में पहले से आपका projectUrl है। अगर पता गायब या गलत हो, तो update_project_address कॉल करें। फिर get_install, स्निपेट इंस्टॉल करें, और check_install। create_workspace और create_project तभी इस्तेमाल करें जब प्लान में जगह हो (सशुल्क प्लान या Studio ट्रायल); create_project को list_workspaces से workspaceId चाहिए। वर्कस्पेस प्रोजेक्ट को समूह में रखता है, उदाहरण के लिए हर क्लाइंट का एक। प्रोजेक्ट में वेब पता न हो सकता है (origin छोड़ दें): तब उसमें टास्क, काम और समाचार होते हैं, पर विजेट नहीं। इंस्टॉल के बाद get_badge फ़ुटर बैज देता है: साइट के फ़ुटर के लिए एक छोटा Notiamo लोगो, जो समीक्षकों के लिए समीक्षा टूल खोलता है और बाकी सबके लिए Notiamo का सादा लिंक है, साइट की भाषा में (update_project_language, या create_project में language)।
  7. फिर टिप्पणियों पर काम करें: list_comments, get_comment, reply और set_status। नया कुछ है या नहीं जांचने के लिए list_comments को since दें: Z पर खत्म होने वाला UTC समय (जैसे 2026-10-17T08:00:00Z), या उसके पिछले जवाब का cursor। आपको सिर्फ़ वही मिलता है जो बदला है, एक प्रोजेक्ट पर या, projectId के बिना, आपके सभी प्रोजेक्ट पर। अगली जांच के लिए नया cursor रखें, more: true हो तो तुरंत आगे बढ़ें, और id से डुप्लिकेट हटाएं: एक आइटम दो बार आ सकता है।
  8. दूसरे संगठन के लिए name के साथ create_organization कॉल करें: ओनर उसका एडमिन बनता है और उसे ईमेल मिलता है, और जवाब में सिर्फ़ उस संगठन के लिए नया token होता है। अगर ओनर के पास कोई मुफ़्त संगठन नहीं है तो यह मुफ़्त है, वरना इसे प्लान चाहिए: नए टोकन के साथ get_payment_link कॉल करें, या 14 दिन के Studio ट्रायल के लिए start_trial (प्रति व्यक्ति एक बार; ओनर लिंक खोलकर कार्ड डालता है)। रोज़ की एक सीमा है; इनकार में बताया जाता है कि आप दोबारा कब कोशिश कर सकते हैं।
  9. किसी प्रोजेक्ट को दूसरे वर्कस्पेस में ले जाने के लिए (kind project, projectId, toWorkspaceId), या किसी वर्कस्पेस को उसके प्रोजेक्ट के साथ दूसरे संगठन में, जहां मालिक भी एडमिन है (kind workspace, workspaceId, toOrganizationId), request_move कॉल करें। अभी कुछ नहीं हिलता: मालिक को ईमेल मिलता है और उसे 24 घंटे के भीतर उसमें दिए पेज पर पुष्टि करनी होती है। स्टेटस के लिए get_move_request कॉल करें: pending, done, cancelled, expired या failed।
  10. किसी पेज से न जुड़ा काम जोड़ने के लिए projectId और title के साथ create_task कॉल करें, और चाहें तो text और pageUrl भी। उसके शब्द बदलने के लिए taskId और नए title, text या दोनों के साथ update_task कॉल करें। दोनों नए वर्कस्पेस, प्रोजेक्ट और टास्क की दैनिक सीमा में गिने जाते हैं; सीमा पर पहुंचने पर इनकार आपको बताता है। list_comments टास्क को [Task] से चिह्नित दिखाता है और type लेता है: task या comment।
  11. जॉब रिपोर्ट (Studio, Agency और ट्रायल) ऐसे टास्क हैं जिन्हें क्लाइंट किए गए काम के बारे में भरता है: जगह, तारीख, अंतिम ग्राहक और चरण (before, during, after, other) के अनुसार फ़ाइलें, कैप्शन के साथ। list_job_reports कॉल करें (state ready आपके इंतज़ार वाली रिपोर्ट गिनाता है), किसी एक को get_comment से पढ़ें, और उसकी भाषा में role article के साथ जवाब दें। मंज़ूरी सिर्फ़ कोई व्यक्ति देता है: उन्हें मंज़ूरी का लिंक दें या request_approval कॉल करें। मंज़ूरी मिलने पर role posts और files (इस्तेमाल होने वाली फ़ाइलों के id) के साथ जवाब दें। update_file फ़ाइल का phase या caption सेट करता है; create_task और update_task jobReport लेते हैं।
  12. वॉइस नोट और AI (Studio, Agency और ट्रायल): get_comment हर रिकॉर्डिंग को ऑडियो के लिंक और AI के ट्रांसक्रिप्ट के साथ सूचीबद्ध करता है (और बाद का कोई ट्रांसक्रिप्ट, जो पोस्ट नहीं किया गया), लगभग 20 सेकंड से लंबे हर वीडियो को समय नोट (m:ss–m:ss क्या होता है) के साथ, और AI कैप्शन जिन पर कोई व्यक्ति जांच ले तब तक (AI, not checked) लिखा रहता है। जब AI किसी फ़ाइल को प्रोसेस नहीं कर पाता, तो वह वही सादे शब्दों में बताता है जो लोग देखते हैं, सहायता के लिए एक रेफ़रेंस कोड (AI-…) के साथ। list_plans और get_billing महीने के वॉइस और AI मिनट देते हैं।

pollAfterSeconds से तेज़ पोल न करें। अगर rate_limited मिले, तो retryAfter सेकंड रुकें। गलत या अनजान id या secret पर {"code":"not_found"} के साथ 404 लौटता है।

अगर आपका प्लेटफ़ॉर्म अपने अनुरोधों पर Web Bot Auth से हस्ताक्षर करता है (HTTP संदेश हस्ताक्षर, कुंजी निर्देशिका के साथ Signature-Agent) और Notiamo उस पर भरोसा करता है, तो साइन-अप और MCP सर्वर आपको पते के बजाय प्लेटफ़ॉर्म से गिनते हैं, ज़्यादा सीमाओं के साथ। बिना हस्ताक्षर वाले अनुरोध पहले की तरह चलते हैं।

उदाहरण: खाता मांगना

curl -X POST https://my.notiamo.com/api/agent/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"owner@example.com","name":"Ada Owner","agent":"my-agent","locale":"en","projectUrl":"https://example.com"}'

मुफ़्त प्लान

मुफ़्त प्लान में 1 वर्कस्पेस, 1 प्रोजेक्ट, 3 लोग (टीम के सदस्य, क्लाइंट सदस्य और लंबित आमंत्रण, हर ईमेल एक बार) और हर प्रोजेक्ट का 1 सार्वजनिक पता होता है। प्रोजेक्ट की पहली सार्वजनिक टिप्पणी के बाद पता एक बार बदला जा सकता है। इसमें 100 MB फ़ाइलें रखी जा सकती हैं, एक फ़ाइल 5 MB; 100 MB से ऊपर जाने पर संगठन के एडमिन को दो ईमेल मिलते हैं, फिर सबसे पुरानी फ़ाइलें हटाई जाती हैं, और टिप्पणियां, टास्क और जवाब बने रहते हैं। दुरुपयोग रोकने के लिए अपलोड अस्वीकार किए जा सकते हैं। वीडियो शामिल नहीं है: उसके लिए Studio, Agency या ट्रायल चाहिए। खाता खुलते समय एक वर्कस्पेस और एक प्रोजेक्ट पहले से मौजूद होते हैं।

मुफ़्त प्लान पर विजेट Notiamo का बैज दिखाता है।

टिप्पणी वाली लाइन को स्क्रिप्ट टैग के ऊपर रखें। मुफ़्त प्लान की शर्तें इसकी मांग करती हैं:

<!-- Notiamo (notiamo.com): website feedback. Free plan: keep this line. -->

plan_limit का इनकार बताता है कि आप कौन-सी सीमा पर पहुंचे और आगे क्या करना है।

इनकार

साइन-अप और टूल एक कोड के साथ जवाब देते हैं। साइन-अप के कोड HTTP स्टेटस के साथ आते हैं:

कोडHTTP स्टेटसइसका मतलब
signup_blocked403इस नेटवर्क को साइन अप करने की अनुमति नहीं है। मालिक खुद साइन अप करता है।
country_blocked403जिस देश से अनुरोध आया है वहां Notiamo उपलब्ध नहीं है। ओनर भी वहां से साइन अप नहीं कर सकता।
rate_limited429बहुत ज़्यादा अनुरोध। retryAfter सेकंड रुकें।
agent_signup_paused503एजेंट द्वारा साइन-अप अभी रुका हुआ है। मालिक खुद साइन अप करता है।
agent_signup_closed503एजेंट द्वारा साइन-अप बंद है। मालिक खुद साइन अप करता है।
account_exists409इस ईमेल का खाता पहले से है। मालिक लॉग इन करके सेटिंग > AI एजेंट > एजेंट टोकन में कुंजी बनाता है।
email_not_accepted422यह ईमेल पता इस्तेमाल नहीं हो सकता। मालिक खुद साइन अप करता है।
invalid_input422कोई फ़ील्ड सही नहीं है। field उसका नाम बताता है।
plan_limit402प्लान की सीमा आ गई। MCP टूल लौटाते हैं, अगले कदम (start_trial या get_payment_link) के साथ।
read_only403यह कुंजी या ऐप केवल-पढ़ने वाला है: देख सकता है, बदल नहीं सकता। MCP टूल लौटाते हैं।
permission_missing403इस कुंजी या ऐप को यह करने की अनुमति नहीं है। permission छूटे हुए समूह (या full) का नाम बताता है। MCP टूल लौटाते हैं।

इनकार अपने मालिक को दिखाएं। उन्हें कभी घुमाकर पार न करें।

Notiamo से साइन इन (OAuth)

कुंजी की जगह, साइन-इन सपोर्ट करने वाला MCP क्लाइंट OAuth से जुड़ सकता है। ऑथराइज़ेशन सर्वर का मेटाडेटा https://my.notiamo.com/.well-known/oauth-authorization-server पर है, और MCP सर्वर 401 के साथ WWW-Authenticate हेडर लौटाता है जो उसके प्रोटेक्टेड रिसोर्स मेटाडेटा (https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp, RFC 9728) की ओर इशारा करता है, जिसमें इस सर्वर का नाम है, और स्कोप notes replies status tasks सुझाता है। क्लाइंट खुद को रजिस्टर करते हैं और PKCE (S256) इस्तेमाल करते हैं, बिना क्लाइंट सीक्रेट के।

आपका मालिक लॉग इन करता है, संगठन चुनता है, आप क्या बदल सकते हैं (फ़ीडबैक पर काम चिह्नित है) और कौन-से प्रोजेक्ट, और अनुमति दें दबाता है। स्कोप नीचे दिए अनुमति समूह हैं। आपका मालिक ऐप को सेटिंग > AI एजेंट > जुड़े हुए ऐप में देखता है और उसे कभी भी डिस्कनेक्ट कर सकता है।

अनुमतियां

पढ़ने के लिए किसी अनुमति की ज़रूरत नहीं। कुछ बदलने के लिए कुंजी या जुड़े हुए ऐप को उसके लिए समूह चाहिए:

notes replies status tasks setup invites billing moves

केवल-पढ़ने में कोई समूह नहीं है। फ़ीडबैक पर काम में notes, replies, status और tasks हैं। पूरा में सब हैं; टीम के सदस्यों को आमंत्रित करने के लिए पूरा चाहिए। समूह के बिना टूल permission_missing के साथ इनकार करता है और permission में समूह का नाम बताता है; केवल-पढ़ने वाली कुंजी को read_only मिलता है। इसे अपने मालिक को दिखाएं: ज़्यादा एक्सेस सिर्फ़ वही दे सकते हैं।

भुगतान

list_plans प्लान दिखाता है (कीमतें कीमत के पेज पर देखें)। start_trial ट्रायल शुरू करता है, प्रति व्यक्ति एक बार। कीमतें

get_payment_link भुगतान का लिंक बनाता है जिसे मालिक खोलकर भुगतान करता है। कार्ड का डेटा आप कभी नहीं संभालते।

रेफ़रल

अगर Notiamo का कोई बैज या लिंक आपको यहां लाया, तो उसका कोड साइन-अप की JSON बॉडी के referral फ़ील्ड में दें। ?via=<code> रूप सिर्फ़ उस साइन-अप वेब लिंक के लिए है जिसे लोग खोलते हैं।

MCP टूल

जुड़ने के बाद आप ये कॉल कर सकते हैं:

whoami list_projects find_project list_comments list_activity get_comment reply set_status assign list_team list_people get_account list_plans get_billing start_trial list_workspaces create_workspace create_project update_project_address update_project_language get_install get_badge check_install invite get_payment_link create_organization request_move get_move_request create_task update_task list_job_reports update_file request_approval

और