إيميلات المعاملات
ابعت رسايل فردية من موقعك أو تطبيقك، زي الفواتير وأكواد التفعيل واسترجاع كلمة السر، عن طريق الـ API أو الـ SMTP.
الإرسال بالـ 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 عشان تستقبل الأحداث لحظياً.