/
مركز المساعدة / للمطورين

إيميلات المعاملات

ابعت رسايل فردية من موقعك أو تطبيقك، زي الفواتير وأكواد التفعيل واسترجاع كلمة السر، عن طريق الـ API أو الـ SMTP.

آخر تحديث: 2026-10-13

الإرسال بالـ API

ابعت POST https://mailhoor.com/api/transactional/send ومعاه JSON:

curl -s -X POST https://mailhoor.com/api/transactional/send \
  -H "X-Auth-APIKey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fromname": "YourBrand",
    "fromemail": "orders@yourbrand.com",
    "to": "sara@example.com",
    "toname": "Sara",
    "subject": "Your order {{ order_id }} is confirmed",
    "body": "<html><body><p>Hi {{ name }}, thanks for your order.</p></body></html>",
    "tag": "receipts",
    "variables": {"name": "Sara", "order_id": "10452"}
  }'

الحقول

الحقل مطلوب الوصف
fromname أيوه اسم المرسِل
fromemail أيوه عنوان المرسِل، على دومين موثّق
to أيوه عنوان المستلم
toname لأ اسم المستلم، بيظهر كـ Name <address>
subject أيوه العنوان
body أيوه محتوى HTML
replyto لأ عنوان الرد. لو مش موجود بيتستخدم fromemail
tag لأ بيجمّع الرسايل في التقارير، زي receipts أو passwordresets
variables لأ قيم لقوالب Jinja2 في العنوان والمحتوى
template لأ رقم قالب محفوظ. العنوان والمحتوى والمرسِل والرد والتاج بيتاخدوا منه بدل اللي في الطلب
route لأ مسار إرسال معيّن من /userroutes

القوالب

لما تبعت variables، العنوان والمحتوى بيتعالجوا بـ Jinja2: {{ name }} و{% if %} و{% for %} وغيرهم. ابعت كائن فاضي {} عشان تستخدم Jinja من غير قيم. القوالب المعمولة بمحرّر السحب والإفلات بتدعم استبدال المتغيرات البسيط بس.

التاجات

التاج يقدر يحتوي على حروف وأرقام و_ و- و.، لحد 18 حرف، ومش بيفرق بين الكابيتال والسمول. كل حساب يقدر يستخدم لحد 400 تاج مختلف. الرسايل من غير تاج بتتجمع تحت untagged.

المنع

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

الإرسال بالـ SMTP بدل كده

لو منصتك بتبعت بـ SMTP بس (WordPress أو Laravel أو ERP)، استخدم الـ SMTP Relay.

تابع النتايج

افتح الإيميل ← الرسائل وشوف رسايل المعاملات حسب التاج، بالوصول والفتح والضغط والمرتجعات. واستخدم الـ Webhooks عشان تستقبل الأحداث لحظياً.

لسه محتاج مساعدة؟ ابعتلنا على support@mailhoor.com أو كلّمنا على +20 101 072 9258. بنرد بالعربي والإنجليزي.