OmniMessage SMPP Gateway - Guia de Operações
O que é o OmniMessage SMPP Gateway?
O OmniMessage SMPP Gateway é um dos vários protocolos frontend para a plataforma de telecomunicações OmniMessage. Ele permite o envio de mensagens SMS conectando sua infraestrutura a redes móveis usando o protocolo SMPP (Short Message Peer-to-Peer), que é um padrão da indústria.
Importante: Este gateway é um frontend de protocolo sem estado. Ele não possui lógica de negócios, processamento de mensagens ou capacidades de armazenamento. Toda a inteligência vem do OmniMessage, acessada via REST API. Assim como outros frontends do OmniMessage (Diameter, MAP, IMS), ele simplesmente traduz mensagens de protocolo para o formato interno do OmniMessage.
Principais Capacidades
- Mensagens SMPP Bidirecionais: Enviar e receber mensagens SMS via SMPP
- Múltiplas Conexões: Conectar-se a vários operadores simultaneamente
- Alto Desempenho: Processar milhares de mensagens por segundo
- Monitoramento: Métricas Prometheus integradas e painel web
- Confiabilidade: Reconexão automática e reenvio de mensagens
- Operação Sem Estado: Todo o processamento delegado ao backend do OmniMessage
Quem Deve Usar Este Guia?
Este guia é para equipes de operações responsáveis por:
- Instalar e configurar o gateway
- Monitorar o tráfego de mensagens
- Gerenciar conexões SMPP
- Solucionar problemas
Início Rápido
Configuração Inicial
- Acessar o Painel Web:
https://your-server:8087 - Verificar o Status do Sistema: Navegar para SMPP → Status ao Vivo
- Revisar a Configuração: Veja CONFIGURATION.md
- Configurar Monitoramento: Veja MONITORING.md
Operações Diárias
Tarefas operacionais comuns:
| Tarefa | Ação |
|---|---|
| Verificar status da conexão | UI Web → SMPP → Status ao Vivo |
| Visualizar tráfego de mensagens | UI Web → Fila |
| Monitorar saúde do sistema | UI Web → Logs ou métricas Prometheus |
| Adicionar/modificar conexões | UI Web → SMPP → Clientes/Servidores |
Veja OPERATIONS.md para procedimentos detalhados.
Arquitetura do Sistema
O SMPP Gateway é um tradutor de protocolo sem estado que opera como parte da plataforma OmniMessage:
Conceitos Chave:
- SMPP Gateway: Apenas tradutor de protocolo - sem processamento de mensagens, armazenamento ou lógica de negócios
- OmniMessage: Plataforma central que lida com toda a lógica de mensagens, roteamento e armazenamento
- Comunicação API: O gateway recupera mensagens a serem enviadas do OmniMessage e relata o status de entrega
Integração com OmniMessage
O OmniMessage SMPP Gateway é um frontend de protocolo para a plataforma de mensagens OmniMessage. É um dos vários tipos de frontend idênticos que se conectam a redes móveis usando diferentes protocolos:
| Frontend | Protocolo | Propósito |
|---|---|---|
| SMPP Gateway | SMPP (SMS) | Mensagens SMS via protocolo SMPP |
| Diameter Gateway | Diameter | Mensagens baseadas em IMS |
| MAP Gateway | MAP | Sinalização de rede móvel |
| IMS Gateway | IMS | Subsistema Multimídia IP |
Todos os frontends compartilham a mesma arquitetura: Eles são tradutores de protocolo sem estado que delegam toda a inteligência ao OmniMessage Core.
Como Funciona
Fluxo de Mensagem de Entrada (Sistema Externo → Operadora):
Fluxo de Mensagem de Saída (Operadora → SMPP Gateway):
O que o Gateway Faz
- Recebe PDUs SMPP de operadoras e clientes externos
- Analisa e valida mensagens de protocolo SMPP
- Traduz o formato SMPP para o formato interno do OmniMessage
- Chama a REST API do OmniMessage com os dados da mensagem
- Recebe mensagens do OmniMessage via polling da API
- Converte o formato OmniMessage de volta para PDUs SMPP
- Relata recibos de entrega de volta ao OmniMessage
O que o Gateway NÃO Faz
- ❌ Sem armazenamento ou persistência de mensagens
- ❌ Sem decisões de roteamento (OmniMessage decide)
- ❌ Sem limitação de taxa (OmniMessage impõe)
- ❌ Sem validação de número (OmniMessage valida)
- ❌ Sem rastreamento de estado (OmniMessage mantém estado)
- ❌ Sem lógica de negócios (OmniMessage lida com toda a lógica)
REST API do OmniMessage
O gateway se comunica com o OmniMessage Core via REST API:
Configuração:
config :omnimessage_smpp,
api_base_url: "https://omnimessage-core.example.com:8443"
Principais Operações da API:
GET /api/message_queue?destination_smsc=<bind_name>- Recuperar mensagens pendentesPUT /api/messages/<id>/delivery_status- Relatar recibo de entregaGET /api/system/health- Verificação de saúde
Formato da Mensagem: Mensagens na fila contêm todas as informações necessárias para entrega:
- Número de destino
- Corpo da mensagem
- Número de origem
- Prioridade
- Período de validade
- SMSC alvo (nome de bind da operadora)
O gateway simplesmente recupera essas informações, formata-as como SMPP, as envia para a operadora e relata o status de volta.
Estrutura da Documentação
Esta documentação está organizada nos seguintes guias:
- CONFIGURATION.md - Referência completa de configuração com todos os parâmetros explicados
- MONITORING.md - Guia de métricas Prometheus e alertas
- OPERATIONS.md - Procedimentos operacionais do dia a dia
- TROUBLESHOOTING.md - Problemas comuns e soluções
- GLOSSARY.md - Termos e definições
Pontos de Acesso
Painel Web
- URL:
https://your-server:8087 - Recursos:
- Verificar status da conexão SMPP
- Monitorar fila de mensagens
- Visualizar logs do sistema
- Configurar pares SMPP
- Acessar documentação
Métricas Prometheus
- URL:
http://your-server:4000/metrics - Formato: Formato de texto Prometheus
- Uso: Integração com Grafana/Prometheus
Endpoint da API
- URL: Configurado em
API_BASE_URL - Propósito: Integração do backend da fila de mensagens
Referência Rápida
Tarefas Comuns
| Tarefa | Comando/Localização |
|---|---|
| Iniciar gateway | systemctl start omnimessage-smpp |
| Parar gateway | systemctl stop omnimessage-smpp |
| Reiniciar gateway | systemctl restart omnimessage-smpp |
| Ver logs | journalctl -u omnimessage-smpp -f |
| Verificar status | UI Web → SMPP → Status ao Vivo |
| Ver métricas | curl http://localhost:4000/metrics |
| Editar configuração | /opt/omnimessage-smpp/config/runtime.exs |
Arquivos Importantes
| Arquivo | Propósito |
|---|---|
/opt/omnimessage-smpp/config/runtime.exs | Configuração principal |
/opt/omnimessage-smpp/priv/cert/ | Certificados SSL |
/var/log/omnimessage-smpp/ | Logs da aplicação |
/etc/systemd/system/omnimessage-smpp.service | Definição do serviço |
Notas de Segurança
- UI Web: Usa HTTPS com seus certificados SSL
- Comunicação API: Pode verificar SSL ou usar certificados autoassinados
- SMPP: Protocolo em texto simples - use segurança de rede
- Credenciais: Armazenadas no arquivo de configuração - proteja o acesso
Próximos Passos
- Revise CONFIGURATION.md para todas as opções de configuração
- Configure MONITORING.md com Prometheus
- Familiarize-se com OPERATIONS.md para tarefas diárias
- Adicione aos favoritos TROUBLESHOOTING.md para referência rápida
- Revise GLOSSARY.md para terminologia