OmniMessage SMPP Gateway - Guía de Operaciones

Versión: 1.0.0
Para Equipos de Operaciones

¿Qué es el Gateway SMPP?

El Gateway SMPP de OmniMessage es uno de varios protocolos frontend para la plataforma de telecomunicaciones OmniMessage. Permite el envío de mensajes SMS conectando tu infraestructura a redes móviles utilizando el protocolo SMPP (Short Message Peer-to-Peer) estándar de la industria.

Importante: Este gateway es un frontend de protocolo sin estado. No tiene lógica de negocio, procesamiento de mensajes ni capacidades de almacenamiento. Toda la inteligencia proviene de OmniMessage, accesible a través de la API REST. Al igual que otros frontends de OmniMessage (Diameter, MAP, IMS), simplemente traduce mensajes de protocolo al formato interno de OmniMessage y viceversa.

Capacidades Clave

Mensajería SMPP Bidireccional: Enviar y recibir mensajes SMS a través de SMPP
Múltiples Conexiones: Conectar a múltiples operadores simultáneamente
Alto Rendimiento: Manejar miles de mensajes por segundo
Monitoreo: Métricas de Prometheus integradas y panel web
Confiabilidad: Reconexión automática y reintento de mensajes
Operación Sin Estado: Todo el procesamiento delegado al backend de OmniMessage

¿Quién Debe Usar Esta Guía?

Esta guía es para equipos de operaciones responsables de:

Instalar y configurar el gateway
Monitorear el tráfico de mensajes
Gestionar conexiones SMPP
Solucionar problemas

Inicio Rápido

Configuración Inicial

Acceder al Panel Web: https://your-server:8087
Verificar el Estado del Sistema: Navegar a SMPP → Estado en Vivo
Revisar la Configuración: Ver CONFIGURATION.md
Configurar Monitoreo: Ver MONITORING.md

Operaciones Diarias

Tareas operativas comunes:

Tarea	Acción
Verificar el estado de conexión	Interfaz Web → SMPP → Estado en Vivo
Ver tráfico de mensajes	Interfaz Web → Cola
Monitorear la salud del sistema	Interfaz Web → Registros o métricas de Prometheus
Agregar/modificar conexiones	Interfaz Web → SMPP → Pares Cliente/Servidor

Ver OPERATIONS.md para procedimientos detallados.

Arquitectura del Sistema

El Gateway SMPP es un traductor de protocolo sin estado que opera como parte de la plataforma OmniMessage:

Conceptos Clave:

Gateway SMPP: Solo traductor de protocolo - sin procesamiento de mensajes, almacenamiento o lógica de negocio
OmniMessage: Plataforma central que maneja toda la lógica de mensajería, enrutamiento y almacenamiento
Comunicación API: El gateway recupera mensajes para enviar desde OmniMessage y reporta el estado de entrega

Integración de OmniMessage

El Gateway SMPP de OmniMessage es un frontend de protocolo para la plataforma de mensajería OmniMessage. Es uno de varios tipos de frontend idénticos que se interfazan con redes móviles utilizando diferentes protocolos:

Frontend	Protocolo	Propósito
SMPP Gateway	SMPP (SMS)	Mensajería SMS a través del protocolo SMPP
Gateway Diameter	Diameter	Mensajería basada en IMS
Gateway MAP	MAP	Señalización de red móvil
Gateway IMS	IMS	Subsistema Multimedia IP

Todos los frontends comparten la misma arquitectura: Son traductores de protocolo sin estado que delegan toda la inteligencia al Core de OmniMessage.

Cómo Funciona

Flujo de Mensajes Entrantes (Sistema Externo → Operador):

Flujo de Mensajes Salientes (Operador → Gateway SMPP):

Lo Que Hace el Gateway

Recibe PDUs SMPP de operadores y clientes externos
Analiza y valida mensajes de protocolo SMPP
Traduce el formato SMPP al formato interno de OmniMessage
Llama a la API REST de OmniMessage con los datos del mensaje
Recibe mensajes de OmniMessage a través de la consulta de API
Convierte el formato de OmniMessage de nuevo a PDUs SMPP
Reporta recibos de entrega de vuelta a OmniMessage

Lo Que NO Hace el Gateway

❌ No almacenamiento ni persistencia de mensajes
❌ No decisiones de enrutamiento (OmniMessage decide)
❌ No limitación de tasa (OmniMessage aplica)
❌ No validación de números (OmniMessage valida)
❌ No seguimiento de estado (OmniMessage mantiene el estado)
❌ No lógica de negocio (OmniMessage maneja toda la lógica)

API REST de OmniMessage

El gateway se comunica con el Core de OmniMessage a través de la API REST:

Configuración:

config :omnimessage_smpp,
  api_base_url: "https://omnimessage-core.example.com:8443"

Operaciones Clave de la API:

GET /api/message_queue?destination_smsc=<bind_name> - Recuperar mensajes pendientes
PUT /api/messages/<id>/delivery_status - Reportar recibo de entrega
GET /api/system/health - Verificación de salud

Formato del Mensaje: Los mensajes en la cola contienen toda la información necesaria para la entrega:

Número de destino
Cuerpo del mensaje
Número de origen
Prioridad
Período de validez
SMSC objetivo (nombre de enlace del operador)

El gateway simplemente recupera estos, los formatea como SMPP, los envía al operador y reporta el estado.

Estructura de la Documentación

Esta documentación está organizada en las siguientes guías:

CONFIGURATION.md - Referencia completa de configuración con todos los parámetros explicados
MONITORING.md - Guía de métricas y alertas de Prometheus
OPERATIONS.md - Procedimientos operativos diarios
TROUBLESHOOTING.md - Problemas comunes y soluciones
GLOSSARY.md - Términos y definiciones

Puntos de Acceso

Panel Web

URL: https://your-server:8087
Características:
- Ver estado de conexión SMPP
- Monitorear cola de mensajes
- Ver registros del sistema
- Configurar pares SMPP
- Acceder a la documentación

Métricas de Prometheus

URL: http://your-server:4000/metrics
Formato: Formato de texto de Prometheus
Uso: Integración con Grafana/Prometheus

Endpoint de API

URL: Configurado en API_BASE_URL
Propósito: Integración de backend de cola de mensajes

Referencia Rápida

Tareas Comunes

Tarea	Comando/Ubicación
Iniciar gateway	`systemctl start omnimessage-smpp`
Detener gateway	`systemctl stop omnimessage-smpp`
Reiniciar gateway	`systemctl restart omnimessage-smpp`
Ver registros	`journalctl -u omnimessage-smpp -f`
Verificar estado	Interfaz Web → SMPP → Estado en Vivo
Ver métricas	`curl http://localhost:4000/metrics`
Editar configuración	`/opt/omnimessage-smpp/config/runtime.exs`

Archivos Importantes

Archivo	Propósito
`/opt/omnimessage-smpp/config/runtime.exs`	Configuración principal
`/opt/omnimessage-smpp/priv/cert/`	Certificados SSL
`/var/log/omnimessage-smpp/`	Registros de la aplicación
`/etc/systemd/system/omnimessage-smpp.service`	Definición del servicio

Notas de Seguridad

Interfaz Web: Usa HTTPS con tus certificados SSL
Comunicación API: Puede verificar SSL o usar certificados autofirmados
SMPP: Protocolo de texto plano - usar seguridad de red
Credenciales: Almacenadas en el archivo de configuración - proteger el acceso

Próximos Pasos

Revisar CONFIGURATION.md para todas las opciones de configuración
Configurar MONITORING.md con Prometheus
Familiarizarse con OPERATIONS.md para tareas diarias
Marcar TROUBLESHOOTING.md para referencia rápida
Revisar GLOSSARY.md para terminología

¿Qué es el Gateway SMPP?​

Capacidades Clave​

¿Quién Debe Usar Esta Guía?​

Inicio Rápido​

Configuración Inicial​

Operaciones Diarias​

Arquitectura del Sistema​

Integración de OmniMessage​

Cómo Funciona​

Lo Que Hace el Gateway​

Lo Que NO Hace el Gateway​

API REST de OmniMessage​

Estructura de la Documentación​

Puntos de Acceso​

Panel Web​

Métricas de Prometheus​

Endpoint de API​

Referencia Rápida​

Tareas Comunes​

Archivos Importantes​

Notas de Seguridad​

Próximos Pasos​