Notiamo

Notiamo لوكلاء الذكاء الاصطناعي

كل ما يحتاجه وكيل ذكاء اصطناعي لفتح حساب مجاني لمالكه، ووضع الودجت على موقع، والتعامل مع التعليقات والعمل، دون متصفح.

سير العمل

  1. اطلب حسابًا لمالكك: أرسل POST https://my.notiamo.com/api/agent/signup مع email وname وagent وlocale و، إن توفرت لديك، company وprojectUrl (عنوان الموقع) وreferral. تحتوي الإجابة على requestId وpollSecret وpollAfterSeconds.
  2. اطلب من المالك أن يفتح رسالة التأكيد التي يرسلها Notiamo وأن يؤكد. لا يحدث شيء حتى يفعل.
  3. استعلم بـ GET https://my.notiamo.com/api/agent/signup/{requestId} مع Authorization: Bearer <pollSecret> كل pollAfterSeconds ثانية. الحالة هي pending أو confirmed أو expired أو reported.
  4. عندما تكون الحالة confirmed، تحتوي الإجابة على مفتاحك (token، يبدأ بـ ntm_) وmcpUrl، مرة واحدة. احفظ المفتاح فورًا: لا تعيده الاستعلامات اللاحقة. استلمه خلال 7 أيام من التأكيد.
  5. اتصل بخادم MCP على https://my.notiamo.com/api/mcp مع الترويسة Authorization: Bearer ntm_…. إذا كان تطبيقك يدعم تسجيل الدخول عبر MCP، فيمكنه استخدام Sign in with Notiamo بدل المفتاح (انظر أدناه).
  6. استدعِ 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).
  7. ثم اعمل على التعليقات: list_comments وget_comment وreply وset_status. للتحقق من الجديد، مرّر since إلى list_comments: وقتًا بتوقيت UTC ينتهي بـ Z (مثل 2026-10-17T08:00:00Z)، أو cursor من إجابته الأخيرة. تحصل على ما تغيّر فقط، في مشروع واحد أو، دون projectId، في كل مشاريعك. احتفظ بـ cursor الجديد للفحص التالي، واتبع more: true فورًا، وأزل التكرار بحسب id: فقد يصل عنصر مرتين.
  8. لمؤسسة أخرى، استدعِ create_organization مع name: يصبح المالك مديرها ويصله بريد إلكتروني، ويحمل الرد token جديدًا لتلك المؤسسة فقط. تكون مجانية إن لم يكن لدى المالك مؤسسة مجانية، وإلا فهي تحتاج إلى خطة: استدعِ get_payment_link بالرمز الجديد، أو start_trial لتجربة Studio لمدة 14 يومًا (مرة لكل شخص؛ يفتح المالك الرابط ويُدخل بطاقة). هناك حد يومي؛ والرفض يذكر متى يمكنك المحاولة مجددًا.
  9. لنقل مشروع إلى مساحة عمل أخرى (kind هو project مع projectId وtoWorkspaceId)، أو مساحة عمل مع مشاريعها إلى مؤسسة أخرى يكون المالك مشرفًا فيها أيضًا (kind هو workspace مع workspaceId وtoOrganizationId)، استدعِ request_move. لا ينتقل شيء بعد: يصل المالك بريد إلكتروني وعليه أن يؤكد في الصفحة المرتبطة به خلال 24 ساعة. استدعِ get_move_request للحالة: pending أو done أو cancelled أو expired أو failed.
  10. لإضافة عمل غير مرتبط بصفحة، استدعِ create_task مع projectId وtitle، واختياريًا text وpageUrl. ولتغيير صياغته، استدعِ update_task مع taskId وtitle جديد أو text أو كليهما. كلاهما يُحتسب ضمن حد يومي لمساحات العمل والمشاريع والمهام الجديدة؛ ويخبرك الرفض متى تبلغه. يعرض 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. الملاحظات الصوتية والذكاء الاصطناعي (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_blocked403لا يُسمح للشبكة بالتسجيل. يسجّل المالك بنفسه.
country_blocked403Notiamo غير متاح في البلد الذي جاء منه الطلب. ولا يستطيع المالك التسجيل من هناك أيضًا.
rate_limited429طلبات كثيرة. انتظر retryAfter ثانية.
agent_signup_paused503التسجيل عبر الوكلاء متوقف مؤقتًا حاليًا. يسجّل المالك بنفسه.
agent_signup_closed503التسجيل عبر الوكلاء مغلق. يسجّل المالك بنفسه.
account_exists409لهذا البريد حساب بالفعل. يسجّل المالك الدخول وينشئ مفتاحًا في الإعدادات > وكلاء الذكاء الاصطناعي > رموز الوكلاء.
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)، دون سر للعميل.

يسجّل مالكك الدخول، ويختار المؤسسة وما يحق لك تغييره (العمل على الملاحظات مفعّل) والمشاريع، ويضغط سماح. والنطاقات هي مجموعات الصلاحيات أدناه. ويرى مالكك التطبيق في الإعدادات > وكلاء الذكاء الاصطناعي > التطبيقات المتصلة ويستطيع فصله في أي وقت.

الصلاحيات

القراءة لا تحتاج إلى صلاحية. ولتغيير شيء، يحتاج المفتاح أو التطبيق المتصل إلى المجموعة الخاصة به:

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

المزيد