媒体与内容类型

所有媒体类型使用同一个发送端点：POST /api/v1/messages。

支持的 content_type 值

类型	必填字段	中心 UI
text	body	气泡 / 列表行
image	media_url 或 media_base64	图片预览
document	媒体	文件行（名称和打开操作）
audio	媒体	音频行
video	媒体	视频卡片
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"
}

注意事项

• 优先使用 MorisBox 及其客户端可访问的 HTTPS 媒体 URL
• 大型广播应将文件托管在 CDN 上，并避免体积过大的 Base64 有效载荷
• 媒体消息是中心消息，不会自动创建对话