Notiamo لوكلاء الذكاء الاصطناعي
كل ما يحتاجه وكيل ذكاء اصطناعي لفتح حساب مجاني لمالكه، ووضع الودجت على موقع، والتعامل مع التعليقات والعمل، دون متصفح.
سير العمل
- اطلب حسابًا لمالكك: أرسل
POST https://my.notiamo.com/api/agent/signupمعemailوnameوagentوlocaleو، إن توفرت لديك،companyوprojectUrl(عنوان الموقع) وreferral. تحتوي الإجابة علىrequestIdوpollSecretوpollAfterSeconds. - اطلب من المالك أن يفتح رسالة التأكيد التي يرسلها Notiamo وأن يؤكد. لا يحدث شيء حتى يفعل.
- استعلم بـ
GET https://my.notiamo.com/api/agent/signup/{requestId}معAuthorization: Bearer <pollSecret>كلpollAfterSecondsثانية. الحالة هيpendingأوconfirmedأوexpiredأوreported. - عندما تكون الحالة
confirmed، تحتوي الإجابة على مفتاحك (token، يبدأ بـntm_) وmcpUrl، مرة واحدة. احفظ المفتاح فورًا: لا تعيده الاستعلامات اللاحقة. استلمه خلال 7 أيام من التأكيد. - اتصل بخادم MCP على
https://my.notiamo.com/api/mcpمع الترويسةAuthorization: Bearer ntm_…. إذا كان تطبيقك يدعم تسجيل الدخول عبر MCP، فيمكنه استخدام Sign in with Notiamo بدل المفتاح (انظر أدناه). - استدعِ
list_projects(أوfind_project) لتجد المشروع المُنشأ لك: فهو يستخدمprojectUrlعنوانًا له. وإذا كان العنوان مفقودًا أو خاطئًا، فاستدعِupdate_project_address. ثمget_install، وثبّت المقطع، وcheck_install. لا تستخدمcreate_workspaceوcreate_projectإلا عندما يتسع للخطة (الخطط المدفوعة أو تجربة Studio)؛ ويحتاجcreate_projectإلىworkspaceIdمنlist_workspaces. تجمع مساحة العمل المشاريع، مثلًا واحدًا لكل عميل. وقد لا يكون للمشروع عنوان ويب (اتركorigin): فيكون له مهام وأعمال وأخبار، لكن بلا ودجت. بعد التثبيت، يعطيget_badgeشارة التذييل: شعار Notiamo صغير لتذييل الموقع يفتح أدوات المراجعة للمراجعين ويبقى رابطًا عاديًا إلى Notiamo لغيرهم، بلغة الموقع (update_project_language، أوlanguageفيcreate_project). - ثم اعمل على التعليقات:
list_commentsوget_commentوreplyوset_status. للتحقق من الجديد، مرّرsinceإلىlist_comments: وقتًا بتوقيت UTC ينتهي بـZ(مثل2026-10-17T08:00:00Z)، أوcursorمن إجابته الأخيرة. تحصل على ما تغيّر فقط، في مشروع واحد أو، دونprojectId، في كل مشاريعك. احتفظ بـcursorالجديد للفحص التالي، واتبعmore: trueفورًا، وأزل التكرار بحسبid: فقد يصل عنصر مرتين. - لمؤسسة أخرى، استدعِ
create_organizationمعname: يصبح المالك مديرها ويصله بريد إلكتروني، ويحمل الردtokenجديدًا لتلك المؤسسة فقط. تكون مجانية إن لم يكن لدى المالك مؤسسة مجانية، وإلا فهي تحتاج إلى خطة: استدعِget_payment_linkبالرمز الجديد، أوstart_trialلتجربة Studio لمدة 14 يومًا (مرة لكل شخص؛ يفتح المالك الرابط ويُدخل بطاقة). هناك حد يومي؛ والرفض يذكر متى يمكنك المحاولة مجددًا. - لنقل مشروع إلى مساحة عمل أخرى (
kindهوprojectمعprojectIdوtoWorkspaceId)، أو مساحة عمل مع مشاريعها إلى مؤسسة أخرى يكون المالك مشرفًا فيها أيضًا (kindهوworkspaceمعworkspaceIdوtoOrganizationId)، استدعِrequest_move. لا ينتقل شيء بعد: يصل المالك بريد إلكتروني وعليه أن يؤكد في الصفحة المرتبطة به خلال 24 ساعة. استدعِget_move_requestللحالة:pendingأوdoneأوcancelledأوexpiredأوfailed. - لإضافة عمل غير مرتبط بصفحة، استدعِ
create_taskمعprojectIdوtitle، واختياريًاtextوpageUrl. ولتغيير صياغته، استدعِupdate_taskمعtaskIdوtitleجديد أوtextأو كليهما. كلاهما يُحتسب ضمن حد يومي لمساحات العمل والمشاريع والمهام الجديدة؛ ويخبرك الرفض متى تبلغه. يعرضlist_commentsالمهام بعلامة[Task]ويقبلtype:taskأوcomment. - تقارير المهام (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. - الملاحظات الصوتية والذكاء الاصطناعي (Studio وAgency والتجربة): يسرد
get_commentكل تسجيل مع رابط الصوت ونصه المفرَّغ بالذكاء الاصطناعي (وأي نص لاحق غير منشور)، وكل فيديو يزيد على نحو 20 ثانية مع ملاحظات الوقت (m:ss–m:ssما يحدث)، والتعليقات التوضيحية بالذكاء الاصطناعي المعلَّمة(AI, not checked)إلى أن يراجعها شخص. وعندما يتعذّر على الذكاء الاصطناعي معالجة ملف، يقول ذلك بالكلمات البسيطة نفسها التي يراها الناس، مع رمز مرجعي (AI-…) للدعم. ويعطيlist_plansوget_billingدقائق الصوت والذكاء الاصطناعي في الشهر.
لا تستعلم أسرع من pollAfterSeconds. وإذا تلقيت rate_limited، فانتظر retryAfter ثانية. ويعيد معرّف أو سر خاطئ أو مجهول الرمز 404 مع {"code":"not_found"}.
إذا كانت منصتك توقّع طلباتها باستخدام 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"}'الخطة المجانية
تسمح الخطة المجانية بمساحة عمل واحدة ومشروع واحد و3 أشخاص (أعضاء الفريق وأعضاء العميل والدعوات المعلّقة، يُحتسب كل بريد مرة) وعنوان عام واحد لكل مشروع. بعد أول تعليق عام على المشروع، يمكن تغيير العنوان مرة واحدة. وتتسع لـ 100 ميغابايت من الملفات، 5 ميغابايت للملف؛ وفوق 100 ميغابايت يصل مشرفي المؤسسة بريدان، ثم تُزال أقدم الملفات، وتبقى التعليقات والمهام والردود. وقد يُرفض الرفع لمنع إساءة الاستخدام. الفيديو غير متضمن: يحتاج إلى Studio أو Agency أو التجربة. توجد مساحة عمل ومشروع بالفعل عند فتح الحساب.
يعرض الودجت شارة Notiamo في الخطة المجانية.
أبقِ سطر التعليق فوق وسم script. فشروط الخطة المجانية تتطلب ذلك:
<!-- 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 | لهذا البريد حساب بالفعل. يسجّل المالك الدخول وينشئ مفتاحًا في الإعدادات > وكلاء الذكاء الاصطناعي > رموز الوكلاء. |
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)، دون سر للعميل.
يسجّل مالكك الدخول، ويختار المؤسسة وما يحق لك تغييره (العمل على الملاحظات مفعّل) والمشاريع، ويضغط سماح. والنطاقات هي مجموعات الصلاحيات أدناه. ويرى مالكك التطبيق في الإعدادات > وكلاء الذكاء الاصطناعي > التطبيقات المتصلة ويستطيع فصله في أي وقت.
الصلاحيات
القراءة لا تحتاج إلى صلاحية. ولتغيير شيء، يحتاج المفتاح أو التطبيق المتصل إلى المجموعة الخاصة به:
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 أو رابط، فمرّر رمزها في الحقل referral من جسم JSON للتسجيل. أما الصيغة ?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