VoxyWatch VoxyWatch
Comece
Wiki oficial VoxyWatch

Guia de Integração e Referência Técnica

O VoxyWatch é uma plataforma de observabilidade e diagnóstico inteligente para redes de voz, operando 100% auto-hospedado e sem dependências de nuvem.

Ingestão padrão: HEPv1/v2/v3 em UDP/TCP 9060, SIPREC ou Port Mirroring. Portal web: porta 443 HTTPS.

Notas de versão, binários e guias no GitHub: github.com/VoxyWatch/publish

Instalação rápida

Um único comando instala tudo. Detecta automaticamente sua distribuição Linux (Debian, Ubuntu, Amazon Linux 2023, RHEL/Rocky):

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

Após a instalação, acesse https://SEU-IP. Credenciais padrão: admin / voxywatch. O plano gratuito suporta até 100 chamadas simultâneas.

Ativação de licença

Obtenha seu Hardware ID com node /opt/voxywatch/get-hwid.js ou em Configurações → Licença. Ative de duas formas:

1. Pelo portal web: Envie o arquivo .key em Configurações → Licença.

2. Pelo terminal: Copie o arquivo .key para /etc/voxywatch/license.key com permissão 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

Compatibilidade com SBCs e Métodos de Ingestão

Compatível com todos os SBCs e gateways do mercado (Cisco, AudioCodes, Ribbon, Kamailio, Asterisk, etc.).

3 Métodos Universais de Ingestão

Selecione o método ideal para a topologia da sua rede:

  • 1. HEP (v1 / v2 / v3): Protocolo de encapsulamento para SIP e RTCP via UDP/TCP na porta 9060.
  • 2. SIPREC (SRS Nativo): Gravação de sessões (RFC 7865/7866) com reconstrução estéreo direta.
  • 3. Port Mirroring / Traffic Mirroring (SPAN, ERSPAN, Cloud Mirroring): Cópia passiva de pacotes de switches ou nuvem (Cisco SPAN/RSPAN/ERSPAN, Juniper/MikroTik/Arista Port Mirroring, AWS VPC Traffic Mirroring [VXLAN], GCP Packet Mirroring, VMware vSwitch) via voxywatch-probe, sem alterar o SBC.
Rede e Firewall: Os requisitos de portas variam pelo método: Port Mirror usa interface dedicada sem portas de escuta, enquanto HEP e SIPREC usam portas UDP/TCP específicas. Veja o Guia de Validação de Plataforma e Captura no GitHub ↗

voxywatch-probe — agente leve de captura

Agente leve (Go + libpcap) para capturar SIP/RTP/RTCP em portas espelhadas e encaminhar HEPv3 ao VoxyWatch.

Instalação no servidor ou ponto de captura (passivo e somente leitura):

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

Executa como serviço systemd. Verifique com systemctl status voxywatch-probe.

Guias por modelo e matriz de SBCs: github.com/VoxyWatch/voxywatch-probe/docs/sbc.

Agente SNMP e traps

Agente SNMP v2c/v3 e traps para integração com PRTG, Zabbix, Nagios e NMS corporativos.

Métricas expostas: Mais de 30 OIDs com saúde do servidor e KPIs de VoIP (ASR, NER, MOS, jitter, perda).

Traps: Disparo por transição de estado para perda de captura ou queda de qualidade.

Baixe a MIB e configure credenciais em Configurações → SNMP. Portas: UDP 161 (agente) / UDP 162 (traps).

Incidentes e Diagnóstico para NOC

Anomalias detectadas abrem incidentes com histórico auditável e fechamento automático por estabilização.

Investigação automatizada de telemetria

O VoxyWatch correlaciona chamadas com falha, códigos SIP e rotas IP para identificar a causa raiz.

Confiança estatística

Severidade crítica requer desvio sustentado de baseline (−92% de falso ruído em produção).

Alertas no Telegram e Email SMTP

Notificações críticas chegam com diagnóstico e botões de ação (Reconhecer · Investigar).

Configuração em 2 minutos

  1. Crie o bot do Telegram em Configurações → Notificações.
  2. Cada operador vincula seu chat com código único.
  3. Defina o nível de severidade por canal.

Ações auditadas pelo usuário do portal e controladas por função.

Canal de Email SMTP

Motor SMTP integrado para envio direto de alertas para listas de plantão.

Roadmap: Integrações com Microsoft Teams e Slack em desenvolvimento.

Servidor MCP (Model Context Protocol)

Conecte assistentes de IA (Claude Desktop, Cursor) à telemetria do NOC sem acesso a terminal ou banco.

Segurança e Isolamento

  • 12 Ferramentas de somente leitura: Consulte tráfego, MOS, incidentes, CDRs e indícios de fraude.
  • Sem acesso a Shell ou SQL: API isolada em sandbox sem capacidade de alterar configurações.
  • Autenticação segura: Chaves de API dedicadas com auditoria local e limites de taxa.

Guia de configuração: Documentação do Servidor MCP no GitHub ↗

Flash Call & Detecção de Fraude

Monitoramento passivo de chamadas curtas de autenticação e desvios de tráfego internacional.

Detector de Flash Call

Identifica chamadas de autenticação flash (A2P OTPs) via Port Mirror, HEP ou SIPREC em modo Shadow ou Alerta.

Inteligência Antifraude

Alerta sobre destinos de alto risco e mudanças bruscas de volume internacional.

100% Passivo: Nunca bloqueia ou altera chamadas no SBC.

Especificação técnica: FLASH_CALL_DETECTION.md no GitHub ↗

Supressão de áudio PCI-DSS

O áudio RTP durante o pagamento é descartado na fonte pelo voxywatch-probe.

Funcionamento

Regras recarregadas dinamicamente sem reinício de serviços.

Fluxo em Contact Centers

Pausa acionada pelo CRM interrompe imediatamente o áudio sensível.

Especificação técnica: Especificação PCI-DSS no GitHub ↗ para esquemas JSON.

Transcrição de Áudio de Chamadas

Geração de transcrições indexadas e pesquisáveis a partir do áudio capturado.

Principais recursos

  • Geração sob demanda diretamente nos detalhes da chamada.
  • Separação estéreo com sincronização por timestamp.
  • Player interativo com segmentos de texto clicáveis.
  • Exportação em TXT, JSON e legendas SRT.
  • Busca textual de termos nas chamadas transcritas.

Privacidade e Segurança

Processamento local seguro com permissões 0600 e respeito à supressão PCI-DSS.

Especificação técnica: SPEECH_TO_TEXT_BETA.md no GitHub ↗

Calculadora de dimensionamento

Calcule a infraestrutura necessária com base no volume de chamadas e período de retenção.

Calculadora de tamanho de servidor

Derivado de medições reais em produção (1104 amostras). Estime o hardware com base na sua carga.

Opções avançadas (ACD, codec,% gravado)

Especificações recomendadas

medido
vCPU8
memória RAM16 GB
Disco—
IOPS—
Rede—
Chamadas simultâneas—
— Gravação — SIP/CDR SSD · Tipo de disco
Instância AWS—
Equivalente ao GCP—

Modelo de utilização alvo 0,65 (cabeçalho 35%). Tamanho pelo pico, não pela média. Contate-nos para >300 CPS.

Copiloto IA para NOC

Diagnóstico inteligente em linguagem natural para identificar causas de falhas. Estritamente de somente leitura.

Traga sua própria chave (BYOK) — Configurações → IA:

Compatível com OpenAI, Anthropic Claude, Google Gemini e modelos locais via Ollama.

Os modelos de IA são atualizados continuamente na plataforma.

Consultas cacheadas localmente e total soberania dos dados.

API de integração /api/v1

API REST de somente leitura para sistemas de bilhetagem e monitoramento.

Endpoints disponíveis: Busca de CDRs, traços SIP JSON e download de capturas PCAP e áudio.

Autenticação e segurança: Chaves API com escopos específicos e erros no padrão RFC 9457.

Gerencie chaves em Configurações → Chaves API. Exemplo:

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

Faturação, Pagamentos e Cancelamento

Pagamentos, assinaturas e recibos são processados com segurança pelo Stripe.

A VoxyWatch é a licenciante do software; o Stripe é nosso processador de pagamentos.

Gerencie sua assinatura ou baixe faturas no portal Stripe:

Abrir Portal Stripe

Acesse com seu e-mail de compra e o código de verificação.

Cancelamento de assinatura

Cancele a qualquer momento mantendo o acesso até o fim do período.

Termos de reembolso

Reembolso integral em até 14 dias se o software não puder operar na sua rede.