Apariencia
message.media_ready
Se envía cuando: la foto, el audio, el video o el documento de un mensaje ya está guardado y se puede descargar. Aplica a lo que te mandan (llega después de message.received) y a lo que el negocio manda desde su teléfono o WhatsApp Web (llega después de message.sent_external). Esos eventos salen en cuanto aparece el mensaje, con media.available: false.
Qué trae data: El mismo objeto message, ahora con media.available: true.
Para qué sirve: Descargar el archivo sin reintentar: al recibirlo, pide GET /api/v1/messages/{id}/media. Sale una sola vez por mensaje. Si el archivo pasa el límite de tamaño de su tipo no se guarda y este evento no llega.
Ejemplo
El cuerpo que recibe tu servidor (datos ficticios):
json
{
"id": "evt_01EXAMPLE00000000000000011",
"type": "message.media_ready",
"created_at": "2026-01-01T12:00:02.000000Z",
"workspace_id": "ten_01EXAMPLE00000000000000000",
"data": {
"message": {
"id": "msg_01EXAMPLE00000000000000000",
"instance_id": "ins_01EXAMPLE00000000000000000",
"direction": "inbound",
"from_me": false,
"source": null,
"api_key_id": null,
"type": "image",
"status": "received",
"to": null,
"from": "5255000000002",
"from_name": "Ana López",
"group_id": null,
"text": null,
"caption": "This is the one I want",
"media": {
"mime_type": "image/jpeg",
"size": 48213,
"filename": null,
"available": true
},
"location": null,
"contacts": null,
"poll": null,
"reply_to": null,
"forwarded": false,
"reactions": [],
"error": null,
"created_at": "2026-01-01T11:59:59+00:00",
"queued_at": null,
"sent_at": null,
"delivered_at": null,
"read_at": null,
"failed_at": null,
"received_at": "2026-01-01T11:59:59+00:00",
"edited_at": null,
"deleted_at": null
}
}
}Todos los eventos comparten el mismo sobre (id, type, created_at, workspace_id, data) y los mismos headers de firma. Cómo verificarla, qué responder y cómo se reintenta: Webhooks.