Skip to main content
Para enviar imágenes, video, audio o documentos, primero subes el archivo y obtienes un file_uuid, que luego pasas a una acción de envío.
1

Pide una URL de subida

Con { filename, mime_type, size_bytes }. Responde 201 con file_uuid, upload_url, upload_token, storage_path y expires_at.
2

Sube el binario

Sube el archivo a la upload_url que recibiste, antes de que expire (expires_at).
3

Confirma

Con { file_uuid }. Responde 200 con file_uuid, mime_type, size_bytes, download_url y expires_at. A partir de aquí el file_uuid es enviable.
Una vez confirmado, pasa el file_uuid a una acción de envío — como media directa en send_message, o como header de una plantilla:
El header.type ∈ image | video | document lleva file_uuid (document acepta un filename opcional). En send_message modo media, el file_uuid va a nivel de acción con body como caption opcional (el audio no admite caption).
Si el preflight rechaza el grupo, la respuesta es un 4xx síncrono y ninguna acción se ejecuta. Ver Errores.

​
Ejemplo ejecutable

El flujo completo en tres llamadas. El file_uuid que confirma el paso 3 es el que después pasas a una acción de envío. 1 · Pide la URL de subida
2 · Sube el binario a la upload_url antes de que expire
3 · Confirma