SMS REST API Integración Corporativa

El Gateway de Interconectados.net es una pasarela de mensajería de texto corta (SMS) de grado corporativo que funciona como intermediario directo entre el Centro de Servicio de Mensajería Corta (SMSC) y las aplicaciones de software de tu empresa. Está diseñado exclusivamente para operar en el territorio de Venezuela, garantizando una compatibilidad probada y una integración total con las tres principales operadoras del país, tanto en tecnologías GSM como CDMA.

Nuestra infraestructura robusta y escalable basada en la Nube cuenta con un sistema de Alta Disponibilidad 24×7. Para garantizar la máxima velocidad de entrega y mitigar fallos, el Gateway ejecuta algoritmos avanzados de enrutado y balanceo de carga del tráfico de SMS de forma simultánea entre múltiples SMSCs. Esto optimiza los tiempos de respuesta y estabiliza el flujo de envíos corporativos masivos.

La integración es completamente agnóstica respecto al stack tecnológico de tu empresa. Al ser una librería de funciones accesible mediante el protocolo HTTP estándar (utilizando peticiones HTTP POST y GET), puedes conectarte desde cualquier lenguaje de programación. El panel de control incluye códigos de ejemplo listos para producción en entornos como PHP, ASP, .NET, Python, entre otros.

El Gateway procesa envíos dirigidos únicamente a celulares con los prefijos oficiales de Venezuela: 0412, 0414, 0416, 0424 y 0426. Toda petición configurada con prefijos distintos o internacionales será debitada y contabilizada por el sistema, pero la entrega final no será ejecutable debido a las restricciones de enrutamiento local.

La plataforma se rige estrictamente por el estándar internacional de la tecnología GSM:

• 1 SMS: De 1 a 160 caracteres alfanuméricos.

• Mensajes Concatenados: Si envías un texto de mayor longitud, los mensajes se unen de forma transparente para el usuario y se contabilizan según la siguiente escala técnica:

  • 2 SMS: De 161 a 305 caracteres.

  • 3 SMS: De 306 a 457 caracteres.

  • 4 SMS: De 458 a 609 caracteres.

  • 5 SMS: De 610 a 761 caracteres.

Nota de optimización: Los caracteres especiales como saltos de línea (\n o --n) ocupan 3 caracteres dentro del bloque. Las letras con acentos o tildes son procesadas y sustituidas automáticamente por sus equivalentes sin acento para prevenir que las operadoras traten el envío como un SMS Binario y garantizar la recepción del texto limpio. Se recomienda enfáticamente usar codificación UTF-8 y URLEncode; el uso de caracteres no soportados provocará una falla con estatus Err.Texto.

El Gateway 3.2 integra un algoritmo automatizado de Lista Negra por usuario para asegurar que las empresas cumplan con las buenas prácticas de comunicación. El sistema analiza las respuestas de los usuarios en tiempo real; si un destinatario responde con la palabra clave #Salir (no distingue mayúsculas de minúsculas), el número es agregado de forma automática a la exclusión. El sistema le notificará su baja vía SMS y bloqueará cualquier intento futuro de envío desde tu cuenta a ese celular. Desde el panel, el administrador puede:

1. Añadir números manualmente a la lista de exclusión.

2. Depurar y eliminar dichos números de sus grupos de contactos de forma masiva.

3. Exportar las bases de datos de exclusión en formatos PDF, CSV y TXT.

4. Configurar un callback o webservice dedicado para sincronizar la Lista Negra con los sistemas internos de la empresa en tiempo real.

Sí. Además de centralizar los mensajes entrantes en el panel de control, el sistema ofrece la capacidad de habilitar un WebService en tiempo real. Al configurar una URL válida en tu panel (Menú > Reportes > Mensajes Recibidos), nuestro Gateway redirigirá inmediatamente cada SMS entrante hacia tu aplicación mediante variables estructuradas corporativas: sender (número remitente), texto (contenido del mensaje) y cuenta (usuario emisor).

Al realizar peticiones de envío, consultas de saldo o estados de cuenta a la API, el sistema responde con texto plano utilizando códigos estandarizados para facilitar la automatización de tu software:

• 200 / [Cantidad]: Procesamiento exitoso. Retorna el código acompañado del número de SMS enviados (Ej: 200/1).

• 400 (Falta Texto): La variable text está vacía o mal configurada.

• 401 (Autenticación Inválida): El usuario corporativo (user) o la contraseña (password) son incorrectos.

• 402 (Créditos Insuficientes): Tu balance de saldo no cuenta con fondos suficientes para el lote solicitado.

• 403 (Cuenta Inactiva): El acceso a la plataforma se encuentra suspendido transitoriamente.

• 405 (Falta Destinatario): La variable obligatoria phonenumber no fue detectada en la petición.

• 501 (Tipo de Cuenta Inválida): Conflicto de compatibilidad del tipo de cuenta con el producto de API solicitado.

• 502 (Petición Sobrecargada): Se intentó procesar un lote que excede los 500 destinatarios permitidos en una sola llamada de servidor.

Absolutamente. La seguridad es prioritaria. Puedes forzar el cifrado de datos extremo a extremo utilizando el protocolo seguro de transferencia HTTPS incorporando nuestro certificado de seguridad SSL en la raíz de cualquier URL de consulta o envío.