MEDIA_BUCKET_NOT_CONFIGURED
detalle
La media entrante no se guardó porque el bucket de Boost no está configurado: queda pending (transitorio).
Canales: media entrante y enlaces estables
Códigos de error · 11 códigos · catálogo del 2026-10-21
La media que llega de Meta se baja al bucket de Boost y se sirve por un enlace estable (constraint.inbound-media-key-and-integrity-transient-stays-pending). Una falla definitiva deja media_status = 'failed'; una transitoria deja pending para el barredor.
Para toda la familia
Lo que un código no dice lo hereda de aquí.
- Cómo se detecta
- Base:
channel_messages.media_status(failed/pending). Render: líneas del servicio de media con el código (MEDIA_*). El front ve 404 en el enlace estable. - Qué hacer
- Transitorias: el barredor reintenta solo. Definitivas: Meta ya no tiene el archivo; pedirle al cliente que lo reenvíe.
Códigos
MEDIA_CHECKSUM_MISMATCH
internodetalle
El archivo bajado de Meta no coincide con su SHA-256: se descarta (falla definitiva).
MEDIA_EMPTY
interno
Meta devolvió un archivo vacío (falla definitiva).
MEDIA_ID_INVALID
interno
El id de media de Meta no es válido (falla definitiva).
MEDIA_NOT_FOUND
HTTPHTTP 404
No se encontró el archivo.
MEDIA_NOT_READY
HTTPHTTP 404
La media todavía se está bajando (pending): el enlace estable responde 404 un rato.
MEDIA_PENDING_TOO_OLD
detalle
El barredor se rindió con una media que siguió pending más del tiempo máximo: queda failed.
MEDIA_SOURCE_MISSING
detalle
El barredor no encontró de dónde bajar la media (sin id de Meta o sin hilo): queda failed.
MEDIA_TOO_LARGE
interno
La media entrante supera el tope de tamaño (falla definitiva).
MEDIA_UNAVAILABLE
HTTPHTTP 404
La media de ese mensaje no está disponible: falló de forma definitiva.
- Qué hacer
- Pedirle al cliente que reenvíe el archivo.
MEDIA_URL_NOT_ALLOWED
interno
La URL de la media no es de un CDN de Meta por https: no se baja (falla definitiva).
Texto generado desde el catálogo de errores de BoostAPI. Para corregirlo, se cambia allá y se sincroniza: verMantener esta documentación. También enMarkdown.