VoxyWatch VoxyWatch
始めましょう
VoxyWatch 公式ドキュメント

VoxyWatch 統合ガイド & 技術リファレンス

VoxyWatch は、音声ネットワークの監視と根本原因の自動診断を提供するセルフホスト型プラットフォームです。クラウドに依存せず社内インフラで完結します。

標準取り込み: HEPv1/v2/v3 (UDP/TCP 9060)、SIPREC、またはポートミラーリング。Web ポータル: HTTPS 443 ポート。

リリースノート、署名済みバイナリ、ガイド（GitHub）: github.com/VoxyWatch/publish

クイックインストール

単一のコマンドで全コンポーネントをインストールします（Debian、Ubuntu、Amazon Linux 2023、RHEL/Rocky 対応）:

curl -fsSL https://raw.githubusercontent.com/VoxyWatch/publish/main/install.sh | sudo bash

インストール後、ブラウザで https://YOUR-IP を開きます。初期認証情報: admin / voxywatch。無料プランで最大 100 同時通話まで利用可能です。

ライセンスのアクティベーション

node /opt/voxywatch/get-hwid.js または「設定 → ライセンス」でハードウェア ID を取得します。アクティベーションは 2 通りの方法があります:

1. Web ポータルから:「設定 → ライセンス」で .key ファイルをアップロード。

2. ターミナルから: .key ファイルを /etc/voxywatch/license.key に配置（権限 640）。

# Terminal activation: Copy your license file into place
cp voxywatch.key /etc/voxywatch/license.key
chown root:voxywatch /etc/voxywatch/license.key
chmod 640 /etc/voxywatch/license.key

SBC 互換性と取り込み方式

主要なすべての SBC、PBX、ゲートウェイ（Cisco、AudioCodes、Ribbon、Kamailio、Asterisk など）と完全に互換性があります。

3 つのユニバーサル取り込み方式

ネットワーク構成に応じて最適な取り込み方式を選択できます:

  • 1. HEP (v1 / v2 / v3): SIP シグナリングおよび RTCP テレメトリを UDP/TCP 9060 ポートでカプセル化受信。
  • 2. SIPREC (ネイティブ SRS): セッション録音プロトコル（RFC 7865/7866）によるステレオ音声再構築。
  • 3. Port Mirroring / Traffic Mirroring (SPAN, ERSPAN, クラウドミラーリング): スイッチやクラウドからの受動パケットコピー（Cisco SPAN/RSPAN/ERSPAN、Juniper/MikroTik/Arista Port Mirroring、AWS VPC Traffic Mirroring [VXLAN]、GCP Packet Mirroring、VMware vSwitch）を voxywatch-probe で受信。SBC の設定変更は不要です。
ネットワークとファイアウォール: ポート要件は取り込み方式によって異なります。Port Mirror はリスニングポート不要の専用 NIC を使用し、HEP や SIPREC は特定の UDP/TCP ポートを使用します。詳細は GitHub のプラットフォーム検証ガイド ↗

voxywatch-probe — 軽量キャプチャエージェント

ミラーポートからパケットを受動取得し、HEPv3 として VoxyWatch に転送する軽量エージェント（Go + libpcap）です。

サーバーまたはキャプチャノードへのインストール（受動・読み取り専用）:

curl -fsSL https://raw.githubusercontent.com/VoxyWatch/voxywatch-probe/master/install.sh | sudo bash -s -- --server YOUR_VOXYWATCH:9060

systemd サービスとしてバックグラウンド実行されます。systemctl status voxywatch-probe で状態を確認できます。

機種別ガイドと SBC 互換性マトリクス: github.com/VoxyWatch/voxywatch-probe/docs/sbc.

SNMP エージェント & トラップ

PRTG、Zabbix、Nagios などの NMS と連携可能な組み込み SNMP v2c/v3 エージェントとトラップです。

公開メトリクス: CPU、メモリ、ディスク状態、VoIP KPI（ASR、NER、MOS、ジッター、パケットロス）を含む 30 以上の OID。

トラップ: キャプチャ停止や品質劣化などの状態変化時にトラップを発行します。

MIB のダウンロードと設定は「設定 → SNMP」から。デフォルトポート: UDP 161 (エージェント) / UDP 162 (トラップ)。

インシデントと NOC 診断

検出された異常はタイムライン付きインシデントとして記録され、安定稼働時に自動クローズされます。

テレメトリに基づく自動調査

失敗した通話サンプル、主要な SIP エラーコード、影響を受けた IP 経路を分析して根本原因を特定します。

統計的信頼性

ベースラインからの有意な逸脱を確認した上でアラートを発行（本番環境で誤報を 92% 削減）。

Telegram & SMTP メール通知

重要インシデントの診断結果と対応ボタン（確認 · 調査）が即座にスマートフォンや NOC に届きます。

2 分間の簡単セットアップ

  1. 「設定 → 通知」のウィザードに従って Telegram Bot を作成。
  2. オペレーターがワンタイムコードでチャットを連携。
  3. ユーザーまたはグループごとに通知しきい値を設定。

すべての操作はポータルユーザーに紐づいて監査ログに記録されます。

SMTP メール通知

組み込みの SMTP エンジンにより、監視グループやオンコール宛てに直接アラートを送信。

ロードマップ: Microsoft Teams および Slack への直接連携機能を開発中です。

MCP サーバー (Model Context Protocol)

Claude Desktop や Cursor などの AI ツールを、シェルや DB 権限を一切与えずに音声監視データと直接連携。

セキュリティとサンドボックス

  • 12 個の読み取り専用ツール: 通話量、MOS 値、インシデント、CDR、不正兆候などをリアルタイム照会。
  • Shell/SQL アクセス完全排除: 厳格なサンドボックス内で動作し、ルーティングや設定の変更は不可能です。
  • 安全な認証: 専用 MCP API キーとローカル監査ログにより保護されます。

設定ガイド: GitHub の MCP サーバーガイド ↗

フラッシュコール & 不正検知

通話を妨げることなく、ワン切り認証通話や国際トラフィックの異常をパッシブに検出。

フラッシュコール検出

Port Mirror、HEP、SIPREC 経由で受信したシグナリングから、ワン切り認証通話（A2P OTP）を Shadow または Alert モードで受動検出します。

不正トラフィック検知

高リスク宛先への急増や短時間通話バーストなど、中継ごとの異常兆候を早期警告します。

完全受動観測: VoxyWatch が通話を遮断または変更することは決してありません。

技術仕様: GitHub の FLASH_CALL_DETECTION.md ↗

PCI-DSS 音声抑制

クレジットカード決済時の音声をキャプチャ元（voxywatch-probe）で即座に破棄し、カード情報を社内ネットワークやストレージから完全に排除します。

仕組み

サービス停止なしで抑制ルールを動的に適用します。

コンタクトセンターでの運用

CRM の録音一時停止操作に連動して、対象ストリームの転送を瞬時に停止します。

完全な技術仕様: GitHub の PCI-DSS 仕様書 ↗ （JSON スキーマ掲載）。

通話音声の文字起こし

キャプチャされた音声から検索可能なテキストを即座に生成します。

主な機能

  • 通話詳細画面からオンデマンドで文字起こしを生成。
  • ステレオ 2 チャンネル分離（発信側と着信側を個別に文字起こしし同期）。
  • クリックしたテキスト位置から音声を再生できる同期プレーヤー。
  • TXT、JSON、SRT 字幕形式でのダウンロードに対応。
  • 蓄積された文字起こしテキストのキーワード全文検索。

プライバシーとセキュリティ

サーバー内ローカル処理（0600 権限）および PCI-DSS 音声抑制ルールへの完全準拠。

技術仕様: GitHub の SPEECH_TO_TEXT_BETA.md ↗

サーバーサイジング計算ツール

通話数と保存期間から、必要なハードウェアリソースを計算できます。

サーバー サイズの計算ツール

生産時の実際の測定値 (1104 サンプル) に基づいています。負荷に基づいてハードウェアを見積もります。

詳細オプション (ACD、コーデック、記録率)

推奨スペック

測定された
vCPU8
RAM16 GB
ディスク—
IOPS—
ネットワーク—
同時通話—
— 録音 — SIP/CDR SSD · ディスクの種類
AWSインスタンス—
GCP 相当—

ターゲット使用率モデル 0.65 (35% ヘッダー)。サイズは平均値ではなく、ピーク値です。 >300 CPS についてはお問い合わせください。

NOC AI コパイロット

トランクの KPI やベースライン異常を分析し、原因と推奨対応を自然言語で提示します。完全な読み取り専用です。

API キーの持ち込み (BYOK) —「設定 → AI」で設定:

OpenAI、Anthropic Claude、Google Gemini、および Ollama 経由のローカルモデルに対応。

AI モデルは最新の推論能力を活用するためプラットフォーム上で継続的に更新されます。

リクエストはローカルキャッシュされ、社内データの機密性が完全に保持されます。

統合 API /api/v1

外部の課金・監視システムと連携可能な読み取り専用 REST API です。

利用可能なエンドポイント: CDR 検索、SIP トレース (JSON)、PCAP エクスポート、音声ストリーム取得。

認証とセキュリティ: 権限分離された API キー、IP ホワイトリスト、RFC 9457 エラー形式に準拠。

「設定 → API キー」から管理可能。リクエスト例:

curl -H "Authorization: Bearer YOUR_KEY" \
     https://YOUR-VOXYWATCH/api/v1/cdr?from=2026-06-01&to=2026-06-07&carrier=acme

請求・支払い・キャンセル

ライセンスの支払い、サブスクリプション管理、領収書発行は Stripe が安全に処理します。

VoxyWatch はソフトウェアの販売元であり、Stripe が決済代行を行います。

サブスクリプションの変更や請求書のダウンロードは Stripe ポータルをご利用ください:

Stripe ポータルを開く

購入時のメールアドレスに届くワンタイムコードでログインします。

サブスクリプションのキャンセル

ポータルからいつでもキャンセル可能で、支払い済み期間の末日まで有効です。

返金ポリシー

環境に導入できない場合、購入後 14 日以内であれば全額返金いたします。