Descarga multimedia

GET /api/v1/media-download

Este endpoint permite descarga archivos de multimedia generados dentro la plataforma, ya sea de llamadas, archivos adjuntos en atención de los canales de mensajería y correo.

Al realizar la solitud de tipo GET se le debe enviar por parámetro media_path en donde se incluya la ruta del archivo a descargar.

La ruta del archivo, se consigue de los endpoints de lista de como por ejemplo: Listar llamadas u otro recurso Webhook personalizado.

ℹ Recuerda que:

La URL base para todas las solicitudes es: https://tu-dominio.c3.pe

Importante: reemplaza tu-dominio por el nombre de dominio específico que te haya proporcionado C3.

Solicitud

Cabeceras

Encabezado	Tipo	Obligatorio	Descripción
Authorization	String	✅ Sí	Token de autenticación (Bearer Token).

Parámetros de consulta

Parámetro	Tipo	Obligatorio	Descripción
media_path	String	✅ Sí	Ruta del archivo a descargar, ejemplo: call_attachments/2026/01/28/OUT18_7022_kKm-20260128-114037-1769618437.3938.mp3

Ejemplo de solicitud

GET /api/v1/media-download?media_path=call_attachments/2026/01/28/OUT18_7022_kKm-20260128-114037-1769618437.3938.mp3

Respuesta

La API devuelve el contenido multimedia del tipo de archivo que se descarga.

Tipos de respuesta, sugeridos:

• audio/mp3
• image/png
• image/jpg
• video/pm4
• application/pdf
• ...

Errores generales

Código HTTP	Tipo	Causa común
401	Unauthorized	El token de acceso no fue proporcionado en el encabezado Authorization, es inválido o ha sido revocado. Verifique que el token sea correcto y esté activo.
422	Unprocessable Entity	La solicitud fue entendida, pero contiene errores semánticos que impiden su procesamiento. Esto puede deberse a: 1. Parámetros faltantes o inválidos (ej, from_date no es una fecha válida); 2. Recurso inexistente (wa_number no registrado en el sistema); 3. Violación de reglas de negocio (el rango de fechas excede el límite permitido).
500	Server Error	Error interno del servidor. Intenta nuevamente más tarde o contacta soporte técnico.