Subir archivos multimedia de WhatsApp

​

Qué es

​

Antes de comenzar

• Conecta y registra el número de teléfono de WhatsApp remitente.
• Guarda tu clave de API de YCloud de forma segura.
• Prepara un archivo que cumpla con los tipos de archivos multimedia admitidos y los límites de tamaño de Meta.
• Comprueba si el tipo de mensaje de destino admite un ID de archivo multimedia o requiere una URL.

​

Cómo funciona

1. Sube el archivo para el número de teléfono remitente.
2. Guarda el ID de archivo multimedia devuelto.
3. Coloca el ID de archivo multimedia en el objeto de contenido correspondiente del mensaje de WhatsApp.
4. Envía el mensaje antes de que el archivo multimedia subido caduque.

​

Solicitud

curl --request POST \
  https://api.ycloud.com/v2/whatsapp/media/+16315551111/upload \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --form "file=@./invoice.pdf;type=application/pdf"

​

Respuesta

{
  "id": "MEDIA_ID"
}

{
  "type": "document",
  "document": {
    "id": "MEDIA_ID",
    "filename": "invoice.pdf"
  }
}

​

Uso de archivos multimedia

​

Límites y resolución de problemas

• Envía el tipo MIME correcto con el archivo subido.
• Verifica los tipos de archivos multimedia admitidos y los límites de tamaño de Meta antes de subir.
• No reutilices un ID de archivo multimedia caducado.
• Mantén alineados el número de teléfono de subida y el del remitente del mensaje.
• Para recursos públicos reutilizables, un enlace puede ser más sencillo que subirlos repetidamente cuando el esquema del mensaje lo admita.