Pular para o conteúdo principal

Servidor de Aplicação IMS da 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, Troncos SIP e Diameter
  • Interface Sh - Recuperação de dados de assinantes do HSS/Repositório
  • Blocos de Dados do Repositório - RepositoryData por documento (MMTel, ODB, personalizado) exposto como variáveis de plano de discagem
  • 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​

  • Configuração do Plano de Discagem - Fundamentos do plano de discagem XML, variáveis e lógica de roteamento de chamadas
  • Tradução de Números - Normalização E.164 e tradução específica do país
  • Serviços Suplementares - Encaminhamento de chamadas, bloqueio de CLI e chamadas de emergência
  • SRVCC - Continuidade de Chamadas de Voz de Rádio Único: esquema de prefixo STN-SR e transferência de sessão PS para CS
  • Correio de Voz - Serviço de correio de voz (depósito/recuperação) com notificações SMS, saudações pessoais, encaminhamento de mensagens, retenção/expiração e caixas de correio federadas multi-TAS
  • TTS Prompts - Áudio de prompt é gerado no momento da implantação pelos playbooks Ansible do Omnicore; OmniTAS apenas o reproduz

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 Troncos SIP - Suporte a múltiplos gateways com monitoramento e failover
  • Roteamento de Chamadas - Plano de discagem baseado em XML flexível 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: depósito, recuperação, notificações SMS, saudações pessoais, encaminhamento, expiração e caixas de correio federadas multi-TAS
  • Conferência IMS - Conferência multipartidária 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
    • Registros de Detalhes de Chamadas com busca e filtragem avançadas
    • Monitoramento de chamadas ativas
    • Status de gateway 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 OpenAPI/Swagger para acesso programático (porta 8444)
  • Métricas Prometheus - Métricas extensas em 3 endpoints (9094, 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 troncos 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: "YourSecretPassword"
  }

# 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 (depósito + recuperação acionado por ESL)
config :tas,
  voicemail: %{
    timezone: "UTC",
    say_language: "fr",
    storage_dir: "/usr/local/freeswitch/storage/voicemail",
    # prompts omitidos aqui (prompts de fala são gerados via TTS através de :prompts); outbound_socket,
    # gravação e menu padrão no código - veja a documentação de Correio de Voz
    # prompts: %{...},
    smsc: %{
      smsc_url: "https://10.80.14.219:8443",
      source_msisdn: "2222"
    }
  }

Veja o guia Correio de Voz para a configuração e fluxo completos, e o Guia de Configuração para a referência completa de parâmetros.

Arquitetura de Monitoramento & Acesso​

Pontos de Acesso​

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

Modelos de Plano de Discagem​

Modelos de plano de discagem 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 do Plano de Discagem para documentação detalhada do plano de discagem.

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 o Guia de Operações para monitoramento e tarefas do dia a dia
  2. Revise a Referência de Métricas para configurar monitoramento e alertas
  3. Use o Painel de Controle em https://your-server-ip/ para tarefas operacionais

Integradores de Sistema & Engenheiros:

  1. Comece com o Guia de Configuração para configuração do sistema
  2. Revise a Configuração do Plano de Discagem 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 a documentação da API REST (OpenAPI/Swagger)
  2. Veja a Referência de Métricas para integração Prometheus
  3. Verifique o 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​

  • Tempo de execução 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 docs/metrics.md
  • Documentação da API: Acesse a UI Swagger em https://your-server-ip:8444/api/swaggerui
  • Painel de Controle: Acesse em https://your-server-ip/

Licença​

Proprietária - Sistemas Omnitouch

Última atualização em