الوسائط وأنواع المحتوى

تستخدم جميع أنواع الوسائط نقطة نهاية الإرسال نفسها: POST /api/v1/messages.

قيم content_type المتوافقة

النوع	المطلوب	واجهة المركز
text	body	فقاعة / صف في القائمة
image	media_url أو media_base64	معاينة صورة
document	media	صف ملف (الاسم، فتح)
audio	media	صف صوتي
video	media	بطاقة فيديو
link	link_url	بطاقة CTA
html	html أو HTML في body	قارئ النشرة الإخبارية الكامل
system	body	نمط النظام

صورة

{
  "phone": "+228XXXXXXXX",
  "content_type": "image",
  "body": "Photo SEED - agence de Lomé",
  "media_url": "https://cdn.example.com/agence.jpg",
  "media_filename": "agence.jpg",
  "media_mimetype": "image/jpeg"
}

مستند

{
  "phone": "+228XXXXXXXX",
  "content_type": "document",
  "body": "Guide d'affiliation (PDF)",
  "media_url": "https://cdn.example.com/guide.pdf",
  "media_filename": "guide-affiliation.pdf",
  "media_mimetype": "application/pdf"
}

صوت

{
  "phone": "+228XXXXXXXX",
  "content_type": "audio",
  "body": "Message vocal d'accueil",
  "media_url": "https://cdn.example.com/accueil.mp3",
  "media_filename": "accueil.mp3",
  "media_mimetype": "audio/mpeg"
}

فيديو

{
  "phone": "+228XXXXXXXX",
  "content_type": "video",
  "body": "Présentation des services",
  "media_url": "https://cdn.example.com/services.mp4",
  "media_filename": "services.mp4",
  "media_mimetype": "video/mp4"
}

رابط CTA

{
  "phone": "+228XXXXXXXX",
  "content_type": "link",
  "body": "Consultez votre espace assuré.",
  "link_url": "https://morisbox.com",
  "link_title": "Espace assuré SEED",
  "link_description": "Cotisations, demandes et documents.",
  "link_label": "Ouvrir le portail",
  "link_image_url": "https://cdn.example.com/cover.jpg"
}

التحميل بصيغة base64

بدلًا من media_url:

{
  "content_type": "document",
  "media_base64": "<base64…>",
  "media_filename": "piece.pdf",
  "media_mimetype": "application/pdf"
}

ملاحظات

• فضّل عناوين URL للوسائط تستخدم HTTPS ويمكن لـMorisBox والعملاء الوصول إليها
• لعمليات البث الكبيرة، استضف الملفات على CDN وتجنب حمولات base64 الضخمة
• رسائل الوسائط هي رسائل في المركز (ولا تنشئ محادثة تلقائيًا)