Newsletters HTML
Envíe newsletters móviles enriquecidas con content_type=html. Los usuarios abren el HTML completo en un lector WebView desde la lista de mensajes del socio.
Enviar
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>"
}
Campos
| Campo | Descripción |
|---|---|
html | Fragmento HTML completo o documento |
subject | Título mostrado en la lista del hub |
preview | Avance opcional en texto sin formato (se extrae automáticamente del HTML si se omite) |
body | Alternativa a html cuando content_type=html |
Cuerpo de la respuesta (título de la lista)
El body de la respuesta de la API es el subject / preview, no el HTML sin procesar. El markup completo se guarda en el payload y se expone a los clientes de la siguiente forma:
{
"content_type": "html",
"body": "SEED Actu · Image & vidéo",
"html": {
"html": "<div>…</div>",
"subject": "SEED Actu · Image & vidéo",
"preview": "Bonjour Découvrez…"
}
}
Comportamiento del cliente
| Superficie | Comportamiento |
|---|---|
| Lista del hub (predeterminada) | Fila de título · al pulsarla, abre el lector completo |
| Resultados de búsqueda | Tarjeta de vista previa enriquecida · al pulsarla, abre el lector completo |
| Burbuja de chat | Fila compacta «Newsletter» · abre el lector completo |
Buenas prácticas
- CSS crítico en línea (muchos clientes eliminan
<style>del HTML parcial; MorisBox envuelve los fragmentos con una hoja de estilos predeterminada segura) - Imágenes responsivas:
max-width:100%; height:auto - Prefiera URL de vídeo alojadas; incluya una imagen de póster
- Proporcione un enlace CTA claro (
https://…) - Mantenga un tamaño de payload razonable (< ~200 KB de HTML)
Ejemplo con imagen + vídeo
Consulte el inicio rápido o envíe:
curl -X POST "$API/messages" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d @newsletter.json
Donde newsletter.json incluye content_type: "html", subject y html con etiquetas <img> y <video>.