POST/api/v6/callblasting/calls/audio

Llamada con audio pregrabado

Envía una llamada que reproduce un audio pregrabado, ya subido o en el mismo paso.

Alcance

API key con el servicio callblasting habilitado

Límite de uso

60 solicitudes por minuto

Idempotencia

Admite Idempotency-Key

El archivo de audio admite hasta 20 MB.

Envía una llamada que reproduce un audio pregrabado. Hay dos formas de hacerlo.

multipart/form-data con file: sube el audio y dispara la llamada en un solo paso. El audio queda reutilizable.
application/json con audioId: usa un audio ya subido (ver GET /api/v6/callblasting/audios).

El resto de los campos es igual que en el envío con texto a voz.

Cuerpo de la petición

application/jsonCon un audio ya subido.

to

stringobligatorio

Número destino en formato internacional, solo dígitos.

audioId

stringobligatorio

Id de un audio ya subido.

callerId

stringopcional

Número que se muestra a quien recibe la llamada.

clientReference

stringopcional

Tu referencia para correlacionar la llamada (máximo 128 caracteres).

repeat

integeropcional

Veces que se reproduce el mensaje.

Por defecto: 2

recordingTtlSec

integeropcional

Retención de la grabación en segundos. Por defecto 24 horas; mínimo 24 horas, máximo 1 año.

retry

objectopcional

Ajustes de reintento. Qué estados se reintentan es una política fija del servicio; aquí solo ajustas los límites.

maxAttempts

integeropcional

Número de intentos.

Por defecto: 2

minIntervalSec

integeropcional

Espera mínima entre intentos, en segundos.

Por defecto: 300

minSuccessSec

integeropcional

Duración mínima para contar la llamada como exitosa, en segundos.

Por defecto: 5

{
  "to": "573001234567",
  "audioId": "01J9Z4M7K2QABCDEF5GHTV3WXY",
  "clientReference": "campania-abril-0012"
}

multipart/form-dataSubiendo el audio en la misma solicitud.

to

stringobligatorio

Número destino en formato internacional.

file

fileobligatorio

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

callerId

stringopcional

Número que se muestra a quien recibe la llamada.

clientReference

stringopcional

Tu referencia para correlacionar la llamada.

repeat

integeropcional

Veces que se reproduce el mensaje.

recordingTtlSec

integeropcional

Retención de la grabación en segundos.

Respuestas

202

Llamada encolada.

{
  "success": true,
  "data": {
    "id": "cb_9f2c0e2a1d8b",
    "to": "573001234567",
    "status": "queued",
    "audioId": "01J9Z4M7K2QABCDEF5GHTV3WXY",
    "clientReference": "campania-abril-0012"
  },
  "meta": {
    "requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
    "timestamp": "2026-06-23T15:04:05+00:00",
    "responseTimeMs": 22.7
  }
}

400

Número inválido, falta el audio (file o audioId), formato no soportado o audio inválido.

401

Credenciales inválidas o faltantes.

403

La API key no tiene habilitado el servicio callblasting.

404

No existe un audio con ese audioId para tu organización.

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.

401AUTH_REQUIREDNo se envió un token Bearer y cada llamada lo requiere.401AUTH_INVALID_KEYLa API key no se reconoce: formato equivocado, revocada o vencida.401AUTH_SERVICE_NOT_ALLOWEDLa key no tiene permitido el servicio detrás de este endpoint.400BAD_REQUESTNo pudimos interpretar tu petición.404NOT_FOUNDLa ruta que pediste no existe en esta API.403ACCOUNT_READ_ONLYModo solo lectura: solo pasan GET, HEAD y OPTIONS.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.

Ver el catálogo completo

Alcance y límites

Cuerpo de la petición

Respuestas

Errores posibles