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 (استعمال کی جانے والی فائلوں کی آئی ڈیز) کے ساتھ جواب دیں۔ 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 سیکنڈ انتظار کریں۔ غلط یا نامعلوم آئی ڈی یا سیکرٹ {"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

مزید