Mídia e tipos de conteúdo

Todos os tipos de mídia usam o mesmo endpoint de envio: POST /api/v1/messages.

Valores de content_type compatíveis

Tipo	Obrigatório	Interface do hub
text	body	Balão / linha de lista
image	media_url ou media_base64	Prévia da imagem
document	media	Linha de arquivo (nome, abrir)
audio	media	Linha de áudio
video	media	Cartão de vídeo
link	link_url	Cartão CTA
html	html ou body HTML	Leitor completo de newsletter
system	body	Estilo do sistema

Imagem

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

Áudio

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

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

Carregamento em base64

Em vez de media_url:

{
  "content_type": "document",
  "media_base64": "<base64…>",
  "media_filename": "piece.pdf",
  "media_mimetype": "application/pdf"
}

Observações

• Prefira URLs de mídia HTTPS acessíveis pelo MorisBox e pelos clientes
• Transmissões grandes: hospede os arquivos em uma CDN; evite payloads base64 enormes
• As mensagens com mídia são mensagens do hub (não criam uma conversa automaticamente)