Media

Cuando un contacto te manda un mensaje con media, Waspy descarga el archivo de Meta automáticamente y lo guarda en su storage. Tu bot recibe el mensaje vía webhook (o GET REST) con dos campos útiles:

mediaId — UUID estable que podés resolver a URL firmada vía GET /media/:id
mediaKey — clave interna del object storage (alternativa)

Scope requerido: media:read.

GET /media/:id

Devuelve una URL firmada de corta duración para descargar el archivo. La URL expira a los pocos minutos — refetch cuando la necesites de nuevo.

curl https://api.waspytech.com/api/v2/media/{mediaId} \
  -H "Authorization: Bearer wspy_..."

Respuesta:

{
  "data": {
    "id": "uuid",
    "url": "https://storage.googleapis.com/...?X-Goog-Signature=...",
    "expiresIn": 3600,
    "mimeType": "audio/ogg",
    "fileName": "voice.ogg"
  },
  "meta": { "requestId": "..." }
}

Tenant-scoped: si el mediaId pertenece a otro tenant, devuelve 404.

GET /media/by-key

Variante por GCS object key, útil cuando el payload del mensaje sólo expone mediaKey. Tenant-scoped: la key debe empezar con tu tenantId.

curl "https://api.waspytech.com/api/v2/media/by-key?key=<tenantId>/<uuid>.jpg" \
  -H "Authorization: Bearer wspy_..."

Flujo típico para un bot

Recibís webhook message.received con type: "audio" y mediaId.
(Si mediaId está null al recibirlo, esperás 1-2 segundos y refetcheás el mensaje vía GET /messages/:id.)
GET /media/:id → URL firmada.
Descargás el archivo desde la URL firmada antes de que expire.

Tipos de media soportados

image, video, audio, document, sticker. Para cada tipo, el mimeType del response corresponde al original que envió Meta.

Introducción

Recursos

GET /media/:id

GET /media/by-key

Flujo típico para un bot

Tipos de media soportados

​GET /media/:id

​GET /media/by-key

​Flujo típico para un bot

​Tipos de media soportados

GET /media/:id

GET /media/by-key

Flujo típico para un bot

Tipos de media soportados