API de SMS para envíos a España
La llamada de envío es la parte sencilla de cualquier integración de SMS. Lo que decide si la integración sirve es lo que vuelve: los acuses de recibo, las respuestas entrantes y la forma en que los errores de red llegan hasta la aplicación.
En España hay además un requisito que no se resuelve en el código: el alias debe estar inscrito en el registro de la CNMC, y desde el 15 de septiembre de 2026 los mensajes con alias no inscrito deben bloquearse. Ninguna cabecera de la API sustituye ese trámite.
Lo que la API no puede resolver
El registro del alias es previo al envío y externo a la integración. La documentación de operador consultada indica que la inscripción de un remitente alfanumérico puede tardar hasta cuatro semanas, y que los remitentes elegidos mensaje a mensaje no se aceptan en España.
La consecuencia de diseño es que el nombre de remitente debe tratarse como configuración con ciclo de vida propio, no como un parámetro por petición. Una aplicación que permita escribir cualquier cadena en ese campo producirá bloqueos silenciosos en producción.
Acuses de recibo: qué significan realmente
Una respuesta correcta de la API significa que la petición se ha admitido, no que el mensaje haya llegado. El estado real aparece después, por webhook, y su interpretación depende de la red: un acuse puede emitirse al entrar en la red del operador y no al llegar al terminal.
Construir una tasa de entrega sobre esa suposición produce una cifra optimista y estable, que es la peor combinación posible: parece buena y no se mueve cuando algo se rompe. Conviene guardar el estado con su origen y no reducirlo a un booleano de entregado.
Codificación y longitud
La eñe y las vocales acentuadas están en el alfabeto GSM de 7 bits, pero otros caracteres habituales no, y basta uno para forzar UCS-2 y reducir el segmento de 160 a 70 caracteres. El coste se multiplica sin que cambie el texto visible.
Una API que no devuelva el número de segmentos calculado antes del envío deja que ese error se repita en cada campaña. El cálculo debe hacerse en el momento de componer, no al revisar la factura.
Fuentes, por tema
| Código de país móvil | www.twilio.com2026-09-22 |
| Remitente alfanumérico | www.twilio.com2026-09-22 |
| Registro del remitente | www.cnmc.es2026-09-22 |
| SMS bidireccional | www.twilio.com2026-09-22 |
| Ruta SMSPro: mercado aún sin mapear | lib/sms/providers/capabilities.ts2026-09-22 |
Casos de uso
Códigos de un solo uso
Mensaje esperado por el destinatario, con requisitos de latencia y de fiabilidad del estado. No debe compartir cola con las campañas promocionales.
Avisos de pedido y de entrega
Disparados por un evento de la tienda, con webhook de estado que actualiza el pedido. La relación entre mensaje y pedido debe sobrevivir a un reenvío.
- El alias debe estar inscrito antes del primer envío; el plazo de inscripción condiciona el calendario del proyecto.
- Los remitentes elegidos mensaje a mensaje no se aceptan según la documentación consultada.
FAQ
¿Se puede enviar a España con un alias nuevo el mismo día?
No con un alias alfanumérico sin inscribir. Desde el 15 de septiembre de 2026 los mensajes con alias no inscrito en el registro de la CNMC deben bloquearse, y la inscripción previa puede tardar hasta cuatro semanas según la documentación de operador consultada.
¿Qué código MCC corresponde a España?
214. Este código identifica el país en el intercambio entre operadores móviles y sirve para encaminar el mensaje hacia la red nacional correcta.
¿Un estado de entregado significa que el usuario lo ha leído?
No. Un acuse de recibo indica, como mucho, que el mensaje ha llegado al terminal, y según la red puede emitirse antes, al entrar el mensaje en la red del operador. La lectura no se reporta en SMS.
¿Por qué un mensaje con ciertos caracteres cuesta más?
Porque un carácter fuera del alfabeto GSM de 7 bits obliga a usar la codificación UCS-2, que reduce el segmento de 160 a 70 caracteres. Un texto de 150 caracteres puede pasar de uno a tres segmentos sin que su apariencia cambie.
Documentación y alta disponibles; la activación comercial por mercado se comprueba en el pago.
SMSPro · 3 fuentes · 2026-09-25