Multimedia WhatsApp

Formatos soportados

WhatsBoost soporta el envio de distintos tipos de archivos multimedia a traves de WhatsApp. A continuacion se detalla cada tipo con sus extensiones, MIME types y soporte de caption:

Estructura JSON interna

Internamente, WhatsBoost construye un objeto JSON para cada tipo de mensaje que se envia al servidor de WhatsApp. Estas son las estructuras segun el tipo de contenido:

{"text": "Tu mensaje de texto aqui"}

{
  "image": {
    "url": "https://ejemplo.com/foto.jpg"
  },
  "caption": "Texto descriptivo de la imagen"
}

{
  "video": {
    "url": "https://ejemplo.com/video.mp4"
  },
  "caption": "Texto descriptivo del video"
}

{
  "audio": {
    "url": "https://ejemplo.com/audio.mp3"
  },
  "caption": false
}

{
  "document": {
    "url": "https://ejemplo.com/factura.pdf"
  },
  "fileName": "factura.pdf",
  "mimetype": "application/pdf",
  "caption": "Aqui tienes tu factura"
}

Formas de enviar multimedia

Existen dos formas de adjuntar archivos multimedia a un mensaje de WhatsApp:

Parametros de la API segun tipo

Cuando type="media"

Para enviar imagenes, videos o audios.

Cuando type="document"

Para enviar documentos PDF, Word, Excel o XML.

Notas importantes

Ejemplos por tipo de media

Enviar imagen con caption

curl -X POST https://tudominio.com/api/send/whatsapp \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "secret=TU_API_KEY" \
  -d "account=a1b2c3d4e5f6" \
  -d "recipient=+34612345678" \
  -d "type=media" \
  -d "media_type=image" \
  -d "media_url=https://ejemplo.com/promo.jpg" \
  -d "message=Aprovecha nuestra oferta del 20% de descuento"

Enviar video con caption

curl -X POST https://tudominio.com/api/send/whatsapp \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "secret=TU_API_KEY" \
  -d "account=a1b2c3d4e5f6" \
  -d "recipient=+34612345678" \
  -d "type=media" \
  -d "media_type=video" \
  -d "media_url=https://ejemplo.com/demo.mp4" \
  -d "message=Mira nuestro nuevo producto en accion"

Enviar audio (nota de voz)

curl -X POST https://tudominio.com/api/send/whatsapp \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "secret=TU_API_KEY" \
  -d "account=a1b2c3d4e5f6" \
  -d "recipient=+34612345678" \
  -d "type=media" \
  -d "media_type=audio" \
  -d "media_url=https://ejemplo.com/mensaje.mp3"

Enviar documento PDF

curl -X POST https://tudominio.com/api/send/whatsapp \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "secret=TU_API_KEY" \
  -d "account=a1b2c3d4e5f6" \
  -d "recipient=+34612345678" \
  -d "type=document" \
  -d "document_type=pdf" \
  -d "document_url=https://ejemplo.com/factura-2025-001.pdf" \
  -d "document_name=factura-enero-2025.pdf" \
  -d "message=Adjuntamos su factura del mes de enero"

Enviar documento Excel

curl -X POST https://tudominio.com/api/send/whatsapp \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "secret=TU_API_KEY" \
  -d "account=a1b2c3d4e5f6" \
  -d "recipient=+34612345678" \
  -d "type=document" \
  -d "document_type=xlsx" \
  -d "document_url=https://ejemplo.com/reporte-ventas.xlsx" \
  -d "document_name=reporte-ventas-Q1.xlsx" \
  -d "message=Aqui tienes el reporte de ventas del primer trimestre"

Enviar documento Word

curl -X POST https://tudominio.com/api/send/whatsapp \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "secret=TU_API_KEY" \
  -d "account=a1b2c3d4e5f6" \
  -d "recipient=+34612345678" \
  -d "type=document" \
  -d "document_type=docx" \
  -d "document_url=https://ejemplo.com/contrato.docx" \
  -d "document_name=contrato-servicio.docx" \
  -d "message=Por favor revisa y firma el contrato adjunto"

Documentacion relacionada