SMS Gateway

Inicio rápido de SMS

Envía códigos OTP, alertas y SMS transaccionales a más de 190 países. Cada mensaje devuelve un acuse de recibo de entrega para que sepas que llegó.

¿Deseas probar sin SMS reales? Usa el Modo Sandbox: sin mensajes reales, códigos OTP predecibles y sin facturación.

1Enviar un SMS

Envía mediante POST el número del destinatario y el texto del mensaje. El campo from establece el ID del remitente visible para el usuario (la compatibilidad con operadores varía según el país).

POST/api/v1/connect-hub/sms

bash

curl -X POST https://api.novauth.com/api/v1/connect-hub/sms \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "to":   "+14155552671",
    "text": "Your verification code is 482951. Valid for 10 minutes.",
    "from": "Novauth"
  }'

200 OK — Respuesta

json

{
  "messageId": "a3f2c1d0-4e5b-6c7d-8e9f-0a1b2c3d4e5f",  // save for delivery check
  "from":      "Novauth",
  "to":        "+14155552671"
}

Longitud del texto: Los SMS tienen un límite de 160 caracteres por segmento. Se aceptan mensajes de hasta 4096 caracteres: se dividen automáticamente en segmentos concatenados y se reensamblan en el dispositivo.

2Comprobar estado de entrega

Consulta el endpoint SDR (informe de entrega de SMS) para verificar que el mensaje llegó al dispositivo. Comprueba poco después del envío: la entrega habitual es en menos de 5 segundos.

GET/api/v1/connect-hub/sms/{messageId}/sdr

bash

curl https://api.novauth.com/api/v1/connect-hub/sms/a3f2c1d0-.../sdr \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID"

3Reportar el resultado de la verificación

Una vez que tu usuario envíe el código recibido, realiza un POST al endpoint de webhook para cerrar el registro de SMS y registrar el resultado.

POST/api/v1/connect-hub/sms/webhook

bash

# Report the verification outcome from your backend
curl -X POST https://api.novauth.com/api/v1/connect-hub/sms/webhook \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "id":     "a3f2c1d0-...",
    "status": "Success"
  }'

Referencia de API

POST/smsEnviar un mensaje SMS

GET/sms/{messageId}/sdrObtener informe de entrega de SMS

POST/sms/webhookReportar resultado de verificación

POST/sms/sdrListar todos los registros de SMS (paginado)

Cuerpo de la solicitud — POST /sms

tostringrequiredTeléfono del destinatario en formato E.164

textstringrequiredContenido del mensaje (1–4096 caracteres)

fromstringoptionalID del remitente o número (depende del operador)

Listar todos los registros de SMS

bash

# Paginated list of all SMS records
curl -X POST https://api.novauth.com/api/v1/connect-hub/sms/sdr \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "rows_per_page": 20,
    "sort_by": "created_at",
    "sort_direction": "DESC"
  }'