Pular para o conteúdo principal

Guia de Operações

📖 Voltar à Documentação Principal

Este documento cobre recursos de monitoramento e gerenciamento operacional disponíveis no Painel de Controle.

Documentação Relacionada​

Documentação Principal​

Ferramentas de Monitoramento e Teste​

Processamento de Chamadas e Serviços​

Interfaces de Integração​

Operações​

Esta seção cobre recursos de monitoramento e gerenciamento operacional disponíveis no Painel de Controle OmniTAS.

Índice​

Visualização de Assinantes​

A visualização de Assinantes fornece monitoramento em tempo real das inscrições de assinantes IMS armazenadas no banco de dados de registro SIP Sofia.

Acesso: Navegue até /subscribers no Painel de Controle

Recursos​

  • Lista de Inscrições: Veja todas as inscrições de assinantes ativas
  • Detalhes da Inscrição: Clique em qualquer inscrição para ver detalhes completos, incluindo:
    • Usuário SIP e Realm
    • URI de Contato
    • Status e expiração da inscrição
    • Informações da rede (IP, porta, nome do host)
    • Detalhes de autenticação
    • Localização da torre de celular (quando disponível via P-Access-Network-Info)
      • MCC/MNC, Tipo de Rádio, TAC/LAC, ID da Célula
      • Coordenadas geográficas e alcance de cobertura
      • Visualização de mapa interativo alimentada por dados do OpenStreetMap e OpenCellID

Visualização de Assinantes

Detalhes da Inscrição

Fonte de Dados​

Os dados de inscrição são consultados diretamente do banco de dados de registro Sofia, fornecendo visibilidade em tempo real sobre o status de anexação do assinante. As localizações das torres de celular são resolvidas usando o banco de dados OpenCellID quando os assinantes fornecem cabeçalhos P-Access-Network-Info em suas mensagens SIP REGISTER.

Casos de Uso​

  • Monitorar inscrições de assinantes ativas
  • Verificar o status de anexação do assinante
  • Solucionar problemas de inscrição
  • Auditar a conectividade do assinante

Registros de Detalhes de Chamadas (CDR)​

A visualização CDR fornece acesso a registros de detalhes de chamadas armazenados pelo TAS para fins de cobrança, solução de problemas e análises.

Acesso: Navegue até /cdr no Painel de Controle

Visualização CDR

Recursos​

  • Visualização Pagina: Navegue pelos registros de chamadas (100 por página com controles Anterior/Próximo)
  • Busca Avançada: Busca poderosa com suporte para correspondência exata, inversa/excluir e múltiplos termos
  • Seleção de Colunas: Personalize quais campos exibir
    • Clique no botão "Colunas" para abrir o modal de seleção de colunas
    • Selecione/deselecione colunas individuais
    • Ações rápidas Selecionar Tudo / Deselecionar Tudo
    • A seleção persiste entre sessões (salva no localStorage do navegador)
    • Mostra o contador "X / Y colunas"
  • Colunas Ordenáveis: Clique em qualquer cabeçalho de coluna para ordenar (crescente/decrescente)
    • Indicadores visuais (▲ crescente, ▼ decrescente)
    • Coluna ordenada destacada em azul
    • Reseta para a página 1 quando a ordenação muda
  • Múltiplas Opções de Filtro:
    • Busca de Texto: Pesquise em todos os campos com operadores avançados
    • Filtro de Intervalo de Datas: Filtre por data e hora de início/fim (seletor de data e hora)
    • Filtro Específico de Campo: Filtre por valor exato de campo (causa de desligamento, ID do chamador, destino, contexto)
    • Exibição de Filtro Ativo: Chips visuais mostram filtros atualmente ativos
    • Limpar Tudo: Remoção com um clique de todos os filtros ativos
  • Informações Detalhadas: Clique em qualquer linha CDR para expandir e ver todos os campos:
    • Partes da chamada (nome/número do ID do chamador, número de destino)
    • Carimbos de data/hora (início, resposta, fim)
    • Duração e segundos cobrados
    • Causa de desligamento (codificada por cores: verde=normal, amarelo=cancelado, vermelho=erro)
    • UUIDs da chamada (A-leg e B-leg)
    • Contexto e código da conta
    • Todos os campos disponíveis do banco de dados em ordem alfabética
  • Causas de Desligamento Codificadas por Cores:
    • 🟢 Verde: NORMAL_CLEARING
    • 🟡 Amarelo: Chamadas canceladas
    • 🔴 Vermelho: Condições de erro
  • Contagem Total: Exibição em tempo real do total de registros correspondentes
  • Layout Responsivo: Filtros se ajustam adequadamente em telas menores

Como Usar​

  1. Visualização Básica:

    • A página carrega com os últimos 100 registros CDR (ordenados por start_stamp em ordem decrescente)
    • A contagem total de registros é exibida no canto superior direito
    • Use os botões Anterior / Próximo para navegar pelas páginas
    • Clique em qualquer linha para expandir e ver todos os campos

  2. Personalizar Colunas:

    • Clique no botão "Colunas" no canto superior direito
    • O modal mostra todos os campos disponíveis
    • Marque/desmarque campos para mostrar/ocultar colunas
    • Use "Selecionar Tudo" ou "Deselecionar Tudo" para seleção rápida
    • As configurações são salvas automaticamente no navegador
    • Feche o modal para aplicar as alterações

  3. Ordenar Dados:

    • Clique em qualquer cabeçalho de coluna para ordenar por aquele campo
    • Primeiro clique: Decrescente (▼)
    • Segundo clique: Crescente (▲)
    • Terceiro clique: Volta para decrescente
    • Coluna ordenada destacada em azul

  4. Pesquisar Registros:

    • Digite a consulta de pesquisa na caixa "Pesquisar"
    • Suporta operadores avançados (veja a Sintaxe de Pesquisa abaixo)
    • Pesquisa em múltiplos campos: caller_id_number, destination_number, uuid, caller_id_name, hangup_cause
    • Clique em "Aplicar" para executar a pesquisa

  5. Filtrar por Intervalo de Datas:

    • Use os seletores de data e hora "Data de Início" e "Data de Fim"
    • Ambas as datas são necessárias para o filtro de data
    • Suporta seleção de data e hora
    • Clique em "Aplicar" para filtrar

  6. Filtrar por Campo Específico:

    • Selecione o campo no dropdown "Selecionar Campo para Filtrar":
      • Causa de Desligamento
      • ID do Chamador
      • Destino
      • Contexto
    • Digite o valor exato em "Digite o Valor do Filtro"
    • Clique em "Aplicar" para filtrar

  7. Combinar Filtros:

    • Todos os filtros podem ser usados simultaneamente:
      • Busca de texto + intervalo de datas + filtro de campo funcionam juntos
    • Filtros ativos são mostrados como chips abaixo do formulário de filtro
    • Clique em "Limpar Tudo" para remover todos os filtros de uma vez

  8. Ver Detalhes:

    • Clique em qualquer linha CDR para expandir
    • Mostra todos os campos do banco de dados em um layout de grade
    • Campos exibidos em ordem alfabética
    • Causa de desligamento codificada por cores para identificação rápida
    • Clique na linha novamente para colapsar

Sintaxe de Pesquisa Avançada​

A caixa de pesquisa suporta uma sintaxe de consulta poderosa para filtragem precisa de registros em múltiplos campos simultaneamente.

Como a Pesquisa Funciona:

O mecanismo de pesquisa verifica todos os campos pesquisáveis em cada registro CDR. Um registro é incluído nos resultados quando corresponde aos seus critérios de pesquisa em qualquer desses campos:

  • caller_id_number
  • destination_number
  • uuid
  • caller_id_name
  • hangup_cause

Operadores de Pesquisa (podem ser combinados):

  1. Pesquisa Contém (padrão):

    • Sintaxe: termo (sem aspas)
    • Corresponde: Registros onde qualquer campo contém o termo em qualquer lugar dentro dele
    • SQL: Usa LIKE '%termo%' em todos os campos pesquisáveis unidos com OR
    • Exemplo: 61480 corresponde a "61480123456", "55561480999", etc.

  2. Correspondência Exata:

    • Sintaxe: "termo" (com aspas duplas)
    • Corresponde: Registros onde qualquer campo é exatamente igual ao termo
    • SQL: Usa = 'termo' em todos os campos pesquisáveis unidos com OR
    • Exemplo: "911" corresponde apenas exatamente a "911", não "9115" ou "1911"

  3. Inverso/Excluir:

    • Sintaxe: !termo (prefixo de exclamação, sem aspas)
    • Corresponde: Registros onde nenhum campo contém o termo
    • SQL: Usa NOT LIKE '%termo%' em todos os campos pesquisáveis unidos com AND
    • Exemplo: !NORMAL exclui qualquer registro com "NORMAL" em qualquer campo

  4. Inverso/Excluir Exato:

    • Sintaxe: !"termo" (exclamação + aspas duplas)
    • Corresponde: Registros onde nenhum campo é exatamente igual ao termo
    • SQL: Usa != 'termo' em todos os campos pesquisáveis unidos com AND
    • Exemplo: !"NORMAL_CLEARING" exclui registros onde qualquer campo é exatamente "NORMAL_CLEARING"

  5. Múltiplos Termos com AND:

    • Sintaxe: termo1 AND termo2 (AND não sensível a maiúsculas)
    • Corresponde: Registros que correspondem a todos os termos (cada termo pode corresponder a diferentes campos)
    • Cada termo é processado com seu próprio operador (aspas, !, etc.)
    • Os termos são combinados com AND em SQL
    • Exemplo: "911" AND "12345" encontra registros com "911" em um campo E "12345" em outro

Lógica de Execução da Pesquisa:

Para cada registro CDR:
  Para pesquisa normal (sem !):
    - Verifique se QUALQUER campo contém/é igual ao termo → Inclua se VERDADEIRO
    - SQL: field1 LIKE '%termo%' OR field2 LIKE '%termo%' OR ...

  Para pesquisa inversa (!):
    - Verifique se TODOS os campos NÃO contêm/são iguais ao termo → Inclua se VERDADEIRO
    - SQL: field1 NOT LIKE '%termo%' AND field2 NOT LIKE '%termo%' AND ...

  Para pesquisas AND:
    - Cada termo é avaliado separadamente
    - Todas as condições de termos devem ser VERDADEIRAS → Inclua se VERDADEIRO
    - SQL: (condições_termo1) AND (condições_termo2) AND ...

Exemplos de Pesquisa Complexa:

ConsultaComo FuncionaResultado
61480Pesquisa contém em todos os camposTodos os registros com "61480" em qualquer lugar (chamador, destino, UUID, etc.)
"911"Correspondência exata em todos os camposRegistros onde qualquer campo é exatamente "911"
!NORMAL_CLEARINGPesquisa inversa contémExclui registros com "NORMAL_CLEARING" em QUALQUER campo (chamadas falhadas)
!"NORMAL_CLEARING"Inverso exatoExclui registros onde qualquer campo é exatamente igual a "NORMAL_CLEARING"
"911" AND "12345"Exato "911" E exato "12345"Registros com ambos os valores (por exemplo, chamador="12345", destino="911")
!NORMAL AND 61480Inverso contém "NORMAL" E contém "61480"Chamadas não normais envolvendo "61480"
!"ANSWER" AND !NORMALInverso exato "ANSWER" E inverso contém "NORMAL"Excluir chamadas atendidas e qualquer coisa com "NORMAL"
61480 AND !NORMAL_CLEARINGContém "61480" E inverso contém "NORMAL_CLEARING"Chamadas falhadas envolvendo "61480"

Casos de Uso Práticos:

  • Encontrar número específico: 61480123456 - Pesquisa contém encontra correspondências parciais
  • Encontrar chamadas de emergência exatas: "911" - Apenas chamadas para exatamente "911"
  • Todas as chamadas falhadas: !NORMAL_CLEARING - Excluir chamadas bem-sucedidas
  • Chamadas falhadas de um chamador específico: "61480123456" AND !NORMAL - Combinar chamador exato com inverso
  • Excluir números de teste: !test AND !demo - Múltiplas pesquisas inversas
  • Depuração complexa: 61480 AND !"ANSWER" AND !CANCEL - Contém um termo, exclui exatos e parciais

Fonte de Dados​

Os dados CDR são consultados diretamente do banco de dados SQLite CDR do TAS.

O esquema pode variar entre implantações com base em requisitos específicos.

Opções de Exportação de CDR​

Importante: Os registros CDR podem ser exportados em vários formatos para suportar integração com sistemas de cobrança, plataformas de análise e ferramentas de relatórios.

O esquema do banco de dados CDR e os formatos de exportação são específicos da implantação. Ao configurar seu sistema, solicite os formatos de saída CDR específicos que você precisa ao seu engenheiro de integração. Os formatos de exportação comuns incluem:

  • CSV (Valores Separados por Vírgula)
  • JSON (para integração de API)
  • XML
  • Acesso direto ao banco de dados
  • Exportações formatadas personalizadas

Seu engenheiro de integração pode configurar mecanismos de exportação de CDR adaptados às suas necessidades operacionais e de cobrança.

Casos de Uso​

  • Solução de Problemas de Chamadas: Pesquise chamadas específicas por número ou UUID para depurar problemas
  • Reconciliação de Cobrança: Filtre por intervalo de datas para corresponder a períodos de cobrança
  • Análise de Qualidade: Filtre por causa de desligamento para identificar padrões de problemas
  • Auditoria de Chamadas de Emergência: Pesquise por "911" para verificar o manuseio de chamadas de emergência
  • Suporte ao Cliente: Procure chamadas específicas de clientes por ID do chamador ou destino
  • Análise de Padrões: Ordene por duração ou carimbos de data/hora para identificar anomalias
  • Conformidade e Manutenção de Registros: Filtros de intervalo de datas para relatórios regulatórios
  • Análise de Chamadas Falhadas: Use !NORMAL_CLEARING para encontrar todas as chamadas falhadas
  • Relatórios Baseados em Contexto: Filtre por contexto para analisar fluxos de chamadas específicos

Configuração​

Colunas Visíveis Padrão​

Você pode configurar quais campos CDR são exibidos por padrão na Visualização ao definir cdrs_field_list em seu config/runtime.exs:

config :tas,
  cdrs_field_list: [
    "caller_id_number",
    "destination_number",
    "start_stamp",
    "duration",
    "hangup_cause"
  ]

Comportamento:

  • Se cdrs_field_list não estiver definido: Todos os campos CDR disponíveis são exibidos por padrão
  • Se cdrs_field_list estiver definido: Apenas os campos especificados são exibidos por padrão, mas todos os outros campos permanecem disponíveis no seletor de colunas
  • Se um campo na lista não existir nos dados CDR, ele será automaticamente ignorado
  • Os nomes dos campos podem ser especificados como strings ou átomos
  • Os usuários podem selecionar manualmente colunas adicionais do seletor de colunas a qualquer momento

Casos de Uso:

  • Definir uma visualização padrão limpa com apenas campos essenciais visíveis
  • Reduzir a sobrecarga de informações para novos usuários
  • Padronizar o layout inicial de colunas entre todos os usuários
  • Manter campos avançados ocultos por padrão, mas ainda acessíveis

Exemplo de Configuração:

# Mostrar apenas informações essenciais da chamada por padrão
cdrs_field_list: [
  "start_stamp",
  "caller_id_number",
  "destination_number",
  "duration",
  "billsec",
  "hangup_cause"
]

Nota: Esta configuração define as colunas visíveis por padrão. Todos os campos CDR permanecem disponíveis no seletor de "Colunas" - os usuários podem manualmente mostrar/ocultar qualquer campo que precisem.

Solução de Problemas​

Nenhum Resultado Encontrado​
  1. Verifique se há erros de digitação nos termos de pesquisa
  2. Tente remover aspas para uma pesquisa mais ampla
  3. Verifique se o termo existe nos campos pesquisáveis
  4. Verifique se o intervalo de datas não é muito restritivo
Muitos Resultados​
  1. Adicione mais termos AND para restringir
  2. Use correspondência exata com aspas
  3. Aplique filtros de intervalo de datas
  4. Use filtros específicos de campo
Resultados Inesperados​
  1. Lembre-se de que a pesquisa se aplica a TODOS os campos pesquisáveis
  2. Verifique se o termo aparece em um campo inesperado (como UUID)
  3. Use correspondência exata para evitar correspondências parciais
  4. Verifique a lógica inversa (AND vs OR)

Dicas​

  • Seleção de Colunas: Oculte colunas não utilizadas para se concentrar em dados relevantes e melhorar o desempenho
  • Combinar Filtros: Use pesquisa + intervalo de datas + filtro de campo juntos para consultas precisas
  • Desempenho do Intervalo de Datas: Intervalos de datas mais restritos retornam resultados mais rapidamente para grandes bancos de dados
  • Ordenar para Análise: Ordene por duração para encontrar chamadas longas/curtas, ou por carimbo de data/hora para ver padrões de chamadas
  • Chips de Filtro Ativo: Use chips visuais para verificar quais filtros estão atualmente ativos
  • Configurações Persistentes: As seleções de colunas são salvas por navegador, úteis para diferentes tarefas de análise
  • Codificação por Cores: Escaneie rapidamente as causas de desligamento - verde é bom, vermelho precisa de investigação
  • Detalhes Expansíveis: Clique nas linhas para ver todos os campos sem desordenar a visualização principal
  • Operadores de Pesquisa: Domine a sintaxe de pesquisa para filtragem poderosa:
    • Use aspas para correspondências exatas: "911"
    • Use ! para excluir: !NORMAL_CLEARING
    • Combine com AND: "61480" AND !NORMAL
  • Paginação: Lembre-se de que os filtros persistem entre páginas - use a paginação para revisar grandes conjuntos de resultados

Monitoramento de Chamadas Ativas​

A visualização de Chamadas Ativas mostra informações em tempo real sobre chamadas em andamento através do sistema.

Acesso: Navegue até /calls no Painel de Controle

Recursos​

  • Status em Tempo Real: Visualização ao vivo das sessões de chamadas ativas
  • Detalhes da Chamada: Veja variáveis de canal e informações de estado da chamada
  • Rastreamento de UUID: Monitore os identificadores de chamadas tanto A-leg quanto B-leg

Servidor de Conferência IMS​

O Servidor de Conferência IMS fornece capacidades de conferência multiparte em conformidade com os padrões IMS da 3GPP (RFC 4579, RFC 4575, TS 24.147).

Acesso: Navegue até /conference no Painel de Controle

Documentação: Veja o Guia do Usuário do Servidor de Conferência IMS para documentação detalhada

Recursos​

  • Monitoramento em Tempo Real: Visualização ao vivo de conferências ativas e participantes
  • Painel de Estatísticas da Conferência:
    • Contagem de conferências ativas
    • Total de participantes em todas as conferências
    • Contagem de conferências de vídeo
    • Contagem de conferências bloqueadas
    • Detalhes de configuração do servidor (domínio, MNC/MCC, max participantes)
  • Lista de Conferências: Veja todas as conferências ativas com:
    • ID da conferência e URI SIP
    • Contagem atual de participantes
    • Identidade do criador da conferência
  • Detalhes da Conferência: Clique em qualquer conferência para expandir e visualizar:
    • Informações completas da conferência (estado, status de vídeo, status bloqueado, status de gravação)
    • Lista completa de participantes com funções e estados
    • Status de vídeo dos participantes
  • Ações de Controle da Conferência:
    • Bloquear/Desbloquear conferências para controlar o acesso
    • Habilitar/Desabilitar vídeo para conferências
    • Atualizações de status em tempo real com feedback de ação
  • Atualização Automática: Atualização automática configurável (padrão: 5 segundos) para monitoramento em tempo real

Gerenciamento do Console OmniTAS​

Todas as operações de conferência também estão disponíveis através do console OmniTAS usando o comando ims_conference:

ims_conference list                    # Lista todas as conferências ativas
ims_conference info <conf_id>          # Mostra detalhes da conferência
ims_conference stats                   # Mostra estatísticas do servidor
ims_conference lock <conf_id>          # Bloqueia uma conferência
ims_conference unlock <conf_id>        # Desbloqueia uma conferência
ims_conference video <conf_id> on|off  # Controla vídeo
ims_conference record <conf_id> start|stop  # Controla gravação
ims_conference add <conf_id> <sip_uri>     # Adiciona participante
ims_conference remove <conf_id> <uuid>     # Remove participante
ims_conference destroy <conf_id>       # Termina conferência

Casos de Uso​

  • Monitoramento Operacional: Visibilidade em tempo real de conferências ativas e uso de recursos
  • Gerenciamento de Capacidade: Monitore contagens de participantes e uso de v��deo para gerenciar largura de banda
  • Solução de Problemas: Diagnostique problemas de acesso à conferência, problemas de conexão de participantes
  • Controle de Conferência: Bloqueie conferências para privacidade, gerencie vídeo para controlar largura de banda
  • Conformidade: Monitore e grave conferências para conformidade regulatória

Conformidade com 3GPP​

O servidor de conferência implementa especificações-chave de conferência IMS da 3GPP:

  • TS 24.147: Conferência usando subsistema de rede central IM
  • RFC 4579: Controle de Chamada SIP - Conferência para Agentes de Usuário
  • RFC 4575: Pacote de Evento SIP para Estado de Conferência
  • RFC 5239: Estrutura para Conferência Centralizada

Status do Gateway​

Monitore o status e a saúde dos gateways/troncos SIP conectados ao TAS.

Acesso: Navegue até /gw no Painel de Controle

Recursos​

  • Status de Registro: Veja o estado de registro do gateway
  • Estatísticas de Chamadas: Acompanhe chamadas de entrada/saída e falhas
  • Monitoramento de Ping: Tempos de ping SIP OPTIONS e acessibilidade
  • Detalhes do Gateway: Informações completas de configuração e status

Métricas Monitoradas​

  • Status de registro SIP
  • Tempo de ping (tempo médio de resposta SIP OPTIONS)
  • Tempo de atividade (segundos desde a reinicialização do perfil)
  • Chamadas Entrantes / Chamadas Saídas
  • Chamadas Falhadas Entrantes / Chamadas Falhadas Saídas
  • Último tempo de ping e frequência

Status do Par Diameter​

Monitore a conectividade do par Diameter para interfaces Sh e Ro.

Acesso: Navegue até /diameter no Painel de Controle

Recursos​

  • Status do Par: Estado de conexão para cada par configurado
  • Suporte a Aplicativos: Veja aplicativos Diameter suportados (Sh, Ro)
  • Status do Watchdog: Monitoramento do watchdog Diameter

Visualizador de Logs do Sistema​

Visualizador de logs unificado em tempo real para logs do Backend do TAS (Elixir) e logs de Processamento de Chamadas do TAS (FreeSWITCH).

Acesso: Navegue até /logs no Painel de Controle

Visualização de Logs

Recursos​

  • Fluxo de Logs Unificado: Veja logs do Backend do TAS e do Processamento de Chamadas em uma única interface
  • Atualizações em Tempo Real: Transmissão ao vivo de mensagens de log à medida que ocorrem (atualização automática a cada 1 segundo)
  • Níveis de Log Codificados por Cores:
    • 🟣 Console - Mensagens de console (roxo/magenta)
    • 🔴 Alerta/Critico - Problemas urgentes que requerem atenção imediata (vermelho)
    • 🟠 Erro - Condições de erro (vermelho claro)
    • 🟡 Aviso - Mensagens de aviso (amarelo)
    • 🔵 Notícia - Mensagens informativas notáveis (ciano)
    • 🔵 Info - Mensagens informativas gerais (azul)
    • ⚪ Debug - Registro de depuração/verbose (cinza)
  • Emblemas de Fonte:
    • 🔵 Backend do TAS - Logs da aplicação Elixir (emblema azul)
    • 🟣 Processamento de Chamadas do TAS - Logs do FreeSWITCH (emblema roxo)
  • Indicadores de Borda Esquerda: Borda esquerda codificada por cores correspondendo ao nível de log para escaneamento visual rápido
  • Múltiplos Filtros:
    • Filtro de Fonte: Todas as Fontes / Backend do TAS / Processamento de Chamadas do TAS
    • Filtro de Nível: Todos / Console / Alerta / Crítico / Erro / Aviso / Notícia / Info / Debug
    • Busca de Texto: Pesquisa de palavras-chave em tempo real através das mensagens de log
  • Pausar/Retomar: Congelar a transmissão de logs para analisar entradas específicas sem perder o contexto
  • Limpar Logs: Remover todas as entradas de log atuais da exibição
  • Contador de Logs: Mostra logs filtrados vs logs totais (por exemplo, "Mostrando 150 de 500 logs")
  • Comportamento de Tail: Mantém as últimas 500 entradas de log para desempenho
  • Exibição de Metadados: Nome do arquivo e número da linha para referências de código-fonte (quando disponível)
  • Visualização Rolável: Container de altura fixa com rolagem automática para os últimos logs

Como Usar​

  1. Visualização Básica:

    • A página carrega com as últimas 500 entradas de log de ambas as fontes
    • Os logs aparecem em tempo real à medida que são gerados
    • Os logs mais recentes aparecem no topo
    • Atualiza automaticamente a cada 1 segundo

  2. Filtrar por Fonte:

    • Selecione no dropdown "Fonte":
      • Todas as Fontes - Mostre logs do Backend do TAS e do Processamento de Chamadas
      • Backend do TAS - Apenas logs da aplicação Elixir
      • Processamento de Chamadas do TAS - Apenas logs do FreeSWITCH/dialplan
    • O filtro é aplicado imediatamente

  3. Filtrar por Nível de Log:

    • Selecione no dropdown "Nível":
      • Todos - Mostre todos os níveis de log
      • Console até Debug - Mostre apenas aquele nível específico
    • Útil para se concentrar em erros ou depurar problemas específicos

  4. Pesquisar por Palavras-chave:

    • Digite na caixa "Pesquisar logs..."
    • Pesquisa não sensível a maiúsculas em mensagens de log
    • Filtra em tempo real à medida que você digita
    • Combina com filtros de fonte e nível

  5. Pausar/Retomar Transmissão:

    • Clique no botão "Pausar" (laranja) para congelar as atualizações de log
    • O indicador "PAUSADO" aparece no cabeçalho
    • Revise entradas de log específicas sem novos logs interrompendo
    • Clique no botão "Retomar" (verde) para reiniciar a transmissão ao vivo

  6. Limpar Logs:

    • Clique no botão "Limpar" (vermelho) para remover todos os logs exibidos
    • Limpa tanto os logs do Backend do TAS quanto os logs do Processamento de Chamadas
    • Novos logs aparecerão à medida que forem gerados

  7. Ler Entradas de Log:

    • Carimbo de Data/Hora: Mostra a hora no formato HH:MM:SS.milissegundos
    • Emblema de Fonte: Indica Backend do TAS (azul) ou Processamento de Chamadas (roxo)
    • Nível de Log: Nível codificado por cores entre colchetes [ERROR], [INFO], etc.
    • Arquivo/Linha: Localização do código-fonte (quando disponível)
    • Mensagem: O conteúdo real da mensagem de log

Níveis de Log Explicados​

NívelCorQuando UsadoExemplo
ConsoleRoxoMensagens específicas do consoleSaída de console de alta prioridade do FreeSWITCH
AlertaVermelhoAção imediata necessáriaFalha de componente do sistema
CríticoVermelhoCondições críticasConexão com o banco de dados perdida
ErroVermelho ClaroCondições de erroFalha ao processar chamada, configuração inválida
AvisoAmareloCondições de avisoFunção obsoleta usada, tentativa de reexecução
NotíciaCianoEventos normais notáveisConfiguração recarregada, serviço iniciado
InfoAzulMensagens informativasChamada conectada, solicitação Diameter enviada
DebugCinzaMensagens de nível de depuraçãoEntrada/saída de função, valores de variáveis

Casos de Uso​

  • Solução de Problemas em Tempo Real: Monitore logs durante chamadas ativas para depurar problemas
  • Investigação de Erros: Filtre por níveis de Erro/Critico para encontrar problemas
  • Análise de Fluxo de Chamadas: Pesquise por Call-ID ou número de telefone para rastrear o caminho da chamada
  • Monitoramento de Desempenho: Observe avisos e erros durante testes de carga
  • Depuração de Integração: Filtre Backend do TAS para ver mensagens Diameter/Sh/Ro
  • Depuração de Dialplan: Filtre Processamento de Chamadas do TAS para ver roteamento de chamadas do FreeSWITCH
  • Monitoramento de Saúde do Sistema: Mantenha logs abertos para observar anomalias
  • Desenvolvimento e Testes: Use nível Debug para ver comportamento detalhado da aplicação

Dicas​

  • Combinar Filtros: Use Fonte + Nível + Pesquisa juntos para filtragem precisa
    • Exemplo: Fonte="Backend do TAS" + Nível="Erro" + Pesquisa="Diameter" → Encontrar erros Diameter
  • Pausar Antes de Pesquisar: Pause a transmissão antes de digitar a consulta de pesquisa para evitar rolagem de logs
  • Use Debug com Sabedoria: O nível Debug é verboso - filtre para fonte específica para reduzir ruído
  • Escaneamento por Cores: Escaneie rapidamente bordas esquerdas - bordas vermelhas indicam problemas
  • Emblemas de Fonte: Emblemas azuis (Backend) para lógica de aplicação, Emblemas roxos (Processamento de Chamadas) para chamadas
  • Precisão do Carimbo de Data/Hora: Carimbos de milissegundos ajudam a correlacionar eventos entre sistemas
  • Referências de Arquivo: Clique/anote referências de arquivo:linha para pular para o código-fonte
  • Limpar Regularmente: Limpe logs ao mudar contextos de investigação para clareza
  • Pesquisar por UUIDs: Pesquise por Call-ID/UUID para seguir uma chamada específica através de todo o sistema
  • Pesquisa de Emergência: Pesquise "911" ou "emergência" para encontrar rapidamente o manuseio de chamadas de emergência

Detalhes Técnicos​

  • Limite de Log: Máximo de 500 logs exibidos (os mais antigos são descartados quando o limite é atingido)
  • Taxa de Atualização: Atualização automática a cada 1000ms (1 segundo)
  • Pesquisa: Correspondência de substring não sensível a maiúsculas no campo de mensagem apenas
  • Filtragem Vazia: Filtra automaticamente mensagens de log vazias/placeholder
  • Detecção de Fonte: Logs marcados com :elixir ou :freeswitch como fonte
  • Ordenação: Logs ordenados por carimbo de data/hora em ordem decrescente (mais novos primeiro)
  • PubSub: Logs Elixir entregues via Phoenix PubSub para atualizações em tempo real
  • Logs do FreeSWITCH: Coletados via Event Socket Interface (ESI) log listener

Banco de Dados de Torres de Celular​

Gerencie e consulte o banco de dados de localização de torres de celular OpenCellID para serviços de emergência e recursos baseados em localização.

Acesso: Navegue até /cell_towers no Painel de Controle

Banco de Dados de Torres de Celular

Recursos​

  • Estatísticas do Banco de Dados: Veja registros totais, cobertura por país/rede
  • Busca e Consulta:
    • Pesquise por MCC (Código do País Móvel)
    • Pesquise por MNC (Código da Rede Móvel)
    • Pesquise por tipo de rádio (GSM, UMTS, LTE)
    • Pesquise por string de localização
  • Gerenciamento do Banco de Dados:
    • Importar dados de torres de celular
    • Rebaixar o conjunto de dados mais recente do OpenCellID
    • Ver status e progresso da importação
  • Resolução de Localização: Resolva IDs de células para coordenadas geográficas

Casos de Uso​

  • Determinação de localização de chamadas de emergência
  • Rastreamento de localização de assinantes (com consentimento)
  • Análise de cobertura de rede
  • Solução de problemas de localização em roaming
  • Manutenção do banco de dados de torres de celular

Fonte de Dados​

Os dados de torres de celular são provenientes do OpenCellID (https://opencellid.org/), um projeto colaborativo da comunidade para criar um banco de dados gratuito de localizações de torres de celular em todo o mundo.

Simulador de Chamadas​

Ferramenta interativa de simulação de chamadas para testar a lógica do dialplan sem fazer chamadas reais.

Acesso: Navegue até /simulator no Painel de Controle

Documentação Detalhada: Veja o Guia de HLR e Simulador de Chamadas

Recursos​

  • Simular Tipos de Chamadas: Teste chamadas MO, MT e de Emergência
  • Parâmetros Configuráveis:
    • Números de origem e destino
    • Endereço IP de origem (para simular SBC/CSCF)
    • Forçar disposição específica da chamada
    • Ignorar autorização OCS para testes mais rápidos
  • Resultados Abrangentes:
    • Saída completa de variáveis do dialplan
    • Resultados de consulta Sh/HLR
    • Resultado de autorização OCS
    • Resultados de consulta SS7 MAP (se aplicável)
    • XML do dialplan gerado
  • Processamento Passo a Passo: Veja cada estágio do processamento da chamada

Casos de Uso​

  • Testar alterações no dialplan antes da implantação
  • Verificar provisionamento de assinantes
  • Depurar problemas de roteamento de chamadas
  • Treinar funcionários sobre o fluxo de chamadas
  • Validar integração OCS/HLR
  • Testar manuseio de chamadas de emergência

Teste HLR/MAP​

Teste operações SS7 MAP, incluindo Send Routing Info (SRI) e Provide Roaming Number (PRN).

Acesso: Navegue até /hlr no Painel de Controle

Documentação Detalhada: Veja o Guia de HLR e Simulador de Chamadas

Recursos​

  • Consulta SRI: Teste Send Routing Info para roteamento de chamadas
  • Consulta PRN: Teste Provide Roaming Number para assinantes em roaming
  • Resultados Reais: Consultas reais ao gateway MAP configurado
  • Exibição de Resposta: Veja MSRN, endereço MSC e status de encaminhamento
  • Tratamento de Erros: Exibição clara de erros MAP e timeouts

Casos de Uso​

  • Verificar conectividade HLR
  • Testar alocação de número de roaming
  • Depurar roteamento de chamadas para assinantes em roaming
  • Validar configuração do gateway MAP
  • Solucionar problemas de encaminhamento de chamadas

Teste OCS​

Teste operações de Credit-Control-Request (CCR) Diameter Ro (Cobrança Online) diretamente contra seu OCS.

Acesso: Navegue até /ocs_test no Painel de Controle

Visualização de Teste OCS

Recursos​

  • Tipos de CCR Flexíveis: Envie solicitações INITIAL, UPDATE, TERMINATION ou EVENT
  • Simulação de Sessão: Reutilize o mesmo Call ID para simular um ciclo de vida completo da sessão
  • Seleção de Tipo de Evento: Teste tanto cobrança SMS (baseada em evento) quanto chamada (baseada em sessão)
  • Controle de Direção: Teste tanto cenários de saída (MO) quanto de entrada (MT)
  • Parâmetros Opcionais: Especifique Destination-Host e Username para testes avançados
  • Resultados em Tempo Real: Veja respostas completas de CCA (Credit-Control-Answer)

Como Usar​

  1. Digite os Parâmetros de Teste:

    • MSISDN Chamado: O número de destino (por exemplo, 61400123456)
    • MSISDN Chamador: O número de origem (por exemplo, 61400987654)
    • Tipo de Evento: Escolha sms ou call
      • SMS padrão para EVENT_REQUEST (tipo 4)
      • Chamada padrão para INITIAL_REQUEST (tipo 1)
    • Direção: out para MO ou in para MT

  2. Configure o Tipo de CCR:

    • Request-Type: Selecione o tipo de CCR:
      • 1 — INITIAL_REQUEST - Iniciar uma nova sessão
      • 2 — UPDATE_REQUEST - Reautorização no meio da sessão
      • 3 — TERMINATION_REQUEST - Encerrar a sessão e relatar uso
      • 4 — EVENT_REQUEST - Evento único (SMS, evento imediato)
    • Request-Number: Começa em 1, incremente para cada solicitação na mesma sessão

  3. Teste de Sessão:

    • Call ID: Identificador único gerado automaticamente para correlação
    • Clique em "Novo ID" para gerar um Call ID novo para um novo teste
    • Mantenha o mesmo Call ID para simular uma sessão completa:
      • Primeira solicitação: INITIAL_REQUEST (tipo 1, número 1)
      • No meio da sessão: UPDATE_REQUEST (tipo 2, número 2, 3, 4...)
      • Solicitação final: TERMINATION_REQUEST (tipo 3, número N+1)

  4. Opções Avançadas:

    • Destination-Host: Direcione para um nó OCS específico (opcional)
    • Username: Substitua o identificador do assinante (opcional)

  5. Executar e Revisar:

    • Clique em "Executar CCR" para enviar a solicitação
    • Veja a resposta completa de CCA com todos os AVPs
    • Verifique o código de resultado, unidades concedidas e tempo de validade
    • O timestamp da última execução é exibido no canto superior direito

Casos de Uso​

  • Teste de Conectividade OCS: Verifique a conexão e autenticação Diameter Ro
  • Lógica de Controle de Crédito: Teste alocação, consumo e esgotamento de crédito
  • Teste de Fluxo de Sessão: Simule ciclo de vida completo da chamada (INITIAL → UPDATE → TERMINATION)
  • Validação de Tarificação: Verifique taxas de cobrança corretas para diferentes faixas de números
  • Teste de Failover: Teste a redundância do OCS direcionando para um Destination-Host específico
  • Depuração de Integração: Solucione problemas de integração OCS com inspeção detalhada de AVP
  • Preparação para Testes de Carga: Valide o comportamento do OCS antes de testes de carga
  • Desvio de Números de Emergência: Verifique se números de emergência contornam a cobrança corretamente

Dicas​

  • Use o mesmo Call ID com números de solicitação que aumentam para testar a continuidade da sessão
  • Monitore logs do OCS simultaneamente para correlacionar solicitações de teste
  • Teste solicitações UPDATE para verificar a lógica de reautorização no meio da sessão
  • Verifique se as solicitações de TERMINATION encerram corretamente as sessões e evitam vazamentos
  • Teste o esgotamento de crédito enviando solicitações UPDATE após consumir unidades concedidas

Teste da Interface Sh​

Teste operações de User-Data-Request (UDR) Diameter Sh para recuperar dados do perfil do assinante do HSS.

Acesso: Navegue até /sh_test no Painel de Controle

Visualização de Teste Sh

Recursos​

  • Múltiplas Referências de Dados: Consulte mais de 20 diferentes tipos de dados de assinantes
  • Consultas HSS Reais: Solicitações Diameter Sh ao seu HSS configurado
  • Exibição Completa de Resposta: Veja dados completos do assinante em XML e AVPs
  • Rastreamento de Sessão: Mostra hostname do HSS, realm e ID da sessão
  • Tratamento de Erros: Exibição clara de códigos de resultado Diameter e condições de erro

Como Usar​

  1. Digite a Identidade Pública:

    • Identidade Pública: A Identidade Pública IMS do assinante
    • Formato: sip:61400123456@ims.mncXXX.mccXXX.3gppnetwork.org
    • Também pode usar o formato tel:+61400123456

  2. Selecione a Referência de Dados: Escolha o tipo de dados do assinante a ser recuperado:

    • RepositoryData (0): Perfil completo do assinante
    • IMSPublicIdentity (10): Lista de identidades públicas
    • IMSUserState (11): Estado de registro
    • S-CSCFName (12): S-CSCF atribuído
    • InitialFilterCriteria (13): Gatilhos iFC para servidores de aplicação
    • LocationInformation (14): Localização atual
    • ChargingInformation (16): Endereços P-Charging
    • MSISDN (17): Número de telefone
    • IMSI (32): Identidade Internacional do Assinante Móvel
    • IMSPrivateUserIdentity (33): Identidade privada do usuário
    • E muitos mais...

  3. Executar e Revisar:

    • Clique em "Buscar Dados SH" para enviar a solicitação UDR
    • Veja a resposta completa de User-Data-Answer (UDA)
    • Verifique o XML do perfil do assinante, dados de serviço e regras iFC
    • Metadados da sessão mostram qual HSS respondeu

Casos de Uso​

  • Verificação de Assinante: Confirme se o assinante está provisionado no HSS
  • Depuração de iFC: Revise Critérios de Filtro Iniciais e pontos de gatilho
  • Solução de Problemas de Registro: Verifique o estado do usuário e a atribuição do S-CSCF
  • Configuração de Cobrança: Verifique Endereços de Função de Cobrança P
  • Teste de Conectividade HSS: Valide a conexão Diameter Sh
  • Validação de Perfil: Assegure-se de que o perfil de serviço correto está atribuído
  • Teste de Integração: Teste a integração HSS após alterações de provisionamento
  • Análise de Roaming: Verifique informações de localização e rede servidora

Dicas​

  • Use IMSPublicIdentity (10) para ver todos os aliases de um assinante
  • Use RepositoryData (0) para obter o perfil completo do assinante em uma única consulta
  • Verifique IMSUserState (11) para verificar se um assinante está registrado
  • InitialFilterCriteria (13) mostra quais servidores de aplicação serão acionados
  • O ID da sessão pode ser usado para correlacionar consultas nos logs do HSS
  • Respostas de erro incluem códigos de resultado Diameter (por exemplo, 5001 = Usuário Desconhecido)

Teste de Tradução de Números​

Teste regras e formatação de tradução de números sem fazer chamadas reais.

Acesso: Navegue até /translate no Painel de Controle

Visualização de Tradução de Números

Recursos​

  • Tradução em Tempo Real: Auto-traduz automaticamente enquanto você digita
  • Suporte a Códigos de País: Teste diferentes contextos de códigos de país
  • Ciente da Disposição: Aplique diferentes regras com base na disposição da chamada
  • Resultados Ao Vivo: Feedback imediato com o número traduzido
  • Informações de Depuração: Veja valores de retorno brutos para solução de problemas

Como Usar​

  1. Configure os Parâmetros:

    • Código do País: O contexto de discagem (por exemplo, AU, US, NZ)
      • Padrão para o código do país configurado em config/runtime.exs
      • Aceita formatos: AU, :AU, au
    • Número de Telefone: O número a ser traduzido
      • Exemplos: +61400111222, 0400111222, 61400111222
    • Disposição: (Opcional) Contexto da chamada para regras condicionais
      • Exemplos: originate, route, emergency

  2. Teste a Tradução:

    • Digite valores no formulário
    • A tradução é executada automaticamente enquanto você digita
    • Ou clique em "Traduzir" para acionar manualmente
    • Veja o resultado traduzido imediatamente

  3. Revise os Resultados:

    • Traduzido: Mostra o número de saída formatado
    • Erro: Exibe erros de validação ou falhas de tradução
    • Retorno bruto (depuração): Mostra a tupla Elixir completa para depuração

Casos de Uso​

  • Desenvolvimento de Dialplan: Teste regras de formatação de números antes da implantação
  • Validação de Formato: Verifique se a conversão E.164 está funcionando corretamente
  • Teste de Código de País: Assegure-se de que o tratamento de prefixos internacionais está correto
  • Detecção de Números de Emergência: Verifique se os números de emergência são identificados corretamente
  • Tratamento de Códigos Curtos: Teste códigos de serviço especiais (correio de voz, etc.)
  • Preparação de Troncos: Formate números corretamente para requisitos de tronco SIP
  • Lógica de Disposição: Teste diferentes regras para cenários MO vs MT
  • Solução de Problemas de Tradução: Solucione problemas sobre por que números específicos falham no roteamento

Dicas​

  • Teste tanto o formato local (0400111222) quanto o formato internacional (+61400111222)
  • Verifique se os números de emergência (000, 112) são detectados corretamente
  • Use o campo de disposição para testar diferentes cenários de chamada (MO, MT, emergência)
  • Verifique se códigos curtos e números internos são tratados adequadamente
  • A saída de depuração mostra o valor de retorno bruto - útil para investigar problemas
  • Teste casos extremos como zeros à frente, prefixos internacionais e caracteres especiais

Gerenciamento de Correio de Voz​

Gerencie e ouça mensagens de correio de voz armazenadas no sistema.

Acesso: Navegue até /voicemail no Painel de Controle

Visualização de Correio de Voz

Recursos​

  • Lista Completa de Correio de Voz: Veja todas as mensagens de correio de voz em todas as caixas de correio
  • Reprodução no Navegador: Ouça gravações de correio de voz diretamente na interface da web
  • Detalhes da Mensagem: Veja nome de usuário, UUID, carimbos de data/hora, caminhos de arquivo e metadados
  • Funcionalidade de Exclusão: Remova mensagens de correio de voz individuais
  • Atualização Automática: Botão de atualização para recarregar os dados mais recentes do correio de voz
  • Colunas Dinâmicas: Exibe automaticamente todos os campos disponíveis do banco de dados

Como Usar​

  1. Visualizar Lista de Correio de Voz:

    • A página carrega automaticamente com todos os registros de correio de voz
    • A tabela mostra todos os campos do banco de dados de correio de voz
    • Carimbos de data/hora são formatados automaticamente a partir de valores epoch
    • Caminhos de arquivo são encurtados para legibilidade

  2. Ouvir Mensagens:

    • Clique no botão "▶ Reproduzir" ao lado de qualquer correio de voz
    • O player de áudio aparece com controles (reproduzir, pausar, buscar, volume)
    • Suporta formatos WAV, MP3 e OGG
    • Clique em "Parar" para fechar o player de áudio

  3. Excluir Mensagens:

    • Clique no botão "Excluir" para remover um correio de voz
    • Prompt de confirmação evita exclusão acidental
    • A página atualiza automaticamente após a exclusão bem-sucedida

  4. Atualizar Dados:

    • Clique no botão "Atualizar" no canto superior direito para recarregar a lista de correio de voz
    • Útil após novas mensagens de correio de voz serem deixadas

Detalhes da Mensagem Exibidos​

A tabela mostra dinamicamente todos os campos disponíveis, tipicamente incluindo:

  • Nome de Usuário: Proprietário da caixa de correio
  • UUID: Identificador único da mensagem
  • Epoch Criado: Quando a mensagem foi deixada (formatada automaticamente para data/hora legível)
  • Epoch Lido: Quando a mensagem foi acessada (se aplicável)
  • Caminho do Arquivo: Localização do arquivo de áudio
  • Metadados adicionais do banco de dados de correio de voz

Casos de Uso​

  • Suporte ao Assinante: Ouça mensagens de correio de voz para solução de problemas
  • Teste de Entrega de Correio de Voz: Verifique se as mensagens de correio de voz estão sendo armazenadas corretamente
  • Gerenciamento de Mensagens: Limpe mensagens antigas ou de teste
  • Solução de Problemas de Gravação: Verifique caminhos de arquivo e verifique se os arquivos de áudio existem
  • Manutenção da Caixa de Correio: Monitore armazenamento e uso de correio de voz
  • Garantia de Qualidade: Revise mensagens gravadas para qualidade de áudio

Dicas​

  • Caminhos de arquivo são automaticamente encurtados para mostrar apenas a parte relevante
  • Carimbos de tempo epoch são automaticamente convertidos para formato legível
  • Banco de dados de correio de voz vazio mostra "Nenhum registro de correio de voz encontrado"
  • A reprodução de áudio usa o elemento de áudio HTML5 - suportado em todos os navegadores modernos
  • A confirmação de exclusão evita a remoção acidental de mensagens importantes

Gerenciamento de Prompts TTS​

Gerencie prompts de áudio gerados por Texto-para-Fala (TTS) usados em todo o sistema.

Acesso: Navegue até /prompts no Painel de Controle

Visualização de Prompts

Recursos​

  • Exibição de Configurações de Prompt: Veja a voz TTS atual, formato de resposta e instruções
  • Status de Gravação: Veja quais prompts existem e quais estão faltando
  • Detalhes do Arquivo: Veja tamanho do arquivo, hora de modificação e caminho para cada prompt
  • Reprodução no Navegador: Ouça prompts diretamente na interface da web
  • Gerar Faltantes: Crie automaticamente todos os arquivos de prompt que estão faltando
  • Regravar Individual: Regenerar um prompt específico com configurações atualizadas
  • Regravar Todos: Regenerar todos os prompts (útil após alterar voz ou configurações)

Como Usar​

  1. Revisar Configurações de Prompt:

    • Voz: Voz TTS sendo usada (por exemplo, alloy, nova, shimmer)
    • Formato de Resposta: Formato de áudio (por exemplo, wav, mp3, opus)
    • Instruções: Instruções especiais passadas para o mecanismo TTS

  2. Verificar Status de Gravação:

    • Texto: O texto do prompt a ser falado
    • Caminho Relativo: Onde o arquivo de áudio está armazenado
    • Existe: Verde "Sim" se o arquivo existir, Amarelo "Não" se estiver faltando
    • Tamanho: Tamanho do arquivo em bytes/KiB/MiB
    • Modificado: Timestamp da última modificação

  3. Gerar Prompts:

    • Gerar Faltantes: Cria apenas prompts que ainda não existem
      • Útil para configuração inicial ou após adicionar novos prompts
    • Regravar Todos: Regenera todos os prompts, independentemente da existência
      • Útil após alterar voz, formato ou instruções
      • Use com cautela, pois regenera tudo

  4. Gerenciar Prompts Individuais:

    • ▶ Reproduzir: Ouça o prompt (somente habilitado se o arquivo existir)
    • 🔄 Regravar: Regenerar apenas este prompt
      • Útil se um prompt soar incorreto
      • Usa a voz e configurações atuais

  5. Ouvir Prompts:

    • Clique em "▶ Reproduzir" para ouvir o prompt
    • O player de áudio aparece na parte inferior com controles completos
    • Clique em "Parar" para fechar o player

Configuração de Prompt​

Os prompts são configurados na configuração da sua aplicação:

config :tas, :prompts,
  voice: "nova",
  response_format: "wav",
  instructions: "Fale claramente e profissionalmente.",
  recordings: [
    %{path: "/sounds/en/us/callie/voicemail/vm-enter_id.wav",
      text: "Por favor, digite seu ID de caixa de correio seguido de cerquilha"},
    # ... mais prompts
  ]

Casos de Uso​

  • Configuração Inicial: Gere todos os prompts após a instalação do sistema
  • Mudanças de Voz: Regrave todos os prompts com uma voz TTS diferente
  • Melhoria de Qualidade: Corrija prompts individuais que não soam corretos
  • Atualizações de Formato: Regenerar prompts em formato de áudio diferente (wav → mp3)
  • Atualizações de Texto: Regrave após alterar o texto do prompt na configuração
  • Teste de TTS: Pré-visualize como os prompts soarão antes da implantação
  • Solução de Problemas de Reprodução: Verifique se os arquivos de prompt existem e são acessíveis
  • Gerenciamento de Armazenamento: Verifique tamanhos de arquivos e gerencie uso de disco

Dicas​

  • Use "Gerar Faltantes" para configuração inicial - não sobrescreverá prompts existentes
  • Use "Regravar Todos" após alterar voz ou formato na configuração
  • A "Regravação" individual é útil para iterar sobre prompts específicos
  • Ouça os prompts antes da implantação para garantir qualidade
  • Formatos de resposta maiores (wav) têm melhor qualidade, mas usam mais espaço em disco
  • O campo de instruções pode guiar o mecanismo TTS para tom e ritmo
  • A regravação pode levar tempo se você tiver muitos prompts - seja paciente
  • Os prompts são armazenados no diretório de sons do FreeSWITCH para fácil acesso

Modelos XML de Dialplan​

Visualize e inspecione modelos XML de dialplan do FreeSWITCH usados para roteamento de chamadas.

Acesso: Navegue até /routing no Painel de Controle

Modelos de Dialplan

Recursos​

  • Lista de Modelos: Veja todos os arquivos XML de dialplan do diretório priv/templates/
  • Detalhes do Arquivo: Veja nome do arquivo e timestamp da última modificação para cada modelo
  • Realce de Sintaxe: Exibição colorida de XML para fácil leitura
    • Tags em teal
    • Atributos em azul claro
    • Valores em laranja/tan
    • Comentários em verde
  • Visualização Expansível: Clique em qualquer modelo para visualizar seu conteúdo XML completo
  • Visualização Somente Leitura: Inspeção segura sem risco de modificação acidental
  • Conteúdo Rolável: Modelos grandes rolam dentro de um container de altura fixa (máx. 600px)

Como Usar​

  1. Visualizar Lista de Modelos:

    • A página carrega com todos os arquivos .xml do diretório de modelos
    • Ordenados alfabeticamente pelo nome do arquivo
    • Mostra timestamp de modificação para cada arquivo

  2. Inspecionar Modelo:

    • Clique em qualquer linha para expandir e visualizar o conteúdo XML
    • O modelo é exibido com realce de sintaxe
    • Clique novamente para colapsar

  3. Ler Conteúdo XML:

    • Tags (teal): Nomes de elementos XML como <extension>, <condition>
    • Atributos (azul claro): Nomes de atributos como name=, field=
    • Valores (laranja): Valores de atributos como "public", "destination_number"
    • Comentários (verde): Comentários XML <!-- ... -->

Casos de Uso​

  • Revisar Lógica de Dialplan: Inspecione regras de roteamento e modelos de fluxo de chamadas
  • Solução de Problemas de Roteamento de Chamadas: Entenda quais modelos são usados para diferentes tipos de chamadas
  • Verificar Sintaxe de Modelo: Verifique a estrutura XML antes da implantação
  • Treinamento e Documentação: Compartilhe conteúdos de modelos com membros da equipe
  • Auditoria de Mudanças: Compare timestamps de modificação para rastrear atualizações
  • Desenvolvimento de Modelos: Referencie modelos existentes ao criar novos

Dicas​

  • Os modelos são carregados de priv/templates/ dentro da aplicação TAS
  • Apenas arquivos .xml são exibidos
  • Os modelos são somente leitura através da interface da web
  • Timestamps de modificação ajudam a identificar mudanças recentes
  • Use esta visualização para verificar se os modelos correspondem às suas expectativas de dialplan
  • O realce de sintaxe torna XML complexo mais fácil de interpretar visualmente
  • Combine com a visualização /logs para correlacionar comportamento de roteamento com modelos

Detalhes Técnicos​

  • Localização: Modelos armazenados no diretório priv/templates/
  • Formato: Formato de dialplan XML do FreeSWITCH
  • Extensão de Arquivo: Apenas arquivos .xml listados
  • Ordenação: Alfabética pelo nome do arquivo
  • Realce de Sintaxe: Colorização do lado do cliente usando padrões regex
  • Altura Máxima de Exibição: 600px com rolagem para arquivos grandes

Executor de Comandos ESL​

Execute comandos do FreeSWITCH Event Socket Layer (ESL) diretamente da interface da web.

Acesso: Navegue até /command no Painel de Controle

Executor de Comandos ESL

Recursos​

  • Execução de Comandos: Execute qualquer comando ESL/API do FreeSWITCH
  • Saída Ao Vivo: Veja os resultados dos comandos em tempo real
  • Histórico de Comandos: Dropdown de comandos recentes (últimos 10 comandos)
  • Pronto para Auto-Completar: Entrada em monoespaço para entrada precisa de comandos
  • Tratamento de Erros: Exibição clara de erros e exceções de comandos
  • Sem Auto-Execução: Selecionar histórico preenche a entrada, mas requer clique explícito em "Executar"

Como Usar​

  1. Digite o Comando:

    • Digite o comando ESL na caixa de entrada
    • Exemplos:
      • status - Mostrar status do FreeSWITCH
      • show channels - Listar chamadas ativas
      • uuid_dump <uuid> - Despejar todas as variáveis para uma chamada
      • sofia status - Mostrar status do perfil SIP
      • reloadxml - Recarregar dialplan XML
      • version - Mostrar versão do FreeSWITCH

  2. Executar Comando:

    • Clique no botão "Executar" para executar
    • O botão mostra "Executando…" enquanto executa
    • Não é possível executar múltiplos comandos simultaneamente

  3. Ver Saída:

    • Os resultados aparecem na seção "Saída" abaixo
    • Comandos bem-sucedidos mostram resposta bruta
    • Erros prefixados com "ERRO:"
    • A saída é rolável com altura máxima de 600px
    • Fonte monoespaçada para dados alinhados

  4. Usar Histórico de Comandos:

    • Comandos recentes aparecem no dropdown após a primeira execução
    • Selecione do dropdown "Recent:" para preencher o campo de entrada
    • O histórico mantém os últimos 10 comandos únicos
    • O comando mais recente no topo
    • Selecionar histórico NÃO executa automaticamente (característica de segurança)

Comandos Comuns​

ComandoDescriçãoExemplo de Saída
statusStatus do sistema e tempo de atividadeInformações de execução do FreeSWITCH
show channelsLista todas as chamadas ativasLista de canais ou "0 total"
show callsResumo das chamadas ativasResumo da contagem de chamadas
uuid_dump <uuid>Todas as variáveis para uma chamadaDespejo completo de variáveis
uuid_kill <uuid>Desligar chamada específica"+OK" ou erro
sofia statusStatus do perfil SIPLista de perfis e estados
sofia status profile <name>Detalhes de perfil específicoContagem de registros, etc.
reloadxmlRecarregar dialplan XMLConfirmação "+OK"
versionInformações da versão do FreeSWITCHString da versão
global_getvar <var>Obter variável globalValor da variável
api helpListar comandos disponíveisReferência de comando

Casos de Uso​

  • Depuração de Chamadas: Obtenha informações detalhadas sobre chamadas ativas com uuid_dump
  • Status do Sistema: Verifique a saúde do FreeSWITCH com status e show calls
  • Solução de Problemas SIP: Inspecione perfis SIP com sofia status
  • Recarregar Dialplan: Aplique alterações de configuração com reloadxml
  • Ações de Emergência: Desligue chamadas travadas com uuid_kill
  • Inspeção de Variáveis: Verifique variáveis globais ou de canal

Solução de Problemas​

Assinantes Não Aparecendo​

  • Verifique se o OmniTAS está em execução
  • Verifique se o perfil Sofia está ativo: sofia status profile internal
  • Verifique se o caminho do banco de dados na configuração corresponde à localização real do banco de dados

Registros CDR Não Aparecendo​

  • Confirme se o módulo CDR do OmniTAS está carregado
  • Verifique se o banco de dados CDR existe no caminho configurado
  • Verifique a configuração do módulo CDR no OmniTAS

Considerações de Desempenho​

  • Grandes bancos de dados CDR (>1M registros) podem exigir indexação adicional para desempenho ideal
  • Considere arquivar registros CDR antigos periodicamente
  • Consultas de registro de assinantes são tipicamente rápidas, pois o banco de dados de registro é pequeno

Configuração​

Controle de Acesso​

O Painel de Controle deve ser implantado atrás de controles de acesso apropriados (firewall, VPN, autenticação), pois fornece visibilidade sobre a atividade dos assinantes e registros de chamadas.