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থাকে। কীটি সঙ্গে সঙ্গে সংরক্ষণ করুন: পরের পোলে তা ফেরত আসে না। নিশ্চিতকরণের ৭ দিনের মধ্যে এটি নিয়ে নিন। Authorization: Bearer ntm_…হেডার সহhttps://my.notiamo.com/api/mcp-এ MCP সার্ভারের সঙ্গে যুক্ত হন। আপনার অ্যাপ MCP সাইন-ইন সমর্থন করলে কীর বদলে Sign in with 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কল করুন, অথবা ১৪ দিনের Studio ট্রায়ালের জন্যstart_trial(প্রতি ব্যক্তি একবার; মালিক লিংকটি খুলে কার্ড দেন)। একটি দৈনিক সীমা আছে; প্রত্যাখ্যানে বলা থাকে কখন আবার চেষ্টা করা যাবে। - একটি প্রজেক্টকে অন্য ওয়ার্কস্পেসে সরাতে (
kindproject,projectId,toWorkspaceId), বা একটি ওয়ার্কস্পেসকে তার প্রজেক্ট সহ মালিক যেখানে অ্যাডমিন সেই অন্য সংস্থায় সরাতে (kindworkspace,workspaceId,toOrganizationId),request_moveডাকুন। এখনো কিছুই সরে না: মালিক একটি ইমেইল পান এবং ২৪ ঘণ্টার মধ্যে তার লিংকের পেজে নিশ্চিত করতে হয়। স্ট্যাটাসের জন্যget_move_requestডাকুন:pending,done,cancelled,expiredবাfailed। - কোনো পেজের সঙ্গে বাঁধা নয় এমন কাজ যোগ করতে
projectIdওtitleসহ, এবং ঐচ্ছিকভাবেtextওpageUrlসহcreate_taskডাকুন। এর শব্দ বদলাতে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(যে ফাইলগুলো ব্যবহার হবে তাদের id) দিয়ে উত্তর দিন।update_fileএকটি ফাইলেরphaseবাcaptionঠিক করে;create_taskওupdate_taskjobReportনেয়। - ভয়েস নোট ও AI (Studio, Agency ও ট্রায়ালে):
get_commentপ্রতিটি রেকর্ডিং তালিকাভুক্ত করে, অডিওর লিংক ও AI-র ট্রান্সক্রিপ্ট সহ (এবং পরের কোনো ট্রান্সক্রিপ্ট, যা পোস্ট করা হয়নি), প্রায় ২০ সেকেন্ডের বেশি প্রতিটি ভিডিও সময়ের নোট সহ (m:ss–m:ssকী ঘটছে), এবং AI ক্যাপশন, কেউ যাচাই না করা পর্যন্ত(AI, not checked)চিহ্ন সহ। AI কোনো ফাইল প্রক্রিয়া করতে না পারলে লোকজন যে সহজ কথা দেখেন সেই কথাতেই তা জানায়, সহায়তার জন্য একটি রেফারেন্স কোড (AI-…) সহ।list_plansওget_billingমাসে ভয়েস ও AI মিনিট জানায়।
pollAfterSeconds-এর চেয়ে দ্রুত পোল করবেন না। rate_limited পেলে retryAfter সেকেন্ড অপেক্ষা করুন। ভুল বা অজানা id বা সিক্রেট {"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"}'বিনামূল্যের প্ল্যান
বিনামূল্যের প্ল্যানে ১টি ওয়ার্কস্পেস, ১টি প্রজেক্ট, ৩ জন (টিম সদস্য, ক্লায়েন্ট সদস্য ও অপেক্ষমাণ আমন্ত্রণ, প্রতিটি ইমেইল একবার) এবং প্রতি প্রজেক্টে ১টি পাবলিক ঠিকানা মেলে। প্রজেক্টের প্রথম পাবলিক মন্তব্যের পর ঠিকানা একবার বদলানো যায়। এতে ১০০ MB ফাইল রাখা যায়, প্রতিটি ৫ MB; ১০০ 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