واجهة API للإشعارات الفورية

إشعارات فورية من cURL.
ينتهي السكربت، فيهتز هاتفك.

أرسل إشعارًا فوريًا إلى هاتف iPhone أو Android باستدعاء cURL واحد. ضعه في نهاية عملية نشر أو نسخ احتياطي أو مهمة CI أو تدريب طويل، فيصلك التنبيه أينما كنت.

لا تطبيق تنشره، ولا مشروع Firebase، ولا شهادة APNs. أنشئ صندوق وارد في AgentsRoom، وانسخ نقطة النهاية الخاصة به ومفتاح الإرسال فقط، وسيبقى كل إشعار أيضًا في سجل قابل للبحث على حاسوبك وهاتفك.

نزّل AgentsRoomشاهد طريقة العمل
deploy.sh

$ curl POST /api/dev-inboxes/…/push

{"title":"اكتمل النشر"}

202 Accepted

هاتفكالآن

اكتمل النشر

api v2.4 يعمل الآن في بيئة الإنتاج

طلب HTTPS واحد من أي سكربت، وإشعار واحد على هاتفك، ونسخة محفوظة في صندوق الوارد.

معظم المهام الطويلة تنتهي بصمت. انتهى النشر قبل عشرين دقيقة، وفشل النسخ الاحتياطي الليلي في الثالثة فجرًا، وعملية الترحيل ما زالت تنتظرك، ولا تعرف بذلك إلا حين تذهب لتتحقق بنفسك. الإشعار الفوري أرخص طريقة لتتوقف عن التحقق، لكن إعداده يتطلب عادةً تطبيقًا للهاتف ومشروع Firebase وشهادات يجب تجديدها.

AgentsRoom موجود أصلًا على هاتفك. واجهة API للإشعارات الفورية تجعله المستقبِل: لكل صندوق وارد نقطة نهاية HTTPS خاصة به ومفتاح للإرسال فقط، وكل ما يستطيع تشغيل cURL يمكنه الآن الوصول إلى شاشة القفل لديك. سكربت shell، أو خطوة في GitHub Actions، أو مهمة cron، أو حدث على خادم تطبيقك.

يُخزَّن كل تنبيه أيضًا على الخادم، في صندوق وارد يمكنك البحث فيه من حاسوبك أو هاتفك. يمكن أن يكون حاسوبك مغلقًا: نقطة النهاية وصندوق الوارد والتسليم كلها تعمل على خوادم AgentsRoom.

كل ما يحتاجه الإشعار، دون أي استضافة من جهتك

جسم JSON واحد، وترويسة واحدة للمفتاح، وبعض الضمانات المهمة حين يعمل السكربت دون مراقبة.

عنوان ونص ورابط وصورة

أرسل عنوانًا حتى 160 حرفًا، ونصًا حتى 16,000 حرف، ورابطًا يُفتح، وصورة HTTPS عامة. يعرض الهاتف معاينة قصيرة، ويحتفظ صندوق الوارد بالنص الكامل.

بصوت أو بصمت

لكل صندوق وارد صوت افتراضي، ويمكن لكل طلب تغييره: صوت الجهاز لنسخ احتياطي فاشل، والوضع الصامت لتقرير روتيني.

لا تكرار عندما يعيد السكربت المحاولة

أضف ترويسة Idempotency-Key، فيُعيد الطلب المكرر الرسالة نفسها بدل أن يهتز هاتفك مرتين. ولا يُحتسب مرة أخرى من حصتك.

مفاتيح للإرسال فقط يمكنك إلغاؤها

المفتاح الموجود في سكربتك يستطيع الإرسال فقط. لا يمكنه قراءة صندوق الوارد ولا تغيير إعداداته. أعد توليده إن تسرّب، أو ألغِه لإيقاف الرسائل الجديدة فورًا.

يعمل وحاسوبك مطفأ

نقطة النهاية وصندوق الوارد يعملان على الخادم. سجّل الدخول إلى تطبيق AgentsRoom للهاتف بالحساب نفسه، واسمح بالإشعارات، وأغلق حاسوبك المحمول.

خاص، أو مشترك عن قصد

ينتمي صندوق الوارد إلى حسابك أو إلى مشروع واحد. ضمن Team أو مجموعة Pro، اختر الزملاء الذين يتلقون تنبيهاته أيضًا. لا يرون المفتاح أبدًا.

التكامل كله طلب واحد

انسخه من إعدادات صندوق الوارد، مع نقطة النهاية والمفتاح الحقيقيين مملوءين مسبقًا.

تنبيه نشر من سكربت shellPOST /push
curl -X POST https://agentsroom.dev/api/dev-inboxes/INBOX_ID/push \
  -H 'Authorization: Bearer SENDING_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: deploy-2481' \
  -d '{"title":"Deploy finished","body":"api v2.4 is live","sound":"default",
       "linkUrl":"https://example.com/releases/2481"}'

الاستجابة 202 تعني أن الرسالة مخزّنة في صندوق الوارد. بعدها يعتمد التسليم إلى الهاتف على نظام التشغيل وإعدادات الإشعارات لديك وخدمة الإشعارات الفورية. على Windows، يمنحك زر النسخ نسخة PowerShell تستدعي curl.exe.

من الصفر إلى إشعارك الأول

ثلاث خطوات، نحو دقيقتين، دون حساب على خدمة أخرى.

01

افتح «إشعارات فورية» وأنشئ صندوق وارد

داخل مشروع، انقر على «إشعارات فورية» في شريط المشروع، أو افتحه من إعدادات الإشعارات. اختر حسابك أو المشروع الحالي، وابدأ من قالب مثل «تثبيت جديد» أو «اكتمل النشر».

02

انسخ أمر cURL

يعرض قسم «الاتصال والإعدادات» نقطة النهاية ومفتاح الإرسال فقط وطلبًا جاهزًا للتشغيل. عدّل العنوان والنص، ثم احفظ التكامل ليرافقك القالب نفسه على كل جهاز.

03

شغّله من سكربتك

الصق الأمر في نهاية سكربت النشر أو مهمة CI أو مهمة cron. في التشغيل التالي يُرسَل الإشعار، وتظهر الرسالة في تبويب «إشعارات فورية» على الحاسوب والهاتف.

ما يربطه المطورون أولًا

كل ما ينتهي وأنت لا تراقبه مرشّح جيد.

اكتمال النشر أو فشله

أضف سطرًا واحدًا في نهاية سكربت النشر أو مهمة CI، مع رابط إلى الإصدار أو إلى سجلات الخطأ.

مستخدم جديد أو تثبيت جديد

استدعِ نقطة النهاية من الخادم الخلفي عندما يسجّل أحدهم أو يثبّت تطبيقك أو يرقّي اشتراكه، واحتفل من هاتفك.

النسخ الاحتياطي ومهام cron

استخدم صوت الجهاز عند فشل النسخ الاحتياطي الليلي، والوضع الصامت عند نجاحه. يُظهر السجل الليالي التي حدثت فيها مشكلة.

عمليات البناء والاستيراد والتدريب الطويلة

توقف عن تفقد الطرفية كل عشر دقائق. المهمة تخبرك حين تنتهي، حتى لو غادرت مكتبك.

مصمَّم ليعمل داخل سكربتاتك

ينتقل المفتاح في ترويسة Authorization، وليس في الرابط أبدًا، فلا ينتهي به الأمر في سجلات الخوادم الوسيطة. طوله 192 بت، ويُخزَّن مُجزّأً (hash) للبحث، ولا يُعرض إلا لمالك صندوق الوارد.

المفتاح المسرّب يُقطع بنقرة واحدة: أعد توليده فيُرفض القديم بدءًا من الطلب التالي، أو ألغِه ليتوقف صندوق الوارد عن قبول أي شيء. تبقى الرسائل المستلمة سابقًا قابلة للقراءة.

تعامل مع ما يصل كمحتوى غير موثوق. تُحمَّل الصور من مضيفها العام حين تفتح الرسالة، ولا تُفتح الروابط إلا حين تنقر عليها.

MCP

اطلب من وكيلك إعداده

dev_inboxes_listdev_inbox_createdev_inbox_configuredev_inbox_membersdev_inbox_messagesdev_inbox_test

قل «أرسل لي إشعارًا على هاتفي عندما يثبّت أحدهم تطبيقي» ويستطيع وكيل البرمجة بالذكاء الاصطناعي إنشاء صندوق الوارد وضبط القالب وإضافة الاستدعاء إلى شيفرتك بأدوات AgentsRoom MCP. كل وكيل يحصل عليها، أيًا كانت أداة CLI التي يعمل بها: Claude Code و Codex و Antigravity وغيرها.

يستأذنك الوكيل قبل تغيير أي إعداد أو مشاركة صندوق وارد، ولا يضع أبدًا مفتاح إرسال في مستودعك.

اكتشف AgentsRoom MCP

الحصة الشهرية للإشعارات الفورية

تُحتسب لكل شهر ميلادي، عبر جميع صناديق الوارد لديك. للبريد الإلكتروني حصة مستقلة خاصة به.

زائر

10

شهريًا

مجاني

100

شهريًا

Plus

200

شهريًا

Pro

غير محدود

مقاعد Team تشمل Pro. تُحفظ الرسائل لمدة 90 يومًا، وحذف رسالة لا يعيد إشعارها إلى الحصة.

قارن الخطط

خدماتك ترسل رسائل بريد إلكتروني بدل طلبات HTTP؟ امنحها عنوانًا مخصصًا بدلًا من ذلك.

صندوق البريد الإلكتروني للمطوّر

تريد أن تعرف متى ينهي وكيل ذكاء اصطناعي دوره، لا متى ينتهي سكربتك؟ هذا إشعار منفصل ومدمج في التطبيق.

إشعارات الوكلاء

واجهة API للإشعارات الفورية: أسئلة شائعة

كيف أرسل إشعارًا فوريًا إلى هاتفي من cURL؟

أنشئ صندوق وارد للإشعارات الفورية في AgentsRoom، وانسخ نقطة النهاية ومفتاح الإرسال فقط من «الاتصال والإعدادات»، ونفّذ طلب POST بجسم JSON يحتوي على عنوان على الأقل. سجّل الدخول إلى تطبيق AgentsRoom للهاتف بالحساب نفسه واسمح بالإشعارات لتستقبله.

هل يجب أن يبقى حاسوبي يعمل؟

لا. نقطة النهاية وصندوق الوارد والتسليم تعمل على خوادم AgentsRoom. يمكن أن يكون حاسوبك المحمول مغلقًا: يصل الإشعار إلى هاتفك رغم ذلك وتنتظرك الرسالة في صندوق الوارد.

هل يعمل على iPhone و Android معًا؟

نعم. تصل الإشعارات إلى كل جهاز سجّل الدخول بحسابك في تطبيق AgentsRoom للهاتف على iOS و Android. النقر على إشعار يفتح الرسالة في صندوق الوارد الصحيح.

ماذا يمكن أن يحتوي الإشعار؟

عنوانًا حتى 160 حرفًا، ونصًا حتى 16,000 حرف، وصورة HTTPS عامة اختيارية، ورابط HTTPS اختياريًا، والصوت: صوت الجهاز الافتراضي أو الوضع الصامت. ملفات الأصوات المخصصة غير مدعومة.

كيف أتجنب الإشعارات المكررة عندما يعيد سكربتي المحاولة؟

أرسل ترويسة Idempotency-Key بقيمة فريدة للحدث، مثل رقم عملية النشر. إعادة المحاولة بالقيمة نفسها تُعيد الرسالة الأصلية دون إشعار ثانٍ ودون استهلاك حصتك مرة أخرى.

ماذا يحدث إذا تسرّب مفتاح الإرسال؟

المفتاح يستطيع إرسال الرسائل فقط، ولا يقرأها أبدًا. أعد توليده من إعدادات صندوق الوارد فيُرفض المفتاح القديم بدءًا من الطلب التالي، أو ألغِه لإيقاف الرسائل الجديدة حتى تنشئ مفتاحًا جديدًا.

كم عدد الإشعارات التي يمكنني إرسالها؟

لكل شهر ميلادي وعبر جميع صناديق الوارد لديك: 10 كزائر، و100 بحساب مجاني، و200 مع Plus، وعدد غير محدود مع Pro. مقاعد Team تشمل Pro. للبريد الإلكتروني حصته الخاصة.

هل يمكن لزملائي تلقي التنبيهات نفسها؟

نعم، ضمن Team أو مجموعة Pro. يختار المالك الزملاء الذين يمكنهم قراءة صندوق الوارد وتلقي إشعاراته. لا يرون مفتاح الإرسال أبدًا ولا يمكنهم تغيير الإعدادات.

ميزات ذات صلة

صندوق البريد الإلكتروني للمطوّر

امنح كل مشروع عنوان بريد إلكتروني مخصصًا للاستقبال. تنبيهات الخدمات وتقارير cron ورسائل التطبيق تصل إلى AgentsRoom، وتُقرأ على الحاسوب والهاتف، لا في بريدك الشخصي.

الإشعارات

شارات غير المقروءة وتنبيهات سطح المكتب وعدّادات Dock تخبرك أي وكيل انتهى. وإشعار الهاتف يحمل صورة الوكيل، فتعرف من هو قبل فتح القفل.

المُشغِّلات: وضع webhook

أطلق وكيل برمجة بالذكاء الاصطناعي من webhook بدلًا من الساعة. الصق رابطًا عامًا واحدًا في GitHub أو GitLab أو Slack أو Linear أو Sentry أو أي خدمة تستطيع إرسال POST بصيغة JSON، ويبدأ AgentsRoom وكيلًا في اللحظة التي يصل فيها الحدث: طلب سحب فُتح، أو بناء فشل، أو تذكرة أُنشئت، أو تنبيه انطلق. التوقيع يُتحقَّق منه، ومرشِّح اختياري على الحمولة، وحدّ للرشقات، وتتحول الحمولة إلى متغيرات في النص التوجيهي. الوكيل الذي يستطلع في حلقة يكلّفك رموزًا في كل دورة؛ ومُشغِّل webhook لا يكلّف شيئًا حتى يحدث شيء.

الرفيق المحمول

أملِ التعليمات وأرفق ملفات من هاتفك. شارك لقطات شاشة على iOS أو Android، واختر مشروعًا، ثم أرسلها إلى وكيل أو احفظها في قائمة انتظار المشروع.

دع سكربتاتك تنبّهك بنفسها

نزّل AgentsRoom، وأنشئ صندوق وارد للإشعارات الفورية، وأرسل إشعارك الأول في دقيقتين.

مجانيتحميل AgentsRoom

التطبيق المرافق: تابع وكلاءك أينما كنت

حمّل من
App Store
احصل عليه من
Google Play

استخدم Claude أو Codex أو Antigravity CLI أو أي مزود AI آخر.

تثبيت الملحق
Chrome Web Store

أرسل الأخطاء والطلبات مباشرة إلى قائمة المهام العامة.

مشاريع متعددة
متعدد المزوّدين
وكلاء متعددون
حالة مباشرة
فرق الملفات والـ commit
تطبيق الهاتف
معاينة مباشرة
فرق الوكلاء
أتمتة المتصفح
تطوير موجّه بالـ backlog
مكتبة البرومبت
مكتبة المهارات
عرض جميع الميزات