Pular para o conteúdo principal

Servidor de Aplicação IMS OmniTouch

Servidor de aplicação IMS que fornece serviços abrangentes de aplicação de telefonia, incluindo roteamento de chamadas, serviços suplementares, cobrança online e gerenciamento de assinantes.

Operações & Monitoramento​

Configuração​

  • Guia de Configuração - Referência completa de configuração para Event Socket, Painel de Controle, API, Trunks SIP e Diameter
  • Interface Sh - Recuperação de dados de assinantes do HSS/Repositório
  • Cobrança Online (Ro) - Integração OCS e controle de crédito
  • MAP SS7 - Consultas HLR para roaming e encaminhamento de chamadas

Roteamento de Chamadas & Serviços​

Conformidade​

Visão Geral do Processamento de Chamadas​

Visão Geral dos Recursos​

Funcionalidade Principal​

  • Processamento de Chamadas Compatível com IMS - Funcionalidade completa do Servidor de Aplicação IMS 3GPP
  • Integração Diameter - Interfaces Sh (dados do assinante) e Ro (cobrança online)
  • Gerenciamento de Trunks SIP - Suporte a múltiplos gateways com monitoramento e failover
  • Roteamento de Chamadas - Dialplan flexível baseado em XML com suporte abrangente a variáveis
  • Tradução de Números - Normalização E.164 para múltiplos países (AU, US, PF, extensível)

Serviços Suplementares​

  • Encaminhamento de Chamadas - Todas as variantes (CFA, CFB, CFNRy, CFNRc) com suporte a MMTel-Config
  • Bloqueio de CLI - Retenção de ID do chamador baseada em prefixo e cabeçalho SIP
  • Chamadas de Emergência - Roteamento dedicado para serviços de emergência com bypass OCS
  • Correio de Voz - Serviço completo de correio de voz com depósito, recuperação e notificações SMS
  • Conferência IMS - Conferência multiparte compatível com 3GPP (RFC 4579, RFC 4575)

Monitoramento & Operações​

  • Interface Web do Painel de Controle - Interface de monitoramento abrangente (HTTPS na porta 443)
    • Registros de assinantes em tempo real com localizações de torres de celular
    • Registros de Detalhes de Chamadas com pesquisa e filtragem avançadas
    • Monitoramento de chamadas ativas
    • Status de gateways e pares Diameter
    • Logs do sistema e métricas
    • Ferramentas de teste (Sh, OCS, HLR, Tradução de Números, Simulador de Chamadas)
  • API REST - API documentada com OpenAPI/Swagger para acesso programático (porta 8444)
  • Métricas Prometheus - Métricas extensivas em 3 endpoints (8080, 9090, 9093)

Pontos de Integração​

  • HSS/Repositório (Sh) - Recuperação de perfil de assinante e MMTel-Config
  • OCS (Ro) - Controle de crédito em tempo real com reautorização periódica
  • HLR (SS7 MAP) - Recuperação de MSRN para assinantes em roaming
  • SMSc - Notificações de correio de voz e chamadas perdidas
  • OpenAI TTS - Geração dinâmica de prompts
  • SBCs/Gateways - Suporte a múltiplos trunks SIP

Início Rápido​

Estrutura de Configuração​

Arquivos de Configuração​

Toda a configuração está em config/runtime.exs:

# Event Socket - Interface de controle de chamadas
config :tas,
  fs_event_socket: %{
    host: "127.0.0.1",
    port: 8021,
    secret: "SuaSenhaSecreta"
  }

# IPs de origem permitidos para roteamento de chamadas
config :tas,
  allowed_sbc_source_ips: ["10.5.198.200"],
  allowed_cscf_ips: ["10.8.3.34"]

# Tradução de números
config :tas,
  number_translate: %{
    country_code: :AU,  # :AU, :US, :PF
    localAreaCode: "617"
  }

# Cobrança online
config :tas,
  online_charging: %{
    enabled: true,
    periodic_ccr_time_seconds: 10,
    schedule_hangup_auth: false,
    skipped_regex: ["^2222", "^911"]  # Bypass OCS para esses destinos
  }

# Chamadas de emergência
config :tas,
  emergency_call_codes: ["911", "112", "000", "sos"]

# Correio de voz
config :tas,
  voicemail: %{
    timezone: "Pacific/Tahiti",
    smsc: %{
      smsc_url: "http://10.8.81.215",
      smsc_api_key: "sua_chave_api",
      source_msisdn: "2222"
    }
  }

Veja o Guia de Configuração para referência completa de parâmetros.

Arquitetura de Monitoramento & Acesso​

Pontos de Acesso​

  • Painel de Controle: https://seu-ip-do-servidor/ (configurado em config/runtime.exs)
  • API REST: https://seu-ip-do-servidor:8444/api/swaggerui
  • Métricas Prometheus:
    • http://seu-ip-do-servidor:8080/metrics (motor TAS, Diameter, OCS, HLR)
    • http://seu-ip-do-servidor:9090/metrics (Sistema, gateways, núcleo de telefonia)
    • http://seu-ip-do-servidor:9093/esl?module=default (qualidade de mídia RTP/RTCP)

Modelos de Dialplan​

Modelos de dialplan XML estão localizados em priv/templates/:

  • mo_dialplan.xml - Chamadas Originadas por Móvel
  • mt_dialplan.xml - Chamadas Terminadas por Móvel
  • mo_emergency_dialplan.xml - Chamadas de Emergência

Veja Configuração de Dialplan para documentação detalhada de dialplan.

Estrutura da Documentação​

Este README fornece uma visão geral de alto nível. A documentação detalhada está organizada por tópico:

Por Papel​

Operadores & Administradores:

  1. Comece com Guia de Operações para monitoramento e tarefas do dia a dia
  2. Revise Referência de Métricas para configurar monitoramento e alertas
  3. Use o Painel de Controle em https://seu-ip-do-servidor/ para tarefas operacionais

Integradores de Sistema & Engenheiros:

  1. Comece com Guia de Configuração para configuração do sistema
  2. Revise Configuração de Dialplan para lógica de roteamento de chamadas
  3. Configure interfaces: Interface Sh, Cobrança Online, MAP SS7
  4. Implemente serviços: Serviços Suplementares, Correio de Voz

Desenvolvedores:

  1. Revise documentação da API REST (OpenAPI/Swagger)
  2. Veja Referência de Métricas para integração com Prometheus
  3. Verifique Guia de Configuração para configuração da API

Por Tópico​

Processamento de Chamadas:

Dados do Assinante:

Configuração do Sistema:

Serviços de Valor Agregado:

Requisitos do Sistema​

Requisitos​

  • Runtime Elixir/OTP
  • PostgreSQL ou SQLite para armazenamento de CDR
  • Acesso ao Core IMS (S-CSCF)
  • Conectividade de rede para:
    • DRA/HSS (Diameter: Sh e opcionalmente Ro)
    • Gateways SIP/SBCs
    • Opcional: Gateway MAP SS7, SMSc, API OpenAI TTS

Suporte & Documentação​

  • Problemas & Solicitações de Recursos: Entre em contato com seu engenheiro de integração
  • Métricas & Monitoramento: Veja doc/metrics.md
  • Documentação da API: Acesse a interface Swagger em https://seu-ip-do-servidor:8444/api/swaggerui
  • Painel de Controle: Acesse em https://seu-ip-do-servidor/

Licença​

Proprietária - Omnitouch Systems