Enviar Código de Verificación (OTP)
Genera y envía un código de verificación por SMS, WhatsApp o llamada de voz al número especificado. Usa `showcode=1` para recibir el código en la respuesta (útil en sandbox/testing).
/otp/sendBody
application/json
Número de teléfono a verificar, formato: XXXXXXXXXX (10 dígitos).
Código de país. Por estandarización, siempre se debe enviar `52` que es el código correspondiente a México.
Nombre de la compañía mostrada al usuario en el mensaje de verificación.
Letra de la plantilla SMS a utilizar. Las variables `{{company}}` y `{{code}}` se reemplazan automáticamente. Por defecto `a`. **Plantillas disponibles:** | Letra | Contenido del mensaje | |-------|----------------------| | **a** | "{{company}} El codigo de verificacion es: {{code}}" | | **b** | "Ingresa el siguiente codigo en tu app de {{company}} para validar tu cuenta: {{code}}" | | **c** | "Ingresa el codigo {{code}} para activar tu cuenta de {{company}}" | | **d** | "El codigo de autenticacion para {{company}} es: {{code}}" | | **e** | "Captura el codigo {{code}} para activar tu cuenta {{company}}" | | **f** | "{{company}} Tu codigo es: {{code}}" | | **g** | "Tu codigo de confirmacion {{company}} es: {{code}}" | | **h** | "{{code}} es tu codigo de verificacion de {{company}}" | | **i** | "{{code}} es tu codigo para iniciar sesion en {{company}}" | | **j** | "Tu codigo de activacion para {{company}} es el {{code}}" | | **k** | "{{company}}: {{code}} es tu codigo de seguridad" | | **l** | "Tu codigo de verificacion {{company}} es: {{code}} No compartas este codigo con nadie." | | **m** | "Tu codigo {{company}} es: {{code}}" | | **n** | "Usa la clave {{code}} para ingresar a {{company}}" | Usa `formal_tone: true` para cambiar el trato de "tú" a "usted" sin alterar la plantilla.
Define el trato gramatical del mensaje. `false` = trato informal (tú). `true` = trato formal (usted). Por defecto `false`.
Longitud del código de verificación (4 a 10 caracteres). Por defecto `4`.
Fecha de expiración para el código de verificación. Por defecto 24 hrs. Máximo 3 días. Formato: `YYYY-MM-DD HH:mm:ss`.
Idioma de la respuesta. `es` = Español, `en` = Inglés. Por defecto `es`.
Devuelve el código de verificación generado en la respuesta. `1` = Mostrar, `0` = No mostrar. Por defecto `0`.
Tipo de código generado. `alphanumeric` = letras y números, `numeric` = solo números, `letters` = solo letras. Por defecto `alphanumeric`.
Nombre del remitente personalizado (hasta 11 caracteres alfanuméricos). Si no lo tienes contratado, este parámetro se ignora.
Devuelve la referencia del mensaje enviado en la respuesta. Por defecto `true`.
Response
Mensaje de estado
Código de respuesta
Número de mensajes enviados
Número de teléfono del destinatario con código de país
Créditos consumidos
ID único de referencia del mensaje
Código de verificación (solo cuando showcode=1)
True si ocurrió fallback de WhatsApp o Voz a SMS
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.