Notiamo لوكلاء الذكاء الاصطناعي
كل اللي وكيل الذكاء الاصطناعي محتاجه علشان يفتح حساب مجاني لصاحبه، ويحط الـ widget على موقع، ويتعامل مع التعليقات والشغل، من غير متصفح.
الخطوات
- اطلب حساب لصاحبك: ابعت
POST https://my.notiamo.com/api/agent/signupمعemailوnameوagentوlocale، ولو معاكcompanyوprojectUrl(عنوان الموقع) وreferral. الإجابة فيهاrequestIdوpollSecretوpollAfterSeconds. - قول لصاحبك يفتح إيميل التأكيد اللي Notiamo بيبعته ويأكّد. مفيش حاجة بتحصل لحد ما يعمل كده.
- اعمل poll لـ
GET https://my.notiamo.com/api/agent/signup/{requestId}معAuthorization: Bearer <pollSecret>كلpollAfterSecondsثانية. الحالة بتبقىpendingأوconfirmedأوexpiredأوreported. - لما الحالة تبقى
confirmed، الإجابة فيها مفتاحك (token، بيبدأ بـntm_) وmcpUrl، مرة واحدة. خزّن المفتاح على طول: الـ polls اللي بعد كده مش بترجّعه. استلمه في خلال 7 أيام من التأكيد. - اتوصل بسيرفر MCP على
https://my.notiamo.com/api/mcpمع الهيدرAuthorization: Bearer ntm_…. لو تطبيقك بيدعم تسجيل دخول MCP، يقدر يستخدم تسجيل الدخول بـ Notiamo بدل المفتاح (شوف تحت). - نادي
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). - بعدها اشتغل على التعليقات:
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 يوم (مرة لكل شخص؛ المالك بيفتح اللينك ويدخّل كارت). فيه حد يومي؛ والرفض بيقول تقدر تحاول تاني امتى. - علشان تنقل مشروع لمساحة عمل تانية (
kindprojectوprojectIdوtoWorkspaceId)، أو مساحة عمل بمشاريعها لمؤسسة تانية صاحبك أدمن فيها كمان (kindworkspaceو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(statereadyبيعرض اللي مستنيينك)، واقرا واحد بـget_comment، وردّ بـrolearticleبلغته. شخص بس هو اللي بيوافق: اديله لينك الموافقة أو ناديrequest_approval. بعد الموافقة، ردّ بـrolepostsو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بيدّوا دقايق الصوت والذكاء الاصطناعي في الشهر.
ماتعملش 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_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. بيانات سيرفر التفويض (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