Newsletters HTML

Envoyer des newsletters mobiles riches avec content_type=html. Les utilisateurs ouvrent le HTML complet dans un lecteur WebView depuis la liste de messages partenaire.

Envoyer

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>"
}

Champs

Champ	Description
html	Fragment HTML complet ou document
subject	Titre affiché dans la liste hub
preview	Teaser texte brut optionnel (extrait automatiquement du HTML s'il est omis)
body	Alternative à html lorsque content_type=html

Corps de réponse (titre de liste)

body dans la réponse API est le subject / preview, pas le HTML brut. Le markup complet est stocké dans le payload et exposé aux clients ainsi :

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

Comportement client

Surface	Comportement
Liste hub (défaut)	Ligne titre · appui ouvre le lecteur complet
Résultats de recherche	Carte d'aperçu riche · appui ouvre le lecteur complet
Bulle de chat	Ligne compacte « Newsletter » · ouvre le lecteur complet

Bonnes pratiques

• CSS critique en ligne (beaucoup de clients stripent <style> dans le HTML partiel ; MorisBox enveloppe les fragments avec une feuille de style par défaut sûre)
• Images responsives : max-width:100%; height:auto
• Préférez les URL vidéo hébergées ; incluez une image poster
• Fournissez un lien CTA clair (https://…)
• Gardez une taille de payload raisonnable (< ~200 KB HTML)

Exemple avec image + vidéo

Voir le démarrage rapide ou envoyer :

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

Où newsletter.json inclut content_type: "html", subject, et html avec des balises <img> et <video>.