نشرات HTML الإخبارية

أرسل نشرات إخبارية ثرية للهواتف باستخدام content_type=html. يفتح المستخدمون HTML الكامل في قارئ WebView من قائمة رسائل الشريك.

الإرسال

POST /api/v1/messages

{
  "phone": "+228XXXXXXXX",
  "content_type": "html",
  "subject": "SEED Actu · Image & vidéo",
  "priority": "notification",
  "html": "<div style=\"font-family:sans-serif\"><h1>Bonjour</h1><p>…</p><img src=\"https://…/photo.jpg\" style=\"max-width:100%\"/><video controls src=\"https://…/clip.mp4\" style=\"max-width:100%\"></video></div>"
}

الحقول

الحقل	الوصف
html	مقتطف HTML كامل أو مستند
subject	العنوان المعروض في قائمة المركز
preview	معاينة اختيارية بنص عادي (تُستخرج تلقائيًا من HTML إذا حُذفت)
body	بديل لـhtml عندما تكون content_type=html

جسم الاستجابة (عنوان القائمة)

يمثل body في استجابة API قيمة subject / preview، وليس HTML الخام. تُحفظ العلامات الكاملة في الحمولة وتُعرض للعملاء كما يلي:

{
  "content_type": "html",
  "body": "SEED Actu · Image & vidéo",
  "html": {
    "html": "<div>…</div>",
    "subject": "SEED Actu · Image & vidéo",
    "preview": "Bonjour Découvrez…"
  }
}

سلوك العميل

السطح	السلوك
قائمة المركز (الافتراضية)	صف عنوان؛ وعند الضغط عليه يفتح القارئ الكامل
نتائج البحث	بطاقة معاينة ثرية؛ وعند الضغط عليها تفتح القارئ الكامل
فقاعة الدردشة	صف «Newsletter» مضغوط؛ يفتح القارئ الكامل

أفضل الممارسات

• ضع CSS المهم داخل العناصر (يزيل كثير من العملاء <style> من HTML الجزئي؛ ويغلف MorisBox المقتطفات بورقة أنماط افتراضية آمنة)
• صور متجاوبة: max-width:100%; height:auto
• فضّل عناوين URL لمقاطع فيديو مستضافة؛ وأضف صورة ملصق
• وفّر رابط CTA واضحًا (https://…)
• حافظ على حجم معقول للحمولة (< نحو 200 كيلوبايت من HTML)

مثال يتضمن صورة + فيديو

راجع البدء السريع أو أرسل:

curl -X POST "$API/messages" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d @newsletter.json

يحتوي newsletter.json على content_type: "html" وsubject وhtml مع وسمَي <img> و<video>.