Notiamo

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

كل اللي وكيل الذكاء الاصطناعي محتاجه علشان يفتح حساب مجاني لصاحبه، ويحط الـ widget على موقع، ويتعامل مع التعليقات والشغل، من غير متصفح.

الخطوات

  1. اطلب حساب لصاحبك: ابعت POST https://my.notiamo.com/api/agent/signup مع email وname وagent وlocale، ولو معاك company وprojectUrl (عنوان الموقع) وreferral. الإجابة فيها requestId وpollSecret وpollAfterSeconds.
  2. قول لصاحبك يفتح إيميل التأكيد اللي Notiamo بيبعته ويأكّد. مفيش حاجة بتحصل لحد ما يعمل كده.
  3. اعمل poll لـ GET https://my.notiamo.com/api/agent/signup/{requestId} مع Authorization: Bearer <pollSecret> كل pollAfterSeconds ثانية. الحالة بتبقى pending أو confirmed أو expired أو reported.
  4. لما الحالة تبقى confirmed، الإجابة فيها مفتاحك (token، بيبدأ بـ ntm_) وmcpUrl، مرة واحدة. خزّن المفتاح على طول: الـ polls اللي بعد كده مش بترجّعه. استلمه في خلال 7 أيام من التأكيد.
  5. اتوصل بسيرفر MCP على https://my.notiamo.com/api/mcp مع الهيدر Authorization: Bearer ntm_…. لو تطبيقك بيدعم تسجيل دخول MCP، يقدر يستخدم تسجيل الدخول بـ Notiamo بدل المفتاح (شوف تحت).
  6. نادي list_projects (أو find_project) علشان تلاقي المشروع اللي اتعمل ليك: هو أصلًا بيستخدم projectUrl بتاعك كعنوانه. لو العنوان ناقص أو غلط، نادي update_project_address. بعدها get_install، وركّب الـ snippet، وcheck_install. استخدم create_workspace وcreate_project لما الخطة يكون فيها مكان بس (الخطط المدفوعة أو تجربة Studio)؛ وcreate_project محتاج workspaceId من list_workspaces. مساحة العمل بتجمّع المشاريع، مثلًا واحدة لكل عميل. المشروع ممكن يبقى من غير عنوان ويب (سيب origin): ساعتها بيبقى فيه مهام وشغل وأخبار، من غير widget. بعد التسطيب، 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 بيدّوا دقايق الصوت والذكاء الاصطناعي في الشهر.

ماتعملش poll أسرع من 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 أو التجربة. مساحة العمل والمشروع موجودين أصلًا لما الحساب بيتفتح.

الـ widget بيعرض شارة 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. بيانات سيرفر التفويض (authorization server metadata) على 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)، من غير client secret.

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

الصلاحيات

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

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 body بتاع التسجيل. شكل ?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

المزيد