POST/api/v6/callblasting/audios

Subir un audio pregrabado

Deja un audio en tu catálogo para reutilizarlo en cuantas llamadas quieras.

Alcance y límites

Alcance

API key con el servicio callblasting habilitado

Límite de uso

30 solicitudes por minuto

  • Formatos aceptados: wav, mp3, ogg y m4a. Hasta 20 MB.

Sube un audio pregrabado que queda en tu catálogo para reutilizarlo en cuantas llamadas quieras. Acepta wav, mp3, ogg y m4a, hasta 20 MB, y lo dejamos listo para la red de voz.

Devuelve un id que luego envías en audioId al crear una llamada. Subir dos veces el mismo audio devuelve el mismo id: no se duplica.

Cuerpo de la petición

multipart/form-data
file
fileobligatorio
Archivo de audio (wav, mp3, ogg o m4a; máximo 20 MB).
name
stringopcional
Etiqueta opcional para identificar el audio (máximo 120 caracteres).

Respuestas

201

Audio subido, o reutilizado si ya existía.

{
  "success": true,
  "data": {
    "id": "01J9Z4M7K2QABCDEF5GHTV3WXY",
    "durationMs": 4200,
    "format": "mp3",
    "sizeBytes": 67200,
    "cached": false
  },
  "meta": {
    "requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
    "timestamp": "2026-06-23T15:04:05+00:00",
    "responseTimeMs": 180.4
  }
}
400

Falta el archivo, el formato no está soportado, o el audio no se pudo procesar.

401

Credenciales inválidas o faltantes.

403

La API key no tiene habilitado el servicio callblasting.

413

El audio está vacío o supera el tamaño máximo permitido.

429

Se excedió el límite de solicitudes.

Errores posibles

Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.

Ver el catálogo completo
POST /api/v6/callblasting/audios
curl -X POST 'https://developers.hablame.co/api/v6/callblasting/audios' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer hk_TU_API_KEY' \
  -F 'file=@path/to/file'

Try-It

Ejecuta la petición contra la API real con tu propia API key.

La key se usa solo en tu navegador para esta petición. No se guarda ni se envía a ningún otro lado.

Cuerpo de la petición

Archivo de audio (wav, mp3, ogg o m4a; máximo 20 MB).

Etiqueta opcional para identificar el audio (máximo 120 caracteres).

POST https://developers.hablame.co/api/v6/callblasting/audios

Respuesta

Todavía no has enviado ninguna petición.