Médias et types de contenu
Tous les types de médias utilisent le même endpoint d'envoi : POST /api/v1/messages.
Valeurs content_type supportées
| Type | Requis | UI hub |
|---|---|---|
text | body | Bulle / ligne de liste |
image | media_url ou media_base64 | Aperçu image |
document | media | Ligne fichier (nom, ouvrir) |
audio | media | Ligne audio |
video | media | Carte vidéo |
link | link_url | Carte CTA |
html | html ou body HTML | Lecteur newsletter complet |
system | body | Style système |
Image
{
"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"
}
Document
{
"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"
}
Vidéo
{
"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"
}
Lien 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"
}
Upload base64
À la place de media_url :
{
"content_type": "document",
"media_base64": "<base64…>",
"media_filename": "piece.pdf",
"media_mimetype": "application/pdf"
}
Notes
- Préférez des URL médias HTTPS accessibles par MorisBox et les clients
- Grosses diffusions : hébergez les fichiers sur un CDN ; évitez les énormes payloads base64
- Les messages média sont des messages hub (pas de conversation automatique)
