API de SMS para empresas: envíe, programe y siga sus mensajes
Envíe un SMS con una solicitud, conozca el número de segmentos antes de enviar y reciba cada cambio de estado. Tarifas bajo presupuesto.
Bajo presupuesto
La API de SMS envía mensajes de texto a sus contactos desde su aplicación. Usted indica el remitente, el destinatario, el texto y la naturaleza del mensaje: transaccional o de marketing.
Un SMS no siempre es un solo mensaje para la red. Un texto largo, o con ciertos caracteres como los emojis, se divide en segmentos, y cada segmento cuenta. La API devuelve la codificación elegida (GSM-7 o UCS-2) y el número de segmentos.
Los estados llegan a medida que avanza el procesamiento: queued, sent, delivered, undelivered o unknown. «Entregado» significa que el operador entregó el mensaje al teléfono, no que la persona lo haya leído.
Cómo circula
Usos concretos
Códigos y alertas
Envíe códigos de confirmación, avisos de entrega o alertas de servicio.
Recordatorios de cita
Programe un mensaje la víspera, a la hora local del destinatario.
Mensajes comerciales con reglas claras
Separe los mensajes de marketing de los transaccionales para aplicar las normas que correspondan.
Respuestas de los clientes
Reciba las respuestas en un número compatible y trátelas en su aplicación.
Funcionalidades
- Envío individual o programado, con zona horaria
- Estimación de segmentos y codificación antes de enviar
- Naturaleza del mensaje: transaccional o de marketing
- Verificación del remitente y prueba a un destino verificado
- Estados queued, sent, delivered, undelivered y unknown
- Recepción de SMS entrantes en un número compatible
Límites que conviene conocer
- Un SMS largo se factura en varios segmentos. Un texto con emojis o acentos poco habituales pasa a UCS-2 y reduce el tamaño de cada segmento.
- «Entregado» no significa «leído». Ninguna entrega está garantizada: depende del operador del destinatario.
- La recepción de SMS exige un número y un país compatibles. Un número que puede llamar no siempre puede recibir SMS.
- El remitente personalizado, su formato y su registro varían según el país y el operador.
- El estado unknown indica que el operador no dio una respuesta final. No equivale a un éxito ni a un fallo.
curl -X POST "https://api.example.test/v1/messages" \
-H "Authorization: Bearer tq_test_EXEMPLE" \
-H "Idempotency-Key: 7b1d2c4e-0000-4000-8000-000000000003" \
-H "Content-Type: application/json" \
-d '{
"from": "+33199001234",
"to": "+33199001235",
"text": "Su cita está confirmada para mañana a las 10:00.",
"nature": "transactional",
"scheduled_at": "2026-11-20T09:00:00",
"timezone": "Europe/Paris"
}'
# => { "id": "msg_ejemplo", "status": "queued", "segments": 1,
# "encoding": "GSM-7", "simulated": true }Aspectos técnicos
| Envío | POST /messages, Idempotency-Key obligatoria |
|---|---|
| Naturaleza | transactional o marketing |
| Codificación | GSM-7 o UCS-2, devuelta junto con el número de segmentos |
| Programación | scheduled_at y timezone |
| Eventos | message.sent, message.delivered, message.undelivered |
Preguntas frecuentes
¿Por qué mi mensaje cuenta como varios segmentos?
O bien el texto supera el tamaño de un segmento, o bien contiene caracteres que obligan a usar UCS-2, una codificación más restrictiva. La API devuelve el número de segmentos al crear el mensaje.
¿Qué significa el estado unknown?
El operador no ha comunicado un estado final. El mensaje puede haber llegado o no. No lo trate ni como un éxito ni como un fallo definitivo.
¿Puedo recibir las respuestas de mis contactos?
Sí, si el número y el país lo permiten. La recepción de SMS no está disponible en todas partes. Se comprueba al buscar el número.
Usos relacionados
Documentación
Servicios relacionados
Planifiquemos sus envíos de SMS
Indique los países, el tipo de mensajes y los volúmenes. Preparamos un presupuesto que detalla las condiciones por destino.