Ir al contenido

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.