AI ایجنٹس کے لیے Notiamo
وہ سب کچھ جو AI ایجنٹ کو اپنے مالک کے لیے مفت اکاؤنٹ کھولنے، ویب سائٹ پر ویجٹ لگانے اور تبصروں اور کام کو سنبھالنے کے لیے چاہیے، براؤزر کے بغیر۔
عمل
- اپنے مالک کے لیے اکاؤنٹ مانگیں:
email،name،agent،localeاور، اگر آپ کے پاس ہوں،company،projectUrl(ویب سائٹ کا پتہ) اورreferralکے ساتھPOST https://my.notiamo.com/api/agent/signupبھیجیں۔ جواب میںrequestId،pollSecretاورpollAfterSecondsہوتے ہیں۔ - مالک سے کہیں کہ Notiamo کی بھیجی ہوئی تصدیقی ای میل کھولے اور تصدیق کرے۔ جب تک وہ نہ کریں کچھ نہیں ہوتا۔
- ہر
pollAfterSecondsسیکنڈ بعدAuthorization: Bearer <pollSecret>کے ساتھGET https://my.notiamo.com/api/agent/signup/{requestId}پول کریں۔ حالتpending،confirmed،expiredیاreportedہوتی ہے۔ - جب حالت
confirmedہو تو جواب میں آپ کی کلید (token، جوntm_سے شروع ہوتی ہے) اورmcpUrlایک بار ہوتے ہیں۔ کلید فوراً محفوظ کریں: بعد کے پولز اسے نہیں لوٹاتے۔ اسے تصدیق کے 7 دن کے اندر حاصل کریں۔ https://my.notiamo.com/api/mcpپر MCP سرور سے ہیڈرAuthorization: Bearer ntm_…کے ساتھ جڑیں۔ اگر آپ کی ایپ MCP سائن اِن کو سپورٹ کرتی ہے تو وہ کلید کی جگہ Notiamo کے ساتھ سائن اِن استعمال کر سکتی ہے (نیچے دیکھیں)۔- اپنے لیے بنایا گیا پروجیکٹ ڈھونڈنے کے لیے
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)۔ - پھر تبصروں پر کام کریں:
list_comments،get_comment،replyاورset_status۔ نئی چیزیں دیکھنے کے لیےlist_commentsکوsinceدیں:Zپر ختم ہونے والا UTC وقت (جیسے2026-10-17T08:00:00Z)، یا اس کے پچھلے جواب کاcursor۔ آپ کو صرف وہ ملتا ہے جو بدلا، ایک پروجیکٹ پر یا،projectIdکے بغیر، آپ کے تمام پروجیکٹس پر۔ اگلی جانچ کے لیے نیاcursorرکھیں،more: trueکی فوراً پیروی کریں، اورidسے ڈپلیکیٹ ہٹائیں: ایک آئٹم دو بار آ سکتا ہے۔ - دوسری تنظیم کے لیے
nameکے ساتھcreate_organizationکال کریں: مالک اس کا ایڈمن بنتا ہے اور اسے ای میل ملتی ہے، اور جواب میں صرف اس تنظیم کے لیے نیاtokenہوتا ہے۔ اگر مالک کے پاس کوئی مفت تنظیم نہیں تو یہ مفت ہے، ورنہ اسے پلان درکار ہے: نئے ٹوکن کے ساتھget_payment_linkکال کریں، یا 14 دن کی Studio آزمائش کے لیےstart_trial(فی شخص ایک بار؛ مالک لنک کھول کر کارڈ درج کرتا ہے)۔ ایک یومیہ حد ہے؛ انکار میں بتایا جاتا ہے کہ آپ دوبارہ کب کوشش کر سکتے ہیں۔ - پروجیکٹ کو دوسرے ورک اسپیس میں منتقل کرنے کے لیے (
kindproject،projectId،toWorkspaceId)، یا ورک اسپیس کو اس کے پروجیکٹس سمیت دوسرے ادارے میں جہاں مالک بھی ایڈمن ہو (kindworkspace،workspaceId،toOrganizationId)،request_moveکال کریں۔ ابھی کچھ منتقل نہیں ہوتا: مالک کو ای میل ملتی ہے اور اسے 24 گھنٹوں کے اندر اس کے لنک والے صفحے پر تصدیق کرنی ہوتی ہے۔ حالت کے لیےget_move_requestکال کریں:pending،done،cancelled،expiredیاfailed۔ - ایسا کام شامل کرنے کے لیے جو کسی صفحے سے بندھا نہ ہو،
projectIdاورtitleکے ساتھcreate_taskکال کریں، اور اختیاری طور پرtextاورpageUrl۔ اس کے الفاظ بدلنے کے لیےtaskIdاور نئےtitle،textیا دونوں کے ساتھupdate_taskکال کریں۔ دونوں نئے ورک اسپیسز، پروجیکٹس اور کاموں کی روزانہ کی حد میں گنے جاتے ہیں؛ حد پر پہنچنے پر انکار آپ کو بتاتا ہے۔list_commentsکام کو[Task]کے نشان کے ساتھ دکھاتا ہے اورtypeلیتا ہے:taskیاcomment۔ - جاب رپورٹس (Studio، Agency اور آزمائش) وہ کام ہیں جو کلائنٹ کسی مکمل کام کے بارے میں بھرتا ہے: جگہ، تاریخ، آخری گاہک اور مرحلے کے مطابق فائلیں (
before،during،after،other) کیپشنز کے ساتھ۔list_job_reportsکال کریں (statereadyآپ کے منتظر رپورٹس دکھاتا ہے)،get_commentسے ایک پڑھیں، اور اس کی زبان میںrolearticleکے ساتھ جواب دیں۔ صرف انسان منظور کرتا ہے: انہیں منظوری کا لنک دیں یاrequest_approvalکال کریں۔ منظوری کے بعدrolepostsاورfiles(استعمال کی جانے والی فائلوں کی آئی ڈیز) کے ساتھ جواب دیں۔update_fileفائل کاphaseیاcaptionطے کرتا ہے؛create_taskاورupdate_taskjobReportلیتے ہیں۔ - وائس نوٹس اور 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_blocked | 403 | اس نیٹ ورک کو سائن اپ کی اجازت نہیں۔ مالک خود سائن اپ کرے۔ |
country_blocked | 403 | جس ملک سے درخواست آئی ہے وہاں Notiamo دستیاب نہیں ہے۔ مالک بھی وہاں سے سائن اپ نہیں کر سکتا۔ |
rate_limited | 429 | بہت زیادہ درخواستیں۔ retryAfter سیکنڈ انتظار کریں۔ |
agent_signup_paused | 503 | ایجنٹس کے ذریعے سائن اپ فی الحال موقوف ہے۔ مالک خود سائن اپ کرے۔ |
agent_signup_closed | 503 | ایجنٹس کے ذریعے سائن اپ بند ہے۔ مالک خود سائن اپ کرے۔ |
account_exists | 409 | اس ای میل کا اکاؤنٹ پہلے سے ہے۔ مالک لاگ اِن کر کے ترتیبات > AI ایجنٹس > ایجنٹ ٹوکنز میں کلید بناتا ہے۔ |
email_not_accepted | 422 | یہ ای میل پتہ استعمال نہیں ہو سکتا۔ مالک خود سائن اپ کرے۔ |
invalid_input | 422 | ایک فیلڈ درست نہیں۔ field اس کا نام بتاتا ہے۔ |
plan_limit | 402 | پلان کی حد پر پہنچ گئے۔ MCP ٹولز لوٹاتے ہیں، اگلے قدم (start_trial یا get_payment_link) کے ساتھ۔ |
read_only | 403 | یہ کلید یا ایپ صرف پڑھنے کے لیے ہے: دیکھ سکتی ہے لیکن بدل نہیں سکتی۔ MCP ٹولز لوٹاتے ہیں۔ |
permission_missing | 403 | یہ کلید یا ایپ یہ نہیں کر سکتی۔ 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