استخدام API موحّدة لـ SMTP
اجمع حسابات SMTP المتعددة الخاصة بك في مخرج إرسال واحد، وتتولى المنصة التدوير بينها:
- تُفعَّل الخطة المجانية تلقائيًا عند أول استخدام؛ والحصة والميزات المتاحة والحدود حسب الباقة، ولتبديل الباقة استخدم «تغيير الباقة»، وتُحتسب المدة غير المستخدمة بسعرها الأصلي
- أضف الحساب أولًا في «حسابات SMTP»، ثم أنشئ المفتاح في «مفاتيح API»؛ يتطلب الإنشاء وإعادة الضبط التحقق من الهوية، ولا يظهر المفتاح إلا مرة واحدة
- ثلاث طرق للإرسال: الكتابة عبر الإنترنت، والحملات، واستدعاء API؛ وتدمج الحملات العناوين وتزيل التكرار وتتخطى قائمة إلغاء الاشتراك تلقائيًا
- إذا فشل حساب SMTP في الإرسال 3 مرات متتالية بسبب مشكلة في الحساب نفسه تصبح حالته «خطأ»، ويُستعاد تلقائيًا بعد نجاح فحص المنصة
- الأخطاء الشائعة: 400 يُعالج وفق message (نفاد الحصة، أو الإبلاغ عن المستلم بأنه مرتدّ، وغير ذلك)، و401 يعني أن المفتاح غير صالح، و403 يعني أن الحساب مقيّد، و429 يعني أن الطلبات متكررة جدًا
ما تفعله هذه الخدمة
تجمع واجهة API الموحّدة لخدمات SMTP حسابات الإرسال المتعددة الخاصة بك عبر SMTP في مخرج إرسال واحد: يتكامل نظامك مع المنصة مرة واحدة، وتتولى المنصة التدوير بين هذه الحسابات. يمكنك الإرسال مباشرةً من لوحة التحكم، أو من نظامك عبر API.
- تناسب بريد المعاملات كرموز التسجيل وإشعارات الطلبات، وكذلك الإرسال الجماعي لمجموعات جهات الاتصال.
- تُفعَّل الخطة المجانية تلقائيًا عند أول استخدام. بعد إضافة حساب SMTP وإنشاء مفتاح API يمكنك الإرسال؛ وعندما تحتاج إلى حصة أو ميزات أكثر غيّر الباقة.
- المدخل في لوحة التحكم هو «واجهة API موحّدة لخدمات SMTP»، وصفحاتها مقسّمة إلى ثلاث مجموعات: «الإرسال» و«التكامل» و«الإعدادات».
بعض المصطلحات أولًا
توجد صفحات كثيرة؛ وفهم هذه المفاهيم يساعدك على اختيار الصفحة الصحيحة.
- الباقة — تحدّد عدد الرسائل التي يمكنك إرسالها يوميًا وشهريًا، والميزات المتاحة (قوالب البريد وجهات الاتصال والحملات وWebhook) والحد الأقصى لكلٍّ منها، وكل ذلك مكتوب بندًا بندًا على بطاقات صفحة «شراء باقة». تُفعَّل الخطة المجانية تلقائيًا عند أول استخدام؛ وبعد انتهاء الباقة المدفوعة يعود الحساب إلى الخطة المجانية.
- حساب SMTP — حساب إرسال SMTP خاص بك (لدى مزوّد بريد أو على خادم تديره بنفسك)، ولا توفر المنصة قناة إرسال. يمكنك إضافة عدة حسابات، وضبط أولوية وحد إرسال يومي لكلٍّ منها، وتدوّر المنصة بينها.
- مفتاح API — بيانات الاعتماد التي يستخدمها نظامك عند استدعاء واجهة الإرسال. يحدّد مفتاح API «من يستدعي»، ويحدّد حساب SMTP «أي بريد يُرسل منه».
- نطاق الإرسال — النطاق الذي يلي @ في بريد الإرسال الخاص بك. افحص سجلات SPF وDKIM وDMARC الخاصة به في صفحة «نطاقات الإرسال»، فاكتمالها يزيد فرص وصول البريد إلى صندوق الوارد.
- قائمة إلغاء الاشتراك — العناوين التي ألغى أصحابها الاشتراك عبر رابط الإلغاء، والعناوين التي أبلغ عنها نظامك عبر الواجهة بأنها مرتدّة أو مُشتكى منها. تتخطى المنصة هذه العناوين تلقائيًا وفق القائمة، دون حاجة إلى صيانتها يدويًا.
إرسال أول بريد
- تأكّد من الباقة: تُفعَّل الخطة المجانية تلقائيًا عند أول دخول. في «واجهة API موحّدة لخدمات SMTP ← شراء باقة» ترى باقتك الحالية وحصة كل باقة؛ وعندما تحتاج إلى حصة أو ميزات أكثر اشترك في فئة أعلى.
- أضف حساب SMTP: في صفحة «حسابات SMTP» اضغط «إضافة حساب»، وأدخل عنوان الخادم والمنفذ واسم المستخدم وكلمة المرور وبريد الإرسال. يعتمد عدد الحسابات التي يمكنك إضافتها على الباقة، وعند إضافة عدة حسابات تدوّر المنصة بينها تلقائيًا.
- أنشئ مفتاح API: في صفحة «مفاتيح API» اضغط «إنشاء مفتاح API». يتطلب الإنشاء وإعادة الضبط التحقق من هويتك أولًا: إذا كان التحقق بخطوتين مفعّلًا فأدخل الرمز المتغيّر، وإلا فرمز التحقق المرسل إلى البريد؛ وبعد التحقق مرة واحدة لا يلزم تكراره خلال 10 دقائق في جلسة الدخول نفسها. يظهر المفتاح مرة واحدة فقط، فانسخه واحفظه فورًا؛ ولكل حساب 50 مفتاحًا كحد أقصى.
- أرسل بريدًا تجريبيًا: في صفحة «حسابات SMTP» اضغط «اختبار» لاختبار الاتصال، أو لإرسال بريد تجريبي إلى بريدك. لا يستهلك البريد التجريبي حصة الإرسال، فجرّب بقدر ما تحتاج.
إذا كانت لديك باقة مدفوعة، اختر فئة أخرى في صفحة «شراء باقة» واضغط «تغيير الباقة» لتبديلها، ويسري التغيير فورًا: تُحتسب المدة المتبقية من الباقة الحالية بسعرها الأصلي وتُخصم من السعر، فتدفع الفرق فقط؛ وما يزيد من المبلغ المحتسب على سعر الباقة الجديدة يُحوَّل إلى مدة إضافية تُمدَّد بها، ولا يُعاد إلى الرصيد؛ وتنتقل الحصة المستخدمة هذا الشهر إلى الباقة الجديدة.
بعد حذف مفتاح API تفشل كل الطلبات التي ما زالت تستخدمه؛ وإعادة الضبط كذلك تُبطل المفتاح الأصلي فورًا. للمفتاح الذي يستخدمه نظام الإنتاج، ضع المفتاح الجديد في مكانه أولًا ثم تعامل مع القديم.
ثلاث طرق للإرسال
حصة واحدة وثلاثة مسارات؛ اختر حسب الحالة:
- كتابة عبر الإنترنت — اكتب وأرسل من اللوحة، للإشعارات الفردية والإعادة اليدوية.
- الحملة — اختر قالبًا ومجموعات للإرسال الجماعي مع ضبط المعدّل والتتبّع والجدولة. يدمج النظام ويزيل التكرار ويستبعد قائمة الإلغاء.
- استدعاء API — يستدعي نظامك النقطة مباشرةً. يدعم طلب واحد عدة مستلمين بمتغيرات قالب خاصة لكل منهم.
القوالب والمتغيرات
ضع المحتوى في قالب ومرّر المتغيرات عند الإرسال، لفصله عن الكود.
- تُدار القوالب في صفحتها وتُستدعى بالمعرّف عند الإرسال؛ تستبدل المنصة المتغيرات.
- تستخرج المنصة بديلًا نصيًا من HTML لقراءة الرسالة حيث لا يُدعم HTML.
جهات الاتصال وإلغاء الاشتراك
تدير صفحة «جهات الاتصال» العناوين والمجموعات، وتدعم الاستيراد والتصدير بملفات CSV؛ وعند الإرسال الجماعي تختار المستهدفين حسب المجموعة.
- تُدمج المجموعات وتُزال التكرارات، فلا يستقبل أحد الرسالة نفسها مرتين.
- عند الاستيراد من CSV، تُتخطّى العناوين التي ألغت الاشتراك تلقائيًا.
- يؤدي رابط الإلغاء إلى صفحة تأكيد؛ يضيف التأكيد العنوان للقائمة ويعلّم جهة الاتصال.
تسري قائمة إلغاء الاشتراك تلقائيًا. العناوين المُبلغ عنها بأنها مرتدّة أو مُشتكى منها لا يُسلَّم إليها أي بريد بعد ذلك؛ أما العناوين التي ألغت الاشتراك عبر الرابط فلا تُتخطّى إلا في الحملات والإرسال المجمّع، وتُرسل إليها الرسائل الفردية مثل رموز التحقق كالمعتاد.
نطاقات الإرسال
أضف في صفحة «نطاقات الإرسال» النطاق الذي ترسل منه (الجزء الذي يلي @ في بريد الإرسال)، ويمكنك في الوقت نفسه إدخال محدِّد DKIM (يوفره مزوّد البريد). تفحص المنصة سجلات SPF وDKIM وDMARC، وتقترح سجلات DNS التي يُنصح بإضافتها مع درجة السلامة. عند اكتمال السجلات يصل البريد إلى صندوق الوارد بسهولة أكبر. هذه الخطوة ليست شرطًا للإرسال؛ ويعتمد عدد النطاقات التي يمكن إضافتها على الباقة.
Webhooks والأحداث
اضبط Webhook لمعرفة مصير الرسائل؛ تستدعي المنصة خدمتك بأحداث التسليم.
- تغطّي الأحداث عملية التسليم ونتيجتها وإلغاء المستلم الاشتراك واكتمال الحملة.
- الاستدعاءات موقّعة؛ يجب أن يتحقّق خادمك من التوقيع قبل الوثوق بها. هذه حدود الأمان فلا تتجاوزها.
الأخطاء الشائعة ومعالجتها
عند فشل استدعاء الواجهة، راجع أولًا رمز حالة HTTP والحقل message في الرد، ثم تصرّف وفق الجدول أدناه.
- يُعاد 400 — رُفض الطلب: نفدت الحصة، أو أُبلغ عن المستلم بأنه مرتدّ أو مُشتكى منه، أو لا يوجد حساب SMTP متاح، أو هناك خطأ في المعاملات، وغير ذلك — تصرّف وفق message. إذا نفدت الحصة فانتظر إعادة ضبطها (تُعاد الحصة اليومية عند منتصف الليل بتوقيت المنطقة الزمنية لحسابك، ويمكن تغيير المنطقة الزمنية في إعدادات الحساب؛ وتُعاد الحصة الشهرية في بداية كل شهر)، أو انتقل إلى باقة أعلى؛ وإذا أفادت الرسالة بعدم وجود حساب SMTP متاح، فراجع الحالة في صفحة «حسابات SMTP».
- يُعاد 401 — لم يُرسل مفتاح API، أو المفتاح غير صالح أو معطّل أو محذوف أو أُعيد ضبطه — تأكّد من الحالة في صفحة «مفاتيح API»، واستبدل المفتاح في نظامك بالمفتاح الصالح حاليًا.
- رد 403 — الحساب مجمّد أو مقيّد — الحساب المقيّد (رمز الخطأ 4031) يظل قادرًا على استدعاء واجهات الاستعلام، لكن الإرسال يُرفض. يُرجى التواصل مع الدعم.
- رد 429 — طلبات متكررة جدًا: 20 طلبًا في الثانية كحد أقصى لكل مفتاح API، و60 طلبًا في الثانية كحد أقصى لمجموع الحساب — انتظر قليلًا وفق ترويسة الرد Retry-After ثم أعد الإرسال. وإذا أردت الإرسال إلى أشخاص كثيرين، فاستخدم طلبًا واحدًا بعدة مستلمين أو حملة، ولا تستدعِ الواجهة بسرعة لكل رسالة على حدة.
- يُرسل البريد لكنه يصل للرسائل غير المرغوب فيها — نطاق غير مهيّأ أو محتوى يفعّل الفلاتر — افحص SPF وDKIM وDMARC في صفحة «نطاقات الإرسال» وأكمل سجلات DNS وفق الاقتراحات، ثم راجع المحتوى؛ وقبل الحملة الفعلية يمكنك الفحص أولًا عبر «تجربة التسليم».
إذا فشل حساب SMTP في الإرسال 3 مرات متتالية بسبب مشكلة في الحساب نفسه، مثل فشل تسجيل الدخول أو تعذّر الاتصال بالخادم، تصبح حالته «خطأ» ويُستبعد مؤقتًا من التدوير. تفحصه المنصة تلقائيًا على فترات، ويُستعاد عند نجاح الفحص؛ ويمكنك أيضًا من صفحة «حسابات SMTP» اختبار اتصاله أو إرسال بريد تجريبي منه فيُستعاد عند النجاح، أو تصحيح بيانات الاتصال، أو تفعيله يدويًا.
الأسئلة الشائعة
ضبطت كل شيء، فلماذا لا يزال الإرسال لا يعمل؟
تحقّق بالترتيب: هل في «حسابات SMTP» حساب مفعّل (الحسابات بحالة «خطأ» لا تشارك في الإرسال)؛ وهل مفتاح API المستخدم هو المفتاح الصالح حاليًا؛ وهل نفدت حصة اليوم أو الشهر. وتوضّح message في رد الواجهة السبب المحدد.
هل تستهلك الرسائل التجريبية الحصة؟
لا. الإرسال التجريبي من صفحة «حسابات SMTP» لا يُحتسب من حصة الإرسال، فجرّب بحرية أثناء الإعداد.
ماذا يحدث بعد انتهاء الباقة المدفوعة؟
بعد الانتهاء يعود الحساب إلى حصة الخطة المجانية وميزاتها. إذا أردت مواصلة الاستخدام، فاضغط «تجديد» في «شراء باقة» قبل الانتهاء، أو اشترك من جديد بعد الانتهاء.
صفحات ذات صلة: مركز المساعدة · أدلة وأسئلة شائعة · واجهة API موحّدة لخدمات SMTP · وثائق الواجهة البرمجية
جارٍ التحميل…