SMS Masivos

Casos de uso

• Notificaciones transaccionales: confirmaciones de pedido, recordatorios de cita, avisos de envío.
• Alertas: seguridad, monitoreo, eventos críticos.
• Recordatorios: pagos pendientes, renovaciones, vencimientos.
• Marketing: promociones, lanzamientos y ofertas (respeta los horarios permitidos).

Envío por lotes

POST /sms/send acepta varios números en una sola petición. Sepáralos con coma en el campo numbers:

curl -X POST https://api.smsmasivos.com.mx/sms/send \
  -H "Content-Type: application/json" \
  -H "apikey: $SMSMASIVOS_API_KEY" \
  -d '{
    "numbers": "525512345678,525598765432,525534567890",
    "message": "Oferta especial: 20% de descuento este fin de semana.",
    "sender": "MiTienda"
  }'

La respuesta trae una reference por cada número, más el total de créditos consumidos:

{
  "success": true,
  "message": "sent_messages",
  "code": "sms_11",
  "total_messages": 3,
  "references": [
    { "reference": "abc123...", "number": "525512345678" },
    { "reference": "def456...", "number": "525598765432" },
    { "reference": "ghi789...", "number": "525534567890" }
  ],
  "credit": 3
}

Personalización

Incluye variables en el mensaje para personalizar cada envío, por ejemplo {nombre}:

{
  "numbers": "525512345678",
  "message": "Hola {nombre}, tu pedido #12345 esta confirmado. Gracias por tu compra!",
  "sender": "MiTienda"
}

Cuando envías a una lista de contactos guardada, los campos dinámicos de cada contacto se sustituyen automáticamente.

Programar envíos

Difiere un envío con el parámetro date en formato YYYY-MM-DD HH:MM:SS (hora de México):

{
  "numbers": "525512345678",
  "message": "Recuerda tu cita manana a las 10:00 AM",
  "sender": "Clinica",
  "date": "2026-07-17 09:00:00"
}

Acortar URLs y medir clics

Activa el acortador integrado para incluir enlaces cortos y rastreables:

Listas de contactos

En lugar de mandar números sueltos, administra listas reutilizables (agendas) desde la API:

• POST /agendas/add: crea una lista.
• POST /contacts/add: agrega contactos con sus campos.
• POST /agendas/get_contacts: consulta los contactos de una lista.

Consulta la sección Contactos y Listas de contactos del API Reference.

Seguimiento y reportes

Mide el resultado de cada campaña:

• POST /reports/generate: genera un reporte de una campaña.
• POST /reports/details: obtiene el desglose (entregados, fallidos, pendientes) por campaign_id.
• POST /credits/consult: revisa tu saldo antes de un envío grande.
• Webhooks: recibe el estatus de entrega y las respuestas de tus clientes en tiempo real, sin tener que consultar.