ForHosting KIT · التنبيهات وسير العمل

حدّد وقت إرسال البريد مسبقًا

notify.email_scheduled يجدول إرسال رسالة بريد إلكتروني لتاريخ ووقت تحدّدهما مسبقًا: تكتب الرسالة الآن وتنطلق بنفسها في الجمعة الساعة الثامنة صباحًا مثلًا. يناسب تذكير استحقاق الفاتورة، وإشعار الصيانة، والتذكير الدوري — دفع مقابل كل رسالة، دون مهمة مجدولة تديرها بنفسك على خادمك.

● مستقرةلكل طلب · لكل بريد إلكتروني$0.002

اطّلع على الـAPI — $0.002 + $0.0035/بريد إلكتروني اطّلع على الـAPI

استخدمها من الويبAPIالبريدالتطبيق قريبًاTelegram قريبًا

لحظة الكتابة غير لحظة الإرسال

يغيّر توقيت الإرسال مصير الرسالة كليًا. تذكير استحقاق يصل صباح الأحد يُحلّ في وقته؛ الرسالة نفسها ليلة الجمعة تضيع بين رسائل أخرى. إشعار صيانة يجب أن يصل قبل موعد التوقف، لا خلاله. تفصل الجدولة بين القرارين: تُكتَب الرسالة حين يتوفر الوقت والهدوء، وينطلق الإرسال حين يكون المستلم جاهزًا للتصرف — يجهّز نظامك كل شيء مسبقًا دون حاجة لمن يراقب الساعة.

كيف تُحدَّد اللحظة

يحمل الطلب على /notify/email-scheduled الحقول المعتادة — المستلم والموضوع والنص — إضافة إلى لحظة الإرسال. حدّد الوقت بدقة لتفادي أي التباس، فيُرسل السؤال الشائع «أي توقيت؟» من الأصل. تحصل على task_id فور الجدولة، وتنطلق الرسالة بنفسها حين تحين اللحظة المحددة دون طلب إضافي من جهتك. يمكن جدولة عشرات الرسائل من طلبات منفصلة، كل واحدة بلحظتها الخاصة، دون أي تعارض بينها مهما اقتربت مواعيدها من بعضها.

تذكيرات لا تعتمد على أحد يتذكّر

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

ما تدفعه

الجدولة لا تكلّف شيئًا إضافيًا: نفس $0.002 للطلب و$0.0035 للإرسال، أي $0.0055 للرسالة، سواء أُرسلت الآن أو بعد أسبوع. مئة تذكير استحقاق في الشهر تجمع $0.55، وألف تذكير عبر عدة أقسام في شركة متوسطة الحجم يجمع $5.50 فقط. الدفع مقابل الاستخدام، لا مقابل وقت الانتظار: لا رسوم على مهمة مجدولة لم يحن موعدها بعد، حتى لو بقيت أسابيع كاملة في الانتظار قبل لحظة الإرسال.

حالات الاستخدام

تذكير قبل استحقاق الفاتورة

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

إشعار صيانة مجدول

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

فاتورة صيانة شهرية لمستقل

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

رسالة عرض خاص في مناسبة

تجدول مؤسسة النخيل للمقاولات رسالة تهنئة بمناسبة تجديد عقود عملائها السنوية، تحمل عرضًا خاصًا يصل في الموعد الدقيق دون تدخل يدوي كل عام.

الأسئلة الشائعة

بأي توقيت يُحدَّد وقت الإرسال؟

بالتوقيت الذي تحدّده صراحة عند الجدولة. لتفادي أي التباس، حدّد فارق التوقيت بوضوح — مثلًا توقيت السعودية أو الإمارات — عند إعداد الطلب.

هل تكلّف الجدولة أكثر من الإرسال الفوري؟

لا، السعر مطابق تمامًا: $0.002 للطلب و$0.0035 للإرسال. لا رسوم على مدة الانتظار قبل الإرسال.

هل يمكن جدولة إرسال متكرر، مثل كل يوم أول من الشهر؟

هذه الوظيفة تجدول رسالة واحدة لموعد محدد. للتكرار الدوري، توجد قدرة منفصلة لجدولة تشغيل مهام متكررة تناسب هذا النمط بدقة.

هل تُحفظ الرسالة حتى موعد الإرسال؟

نعم، تبقى محجوزة حتى اللحظة المحددة ثم تُعالَج للتسليم. تجنّب جدولة محتوى حساس بأسابيع مسبقًا إن لم يكن ذلك ضروريًا.

هل يمكن إلغاء رسالة مجدولة قبل موعدها؟

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

هل تدعمون الدفع بالريال أو الدرهم؟

السعر معلن بالدولار الأمريكي عبر PayPal فقط حاليًا. نفضّل ذكر ذلك بوضوح بدل تقديم وعد بعملة محلية قد لا نستطيع الوفاء به.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/notify/email-scheduled

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/notify/email-scheduled \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/notify/email-scheduled", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/notify/email-scheduled",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/notify/email-scheduled", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/notify/email-scheduled", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "input": "…"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "notify.email_scheduled",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

لكل بريد إلكتروني$0.0035

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←