POST/api/v6/callblasting/calls

Llamada con voz generada

Envía una llamada que reproduce un audio generado por texto a voz.

Alcance

API key con el servicio callblasting habilitado

Límite de uso

60 solicitudes por minuto

Idempotencia

Admite Idempotency-Key

Hasta 4000 caracteres de texto por llamada.
Hasta 5 intentos por llamada.

Envía una llamada que reproduce un audio generado por texto a voz. El audio se sintetiza al crear el proceso y se reutiliza si ya existía, sin recargo.

La voz se elige siempre por código del catálogo (voice). El audio pregrabado tiene su propio endpoint: POST /api/v6/callblasting/calls/audio.

Qué estados se reintentan es una política fija del servicio. En retry solo ajustas los límites: cuántos intentos, cada cuánto y cuánto debe durar una llamada para contarla como exitosa.

Cuerpo de la petición

application/json

to

stringobligatorio

Número destino en formato internacional, solo dígitos (7 a 18).

text

stringobligatorio

Texto a sintetizar (1 a 4000 caracteres).

voice

stringobligatorio

Código de voz del catálogo (ver GET /api/v6/callblasting/voices).

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",
  "text": "Hola, te llamamos de Acme para confirmar tu cita del jueves.",
  "voice": "es-us-female-1",
  "clientReference": "campania-abril-0012",
  "repeat": 2
}

Respuestas

202

Llamada encolada.

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

400

Número inválido, falta el texto, o la voz no existe.

401

Credenciales inválidas o faltantes.

402

Saldo insuficiente para generar el audio de la llamada.

403

La API key no tiene habilitado el servicio callblasting.

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.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