Guía rápida

De cero a tu primera integración en 5 minutos. Elige tu flujo, ya sea verificar usuarios o enviar notificaciones.

Requisitos

Una cuenta activa en app.smsmasivos.com.mx con saldo disponible.
Tu API Key desde la sección Integraciones del panel. Si aún no la tienes, revisa Autenticación.

1. Autentica

Comprueba tu llave consultando el saldo. Todas las peticiones llevan el header apikey:

curl -X GET https://api.smsmasivos.com.mx/credits/consult \
  -H "apikey: TU_API_KEY"

Guarda tu llave en una variable de entorno para no exponerla: export SMSMASIVOS_API_KEY="tu_llave".

2. Elige tu flujo

El endpoint correcto depende de qué envías. Elige tu caso antes de copiar código:

Para códigos de verificación, login, 2FA o confirmación de identidad. Usa el producto OTP: entrega con prioridad de red, fallback automático a voz o WhatsApp si el SMS no llega, y códigos hasheados. Sin costo extra sobre un SMS normal.

Son 2 pasos: enviar el código y verificarlo.

Paso 1: envía el código

POST /otp/send genera y envía el código. Los campos obligatorios son phone_number, country_code y company.

curl -X POST https://api.smsmasivos.com.mx/otp/send \
  -H "Content-Type: application/json" \
  -H "apikey: $SMSMASIVOS_API_KEY" \
  -d '{
    "phone_number": "5512345678",
    "country_code": "52",
    "company": "Mi Empresa",
    "code_length": 6,
    "code_type": "numeric"
  }'

Paso 2: verifica el código

Cuando el usuario ingresa el código que recibió, valídalo con POST /otp/verify:

curl -X POST https://api.smsmasivos.com.mx/otp/verify \
  -H "Content-Type: application/json" \
  -H "apikey: $SMSMASIVOS_API_KEY" \
  -d '{
    "phone_number": "5512345678",
    "verification_code": "483920"
  }'

Si el código es correcto, el número queda verificado. Eso es todo.

Guía completa del producto, plantillas y opciones del código en Verificación OTP.

Confirma la entrega

Consulta el detalle de una campaña con POST /reports/details usando su campaign_id, o genera un reporte con POST /reports/generate para ver entregados, fallidos y pendientes.

Para recibir el estatus de cada mensaje en tiempo real (en lugar de consultarlo), configura un webhook de confirmación de entrega. También puedes recibir por webhook las respuestas de tus clientes.

Un estatus "Entregado" del operador no siempre garantiza que el mensaje llegó a la bandeja. Los filtros de las operadoras pueden bloquear contenido aunque reporten entrega. Reduce ese riesgo siguiendo las Buenas prácticas de envío.