Help Center Mensajes SMS

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

Mensajes de Viber - Mensajes multimedia enriquecidos
Mensajes RCS - Servicios de comunicación enriquecidos
Verificar estado - Seguimiento del estado de entrega
Estrategias de respaldo - Configurar respaldos

Search Results