Una API que envía, consulta y recibe SMS desde tu aplicación. Ni más, ni menos: tu sistema decide el qué y el cuándo, nosotros ponemos la mensajería.
Cuando un proceso necesita avisar a una persona —una reserva confirmada, un pedido que sale, una cita que se acerca—, el SMS sigue siendo el canal más directo: llega al teléfono sin depender de que haya una app abierta ni conexión de datos. La API de SMS de netelip existe para que ese aviso lo dispare tu aplicación, y no una persona pulsando «enviar» en un panel.
En este artículo te contamos qué hace exactamente la API, qué deja fuera a propósito y cómo se integra en un proceso real. Sin promesas de más: lo que puedes construir con ella es justo lo que está documentado.
LA IDEA EN UNA FRASE
Tu aplicación gobierna el proceso. La API de SMS de netelip conecta ese proceso con el envío o la recepción del mensaje.
1. Qué hace la API de SMS (y qué no hace)
La API SMS v1.0 conecta tu aplicación con la pasarela de envío de SMS M2M de netelip. Sirve para que un sistema realice y controle envíos mediante peticiones web, sin que nadie tenga que ejecutar cada mensaje a mano. Con ella puedes:
- Enviar un SMS con una petición POST.
- Indicar remitente, número de destino y contenido del mensaje.
- Obtener un identificador único del envío, el ID-SMS.
- Consultar después el estado del SMS con ese ID-SMS.
- Recibir en tu aplicación los datos de un SMS entrante mediante una URL, cuando el número lo admite.
Y aquí viene la parte que otros no te cuentan: hay cosas que la API no hace, y las deja fuera a propósito.
- No gestiona reservas, citas, compras ni expedientes.
- No crea reglas de automatización dentro de tu sistema.
- No incluye plantillas, variables dinámicas, listas de contactos ni CRM.
- No documenta un endpoint de campañas ni de envíos masivos.
- No programa envíos por fecha y hora desde la API.
No es una limitación: es un reparto de responsabilidades. Tu sistema detecta el evento y decide el contenido; la API se encarga de una sola cosa —enviar o entregar el mensaje— y la hace bien.
CUÁNDO USARLA
Tiene sentido usar la API cuando el envío o la recepción de un SMS debe formar parte de un proceso gestionado por otra aplicación. El sistema detecta el evento, construye el mensaje y llama a netelip.
2. Cómo funciona un envío
Un envío es una petición HTTPS de tipo POST al endpoint de envío. Cuatro parámetros obligatorios y poco más.
El endpoint y los parámetros
El endpoint de envío es https://api.netelip.com/v1/sms/api.php, y necesita cuatro parámetros obligatorios:
- token — el token de seguridad de tu cuenta.
- from — el remitente que verá el destinatario, con un máximo de 11 caracteres.
- destination — el número de destino en formato internacional, empezando por 00.
- message — el contenido del mensaje, hasta 160 caracteres.
El endpoint, sus parámetros y ejemplos están documentados en la API SMS v1.0.
EJEMPLO DE PETICIÓN (cURL)
curl -X POST «https://api.netelip.com/v1/sms/api.php» –data «token=TU_TOKEN» –data «from=MiEmpresa» –data «destination=0034666554433» –data «message=Tu cita ha sido confirmada»
Los valores son ficticios: sustitúyelos por los tuyos antes de probar.
Dos detalles que conviene tener claros: si el remitente (from) supera los 11 caracteres, aparecerá vacío; y cada petición admite un único destino: para varios números, tu sistema hace una petición por cada uno, respetando los límites.
La respuesta: guarda el ID-SMS
Si la petición se acepta, la API devuelve una respuesta en XML con tres valores: el estado (status), el ID-SMS y el saldo restante (remainingbalance).
Ese ID-SMS es la pieza clave: es el identificador único del envío y lo necesitarás para consultar después su estado. Guárdalo y asócialo en tu sistema al registro que originó el mensaje.
3. Consultar el estado y recibir respuestas
Consultar si el SMS se ha entregado
Con el ID-SMS puedes preguntar por el estado del envío mediante otra petición POST, esta vez al endpoint status.php, enviando el token y el id-sms. La API responde con uno de tres estados documentados:
- OK — entregado. La respuesta puede incluir la fecha de entrega.
- ERROR — no entregado.
- PENDING — pendiente.
SIN SORPRESAS
La API documenta una consulta activa por ID-SMS: tu aplicación pregunta cuando lo necesita. No hay un aviso automático que notifique el cambio de estado; si quieres saber el resultado, lo consultas tú.
Recibir SMS en tu aplicación
La API también entrega los SMS entrantes. Cuando el número contratado admite recepción y configuras un destino, netelip envía los datos del mensaje recibido a una URL de tu aplicación mediante una petición POST. Recibes cuatro campos: la fecha (date), el origen (from), el número de netelip donde se recibió (destination) y el contenido (message).
DISPONIBILIDAD
No todos los números admiten recepción de SMS. Consulta la disponibilidad vigente antes de contratar o configurar la numeración.
4. Límites, errores y buenas prácticas
La API está pensada para integrarse en producción, y eso implica respetar sus límites.
Cuántas peticiones puedes hacer
La documentación general de APIs establece para la API SMS un máximo de 3 peticiones por segundo y 120 peticiones por minuto. Cada respuesta incluye cabeceras X-RateLimit que indican el límite y cuántas peticiones te quedan en cada intervalo. Si superas un límite, recibirás un código 429.
Los códigos que conviene conocer
| Código | Qué significa |
|---|---|
| 200 | Petición correcta. |
| 401 | Error de autenticación: revisa el token. |
| 402 | Saldo insuficiente. |
| 404 | No se encuentra el ID-SMS consultado. |
| 406 | Falta un parámetro obligatorio. |
| 429 | Has superado un límite de peticiones. |
| 500 / 503 | Problema o mantenimiento en el servidor. |
ADVERTENCIA OFICIAL
netelip monitoriza la repetición continuada de errores 4xx y 5xx y puede aplicar medidas de seguridad, incluido el bloqueo temporal o permanente del servicio. La buena práctica: corrige la causa antes de reintentar, controla las cabeceras de límite y no repitas peticiones fallidas en bucle.
5. Dónde encaja: casos de uso reales
En todos los casos el patrón es el mismo: tu sistema detecta el evento y decide el contenido; la API realiza el envío. Algunos ejemplos habituales:
- Confirmación de reservas y compras. Cuando tu sistema registra una reserva o un pedido, dispara un SMS de confirmación.
- Recordatorios de cita. Tu aplicación decide la regla —«24 horas antes»— y pide el envío cuando toca.
- Avisos de horario o cambios. Un mensaje breve cuando el proceso interno determina que hay que comunicarlo.
- Notificaciones operativas. Estados de un envío logístico o avisos vinculados a eventos definidos por tu organización.
¿Por qué SMS y no otro canal? Porque llega directo al teléfono, sin depender de que el usuario tenga una app instalada o abierta. Para un aviso que no se puede perder, esa sencillez es una ventaja.
Un ejemplo de flujo: confirmar una reserva
- El cliente completa una reserva en tu aplicación.
- Tu aplicación guarda la reserva y determina que debe enviar una confirmación.
- Construye el remitente, el destino y el mensaje.
- Realiza una petición POST a la API de SMS de netelip.
- netelip devuelve la respuesta con el ID-SMS si todo es correcto.
- Guardas el ID-SMS por si quieres consultar el estado más tarde.
La reserva se crea y se mantiene en tu sistema de principio a fin. La API solo pone el mensaje. Ese es exactamente el reparto que buscamos.
Empieza por lo básico, integra lo justo
La API de SMS de netelip no intenta ser tu CRM ni tu motor de campañas. Hace tres cosas —enviar, consultar y recibir— y las deja bien definidas para que las conectes con el proceso que ya tienes. Esa claridad es lo que hace que una integración sea fácil de mantener en el tiempo.
La referencia técnica completa —endpoints, parámetros y códigos— está en la documentación oficial, y puedes contratar el envío y recepción de SMS desde el panel o por API.
Una API que hace su trabajo
No te vendemos una plataforma de campañas con mil funciones que no vas a usar. Te damos una API de SMS que envía, consulta y recibe, y encaja con lo que ya tienes.
¡Contáctanos! Estamos disponibles para charlar cuando quieras.
¿Te gusta el contenido? Compártelo.
La entrada API de SMS: qué hace y cómo integrarla con netelip se publicó primero en Noticias sobre Tecnología – IA – Automatización de procesos.
