Medios y tipos de contenido
Todos los tipos de medios utilizan el mismo endpoint de envío: POST /api/v1/messages.
Valores de content_type compatibles
| Tipo | Requerido | Interfaz del hub |
|---|---|---|
text | body | Burbuja / fila de lista |
image | media_url o media_base64 | Vista previa de imagen |
document | media | Fila de archivo (nombre, abrir) |
audio | media | Fila de audio |
video | media | Tarjeta de vídeo |
link | link_url | Tarjeta CTA |
html | html o body HTML | Lector de newsletter completo |
system | body | Estilo del sistema |
Imagen
{
"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"
}
Documento
{
"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"
}
Audio
{
"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"
}
Vídeo
{
"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"
}
Enlace 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"
}
Carga en base64
En lugar de media_url:
{
"content_type": "document",
"media_base64": "<base64…>",
"media_filename": "piece.pdf",
"media_mimetype": "application/pdf"
}
Notas
- Prefiera URL de medios HTTPS accesibles para MorisBox y los clientes
- Difusiones grandes: aloje los archivos en un CDN; evite payloads base64 enormes
- Los mensajes con medios son mensajes del hub (no crean una conversación automáticamente)