Newsletters HTML

Envie newsletters móveis enriquecidas com content_type=html. Os usuários abrem o HTML completo em um leitor WebView a partir da lista de mensagens do parceiro.

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	Descrição
html	Fragmento HTML completo ou documento
subject	Título exibido na lista do hub
preview	Prévia opcional em texto simples (extraída automaticamente do HTML se omitida)
body	Alternativa a html quando content_type=html

Corpo da resposta (título da lista)

O body da resposta da API é o subject / preview, não o HTML bruto. O markup completo é salvo no payload e exposto aos clientes da seguinte forma:

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

Comportamento do cliente

Superfície	Comportamento
Lista do hub (padrão)	Linha de título · ao tocar, abre o leitor completo
Resultados da busca	Cartão de prévia enriquecido · ao tocar, abre o leitor completo
Balão de chat	Linha compacta «Newsletter» · abre o leitor completo

Boas práticas

• CSS crítico inline (muitos clientes removem <style> do HTML parcial; o MorisBox envolve os fragmentos com uma folha de estilos padrão segura)
• Imagens responsivas: max-width:100%; height:auto
• Prefira URLs de vídeo hospedadas; inclua uma imagem de pôster
• Forneça um link CTA claro (https://…)
• Mantenha um tamanho de payload razoável (< ~200 KB de HTML)

Exemplo com imagem + vídeo

Consulte o início rápido ou envie:

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

O arquivo newsletter.json inclui content_type: "html", subject e html com tags <img> e <video>.