Enviar Llamada de Voz
Realiza una llamada telefónica con mensaje de voz usando plantillas TTS (Text-to-Speech). Soporta GET y POST.
/voice/sendBody
application/json
Números de teléfono de los destinatarios, separados por coma. Ejemplo: `4771234567,4770987654`
Código de país. Por estandarización, siempre se debe enviar `52` que es el código correspondiente a México.
Letra de la plantilla de voz a utilizar (a - k). Cada letra corresponde a un guion de voz pregrabado que se reproduce durante la llamada. Las variables `{{company}}` y `{{code}}` se reemplazan automáticamente. **Plantillas disponibles:** | Letra | Tipo de mensaje | |-------|----------------| | **a** | Verificación — "{{company}} tu código de verificación es: {{code}}" | | **b** | Validación de cuenta — "Ingresa el código en tu app de {{company}}: {{code}}" | | **c** | Activación — "El código {{code}} activa tu cuenta de {{company}}" | | **d** | Autenticación — "Código de autenticación para {{company}}: {{code}}" | | **e** | Activación alternativo — "Captura el código {{code}} para {{company}}" | | **f** | Código simple — "{{company}} tu código es: {{code}}" | | **g** | Confirmación — "Código de confirmación {{company}}: {{code}}" | | **h** | Verificación inverso — "{{code}} es tu código de {{company}}" | | **i** | Inicio de sesión — "{{code}} para iniciar sesión en {{company}}" | | **j** | Activación extendido — "Código de activación para {{company}}: {{code}}" | | **k** | Mensaje personalizado — Usa el parámetro `voice_message` para definir el texto (máx. 160 caracteres). | La plantilla **k** es especial: permite enviar un mensaje de voz completamente personalizado mediante el parámetro `voice_message`. El resto de plantillas (a-j) usan guiones fijos. Usa `formal_tone: true` para cambiar el trato de "tú" a "usted".
Modo de pruebas. `1` = sandbox (no descuenta créditos), `0` = producción. Por defecto `0`.
Nombre de la compañía para personalizar el mensaje de voz.
Código de verificación a comunicar en la llamada.
Mensaje de voz personalizado (máximo 160 caracteres). Solo compatible con la plantilla `k`.
Define el trato gramatical del mensaje. `false` = trato informal (tú). `true` = trato formal (usted). Por defecto `false`.
Response
Mensaje de estado
Código de respuesta
Número de mensajes enviados
IDs de referencia de los mensajes
▸ Show array item attributes▾ Hide array item attributes
ID único de referencia del mensaje
Número de teléfono del destinatario
Créditos consumidos
ID de campaña (solo cuando showCampaignId=true)
Siempre `false` para respuestas de error
Descripción del error en español
Código HTTP de la respuesta
Código de error estructurado (`{dominio}_{número}`). Identifica de forma única la causa del error para manejo programático.
Siempre `false`
Descripción del error de autenticación en español
Código HTTP
Código de error de autenticación (`auth_01`, `auth_05`, `auth_06`, `auth_07`, `auth_99`)
Siempre `false`
Descripción del error
Código HTTP
Código de error: `auth_04` (IP no autorizada en whitelist)
Siempre `false`
Descripción del error
Código HTTP
Código de error de rate limit
Siempre `false`
Descripción del error
Código HTTP
Código de error interno
Identificador único de la petición. Inclúyelo al contactar a soporte.