HTML 新闻简报
使用 content_type=html 发送内容丰富的移动端新闻简报。用户可从合作伙伴消息列表进入 WebView 阅读器,打开完整 HTML。
发送
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 | content_type=html 时 html 的替代字段 |
响应正文(列表标题)
API 响应中的 body 是主题 / 预览,而不是原始 HTML。完整标记存储在有效载荷中,并以下列形式提供给客户端:
{
"content_type": "html",
"body": "SEED Actu · Image & vidéo",
"html": {
"html": "<div>…</div>",
"subject": "SEED Actu · Image & vidéo",
"preview": "Bonjour Découvrez…"
}
}
客户端行为
| 界面 | 行为 |
|---|---|
| 中心列表(默认) | 显示标题行;点击后打开完整阅读器 |
| 搜索结果 | 显示丰富的预览卡片;点击后打开完整阅读器 |
| 聊天气泡 | 显示紧凑的“新闻简报”行;打开完整阅读器 |
最佳实践
- 内联关键 CSS。许多客户端会从局部 HTML 中移除
<style>;MorisBox 会使用安全的默认样式表包装片段 - 响应式图片:
max-width:100%; height:auto - 优先使用托管的视频 URL,并提供封面图
- 提供清晰的 CTA 链接(
https://…) - 保持合理的有效载荷大小(HTML 建议不超过约 200 KB)
图片和视频示例
请参阅快速入门,或发送:
curl -X POST "$API/messages" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d @newsletter.json
其中,newsletter.json 包含 content_type: "html"、subject,以及带有 <img> 和 <video> 标签的 html。