Subir un archivo para una conversación
POST/inbox/conversations/:id/media
Envía los bytes del archivo en el cuerpo (no es multipart), con el nombre en
X-File-Name. El tipo se detecta por el contenido: imagen (JPEG, PNG), sticker (WebP),
video (MP4, 3GP), audio, PDF, documentos de Office y texto. Límites: imagen 5 MB, video y
audio 16 MB, documento 100 MB, sticker 500 KB. Usa el id devuelto como assetId en
una respuesta kind: media.
Request
Responses
- 201
- 401
- 402
- 404
- 409
- 413
- 415
- 422
- 429
Mensaje registrado.
Token ausente, mal formado, desconocido o revocado (authentication), o cuenta
suspendida (tenant_inactive).
Sin derecho de uso (payment_required). El cuerpo trae el motivo en reason y la
salida en action: qué hacer (kind) y la página del panel donde se hace (url).
El recurso no existe (not_found).
El número de la conversación ya no está conectado (phone_unavailable).
Por encima del límite del tipo (media_too_large, con limit y kind).
Tipo de archivo no reconocido (media_type_not_allowed).
El payload no pasó la validación (invalid_request, detallado en issues) o fue
rechazado por Meta (meta_error, con el cuerpo original en meta).
Límite de peticiones superado (rate_limit).
Response Headers
Segundos a esperar antes de reintentar.
Categoría de límite aplicada — send, media o default.
Qué cubo describen las otras cabeceras — key (la API key), session (el panel) o account (el techo de la cuenta).
Techo de peticiones de la categoría en la ventana actual.
Peticiones restantes en la ventana actual.