MANUAL DO USUÁRIO. v Copyright Bichara Tecnologia. Manual elaborado por: Bichara Tecnologia

Transcrição

1 v. 2.3 MANUAL DO USUÁRIO Copyright Bichara Tecnologia Manual elaborado por: Bichara Tecnologia pág. 1

2 Índice 1. Introdução O que é VoIPzilla? Interface Gráfica Navegação e Operação do Sistema Menu Superior Área de dados Edição de Dados Lingüetas de Sub-Itens Fluxograma de Processos Prefixos, Provedores e Rotas Prefixos (menu Cadastros / Roteamento / Prefixos / Cadastro) Categorias (menu Cadastros / Roteamento / Prefixos / Categorias) Grupos (menu Cadastros / Roteamento / Prefixos / Grupos) CNL (menu Cadastros / Roteamento / Prefixos / CNL) Provedores (menu Cadastros / Roteamento / Provedores) Gateways (lingüeta de Provedores) Vinculando Prefixos aos GWs (menu Cadastros / Roteamento / Vincular GW) Rotas (menu Cadastros / Roteamento / Rotas) Gateways membros da Rota (lingüeta de Rotas) Planos (de tarifas) (menu Cadastros / Planos) Planos - Diretiva Global Planos - Itens (lingüeta de Planos) Planos - IP Origem (lingüeta de Planos) Revendedores (menu Cadastros / Revendedores) Clientes (menu Cadastros / Clientes) Clientes - Auth (lingüeta de Clientes) Clientes - ANI (lingüeta de Clientes) Clientes - Chamadas (lingüeta de Clientes) Clientes - Contatos (lingüeta de Clientes) Clientes - Descontos (lingüeta de Clientes)...29 pág. 2

3 2.4.6 Clientes - Lançamentos (lingüeta de Clientes)...30 pág. 3

4 1. Introdução 1.1 O que é VoIPzilla? VoIPzilla é a plataforma de próxima geração da Bichara Tecnologia, oferecendo à Operadora VoIP a mobilidade do protocolo SIP para operação de produtos pré-pago, pós-pago e cartão de chamada telefônica (PPCC). A partir de um clique, é possível visualizar a qualidade e custo das terminações (Provedores), desempenho financeiro e outros índices para gestão eficaz. A plataforma VoIPzilla é composta de 8 (oito) módulos: SIP-Server; Financeiro; PPCC (PrePaid Calling Cards / Cartões de Chamadas); Gerenciamento; Roteamento; Relatórios & Exportação; Manutenção & Importação; Particionamento para Distribuidores. 1.2 Interface Gráfica O Sistema foi desenvolvido para interface gráfica Web (Internet), estando disponível para acesso a partir de qualquer Navegador (Browser) que atenda os seguintes requisitos: Suporte JavaScript versão 1.1 ou superior Suporte para DIVs e Frames O sistema foi testado nos seguintes navegadores: Internet Explorer versão 6.0* Mozilla (Netescape Navigator) versão 1.2 Firefox versão 2.0 * IE v.6.0 e superior apresenta problema para download de arquivos em protocolo HTTPS e, portanto, não é possível rodar relatórios exceto no formato browser HTML. pág. 4

5 1.3 Navegação e Operação do Sistema A navegação é iniciada no Menu Superior e as informações são apresentadas na Área de Dados. Login Menu Superior Área de Dados Menu Superior O Menu é apresentado em 5 tópicos: Cadastros, Relatórios, Faturamento, Manutenção e Sistema. Para acessar um tópico do Menu, posicione o mouse sobre o item desejado e assim, sucessivamente, para os sub-menus. pág. 5

6 1.3.2 Área de dados Na Área de Dados são apresentadas as informações conforme seleção dos itens do Menu e sub-itens Edição de Dados As informações são apresentadas em duas etapas na Área de Dados: Seleção ou Busca e Edição. Na etapa de Seleção ou Busca, os itens do banco de dados são listados na Área de Dados, conforme abaixo: Tópico Ferramentas Navegação Cabeçalho Listagem Itens Listagem pág. 6

7 A listagem das informações pode ser ordenada por qualquer uma das colunas para facilitar a localização do item, por exemplo: para ordernar a listagem acima por Nome (localidade), posicione o mouse sobre o Cabeçalho da coluna (palavra Nome) e pressione o botão esquerdo do mouse. Se o procedimento for repetido, a coluna será colocada em ordem ascendente. Para selecionar o item desejado para edição, posicione o mouse sobre a linha (item) desejado e pressione o botão esquerdo. Para cadastrar um novo item, clique no botão Inserir, localizado no topo da listagem. Para localizar um item na lista, digite uma parte do nome ou título no campo Busca e pressione o botão -> Lingüetas de Sub-Itens Os dados são organizadas em níveis hierárquicos. Cada nível está vinculado ao seu superior através das Lingüetas. Lingüetas Sub-Itens Nota: Os campos marcados com * são obrigatórios. No caso do item acima, para cada Plano (de tarifas), temos vários Itens e exceções por IP de Origem possíveis, criando uma relação do tipo um para muitos (1 Plano -> muitos Itens / 1 Plano -> muitos IP Origem). Novamente, referenciando o exemplo acima, quando for clicada a lingüeta Itens do Plano VoIP - Gold, serão listados todos os Itens do Plano de tarifas. pág. 7

8 2. Fluxograma de Processos As informações foram distribuídas de forma a garantir a flexibilidade da Plataforma em consonância com a LGT (Lei Geral de Telecomunicações) e sistemas da Anatel, conforme quadro abaixo: O primeiro módulo do VoIPzilla, o SIP-Server mantem as informações dos usuários registrados e, com o apoio do módulo de Roteamento, realiza o encaminhamento de chamadas baseado nas informações do Cliente / PPCC, autenticados (Authentication e Authorization) de acordo com as entradas ANI e AUTH, identificando as Rotas e terminações (Gateways) para o Prefixo solicitado. O módulo Financeiro tarifa as chamadas bilhetadas pelo SIP-Server de acordo com o Plano (de tarifas) associado ao Cliente / PPCC. O módulo de Gerenciamento fornece as informações para gestão instantânea das chamadas e usuários conectados à plataforma (registrados). O módulo para Relatórios & Exportação apresenta as ferramentas complementares de gestão para extração de informações e integração com outros sistemas legados (off-line), enquanto o módulo de Manutenção & Importação oferece funcionalidades para a entrada e atualização de dados em massa. Neste manual, didaticamente, apresentaremos as informações na ordem necessária para operação do VoIPzilla, ou seja: Prefixos, Provedores, Rotas, Planos (de tarifas), Revendedores e Clientes. pág. 8

9 2.1 Prefixos, Provedores e Rotas O destino das chamadas SIP (VoIP) são classificadas por Prefixos (best-match) e encaminhados para os Provedores (terminações) de acordo com as Rotas do sistema. A Rota será definida de acordo com o cadastro do Cliente, ANI ou AUTH. Poderão ser atribuídos tantos Gateways quantos forem necessários a uma Rota e a decisão do roteamento levará em consideração a prioridade do Gateway para seleção do Provedor. Ao final da chamada, esta será tarifada (atribuído preço de venda e custo) de acordo com o Plano (de tarifas) do Cliente/PPCC e o Custo definido para o Provedor. Chama-se ponta A ou caller o originador da chamada. Chama-se ponta B ou callee o destinatário da chamada. Na figura acima, posicionamos o Gateway do Provedor que faz o papel de conversor de meios (VoIP / PSTN) ou sinalização (SIP / H.323) ou simplesmente encaminhamento para a próxima rede SIP. pág. 9

10 2.1.1 Prefixos (menu Cadastros / Roteamento / Prefixos / Cadastro) O Prefixo define a localidade de destino da chamada comparando o padrão numérico do destinatário com a expressão regular (Regex) definida. Para efeito de tarifação, cada Prefixo pertence a uma Categoria; as Categorias estão reunidas em Grupos. Os Prefixos também podem estar classificados por CNL (Código Nacional de Localidade definido pela Anatel); os CNLs estão reunidos por Código de Tarifa. Por exemplo: a regex 5511[2-6] identifica a localidade São Paulo ; este prefixo pertence a Categoria Telefones Fixos Local SP que, por sua vez, pertence ao Grupo Telefones Fixos Brasil ; este Prefixo também pertence ao CNL que faz parte do Código de Tarifa 11. Nota: A utilização de Categorias, Grupos, CNL e Código de Tarifa para atribuição de tarifas será detalhada em Planos. pág. 10

11 a) Nome: nome da localidade. b) Regex: expressão regular para comparação do prefixo. As expressões regulares são seqüências de algarismos e intervalos numéricos definidos entre [...]. Por exemplo: para agrupar todos os prefixos de uma mesma localidade identificados como 55112, 55113, e 55116, você pode utilizar a expressão regular 5511[2 4,6]. c) Categoria: categoria do prefixo. d) CNL: Código Nacional de Localidade (numérico). Nota: Para converter uma grande quantidade de prefixos numéricos em expressões regulares, você pode utilizar a ferramenta de conversão disponível no menu Manutenção / Importar / Conv Regex Categorias (menu Cadastros / Roteamento / Prefixos / Categorias) a) Grupo: grupo a que pertence a categoria. b) Categoria: nome da categoria. pág. 11

12 Grupos (menu Cadastros / Roteamento / Prefixos / Grupos) a) Grupo: nome do grupo CNL (menu Cadastros / Roteamento / Prefixos / CNL) a) Cod.CNL: Código Nacional de Localidade (numérico). b) Sigla CNL: sigla de identificação do CNL. c) Cod.Tarifa: Código de Tarifa do CNL (numérico). Vários CNLs podem ter o mesmo Código de Tarifa. d) UF: UF do CNL. e) Localidade: nome da localidade do CNL. f) Cidade: cidade do CNL. g) Latitude / Hemisfério / Longitude: coordenadas geográficas da localidade. Nota: Os CNLs podem ser importados a partir de arquivos tipo CSV no menu Manutenção / Importar / CNL. Os Prefixos podem ser vinculados a CNLs em massa através da ferramenta no menu Manutenção / Importar / Vínculo CNL. pág. 12

13 2.1.2 Provedores (menu Cadastros / Roteamento / Provedores) O Provedor agrupa uma ou mais Gateways para terminação de chamadas. a) Partição: para plataformas com recurso de Particionamento. b) Tipo, CPF / CNPJ, Nome, Endereço, etc.: dados cadastrais. pág. 13

14 Gateways (lingüeta de Provedores) Define uma ou mais Gateways para terminação de chamadas do Provedor. a) Nome: nome da gateway para visualização (extenso). b) ID: Identificação da gateway para visualização (abreviado). c) Proto: protocolo de encaminhamento UDP ou TCP. O VoIPzilla pode atuar como proxy para conversão UDP / TCP. d) IP: endereço IP de destino. e) Prioridade: prioridade para roteamento de chamadas. O módulo de Roteamento utilizará este número para classificar as gateways de terminação de uma chamada (maior número, indica maior prioridade). f) Qualidade: ASR (Avarage Success Rate) previsto para esta gateway. g) Map Destino: mapeamento para transformação numérica do endereço de destino da chamada no padrão GNU-GK (formato: [prefixo]=[substituição];...). Por exemplo, para transformar um telefone do formato internacional E.164 para DDD Brasil, deve-se substituir o código do país 55 por 0 com a seguinte expressão: 55=0;. Para acrescentar o tech prefix 1234# ao endereço de destino:.=1234#;. Para efetuar a substituição do formato internacional e acrescentar o tech prefix, você pode seqüenciar as transformações: 55=0;.=1234#;. h) Descrição: breve descrição e comentários. pág. 14

15 2.1.3 Vinculando Prefixos aos GWs (menu Cadastros / Roteamento / Vincular GW) Os Prefixos devem ser vinculados aos Gateways dos Provedores para encaminhamento das chamadas. Este vínculo pode ser estabelecido facilmente movendo os Prefixos entre as janelas, sendo que a caixa da esquerda contem os Prefixos disponíveis e a da direita, os Prefixos já vinculados ao Gateway. Utilize as setas para movimentar os Prefixos entre as caixas. Nota: Para roteamento e tarifação são utilizados os Prefixos vinculados aos Gateways. Portanto, mesmo que exista um prefixo mais específico, o módulo de Roteamento considerará apenas os Prefixos vinculados para seleção do destino e este Prefixo será utilizado para definição do preço de venda (tarifação). Nota: Verifique cuidadosamente os Prefixos vinculados aos Gateways para evitar falhas de tarifação de ligações móveis (celular) como fixas ou vice-versa. pág. 15

16 2.1.4 Rotas (menu Cadastros / Roteamento / Rotas) A Rota define os Gateways (conseqüentemente Provedores e Prefixos) para encaminhamento de chamadas. Como será exposto adiante, podem ser definidas rotas para uma determinada autenticação (ANI ou AUTH), Cliente (ou PPCC) e Padrão. O módulo de Roteamento utilizará a rota definida na hierarquia exposta e, portanto, a rota definida para a autenticação sobrepõe a rota definida no Cliente que, por sua vez, sobrepõe a rota Padrão. a) Partição: para plataformas com recurso de Particionamento. b) Nome: nome da rota. c) Padrão: Sim ou Não. A definição de uma rota com Padrão = Sim, automaticamente, cancela o status da rota padrão anteriormente definida para a Partição. Nota: Sempre deve existir um rota padrão definida Gateways membros da Rota (lingüeta de Rotas) Os Gateways participantes de uma Rota devem ser inseridos nesta: Nota: O roteamento considera apenas os Prefixos vinculados aos Gateways da Rota. pág. 16

17 2.2 Planos (de tarifas) (menu Cadastros / Planos) O Plano de tarifas define o formato e o valor para tarifação das chamadas de um Cliente ou PPCC. O Plano é composto por duas diretivas: Global e Itens. A diretiva de Itens detalha a tarifação a nível de Prefixos ou Categorias ou Grupos ou Código de Tarifa. A diretiva Global será aplicada sempre que não for encontrado um Item mais específico. A tarifa é aplicada considerando-se: tempo mínimo e tempo excedente. O tempo mínimo de tarifação é especificado em Tempo Inicial e sempre será considerado para ligações completadas com sucesso, cobrando do cliente o valor especificado em Preço Inicial. O tempo excedente será fracionado em intervalos equivalentes ao número de segundos especificado em Incremento e aplicar-se-á a tarifa especificada em Preço Minuto proporcionalmente a 60 segundos. pág. 17

18 2.2.1 Planos - Diretiva Global A diretiva Global é definida juntamente com o Plano: a) Partição: para plataformas com recurso de Particionamento. b) Plano: nome do Plano. c) Preço Inicial, Preço Minuto, Tempo Inicial e Incremento: conforme explicado no tópico anterior. d) Ajuste Tempo %: percentual a ser acrescentado a tempo efetivo da chamada para cálculo da Tarifa. e) Decimais: número de casas decimais para arredondamento: 2 ou 3. f) Ativo: Sim indica que o Plano é visível para cadastramento de novos Clientes. pág. 18

19 2.2.2 Planos - Itens (lingüeta de Planos) Os Itens do Plano são processados hierarquicamente do mais específico para o menos específico, ou seja, a tarifa definida para o Prefixo sobrepõe a do Código de Tarifa; a tarifa definida para o Código de Tarifa sobrepõe a da Categoria que, por sua vez, sobrepõe a do Grupo que sobrepõe a diretiva Global. No caso de definição de mais de uma hierarquia, elas serão processadas pela lógica OU, por exemplo: se for definida uma tarifa para o Código de Tarifa 11 (São Paulo) e o mesmo item especificar a Categoria Celular 11, esta tarifa será válida para os Prefixos com Código de Tarifa 11 OU Categoria Celular 11. a) Prefixo: para definir um Prefixo, digite uma parte do nome (localidade), pressione o botão Busca e selecione na janela a opção. b) Cód. Tarifa: Código de Tarifa do Prefixo. c) Categoria: Categoria a que pertence Prefixo. d) Grupo: Grupo a que pertence a Categoria do Prefixo. e) Preço Inicial, Preço Minuto, Tempo Inicial e Incremente: conforme explicado no item anterior. Nota: Para tarifação é considerado o Prefixo que foi utilizado no módulo de Roteamento, definido de acordo com a Rota e Gateway. pág. 19

20 2.2.3 Planos - IP Origem (lingüeta de Planos) Podem ser definidos valores adicionais para Preço Inicial e Preço Minuto, para efeito de cálculo da tarifa, com base no IP de origem da chamada ponta A. a) IP Origem Chamada: endereço IP ponta A. b) Delta Preço Inicial: adicional a ser considerado para o Preço Inicial. c) Delta Preço Minuto: adicional a ser considerado para o Preço do Minuto. Nota: É considerado IP de Origem aquele definido como primeiro hop da comunicação. pág. 20

21 2.3 Revendedores (menu Cadastros / Revendedores) Todo Cliente tem um Revendedor associado a ele. a) Partição: para plataformas com recurso de Particionamento. b) Revendedor: nome do revendedor. c) endereço de do revendedor. Será utilizado para login ao sistema pelo Revendedor. d) Senha: senha do revendedor para acesso ao sistema. Nota: Como login ao sistema, o Revendedor deve utilizar seu e Senha. Nota: O Revendedor terá visibilidade de seus Clientes e Relatórios definidos. pág. 21

22 2.4 Clientes (menu Cadastros / Clientes) As informações do Cliente definem todos os parâmetros do sistema AAA (Authentication, Authorization and Accounting) do VoIPzilla: As requisições para registro de autenticações tipo AUTH com definição de usuário e senha, são encaminhadas para o SIP Registrar que mantem a tabela de localização (Location) de todos usuários do sistema, possibilitando a conversação entre eles (e atribuição dos recursos de numeração). As chamadas originadas em autenticações (contas) do tipo AUTH sem senha ou ANI são encaminhadas diretamente para o Proxy / Redirect Server e, então, para a terminação pelo módulo de Roteamento conforme abordado nos capítulos anteriores. O módulo Financeiro interage com as informações do bilhete na fase de Accounting, atualizando saldos e limites do Cliente. pág. 22

23 a) Partição: para plataformas com recurso de Particionamento. b) Classificação: índice numérico para referência cadastral que pode ser utilizado em algumas funcionalidades do módulo Financeiro. c) Tipo, CPF/CNPJ, I.E., Nome, Endereço, etc.: dados cadastrais. d) Revendedor: revendedor associado a este cliente. e) Plano: plano de tarifas para as chamadas efetuadas pelo Cliente. f) Rota Especial: definição de uma rota não padrão para as chamadas do Cliente. g) Cobrança: Pós-Pago / Pré-Pago. h) Moeda: R$ ou U$. i) Dia Fatura (para Pós-Pago): dia de vencimento da fatura. j) Limite Crédito (anti-fraude): limite de utilização por Período. pág. 23

24 k) Período Limite: período de amostragem para o Limite de Crédito. l) Saldo Limite: utilização do Cliente no Período Limite, considerado até o dia anterior. m) Ativo: quando configurado para Não bloqueia todas as autenticações do Cliente. n) Conex.Simultâneas: número máximo de chamadas simultâneas que o Cliente pode realizar. o) Saldo (para Pré-Pago): saldo (balanço) da conta. pág. 24

25 2.4.1 Clientes - Auth (lingüeta de Clientes) Auth constitui as autenticações vinculadas ao Cliente. a) Seq #: número seqüencial da autenticação, atribuído automaticamente pelo sistema; b) ID: identificação (username) para autenticação. Também pode ser utilizado como tech prefix seguido de # para autenticações sem senha. Não podem existir dois ID idênticos ativos; c) Senha: senha para autenticação. Para autenticação por tech prefix utilize. na senha; d) Tel. Associado: telefone associado para a autenticação. Deixe em branco para aceitar o telefone associado (screen name) oferecido pelo ATA no momento do registro; e) IP Origem: quando especificado, restringe o envio de chamadas (sinalização) e registro a partir do IP especificado. O IP pode ser especificado incluindo o coringa. Este campo é obrigatório para autenticações por tech prefix ; f) Loose Password: indique Sim para autenticação por tech prefix ; g) Rota: define uma Rota específica para a Auth. Nenhum indica ao sistema para utilizar a rota definida no cadastro do Cliente; h) Ativo: indica status da Auth; i) Sis.Bloq.: indica se a Auth foi bloqueada pelo sistema (bloqueio por inadimplência); j) Map Origem: mapeamento para transformação numérica do endereço de destino da chamada no padrão GNU-GK (formato: [prefixo]=[substituição];...). Por exemplo, para um usuário que utiliza 0 para fazer chamadas longa distância (formato DDD Brasil) e transformar o telefone para o formato internacional E.164, deve-se substituir o 0 pelo código do país 55 com a seguinte expressão: 0=55;. pág. 25

26 2.4.2 Clientes - ANI (lingüeta de Clientes) Utilize ANI para autenticar as chamadas do Cliente por caller ID (número de origem). A autenticação tipo ANI não possui senha, apenas a definição do caller ID. Também pode ser definido um IP de Origem da chamada para autenticação ANI. As autenticações tipo ANI não pressupõem registro de ATAs. Demais campos definidos conforme demonstrado em Auth. pág. 26

27 2.4.3 Clientes - Chamadas (lingüeta de Clientes) Relação das ultimas 20 chamadas realizadas pelo Cliente, excluídas as finalizadas com erro 486 (busy). pág. 27

28 2.4.4 Clientes - Contatos (lingüeta de Clientes) Controle de chamados e contatos com o Cliente. a) Data: data do registro do Contato; b) Contato: breve descritivo da ocorrência. pág. 28

29 2.4.5 Clientes - Descontos (lingüeta de Clientes) Definição de descontos por volume e franquia de minutos para Clientes pós-pago. Os descontos podem ser aplicados para todas chamadas da fatura do cliente, apenas para um Prefixo ou uma Categoria ou um Grupo. a) Prefixo: para definir um Prefixo, digite uma parte do nome (localidade), pressione o botão Busca e selecione na janela a opção; b) Categoria: Categoria dos Prefixos das chamadas que incidirão o Desconto; c) Grupo: Grupo dos Prefixos das chamadas que incidirão o Desconto; d) Tempo Mín.: tempo total mínimo exigido para a aplicação do Desconto. Os Descontos serão ordenados em ordem decrescente de tempo mínimo para processamento. Será processado apenas um desconto para o mesmo filtro Prefixo / Categoria / Grupo; e) Valor Mín.: valor total mínimo exigido para a aplicação do Desconto. Os Descontos serão processados analogamente ao exposto em Tempo Mín.; f) Desconto %: alíquota de Desconto a ser processada; g) Desconto $: Desconto em moeda a ser processado. Nota: Os Descontos processados serão descriminados na Fatura do Cliente. Nota: Para definir uma franquia mínima de minutos, defina dois Descontos: um com o filtro do Prefixo ou Categoria ou Grupo definido na franquia e tempo mínimo equivalente aos minutos definidos na franquia e alíquota igual a 100%; outro com o tempo mínimo equivalente aos minutos da franquia mais 1 e valor do Desconto em moeda equivalente ao valor total dos minutos na tarifa do Prefixo ou Categoria ou Grupo. pág. 29

30 2.4.6 Clientes - Lançamentos (lingüeta de Clientes) Lançamentos a crédito ou débito para Cliente. a) Histórico: breve descritivo do Lançamento; b) Valor: valor do Lançamento; c) C/D: Crédito ou Débito; d) Parcela: número de parcelas já processadas pelo sistema (zero para primeira parcela); e) Num.Parcelas: número total de parcelas a emitir; f) Tipo: tipo do Lançamento: Moeda, Tx.Habilita (taxa de habilitação) ou Minutos; g) ICMS: incidência de ICMS sobre o valor do Lançamento (apenas para pós-pago). Nota Clientes pós-pago: Para Clientes pós-pago, será processada uma parcela a cada fatura emitida. Nota Clientes pré-pago: Lançamentos com uma única parcela para Clientes pré-pago serão processados imediatamente e o Saldo será alterado de acordo. Lançamentos com mais de uma parcela, cada parcela será processada pelo acionamento da opção do menu Faturamento / Gerar / Pré/Lanç. pág. 30