Pular para o conteúdo principal

Uso do Serviço e Rastreamento de Saldo

O sistema de Uso do Serviço fornece monitoramento em tempo real do consumo dos clientes para dados, voz, SMS e saldos monetários. Este recurso integra-se ao OCS (Sistema de Cobrança Online) para exibir o uso atual, as permissões restantes e as informações de expiração do saldo tanto para os clientes (via Portal de Autoatendimento) quanto para a equipe.

Visão Geral​

O rastreamento de uso permite:

  • Exibição de Saldo em Tempo Real - Visualizar o uso atual e as permissões restantes
  • Múltiplos Tipos de Saldo - Rastrear dados, voz, SMS e saldos monetários simultaneamente
  • Monitoramento de Expiração - Ver quando os saldos expiram
  • Detalhamento de Saldo - Visão detalhada dos diferentes buckets de saldo
  • Atualização Automática - Atualizações de uso a cada 3 segundos automaticamente

Acessando o Uso do Serviço​

Da Lista de Serviços:

  1. Navegue até Serviços → Lista de Serviços
  2. Clique no menu de ações (⋮) ao lado de um serviço
  3. Selecione "Uso"

Dos Detalhes do Serviço:

  1. Abra a página de detalhes de um serviço
  2. Clique na aba "Uso"

Da Página do Cliente:

  1. Abra a visão geral do cliente
  2. Navegue até a aba Serviços
  3. Clique em "Ver Uso" ao lado de qualquer serviço

O modal ou página de uso se abre mostrando dados de consumo em tempo real.

Exibição de Uso​

A interface de uso mostra cartões de resumo e barras de progresso detalhadas para cada tipo de saldo.

Exibição de Uso do Serviço

Modal de Saldo do Serviço{.align-center width="800px"}

Cartões de Resumo​

A linha superior exibe cartões de visualização rápida para cada tipo de saldo:

Informações do Cartão:

  • Tipo de Saldo - Ícone e rótulo (Dados, Voz, SMS, Monetário)
  • Quantidade Restante - Saldo atual nas unidades apropriadas
  • Tempo de Expiração - Dias/horas até o saldo expirar
  • Botão Mais Informações - Clique para expandir o detalhamento

Barras de Progresso​

Abaixo dos cartões, as barras de progresso mostram o consumo visualmente, com porções preenchidas indicando o saldo restante.

Características da Barra de Progresso:

  • Indicador Visual - Porção preenchida mostra o saldo restante
  • Porcentagem - Porcentagem numérica do saldo restante
  • Valores Absolutos - Mostra usado vs. total (por exemplo, "12.5GB / 20GB")
  • Codificação de Cores:
    • Verde: >50% restante
    • Amarelo: 20-50% restante
    • Vermelho: <20% restante
  • Clicável - Clique para expandir o detalhamento

Tipos de Saldo​

Saldo de Dados​

Rastreia o consumo de dados da internet.

Unidades: Gigabytes (GB) ou Megabytes (MB)

Formato de Exibição:

Progresso: 12.5GB / 20GB (62%)

Cenários Comuns:

  • Planos de dados móveis - 5GB, 10GB, 20GB de permissões mensais
  • Wireless fixo - Ilimitado ou limitado a altos valores (500GB, 1TB)
  • Recargas - Dados adicionais comprados no meio do ciclo
  • Serviços de dongle - Dados pré-pagos para dispositivos hotspot

Múltiplos Buckets:

Os serviços frequentemente têm múltiplos saldos de dados:

  • Permissão mensal (expira mensalmente)
  • Dados bônus (expira após o período da campanha)
  • Dados de recarga (expiração mais curta, consumidos primeiro)

Saldo de Voz​

Rastreia minutos de chamadas telefônicas.

Unidades: Minutos (min)

Formato de Exibição:

Progresso: 125 min / 500 min (25%)

Rastreamento de Duração de Chamadas:

  • Chamadas recebidas (se cobradas)
  • Chamadas feitas
  • Chamadas internacionais (bucket separado, se aplicável)
  • Números premium

Cálculo:

O uso de voz é calculado pela duração da chamada em nanosegundos internamente, convertido em minutos para exibição.

Saldo de SMS​

Rastreia o uso de mensagens de texto.

Unidades: Mensagens (msgs)

Formato de Exibição:

Progresso: 45 / 250 (18%)

Tipos de Mensagens:

  • SMS padrão (160 caracteres)
  • SMS longo (múltiplos segmentos)
  • MMS (se rastreado separadamente)

Saldo Monetário​

Rastreia crédito pré-pago ou saldo da conta.

Unidades: Moeda (£, $, €, etc.)

Formato de Exibição:

Progresso: £15.50 / £20.00 (77%)

Uso:

  • Contas pré-pagas usam o saldo monetário para pagar pelo uso
  • O crédito diminui à medida que o cliente utiliza os serviços
  • Pode ser recarregado via pagamento ou voucher
  • Pode expirar se não for usado dentro do período de validade

Detalhamento de Saldo​

Clique em "Mais Informações" em qualquer cartão ou clique em uma barra de progresso para expandir o detalhamento.

Visão Expandida:

📦 Permissão Mensal 20GB

: Restante: 12.5 GB Usado: 7.5 GB Expira: 25 Jan 2025 (15 dias) Peso: 10

📦 Dados Bônus 5GB

: Restante: 5.0 GB Usado: 0 GB Expira: 31 Jan 2025 (21 dias) Peso: 20

📦 Dados de Recarga 3GB

: Restante: 0 GB Usado: 3.0 GB Expira: 18 Jan 2025 (EXPIRADO) Peso: 30

Total Restante: 17.5 GB

Campos do Bucket de Saldo:

  • ID/Nome - Identificador para o bucket de saldo
  • Restante - Quantidade restante neste bucket específico
  • Usado - Quantidade consumida deste bucket
  • Data de Expiração - Quando este saldo expira
  • Peso - Ordem de prioridade (peso mais alto consumido primeiro)

Sistema de Peso​

Os saldos têm um valor de peso que determina a ordem de consumo:

  • Peso mais alto = consumido primeiro
  • Peso mais baixo = consumido por último

Exemplo de Pesos:

  • Dados de recarga: Peso 30 (consumido primeiro, expiração mais curta)
  • Dados bônus: Peso 20 (consumido em segundo)
  • Permissão mensal: Peso 10 (consumido por último, expiração mais longa)

Isso garante que os saldos que estão prestes a expirar sejam usados antes dos que duram mais.

Atualizações em Tempo Real​

Os dados de uso são atualizados automaticamente a cada 3 segundos via polling.

O que Atualiza:

  • Quantidades de saldo atuais
  • Barras de progresso de uso
  • Temporizadores de expiração
  • Detalhes de buckets individuais

Experiência do Usuário:

  • Nenhum recarregamento de página necessário
  • Atualizações suaves sem piscadas
  • Sobreposição de carregamento durante a atualização
  • Insígnia de status mostra o estado atual do serviço

Casos de Uso:

  • Monitorar o uso do cliente durante a chamada
  • Assistir a diminuição do saldo em tempo real à medida que o cliente utiliza o serviço
  • Verificar a recarga imediatamente após a compra

Uso em Diferentes Tipos de Serviço​

Serviços Móveis​

Exibe todos os quatro tipos de saldo:

  • Dados (GB)
  • Voz (minutos)
  • SMS (mensagens)
  • Monetário (moeda)

Exemplo:

DADOS: 12.5GB restantes VOZ: 125 min restantes SMS: 45 msgs restantes MONETÁRIO: £15.50 restantes

Wireless Fixo / Internet​

Normalmente mostra apenas:

  • Dados (GB ou TB)
  • Monetário (se pré-pago)

Exemplo:

DADOS: 450GB / 500GB restantes MONETÁRIO: £45.00 (crédito pré-pago)

Serviços de Hotspot / Dongle​

Mostra rastreamento de dados específico do dongle:

  • Dados (consumidos vs. pré-pagos)
  • Monetário (saldo pré-pago)

Modo de Exibição:

Quando dongle=true, o componente oculta voz e SMS, mostrando apenas dados relevantes e saldos monetários.

Solução de Problemas​

Uso mostrando como 0 / 0

  • Causa: Serviço não integrado com OCS ou CGRateS
  • Solução:
    • Verifique se o serviço está provisionado no OCS
    • Verifique a conectividade da API do OCS
    • Revise o mapeamento do UUID do serviço

Uso não atualizando

  • Causa: Polling parado ou OCS inacessível
  • Solução:
    • Atualize a página
    • Verifique o console do navegador para erros
    • Verifique se a API do OCS está online

Saldos mostram valores incorretos

  • Causa: Desvio de dados do OCS ou problema de cache
  • Solução:
    • Forçar atualização do saldo do OCS
    • Verifique se há transações pendentes
    • Verifique a configuração do OCS

Datas de expiração ausentes

  • Causa: Saldo não tem expiração definida
  • Solução:
    • Alguns saldos são definidos para nunca expirar (validade ilimitada)
    • Verifique a configuração do saldo no OCS

Múltiplos saldos confusos

  • Causa: Múltiplas recargas ou dados bônus adicionados
  • Solução:
    • Use a visão de detalhamento para ver todos os buckets
    • Classifique por peso para ver a ordem de consumo
    • Revise as datas de expiração individuais

Integração com OCS/CGRateS​

Os dados de uso vêm do OCS (Sistema de Cobrança Online), tipicamente CGRateS.

Fluxo de Dados:

  1. O usuário abre a visualização de uso
  2. OmniCRM chama GET /crm/service/{service_id}
  3. A API consulta o OCS via UUID do serviço
  4. O OCS retorna o mapa de saldo:
{
  "BalanceMap": {
    "*data": [
      {
        "ID": "monthly_data_20GB",
        "Value": 13421772800,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*voice": [
      {
        "ID": "monthly_voice_500min",
        "Value": 7500000000000,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*sms": [
      {
        "ID": "monthly_sms_250",
        "Value": 250,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*monetary": [
      {
        "ID": "prepaid_credit",
        "Value": 1550,
        "ExpiryTime": "2025-02-25T23:59:59Z",
        "Weight": 10
      }
    ]
  }
}
  1. A UI converte os valores para unidades de exibição (bytes → GB, nanosegundos → minutos)
  2. Barras de progresso e cartões renderizados
  3. O polling continua a cada 3 segundos

Mapeamento de Tipos de Saldo do OCS:

O OCS retorna dados de saldo com prefixos de tipo que mapeiam para a exibição da UI:

  • *data → CARTÃO DE DADOS (uso da internet)
  • *voice → CARTÃO DE VOZ (minutos de chamadas)
  • *sms → CARTÃO DE SMS (mensagens de texto)
  • *monetary → CARTÃO MONETÁRIO (crédito pré-pago)

Cada tipo de saldo pode ter múltiplos buckets (por exemplo, permissão mensal + dados bônus + dados de recarga), todos exibidos na visão de detalhamento.

Conversões de Valores de Saldo:

  • Dados: Bytes → GB (dividir por 1024³)
  • Voz: Nanosegundos → Minutos (dividir por 60×10⁹)
  • SMS: Contagem (sem conversão)
  • Monetário: Centavos → Moeda (dividir por 100)

Auto-Renovação e ActionPlans​

Serviços com auto-renovação habilitada têm ActionPlans agendados no OCS.

O que são ActionPlans?

ActionPlans são tarefas agendadas no CGRateS que são executadas automaticamente em horários específicos para:

  • Adicionar saldo a uma conta (recarga automática)
  • Renovar permissões mensais
  • Aplicar cobranças recorrentes
  • Expirar saldos antigos

Como Funciona a Auto-Renovação:

  1. Provisionamento do Serviço:

    • Quando o serviço é criado com auto_renew = true
    • O playbook de provisionamento cria um ActionPlan no OCS
    • ActionPlan configurado para ser executado mensalmente (ou por ciclo de cobrança)

  2. Configuração do ActionPlan:

    O ActionPlan contém:

    • ID da Conta - UUID do serviço
    • Ações - O que fazer (adicionar dados, voz, SMS, saldo monetário)
    • Agendamento - Quando executar (por exemplo, mensalmente no dia 1 às 00:00 UTC)
    • Quantidade - Quanto saldo adicionar

  3. Execução Automática:

    • O OCS executa o ActionPlan no horário agendado
    • Adiciona saldo à conta (por exemplo, 20GB de dados, 500 minutos de voz)
    • Define a data de expiração para o novo saldo (por exemplo, 30 dias)
    • O cliente é cobrado via método de pagamento registrado

  4. Visualizando ActionPlans:

    • Navegue até os detalhes do serviço na visualização do OCS
    • ActionPlans listados com o próximo horário de execução
    • Mostra: Nome do plano, data da próxima execução, detalhes da ação

Exemplo de ActionPlan:

{
  "ActionPlanId": "ProductID_MonthlyPlan__ProductName_20GB_Mobile__ActionPlan_Monthly_Renew",
  "NextExecTime": "2025-02-01T00:00:00+00:00",
  "ActionName_hr": "Renovação Mensal",
  "PlanName": "20GB Móvel",
  "ActionFrequency_hr": "Todo Plano Mensal",
  "custom_NextExecTime_hr": "em 22 dias"
}

Gerenciando Auto-Renovação:

  • Habilitar - Definido durante a criação ou modificação do serviço
  • Desabilitar - Remover ActionPlan do OCS (o serviço mantém o saldo existente, mas não será auto-renovado)
  • Modificar - Alterar a quantidade ou frequência de renovação via modificação do serviço

Renovação Manual:

Se a auto-renovação estiver desabilitada, o cliente deve manualmente:

  • Recarregar antes que o saldo expire
  • Ou o serviço é suspenso quando o saldo se esgota

Visualizando na UI:

A aba de serviços mostra o status da auto-renovação:

Próxima Renovação: 1 Fev 2025 (em 22 dias) Quantidade de Renovação: £15.00

Melhores Práticas​

Para a Equipe de Suporte:

  • Verifique o uso antes de responder chamadas "Por que meu serviço está lento?"
  • Verifique o saldo após recargas para confirmar o sucesso
  • Use o detalhamento para identificar buckets expirados
  • Monitore clientes de alto uso para evitar excessos

Para Clientes (Autoatendimento):

  • Verifique o uso regularmente para evitar ficar sem saldo
  • Recarregue antes que o saldo expire
  • Entenda o sistema de peso para saber qual saldo é consumido primeiro
  • Entre em contato com o suporte se o uso parecer incorreto

Para Administradores:

  • Configure as expirações de saldo apropriadas
  • Defina valores de peso para priorizar saldos que estão prestes a expirar
  • Monitore a conectividade do OCS para relatórios precisos
  • Revise as configurações de saldo para garantir que correspondam às ofertas de produtos

Documentação Relacionada​

  • features_topup_recharge - Sistema de recarga para adicionar saldo
  • csa_service_management - Gerenciando serviços
  • csa_modify - Adicionando complementos para aumentar as permissões
  • concepts_products_and_services - Configuração de produtos