Saltar a contenido

Mensajes SMS

Envíe mensajes de texto estándar utilizando SMSBAT API. Los SMS son el canal de mensajería más universal y con las tasas de entrega más altas en todos los dispositivos móviles.

Descripción general

SMS (Servicio de Mensajes Cortos) es ideal para:

  • Notificaciones de tiempo crítico
  • Respaldo para mensajes de Viber/RCS
  • Llegar a usuarios sin smartphones
  • Compatibilidad universal en todas las redes móviles
  • Altas tasas de entrega (95%+)

Mensaje SMS básico

Solicitud

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

Parámetros

Parámetro Tipo Requerido Descripción
de cadena Sí ID de remitente alfanumérico (hasta 11 caracteres)
a cadena Sí Número de teléfono del destinatario en formato E.164
tipo cadena Sí Establecer en "sms"
texto cadena Sí Contenido del mensaje
clienteMessageId cadena No Su ID de seguimiento interno
ttl entero No Tiempo de vida en segundos

Ejemplos

SMS sencillos

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourBrand",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello! This is a test SMS message."
    }]
  }'

SMS con ID de cliente

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your order #12345 has been shipped.",
    "customerMessageId": "order-12345-notification"
  }]
}

SMS con TTL

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your verification code is: 123456",
    "ttl": 300
  }]
}

Codificación de caracteres

Codificación GSM de 7 bits

Alfabeto GSM estándar (160 caracteres por SMS):

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

Caracteres GSM extendidos

Estos caracteres cuentan como 2 caracteres:

| ^ € { } [ ] ~ \

Codificación Unicode (UCS-2)

Los mensajes con caracteres especiales utilizan codificación Unicode (70 caracteres por SMS):

-Emoji: 😀 🎉 ❤️ - Cirílico: А Б В Г Д Е Ж - Símbolos especiales: ✓ ✗ ★ ♥

Longitud del mensaje

SMS único

  • GSM 7 bits: 160 caracteres
  • Unicode: 70 caracteres

SMS de varias partes

Cuando su mensaje excede el límite, se divide en varias partes:

  • GSM 7 bits: 153 caracteres por parte
  • Unicode: 67 caracteres por parte

Ejemplo

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "This is a very long message that will be split into multiple parts. Each part will be delivered separately but will appear as a single message on the recipient's phone. The system automatically handles the splitting and reassembly."
  }]
}

Este mensaje (201 caracteres) se dividirá en 2 partes.

Respuesta

Respuesta exitosa

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 2,
      "customerMessageId": "order-12345-notification",
      "to": "+380XXXXXXXXX"
    }
  ]
}

Campos de respuesta

Campo Descripción
Id del mensaje Identificador único para seguimiento
estado Estado del mensaje (aceptado, rechazado)
partes Número de partes de SMS
a Número de teléfono del destinatario

ID del remitente

Remitente alfanumérico

Utilice su marca como remitente (hasta 11 caracteres):

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

Restricciones:

  • Máximo 11 caracteres
  • Sólo letras y números
  • Sin espacios ni caracteres especiales
  • El destinatario no puede responder a remitentes alfanuméricos

Remitente numérico

Utilice un número de teléfono como remitente (para SMS bidireccionales):

{
  "from": "+380123456789",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello! You can reply to this message."
}

Casos de uso

Verificación OTP

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

Notificaciones de pedidos

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

Recordatorios de citas

{
  "from": "YourClinic",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Reminder: Your appointment is scheduled for tomorrow at 2:00 PM."
}

Confirmaciones de pago

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

Mejores prácticas

Contenido del mensaje

  • ✅ Mantenga los mensajes concisos y claros
  • ✅ Incluir identificación del remitente
  • ✅ Agregue un llamado a la acción si es necesario
  • ✅ Utilizar gramática y ortografía adecuadas
  • ❌ ¡¡¡Evita la puntuación excesiva!!!
  • ❌ No uses todas las MAYÚSCULAS
  • ❌ Evite acortadores de URL que parezcan sospechosos

Uso de caracteres

  • Verifique el recuento de caracteres antes de enviar
  • Tenga en cuenta los caracteres GSM extendidos (cuenten como 2)
  • Pruebe con caracteres especiales antes del envío masivo
  • Considere utilizar codificación GSM para mensajes más largos

Números de teléfono

  • Utilice siempre el formato E.164: +380XXXXXXXXX
  • Validar números de teléfono antes de enviar.
  • Eliminar números no válidos de tu lista
  • Mantén tu lista de contactos actualizada

Momento

  • Respetar las zonas horarias locales
  • Evite enviar por la noche (22:00 - 8:00 horas)
  • Considerar horarios comerciales para mensajes comerciales.
  • Establecer TTL apropiado para mensajes urgentes

Cumplimiento

  • Obtener el consentimiento antes de enviar mensajes de marketing.
  • Incluir instrucciones de exclusión voluntaria para SMS promocionales
  • Siga las regulaciones locales (GDPR, etc.)
  • Respetar las listas de "No molestar"

Manejo de errores

Errores comunes

Error Causa Solución
INVALID_RECIPIENT Formato de teléfono incorrecto Utilice el formato E.164
INVALID_SENDER ID de remitente no válido Verifique las reglas de identificación del remitente
MENSAJE_DEMASIADO_LARGO Supera la longitud máxima Dividir o acortar mensaje
INVALID_ENCODING Caracteres no compatibles Utilice GSM o Unicode

Optimización de costos

Reducir partes del mensaje

  • Mantenga los mensajes con menos de 160 caracteres (GSM) o 70 (Unicode)
  • Evite los caracteres especiales que activan Unicode
  • Utilizar abreviaturas cuando sea apropiado.
  • Eliminar espacios innecesarios

Ejemplo de optimización

❌ Antes (171 caracteres, 2 SMS): 

Hello John! Your order #12345 has been successfully delivered to your address at 123 Main Street. Thank you for shopping with us! We hope to see you again soon.

✅ Después (156 caracteres, 1 SMS): 

Hi John! Order #12345 delivered to 123 Main St. Thanks for shopping with us! Visit example.com/order/12345 for details.

Envío masivo

Envíe varios mensajes en una sola solicitud:

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

Próximos pasos