跳到主要内容

Omnitouch IMS 应用服务器

IMS 应用服务器提供全面的电话应用服务,包括呼叫路由、附加服务、在线计费和用户管理。

快速链接

操作与监控

配置

  • 配置指南 - Event Socket、控制面板、API、SIP 中继和 Diameter 的完整配置参考
  • Sh 接口 - 从 HSS/存储库检索用户数据
  • 在线计费 (Ro) - OCS 集成和信用控制
  • SS7 MAP - 漫游和呼叫转移的 HLR 查询

呼叫路由与服务

  • 拨号计划配置 - XML 拨号计划基础、变量和呼叫路由逻辑
  • 号码翻译 - E.164 规范化和特定国家的翻译
  • 附加服务 - 呼叫转移、CLI 阻止和紧急呼叫
  • 语音信箱 - 语音信箱(存储/检索)与 SMS 通知、个人问候、消息转发、保留/过期和多 TAS 联邦邮箱
  • TTS 提示 - 文本转语音提示配置

合规性

呼叫处理概述

功能概述

核心功能

  • 符合 IMS 的呼叫处理 - 完整的 3GPP IMS 应用服务器功能
  • Diameter 集成 - Sh(用户数据)和 Ro(在线计费)接口
  • SIP 中继管理 - 支持多个网关,具有监控和故障转移功能
  • 呼叫路由 - 灵活的基于 XML 的拨号计划,支持全面的变量
  • 号码翻译 - 针对多个国家的 E.164 规范化(AU、US、PF,可扩展)

附加服务

  • 呼叫转移 - 所有变体(CFA、CFB、CFNRy、CFNRc)支持 MMTel-Config
  • CLI 阻止 - 基于前缀和 SIP 头的来电显示屏蔽
  • 紧急呼叫 - 为紧急服务提供专用路由,绕过 OCS
  • 语音信箱 - 完整的语音信箱服务:存储、检索、SMS 通知、个人问候、转发、过期和多 TAS 联邦邮箱
  • IMS 会议 - 符合 3GPP 标准的多方会议(RFC 4579、RFC 4575)

监控与操作

  • 控制面板 Web UI - 全面的监控界面(HTTPS ��口 443)
    • 实时用户注册
    • 带有高级搜索和过滤的呼叫详细记录
    • 活跃呼叫监控
    • 网关和 Diameter 对等状态
    • 系统日志和指标
    • 测试工具(Sh、OCS、HLR、号码翻译、呼叫模拟器)
  • REST API - 公开的 OpenAPI/Swagger 文档 API,用于编程访问(端口 8444)
  • Prometheus 指标 - 在 3 个端点(8080、9090、9093)上提供广泛的指标

集成点

  • HSS/存储库 (Sh) - 用户档案和 MMTel-Config 检索
  • OCS (Ro) - 实时信用控制,具有定期重新授权
  • HLR (SS7 MAP) - 漫游用户的 MSRN 检索
  • SMSc - 语音信箱和未接来电通知
  • OpenAI TTS - 动态提示生成
  • SBCs/网关 - 支持多个 SIP 中继

快速入门

配置结构

配置文件

所有配置都在 config/runtime.exs 中:

# 事件插座 - 呼叫控制接口
config :tas,
fs_event_socket: %{
host: "127.0.0.1",
port: 8021,
secret: "YourSecretPassword"
}

# 呼叫路由的允许源 IP
config :tas,
allowed_sbc_source_ips: ["10.5.198.200"],
allowed_cscf_ips: ["10.8.3.34"]

# 号码翻译
config :tas,
number_translate: %{
country_code: :AU, # :AU, :US, :PF
localAreaCode: "617"
}

# 在线计费
config :tas,
online_charging: %{
enabled: true,
periodic_ccr_time_seconds: 10,
schedule_hangup_auth: false,
skipped_regex: ["^2222", "^911"] # 对这些目的地绕过 OCS
}

# 紧急呼叫
config :tas,
emergency_call_codes: ["911", "112", "000", "sos"]

# 语音���箱(ESL 驱动的存储 + 检索)
config :tas,
voicemail: %{
timezone: "Pacific/Tahiti",
say_language: "fr",
storage_dir: "/usr/local/freeswitch/storage/voicemail",
# 此处省略提示(语音提示通过 :prompts 生成);外部套接字,
# 记录和菜单默认在代码中 — 请参见语音信箱文档
# prompts: %{...},
smsc: %{
smsc_url: "https://10.80.14.219:8443",
source_msisdn: "2222"
}
}

请参阅 语音信箱 指南以获取完整的配置和流程,以及 配置指南 以获取完整的参数参考。

监控与访问架构

访问点

  • 控制面板: https://your-server-ip/(在 config/runtime.exs 中配置)
  • REST API: https://your-server-ip:8444/api/swaggerui
  • Prometheus 指标:
    • http://your-server-ip:8080/metrics (TAS 引擎、Diameter、OCS、HLR)
    • http://your-server-ip:9090/metrics (系统、网关、电话核心)
    • http://your-server-ip:9093/esl?module=default (RTP/RTCP 媒体质量)

拨号计划模板

拨号计划 XML 模板位于 priv/templates/

  • mo_dialplan.xml - 移动发起呼叫
  • mt_dialplan.xml - 移动终止呼叫
  • mo_emergency_dialplan.xml - 紧急呼叫

请参阅 拨号计划配置 以获取详细的拨号计划文档。

文档结构

此 README 提供了高层次的���述。详细文档按主题组织:

按角色

操作员 & 管理员:

  1. 操作指南 开始,了解监控和日常任务
  2. 查看 指标参考 以设置监控和警报
  3. 使用控制面板访问 https://your-server-ip/ 进行操作任务

系统集成商 & 工程师:

  1. 配置指南 开始,了解系统设置
  2. 查看 拨号计划配置 以了解呼叫路由逻辑
  3. 配置接口: Sh 接口在线计费SS7 MAP
  4. 实施服务: 附加服务语音信箱

开发者:

  1. 查看 REST API 文档 (OpenAPI/Swagger)
  2. 查看 指标参考 以了解 Prometheus 集成
  3. 查看 配置指南 以获取 API 配置

按主题

呼叫处理:

用户数据:

系统配置:

增值服务:

系统要求

要求

  • Elixir/OTP 运行时
  • PostgreSQL 或 SQLite 用于 CDR 存储
  • 访问 IMS 核心 (S-CSCF)
  • 网络连接到:
    • DRA/HSS (Diameter: Sh 和可选的 Ro)
    • SIP 网关/SBC
    • 可选: SS7 MAP 网关、SMSc、OpenAI TTS API

支持与文档

  • 问题与功能请求: 联系您的集成工程师
  • 指标与监控: 请参阅 docs/metrics.md
  • API 文档: 访问 Swagger UI 在 https://your-server-ip:8444/api/swaggerui
  • 控制面板: 访问在 https://your-server-ip/