Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual...

46
MANUAL DE GERENCIAMENTO SISTEMA VOIP VIRGOS (TARIFADOR)

Transcript of Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual...

Page 1: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

MANUAL DE GERENCIAMENTOSISTEMA VOIP VIRGOS 

(TARIFADOR)

Page 2: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

Sumário

Introdução..............................................................................................................3

1 – Visão Geral......................................................................................................4

2 – Cadastrando Clientes.......................................................................................82.1- Criando contas no sistema......................................................................................................................... 82.2-Criando um acesso SIP/IAX (número voip).............................................................................................12

3 – Cadastrando Troncos (Operadoras)...............................................................163.1 - Cadastrando as informações de conexão para um tronco (ip,usuário, senha, etc...)...................................................................................................................................................................... 163.2 – Cadastrando o tronco............................................................................................................................. 16

4 – Tarifação........................................................................................................184.1 – Descrição geral...................................................................................................................................... 184.2 – Tariffgroup............................................................................................................................................ 18

4.2.1 – Criando um Tariffgroup......................................................................................................................184.2.2 – Listando Tariffgroup's cadastrados....................................................................................................194.2.3 – Associando um Tariffgroup a um cliente............................................................................................19

4.3 – Ratecard................................................................................................................................................ 194.3.1 – Criando um Ratecard..........................................................................................................................194.3.2 – Listando Ratecard's cadastrados........................................................................................................204.3.3 – Associando um Ratecard a um Tariffgroup........................................................................................20

4.4 – Tarifas (rotas)........................................................................................................................................ 204.4.1 – Criando uma Tarifa............................................................................................................................214.4.2 – Listando e editando tarifas existentes.................................................................................................22

4.5 - Importando uma tabela de tarifas de uma planilha..................................................................................22

5 - Agendamento de tarefas para débito/crédito de clientes periodicamente......26

6 - Billing.............................................................................................................296.1 - Creditando um cliente............................................................................................................................ 296.2 - Cadastrando pagamentos efetuados pelos clientes..................................................................................296.3-Visualizando pagamentos......................................................................................................................... 296.4-Verificando a situação financeira dos clientes..........................................................................................296.5-Vouchers................................................................................................................................................. 30

6.5.1-Descrição...............................................................................................................................................306.5.2-Criando um Voucher.............................................................................................................................30

1

Page 3: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

6.5.3-Criando vouchers em lote......................................................................................................................31

7- Relatórios........................................................................................................327.1 - Relatório geral....................................................................................................................................... 327.2 - Fatura.................................................................................................................................................... 337.3 - Comparar Ligações................................................................................................................................ 337.4 - Tráfego mensal...................................................................................................................................... 337.5 - Tráfego diário........................................................................................................................................ 337.6 - Relatório por cliente............................................................................................................................... 34

8 - Manutenção....................................................................................................358.1 - Backup / Download............................................................................................................................... 358.2 - Logs....................................................................................................................................................... 358.3 - Teste de DTMF...................................................................................................................................... 358.4 - Customizar Layout do Cliente................................................................................................................ 368.5 - Configurações........................................................................................................................................ 36

8.5.1 - Chave de Acesso ao WebService.........................................................................................................368.5.3 - Exibição do tempo de chamadas ........................................................................................................368.5.4 - Configurações SMTP...........................................................................................................................368.5.5 - Dados para emissão de Boleto(*).......................................................................................................378.5.6 - Pesonalizar os logos da Área Administrativa.....................................................................................378.5.7. - Valor Mínimo para Fechamento Automático.....................................................................................37

9 - Monitoramento ..............................................................................................389.1 - Asterisk Console.................................................................................................................................... 38

9.1.1 - Usuários conectados SIP.....................................................................................................................389.1.2 - Usuarios conectados IAX....................................................................................................................389.1.3 - Chamadas em andamento: .................................................................................................................399.1.4 - Matar ligações e reiniciar Asterisk ....................................................................................................39

9.2 - Ping....................................................................................................................................................... 399.3 - Gráficos................................................................................................................................................. 39

10 - Revendas......................................................................................................4010.1 - Revenda por Comissão......................................................................................................................... 40

10.1.1 - Adicionar Revenda Comissionada.....................................................................................................4010.2 - Revenda-Master................................................................................................................................... 41

10.2.1 - Adicionar Revenda Master................................................................................................................4210.3 - Listar Revenda Master/Comissionada.................................................................................................. 4310.4 Deletar Revenda..................................................................................................................................... 43

11 - Configuração dos Administradores..............................................................4411.1 - Adicionar............................................................................................................................................. 4411.2 - Adicionar Admin Parcial...................................................................................................................... 4411.3 - Listar Admin e Admin Parcial.............................................................................................................. 45

2

Page 4: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

Introdução

Este   manual   apresenta   as   principais   funcionalidades   do   sistema Voip   Virgos,   versão   tarifador.   O   sistema   é   baseado   no   software   a2billing (www.asterisk2billing.org)   e   é   distribuído   sob   licença   GPL,   assim   como   o original. Não é tratado neste documento passos para instalação do sistema e sim para o seu gerenciamento.

Esta   documentação,   desenvolvida   pela   Virgos,   pode   ser   distribuída gratuitamente, desde que mantida sua forma e a referência à empresa­autora.

Verifique   sempre   a   última   versão   disponível   deste   documento   em http://suporte.virgos.com.br/downloads/manual.pdf 

Customizações,   consultorias,   treinamentos   e   outros   serviços   sempre podem ser solicitados conosco. O contato pode ser feito via:

Virgos Tecnologia da Informação S/SEpiscopal, 1763 – São Carlos ­ SP(16) 2107­8647 – www.virgos.com.br

3

Page 5: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

1 – Visão Geral

O sistema   trabalha  basicamente   com o  cadastramento  de   troncos  de saída para as chamadas, rotas e clientes.

É possível trabalhar com várias operadoras simultaneamente no sistema, onde cada operadora será um tronco no sistema.

O que torna isto possível é o cadastramento de rotas no sistema, rotas são definidas atráves de prefixos de discagem e para cada rota definimos um tronco de saída. As rotas possuem diversas propriedades, como por exemplo, valor pago por minuto na rota e valor que será cobrado pela rota.

Abaixo um diagrama mostrando a relação entre cliente, rotas e troncos.

No   cadastro   de   clientes,   é   cadastrado   primeiramente   uma   conta   que detém as informações do cliente, como: nome, endereço, enfim, os dados cadastrais do cliente. É nesta conta que atribuímos os créditos ao cliente.

Para   cada   conta   existente   podemos   criar   vários   números   voip,   estes conhecidos   no   sistema   como   sip/iax­friends.   Os   termos   SIP   e   IAX   indicam   o protocolo   de   comunicação   utilizado   pelo   dispositivo   (ata,   softphone,   voipphone) utilizado na comunicação.

Observamos também no digrama acima outros dois termos: tariffgroup e ratecard. 

4

Page 6: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

Os   ratecard's   são   na   verdade   um   grupo   de   tarifas   (rotas).   No cadastramento   das   tarifas   umas   das   propriedades   indicadas   é   em   qual   dos ratecard's existentes no sistema ela será inserida.

Os   tariffgroup's   podem   ser   considerados   como   os   planos   de   venda praticados no sistema, dentro dos tariffgroup's  inserimos os ratecard's criados no sistema.

Com o cadastro de tariffgroup's e ratecard's podemos então associar um cliente a um tariffgroup.

Desta   forma,   poderíamos   por   exemplo,   criar   um   plano   com   tarifas reduzidas   para   clientes   empresariais   e   manter   clientes   residenciais   em   um tariffgroup com tarifação comum.

Abaixo   é   apresentado   outro   diagrama,   agora   demonstrando   o funcionamento   do   sistema   com   um   cadastramento   básico   de   clientes,   rotas   e troncos.

5

Page 7: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

1 ­ ATA configurado para conectar­se ao servidor com os dados do acesso criado no servidor   (sip­friend).   Considerando   que   o   ATA   esteja   autenticado   no   servidor, quando o cliente efetuar uma ligação o ATA enviará número discado para o servidor.

2 ­ O sistema verificará então que este acesso sip está associado ao cliente 'Empresa1'.

3 ­ Nesta fase é verificado a qual tariffgroup o cliente 'Empresa1' está associado, que no caso é o tariffgroup 'Empresarial'.

4  ­ O sistema fará uma comparação do número discado pelo cliente com todas as tarifas existentes nos ratecard's atribuídos ao tariffgroup Empresarial, vale ressaltar que sempre será selecionada a tarifa que seja mais completa em relação ao número discado pelo usuário.Por exemplo, caso o usuário disque 01140634771, será procurada por tarifas cujo prefixo definido seja   01140634771, caso não exista, serão procuradas por tarifas 

6

Page 8: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

0114063477,  depois     011406347,   depois     01140634,   depois     0114063  e  assim sucessivamente, até que algo seja encontrado.Caso exista mais de uma tarifa cadastrada com o mesmo prefixo, será escolhida a de menor custo.Selecionada   a   tarifa,   o   sistema   então   enviará   a   chamada   para   o   tronco correspondente a tarifa selecionada.

5 ­ Chegamos então ao final do processo, onde já sabemos para qual tronco enviar a   ligação.   Basta   agora   resgatarmos   as   informações   de   autenticação   do   tronco escolhido, tais informações estão no sip­friend determinado no campo 'ip ou nome do friend' no cadastro do tronco.

6 ­ E aqui, finalmente enviamos a chamada para a operadora.

7

Page 9: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

2 – Cadastrando Clientes

2.1­ Criando contas no sistema

Para cadastrar um cliente, vá em 'Adicionar Cliente' que está localizado no menu  'Clientes'.  Abaixo a descrição dos campos disponíveis no  formulário de cadastro:

– Número:   Número   gerado   automaticamente   pelo   sistema,   código   único   para identificação da conta

– Apelido:  É  o nome de usuário utilizado para o cliente acessar a  interface de consulta de saldo desta conta. Este campo só aceita caracteres numéricos.

– Senha via Web: Senha utilizada para acesso a interface de consulta de saldo.

– Crédito: Este campo possibilita definir um crédito inicial para o cliente, porém o sistema não contabiliza o valor como um crédito a ser pago pelo cliente.

– Aviso de crédito: Valor para o aviso de crédito baixo. 

– Revendedor:  Este campo determina à  quem este cliente pertence. Caso seja selecionado algum revendedor, ele terá acesso a este cliente.

– Língua: idioma do cliente.

– Tariffgroup:  Neste   campo   é   definido   qual   tariffgroup   o   cliente   utilizará   para efetuar suas ligações.

– Campanhas de  Áudio(*):  Este  campo define  se  este  cliente   tem acesso  às campanhas de áudio.

– Campanhas   de   SMS(*):  Este   campo   define   se   este   cliente   tem   acesso   às campanhas de sms.

8

Page 10: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– Callcenter(*): Este campo define se este cliente tem acesso ao Callcenter.

– Ativo: estado da conta, possíveis valores:

– sim:   conta   ativada,   ligações   feitas   normalmente   (caso   o   cliente   tenha créditos).

– não: conta desativada, utilização da conta bloqueada.

– Acesso simultâneo: Defina se esta conta poderá realizar mais de um acesso simultâneo.

– Moeda: moeda corrente do cliente.

– Executar tarefas periódicas: o sistema permite o agendamento de tarefas de débito,  caso exista  alguma,  defina  aqui  se  tais   tarefas  serão aplicadas nesta conta.

– Tipo: tipo de conta, Pré­Pago ou Pós­Pago.

– Limite de Crédito: Caso a conta seja do tipo pós­pago, deve­se definir aqui um limite de utilização de crédito.

– Data   primeiro   uso:   data   da   primeira   utilização   da   conta.   Inserido   automati­camente pelo sistema.

– Data da última chamada realizada:  data da última vez que o cliente efetuou uma chamada.  Inserido automaticamente pelo sistema.

– Ativar   expiração:   É   possível   definir   uma  data   para   expiração   da   conta.   As seguintes opções estão disponíveis:

– Não expirar: A conta nunca expira.

9

Page 11: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– Expirar em uma data:   a conta expira na data informada no campo “data de expiração”.

– Expirar alguns dias após o primeiro uso: A conta expira após o número de dias   informado   no   campo   “dias   para   expirar”,   contando   após   o   data   do primeiro uso.

– Expirar alguns dias após a criação: Expira a conta   após o número de dias informado no campo “dias para expirar”,  contando após a data de criação (cadastro).

– Data de expiração: Defina uma data de expiração para a conta, se o campo “Ativar expiração” estiver ativo.

– Dias   para   expirar:   Defina   o   número   de   dias   para   a   conta   expirar,   calculo baseado na definição do campo “Ativar expiração”.

– Sobrenome: sobrenome do cliente.

– Primeiro nome: primeiro nome do cliente.

– Email: E­mail do cliente.

– Email2: Campo adicional para e­mail do cliente, caso seja necessário.

– Endereço: Endereço  do cliente.

– Bairro: Bairro  do cliente.

– Cidade: Cidade do cliente.

– Estado: Estado do cliente.

– País: País do cliente.

10

Page 12: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– CEP: CEP do cliente.

– DDD:  Área   do   telefone   do   cliente.   Informando   a   área   local,   o   cliente   não precisará discá­lo para efetuar chamadas para localidades com este DDD.

– Telefone: Telefone do cliente.

– Telefone2: Campo adicional para telefone do cliente, caso seja necessário.

– Pessoa   para   contato:  Nome   da   pessoa   para   quando   for   necessário   fazer contato.

– FAX: Fax do cliente.

– Documento (CPF/CNPJ): CPF/CNPJ do cliente.

– Empresa: Nome da empresa do cliente.

– Inscrição Estadual: Número da inscrição estadual do cliente.

– Em uso: Usado para debug, este valor será maior que 0 se o cartão estiver em uso. Caso a aplicação trave por algum motivo então o ficara marcado como >0. Neste caso, pode­se marcar de volta ao 0 para liberar o uso futuro.

– Gravação(*): Ativar a gravação de chamadas para este cliente.

– Data do último Fechamento:  Data  em que ocorreu o  último  fechamento  da conta deste cliente. Inserido automaticamente pelo sistema.

– Período de Fechamento:  Período de dias entre cada fechamento. Disponível apenas se a conta for do tipo pós­paga.

– Período de Vencimento: Período de dias para vencimento do boleto. Disponível apenas se foi selecionado um Período de Fechamento.

11

Page 13: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– Observações: Campo livre onde pode ser inserido observações sobre o cliente.

(*)   ­  Necessário   adquirir   estes   serviços.   Entre   em   contato   com   nosso   Setor Comercial para maiores detalhes.

2.2­Criando um acesso SIP/IAX (número voip)

É   neste   cadastro   que   criamos   os   acessos   que   serão   utilizados   nos dispositivos. Para cadastrar um acesso, no menu “Clientes” clique em “Adicionar SIP­friend” (para um dispositivo que utilize o protocolo SIP) ou em “Adicionar IAX­friend” (para um dispositivo que utilize o protocolo IAX).

– Name: identificação do acesso. É através deste número que o acesso receberá chamadas.

– Tipo: tipo de sip­friend, no caso de clientes utilize o padrão “friend”, a definição “peer” é utilizada somente no cadastramento de operadoras.

– Username: nome de usuário que será utilizado para este acesso se autenticar no sistema. Normalmente igual a 'name'.

– Cartão associado: número da conta à qual este acesso será associado.

– Regexten: Se for preenchido deve ser igual ao username.

– Callerid: Identificação do usuário, a que aparece na BINA.

– Amaflags: Deixe como 'billing' para as chamadas serem registradas.

– Senha: senha que será utilizada para autenticação deste acesso no sistema.

– MD5Secret: Senha pré­criptografada (quase não usado).

– NAT:  defina se o dispositivo que utilizará  este acesso esta em uma rede que utilize NAT.

12

Page 14: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– DTMFMode: Deixe como  RFC2833.

– Qualify: se habilitada, o sistema irá fazer uma verificação do status deste acesso regularmente. Se a latência do servidor for muito alta ou ele não suportar 'qualify' ele   pode   se   tornar   UNREACHABLE,   impedindo   que   ligações   saim   pela operadora usada. Desabilite e ele deverá funcionar.

– Canreinvite: Determina se durante uma chamada, o sistema deve tentar fazer com que origem e destino comuniquem­se diretamente, com o objetivo de liberar o tráfego do sistema.

– Disallow: Codecs que não serão permitidos, deixe como 'all'.

– Allow: define quais codecs poderão ser utilizados por este acesso. Os codecs mais conhecidos estão definidos em ordem de prioridade.

– Host:   Deixe   dynamic   no   caso   de   usuários   com   ip   dinâmico.   Você   precisa preecher este campo apenas no caso das operadoras/troncos.

– Callgroup: Deixe em branco.

– Context: Contexto ao que o SIP está atrelado, normalmente 'callingcard'.

– Defaultip:   Usado para definir um IP para um SIP antes que o ATA se registre com o Asterisk. Normalmente deixado em branco.

– Fromuser:   Se   estiver   cadastrando   uma  operadora/tronco,   coloque   aqui   o mesmo valor do campo USERNAME, isto é, o usuário que vc usa para conectar­se nela.

– Fromdomain: Força um domínio nas mensagens entre os SIPs.

– Insecure: Define como manipular a conexão entre os peers. Normalmente 'no' (default) para SIPs e pode ser 'very' para alguns troncos/operadoras.

13

Page 15: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– Language: Código de duas letras indicando o país, isto influencia nos toques e tons usados. Para o Brasil é br, normalmente fica em branco.

– Mailbox: Extensão do VoiceMail, válido apenas para SIPs do tipo peer.

– Permit, Deny, Mask: Restringem ou permitem IPs.

– Pickupgroup: Grupo que pode pegar chamadas de outros usuários usando *8. É necessário que a extensão *8 esteja configurada corretamente.

– Port: Porta em que o SIP responde.

– Restrictcid:  Não é usado.

– RTPTimeout:   Termina   uma   chamada   se   houver   mais   de   N   segundos   de inatividade   na   chamada   quando   o   telefone   não   estiver   em   espera.   Válido somente para SIPs do tipo igual a peer.

– RTPHoldTimeout: Termina uma chamada depois de N segundos de inatividade em uma chamada em espera.

– Musiconhold:    Uma das  classes  especificadas  no  arquivo  musiconhold.conf. Normalmente não usado aqui.

– Regseconds:   Número de segundos antes do peer se registrar. Válido apenas para entradas em tempo real e normalmente é deixado em branco.

– IP Addr: IP do SIP, válido para conexões em tempo real. Deixe em branco.

– CanCallForward:  Deixe em yes.

– DDD: Código da área deste SIP/IAX.

– Call­limit: Limite de chamadas que este SIP/IAX pode efetuar simultaneamente.

14

Page 16: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

15

Page 17: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

3 – Cadastrando Troncos (Operadoras)

3.1 ­ Cadastrando as informações de conexão para um tronco (ip,usuário, senha, etc...)

Este   cadastro   é   normalmente   utilizado   para   troncos   que   fazem autenticação através de usuário e senha. Para este cadastro insira um SIP client (veja em “2.2­Criando um acesso SIP/IAX (número voip)”). Abaixo a descrição dos campos necessários. 

– Name: nome para identificação do tronco no sistema, livre escolha.

– Tipo: o tipo de acesso que estamos cadastrando, no caso de operadoras defina “peer”.

– Username:   insira   o   nome   de   usuário   fornecido   pela   operadora.   Caso   a autenticação seja feita  através do IP do servidor, deixe este campo em branco.

– Senha: insira a senha oferecida pela operadora. Caso a autenticação seja feita através do IP do servidor, deixe este campo em branco.

– Qualify: Defina se o sistema deve fazer uma verificação regularmente do status da operadora. Algumas operadoras não suportam este parâmetro, se este for o caso defina 'no' neste campo.

– Host: insira o IP ou o domínio da operadora.

– Fromuser: Defina o mesmo valor informado no campo username.

3.2 – Cadastrando o tronco

16

Page 18: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

Para   criar  um novo   tronco,   clique  em  “Adicionar”   localizado  no  menu “Troncos”. Abaixo a descrição dos campos utilizados:

– Código do tronco: insira um nome para identificação deste tronco.

– Adicionar prefixo:   algumas operadoras necessitam do prefixo '011' antes do número   discado,   este   campo   possibilita   que   o   prefixo   seja   adicionado automaticamente ao número discado (*).

– Remover prefixo: remove um ou mais dígitos discados pelo usuário.

– Protocolo: Tipo de protocolo usado para conectar­se ao tronco. Sua operadora lhe fornecerá este parametro. Os valores possíveis são: SIP, IAX2 e ZAP.

– IP  ou  nome  do   friend:   indique  aqui   o   nome  do   sip­friend   criado  para  esta operadora, ou informe o IP ou domínio caso a operadora possua a facilidade de autenticação através do IP.

– Parametros Adicionais:  Usados nos comandos Dial  do asterisk.  Geralmente não é necessário.

– Tronco secundário, em caso de falhas: podemos definir aqui tronco dentre os cadastrados   no   sistema   para   que   assuma   as   chamadas   destinadas   a   este (cadastro atual), caso ele não consiga completa­las.

– Crédito   no   tronco:   usado   para   controlar   quanto   crédito   você   tem   com   a operadora. Conforme as ligações saírem pelo tronco o crédito diminui. Quando você colocar mais créditos na operadora você atualiza aqui. Este campo serve apenas para seu controle não influenciando no sistema de tarifas.

17

Page 19: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

4 – Tarifação

4.1 – Descrição geral

  A   tarifação   é   constituída   por   3   elementos,   tariffgroup's,   ratecard's   e tarifas, onde os tariffgroup' são os planos de venda do sistema, a cada cliente do sistema é associado um tariffgroup. Associamos então a um tariffgroup um ou mais ratecard's, que são grupos de tarifas.

Inserimos então, dentro dos ratecard's, as tarifas, que são uma definição de cada rota (prefixo) que desejamos permitir ligações dentro do sistema. As tarifas possuem diversas propriedades, como: prefixo, valor de compra e venda na rota,  tronco de destino para a rota, dentre outras.

Veja abaixo uma figura demonstrando a associação como deve ser feita no sistema.

4.2 – Tariffgroup

4.2.1 – Criando um Tariffgroup

Para   criar   um   Tariffgroup,   clique   em   “Adicionar   Tariffgroup”   no   menu “Tarifas”. Abaixo a descrição do formulário de cadastro de um tariffgroup.

– Nome: defina o nome do Tariffgroup.

18

Page 20: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– Tipo: este campo define como o sistema deve agir quando encontrar duas rotas iguais, porém com tarifas diferenciadas. As opções são: LCR opta pela rota que possua o menor custo para você, LCD opta pela rota que possua o menor custo para seu cliente.

– Remover prefixo internacional: defina se as tarifas dos ratecard's que serão associados a este Tariffgroup possuem os prefixos internacionais '011' ou '00'.

4.2.2 – Listando Tariffgroup's cadastrados

Para listar os Tariffgroup's cadastrados no sistema, vá em “Listar/Editar Tariffgroup”, localizado no menu “Tarifas”.

Será apresentada a lista de todos os Tariffgroup's cadastrados no sistema e suas principais informações. É possível editar e apagar qualquer tariffgroup criado clicando nos botões 'editar' e 'deletar'.

4.2.3 – Associando um Tariffgroup a um cliente.

A associação dos clientes com os Tariffgroup's é feita editando o cadastro no   cliente   (menu   “Clientes”,   “Lista   de   Clientes/Cartões”)   e   alterando   o   campo Tariffgroup do cliente.

4.3 – Ratecard

4.3.1 – Criando um Ratecard

Para   criar   um   novo   ratecard,   clique   em   criar   “Adicionar   Ratecard”, localizado no menu “Tarifas”.  Os campos envolvidos no cadastro estão descritos abaixo.

– Nome: defina o nome que será utilizado para identificar o Ratecard.

19

Page 21: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– Data inicial: inicio da validade deste Ratecard.

– Data final:  final da validade  do Ratecard.

– Tronco:   define­se   um   tronco   padrão   para   as   tarifas   que   estarão   dentro   do Ratecard. Porém isso não restringe que todas as tarifas dentro do ratecard saiam pelo tronco definido aqui. O tronco de cada tarifa pode ser editado na própria tarifa.

– Descrição: apenas um campo para comentários explicativos do ratecard. Não é obrigatório.

– DNID: não deve ser alterado o valor padrão.

4.3.2 – Listando Ratecard's cadastrados

Para  listar  os  Ratecard's  cadastrados no sistema,  vá  em  “Listar/Editar Ratecard”, localizado no menu “Tarifas”.

Será apresentada a lista de todos os Ratecard's cadastrados no sistema e suas principais   informações.  É  possível  editar  e apagar  qualquer   ratecard criado clicando nos botões 'editar' e 'deletar'.

4.3.3 – Associando um Ratecard a um Tariffgroup

Isto é feito na edição do Tariffgroup em que o Ratecard será associado. Um tariffgroup pode possuir  uma  lista  de   ratecard  associados,  que  também são conhecidos como tariffplan's.

Na edição do tariffgroup temos a lista de ratecards associados, pode­se remover os ratecards já associados e associar novos ratecards.

4.4 – Tarifas (rotas)

20

Page 22: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

4.4.1 – Criando uma Tarifa

Para criar uma nova tarifa, clique em “Adiconar Tarifa” no menu “Tarifas”. No cadastramento de tarifas é definido para onde o sistema fará ligações (prefixos), qual operadora utilizar e os valores praticados para cada destino. Abaixo a descrição dos campos do formulário de cadastro da tarifa:

– Ratecard: defina a qual ratecard a tarifa deve ser inserida.

– Prefixo de Discagem: defina o prefixo da rota. É possível criar tanto rotas mais abrangentes     e   rotas   mais   especificas,   dependendo   da   necessidade   de diferenciação na tarifação. Por exemplo, poderíamos criar uma rota para todos os destinos do Brasil   informando neste campo apenas o  '55'.  Outra possibilidade seria criar  uma rota para cada DDD, ex: 5516,  5511. Caso queira diferenciar  tarifas   com   destinos   celular   ou   fixo,   é   preciso   criar   rotas   específicas   que determinem essa diferença, alguns exemplos: 55119, 55118, 55219 e 55218.

– Destino: uma descrição para a rota, ex: Brasil.

– Por quanto você compra: defina o valor pago na rota à operadora.

– Tempo   mínimo   que   você   paga   na   chamada:   defina   o   tempo   mínimo   de tarifação aplicado pela operadora. Ex:   Uma operadora que aplique uma tarifa nos primeiros 30 segundos, após isso a cada 6 segundos.

– Em blocos de quantos segundos você paga: o período de tempo em que a tarifa é aplicada após a tarifação mínima.

– Quanto você cobra?: O valor que será aplicado ao cliente nesta rota.

– Tempo mínimo de tarifação: o tempo mínimo em que a tarifa será aplicada ao cliente.

– De quantos em quantos segundos você tarifa o cliente: defina o período em que será feita a tarifação no cliente após o período mínimo.

21

Page 23: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– Custo por conexão: possibilita tarifar o cliente na conexão da chamada, além do tempo total utilizado.

– Custo por desconexão: possibilita tarifar o cliente na desconexão da chamada, além do tempo total utilizado.

– Data inicial: data de inicio do período de validade da tarifa.

– Data final: data final do período da validade da tarifa.

– Dias de semana: dias da semana em que a tarifa será válida.

– Tronco: define para qual tronco a chamada deve ser redirecionada.

– Música de espera:  altera o tom de discagem para uma música. O valor  “No music on hold” mantém o tom de discagem convencional.

4.4.2 – Listando e editando tarifas existentes

Após o cadastramento das tarifas, alterações poderão ser feitas atráves do menu “Editar Ratecard”, localizado no menu “Tarifas”. 

Um campo de seleção contendo os ratecards existentes no sistema é apresentado. Listadas as tarifas de um Ratecard temos   a opção de editá­las ou apagá­las, clicando nos respectivos botões. Os campos são os mesmos da criação da tarifa.

4.5 ­ Importando uma tabela de tarifas de uma planilha

O sistema oferece também, a funcionalidade de fazer o cadastramento das tarifas baseando­se em dados de planilha eletrônica (Excel, OpenOffice). Abaixo o modelo da tabela de tarifas:

55163 São Carlos­Fixo 0.1 30 6 0.05 30 655168 São Carlos­Celular 0.5 30 6 0.30 30 6

22

Page 24: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

55169 São Carlos­Celular 0.5 30 6 0.30 30 65511 São Paulo­Geral 0.08 30 6 0.04 30 65516 Rio de Janeiro­Geral 0.08 30 6 0.04 30 6

Temos então uma tabela com algumas rotas definidas. Veja que foram definidos os mesmos campos do cadastramento comum de uma tarifa,  são eles: prefixo, destino, preço de venda, tempo mínimo de venda, tempo adicional de venda, preço de compra, tempo mínimo de compra e tempo adicional de compra.

O último passo na preparação da tabela é salvá­la no formato de arquivo “csv”. Para isso, utilizamos a opção “salvar como” geralmente localizada no menu “arquivo”. No Excel, selecione o tipo de arquivo “CSV (MS­DOS)”, é normal o Excel emitir alguns avisos portanto confirme­os para finalizar a operação. Em outro editor, selecione a opção “Texto CSV”, edite as configurações de filtro deixando “;” como delimitador de campo e delimitador de texto em branco.

Com a planilha salva no formato CSV, podemos executar a importação. No menu “Tarifas”, vá em “Importar Ratecard”, os passos são descritos abaixo:

– Escolha qual ratecard quer importar: Selecione o ratecard em que as tarifas da tabela serão importadas.

– Tronco a usar: Determine qual será o tronco de saída para as tarifas.

Em seguida devemos informar como as informações estão dispostas no arquivo  csv.  As primeiros  3 colunas do arquivo   já  estão pré­selecionadas e são campos obrigatórios para a importação, são eles:

– Dialprefix: prefixo de discagem (ex.: 5511).

– Destination: uma descrição para a tarifa (ex.: Brasil – São Paulo).

– Rate intial: o preço de venda aplicado na rota.

Na seqüência, podemos informar alguns dados opcionais, como:

23

Page 25: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– Buyrate: o preço de compra para rota.

– Buyrateinitblock: tempo mínimo de compra aplicado na rota.

– Buyrateincrement: o tempo adicional de compra aplicado na rota.

– Initblock: tempo mínimo de venda aplicado na rota.

– Billingblock: tempo adicional de venda aplicado na rota.

– Connect charge: taxa de conexão.

– Disconnect charge: taxa de desconexão.

Considerando a utilização de arquivo seguindo o modelo aqui apresentado, teríamos a seguinte seqüência a determinar.

● campos obrigatórios

1 – dialprefix.2 – destination.3 – rateinitial.

● campos opcionais

4 – initblock.5 – billingblock.6 – buyrate.7 – buyrateinitblock.8 – buyrateincrement.

Feito isso, indicamos ao sistema qual o arquivo a utilizar na importação, para isso clique no botão “arquivo”, em seguida clique em importar.

A   tela   seguinte   nos   apresenta   uma   comparação   entre   o   que   foi determinado na tela anterior e os valores encontrados na primeira linha do arquivo csv.  Estando   tudo   certo,   carregue   o   arquivo   novamente   e   clique   em   'continuar importação' para finalizar o processo.

24

Page 26: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

25

Page 27: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

5 ­ Agendamento de tarefas para débito/crédito de clientes periodicamente

Esta é uma funcionalidade em que podemos agendar tarefas para realizar débito   ou   crédito   dos   clientes   automaticamente,   em   um   intervalo   de   tempo determinado.

Para  criar  uma    tarefa  periódica,   vá   em  “Adicionar  Tarefas”  no  menu “Execuções Periódicas”, abaixo a descrição dos campos disponíveis no cadastro da tarefa:

– Nome: Defina um nome para a tarefa.

– Valor:  Defina o valor que será  debitado/creditado de cada cliente. As opções são:

– valores positivos: debita créditos das contas atingidas pela execução.– valores negativos: credita as contas atingidas pela execução.

– Ação no cartão: Nesta opção é possível escolher se o cartão do cliente deve ser desativado e se seus créditos serão retirados quando ele for afetado pela tarefa periódica. As opções são:

– Apenas retirar os créditos acima inseridos.– Apenas desativar o cartão sem retirar os créditos.– Desativar e retirar os créditos acima inseridos.– Retirar todos os créditos acima inseridos.

– Periodicidade: o intervalo de tempo em que a tarefa deve ser executada. Ex: diariamente, a cada 10  dias, a cada 30 dias, todo dia x do mês e etc...

– Dia: Caso tenha sido selecionada a opção “Todo dia X do mês” no item anterior, deve­se indicar neste campo em qual dia ela será executada.

– Regra: É determinar também que a tarefa somente seja executada caso a regra aqui definida seja verdadeira, as opções são:

– O usuário não usa o cartão desde N dias.26

Page 28: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– O usuário usou o cartão nos últimos N dias.– Recarga de créditos não realiazada nos últimos N dias.– Cartão possui apenas 1 sip­friend.– Cartão possui 2 ou mais sip­friends.– Apenas neste tariffgroup.– Movimentação em aberto vencido por N dias.– Usuário efetuou menos de N recargas no mês passado.

– Número de dias: campo utilizado para definição de “N dias” do campo regra. Caso for utilizada a regra “Apenas neste tariffgroup”, deve­se definir neste campo qual o ID do tariffgroup que a tarefa afetará. Caso for utilizada a regra “Usuário efetuou menos de N recargas no mês passado”, deve­se definir neste campo o número de recargas que será utilizada.

– Parar de executar: Não executa a tarefas nos clientes que se encaixem da regra aqui definida

– Nunca.– O crédito da conta chegou a zero.– Máximo de execuções alcançado.

– Máximo de execuções por cartão: determina o valor para o campo “máximo de execuções alcançado”, da opção parar de executar.

– Tipos dos cartões: Este campo define o tipo do cartão que a tarefa irá afetar. Suas opções são:

– Pré­pago;

– Pós­pago;

– Ambos.

– Status: estado da tarefa, ativa ou inativa.

– E­mail para envio de relatório: indique um envio de um relatório contendo os resultados da execução da tarefa.

27

Page 29: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

OBS: a tarefa somente será aplicada aos clientes que estiverem com a opção “Executar tarefas periódicas” ativada em seu cadastro.

28

Page 30: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

6 ­ Billing

6.1 ­ Creditando um cliente

Para creditar  um cliente,  vá  em  “Creditar  cliente”,   localizado no menu “Billing”. Indique o número do cliente e a quantia a ser creditada. Pode ser inserido também um comentário junto ao crédito que está sendo efetuado. Em seguida clique em “Creditar valor ao cartão associado”.

6.2 ­ Cadastrando pagamentos efetuados pelos clientes

O cadastramento de pagamentos dos clientes é efetuado para facilitar o gerenciamento do sistema, quanto a quantias pagas e quantias à pagar.

Está   localizado   no   menu   “Billing”   em   “Cadastrar   pagamentos”.   Para cadastrar   uma   pagamento   informamos   o   username   do   cliente   que   efetuou   o pagamento  e  a  quantia  que   foi   paga,  além de   ser   possível   também  inserir   um comentário sobre o pagamento. É possível escolher o username do cliente clicando no botão laranja, onde será exibida uma lista para seleção.

6.3­Visualizando pagamentos

Nesta   opção,   localizada   no   menu   “Billing”   em   “Listar   Pagamentos”, podemos conferir   todos os pagamentos efetuados no sistema, com os dados do cliente que efetuou o pagamento, a data do pagamento, o valor pago e o comentário associado. Caso você possua o serviço de boletos(*), aparecerá também o campo “Status” do pagamento, que indica se o boleto já está “pago” ou “à confirmar”.

6.4­Verificando a situação financeira dos clientes

Nesta   tela   podemos   visualizar   todas   as   informações   relacionadas   a questões  financeiras para cada cliente do sistema. A opção chama­se “Situação Financeira” e esta localizada no menu “Billing”.

Temos então listados todos os clientes do sistema, o total de crédito atual, a quantia total já creditada, o total pago e o valor total à pagar.

29

Page 31: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

Em   “detalhes”   podemos   visualizar   a   data   e   valor   de   cada   crédito   e pagamento efetuado pelo cliente.

OBS: o campo “crédito” definido no cadastro do cliente, não consta como valor à pagar para o cliente.

6.5­Vouchers

6.5.1­Descrição

Vouchers podem ser comparados com os cartões de recarga de celulares pré­pagos,   onde   através   de   um   código   digitado   do   celular   o   cliente   é automaticamente creditado.

O sistema gera um código de voucher aleatório, para o qual é definido um valor de crédito. O cliente que possuir este código poderá digita­lo na interface de consulta de saldo para obter os créditos.

Considerações sobre Vouchers:­ um voucher só poderá ser utilizado uma única vez.­ somente serão aceitos os códigos cadastrados no sistema e seu status estiver como Ativo.­ após sua utilização o voucher é automaticamente desativado.

6.5.2­Criando um Voucher

Para criar um voucher, vá em “Adicionar Voucher”,  localizado no menu “Billing”. Abaixo a descrição dos campos:

– Voucher: código aleatório gerado para o voucher.

– Credit: crédito associado a este voucher.

– Activated: estado do voucher.

– Currency: moeda utilizada para o crédito.

30

Page 32: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– Expiration date: data de expiração para o voucher.

6.5.3­Criando vouchers em lote

Há a opção de criar vários vouchers em um único processo, bastando apenas indicar a quantidade de vouchers à criar, a valor que será associado, a moeda utilizada nos créditos e a data de expiração.

Esta opção chama­se “Adicionar Vouchers (em lote)” e está localizada no menu “Billing”.

31

Page 33: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

7­ Relatórios

O sistema disponibiliza uma série de relatórios que mostram de várias maneiras as chamadas efetuadas pelos clientes. Abaixo a descrição dos relatórios disponíveis.

Diversos filtros podem ser aplicados ao relatório, como: listar chamadas de apenas um cliente, chamadas em um determinado intervalo de meses, filtrar as chamadas através do Destino da rota ou filtrar através do número que originou a chamada.   Há   também   a   opção   de   fazer   uma   combinação   dos   diversos   filtros disponíveis.

7.1 ­ Relatório geral

Um dos principais relatórios do sistema é o Relatório geral. Nele conseguimos listar todas as chamadas efetuadas pelos clientes através do sistema, onde são mostradas as seguintes informações:

– Data da chamada– Origem– Número chamado– Destino– Duração– Cliente/Cartão– Status– $/min (compra)– $/min (venda)– Custo– Total– Tronco– Tarifa 

Caso o serviço de gravações(*) do asterisk estiver ativo, aparecerá também o ícone de um microfone, onde ao ser clicado é possível fazer o download da gravação da chamada correspondente. Você ainda pode remover a entrada no log clicando em “Apagar”.

32

Page 34: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

7.2 ­ Fatura

O relatório “Fatura”, apresenta vários dados e sub relatórios. Nele você pode ver o 'Serviço de Fatura', 'Evolução da Conta' e 'Detalhe das Ligações'.

No 'Serviço de Fatura' você pode ver um gráfico mostrando as ligações para destinos mais usados, com os dados de duração, número de ligações e  custo total.

No  'Evolução da Conta'  é  exibido  um gráfico   relacionando número de ligações e duração com os dias pedidos no relatório. Ainda é  exibido o dado do custo total.

No   'Detalhes   das   Ligações'   são   apresentados   detalhes   na   seguinte ordem:

– Data da ligação– Origem– Número chamado– Destino– Tempo– Cartão– Total

7.3 ­ Comparar Ligações

Apresenta um gráfico mostrando a utilização do sistema no decorrer no dia. Útil para verificar em quais horários há  uma maior demanda na utilização do sistema. Existe também a possibilidade de comparar o dia selecionado com os dias anteriores (“Quantidade de dias para comparar”).

7.4 ­ Tráfego mensal

Exibe um gráfico em pizza relacionando os meses anteriores e o atual com os minutos usados. Você pode escolher de 1 mês a 6 meses na opção “Quantidade de meses para comparar”.

7.5 ­ Tráfego diário

33

Page 35: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

Exibe um gráfico em pizza relacionando os meses anteriores e o atual com os minutos usados. Você pode escolher de 1 mês a 6 meses na opção “Quantidade de meses para comparar”.

7.6 ­ Relatório por cliente

Exibe um relatório por cliente com os seguintes dados para cada entrada:

– Usuário– Nome– Sobrenome– Tipo– Ligações– Valor de Venda– Valor de Compra– Lucro 

No fim do relatório mostra o total de ligações, de venda, de compra e de lucro.

34

Page 36: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

8 ­ Manutenção

8.1 ­ Backup / Download

A primeira opção aqui permite que se faça um backup em formato tar.gz da base de dados e do sistema de billing e cliente.

A segunda opção permite que se faça backup dos usuários do sistema em um arquivo xls. Algo como uma exportação dos dados dos usuários..

8.2 ­ Logs

Nessa opção você pode fazer o log de alguns arquivos de log do sistema.São eles:

– full: Log geral de uso do asterisk.

– revenda_pospago.log:  Log  de  desativacao  de   clientes  pos­pagos  quando  o revendedor associado fica com credito negativo.

– log_mudanca_plano.txt: Log de alteracao automatica de plano dos clientes ao atingirem determinado consumo em ligacoes celular.

– a2billing.log: Log de processamento do sistema billing.

– Master.csv:  CDR   de   chamadas.   Todas   as   chamadas   do   sistema   ficam registradas neste arquivo. Porém, NAO é  do billing, nao tem associacao com tarifas ou planos. 

8.3 ­ Teste de DTMF

Utilizado para testar se determinada operadora é capaz de fazer callback.

35

Page 37: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

8.4 ­ Customizar Layout do Cliente

Aqui é possível customizar certos aspectos da área do cliente. Para isso, é possível utlizar os seguintes recursos:

– Arquivo CSS: Efetue o upload de um arquivo CSS para alterar o estilo da área do cliente;

– Imagem do Topo:  Imagem que será  exibida  no  topo da página na área  do cliente.

8.5 ­ Configurações

8.5.1 ­ Chave de Acesso ao WebService

Configure essa chave para usar em aplicações externas que precisem de acesso ao billing.

8.5.3 ­ Exibição do tempo de chamadas 

Você pode configurar para que seja exibido o tempo real de conexão ou o tempo em blocos. Detalhe que pode ocorrer discrepância de tempo em comparação com   as   operadoras   se   usar   o   tempo   real,   pois   comumente   elas   configuram   a exibição por blocos de 30 (trinta) segundos.

8.5.4 ­ Configurações SMTP

Configurações utilizadas para o envio de e­mail do sistema.

36

Page 38: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

8.5.5 ­ Dados para emissão de Boleto(*)

Insira aqui os dados para a emissão de boletos diretamente pela área do cliente. Seguem abaixo os campos que devem ser configurados:– Banco: Selecione aqui o banco de sua preferência;– Número do Convênio: Número do convênio junto ao banco;– Número da Agência: Número da agência de seu banco;– Carteira: Número da carteira junto ao banco;– Taxa  do  Boleto:  Caso  houver,   insira   aqui   a   taxa   cobrada  pela  emissão  do 

boleto.– Instruções:  Instruções que serão impressas junto ao boleto (Ex: “Pagável em 

qualquer agência bancária.”);– Nome da sua Empresa,  Endereço,  Cidade,  Estado,  CPF:  Informações que 

aparecerão junto ao boleto.– Valores: Valores disponíveis que o cliente terá acesso para escolher.

8.5.6 ­ Pesonalizar os logos da Área Administrativa

Nesta   configuração   é   possível   fazer   o   upload   de   uma   imagem   que aparecerá na interface da área administrativa do Billing. Caso for necessário, existe também a opção de voltar o logo padrão do sistema, basta apenas clicar no botão “Voltar Logo Padrão”.

8.5.7. ­ Valor Mínimo para Fechamento Automático

Onde é determinado o valor mínimo do saldo gasto pelo cliente para a ativação automática do pagamento.  O  fechamento automático só  está  disponível para clientes pós­pago. Caso nenhum valor seja especificado o sistema utiliza o valor padrão de 150,00. Segue abaixo o campo que devem ser configurado:

– Valor: Valor mínimo para ativar o fechamento automático. Para valores decimais, utilizar o ponto (.) ao invés da virgula (,).

37

Page 39: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

9 ­ Monitoramento 

9.1 ­ Asterisk Console

9.1.1 ­ Usuários conectados SIP

Este relatório possibilita ver os usuários sip que estão conectados no momento. Para chegar nele entre em “Asterisk console” no menu “Manutenção”, em seguida clique em “Usuários conectados SIP”. No relatório você terá algo como:

– Nome/User do sipfriend– Cartão associado– Nome do cliente– IP do sipfriend– Porta de conexão– Se o reinvite está habilitado– Status   da   conexão   do   sipfriend   (tempo   em   milisegundos   da   conexão, 

desconhecido (UNKNOW),  inalcançável  (UNREACHABLE) ou não monitorado, quando o qualify está desabilitado nas configurações do sip friend).

– Reinvite   (siginifica  que o   tráfego de voz da  ligação não passa pelo  servidor, economizando processamento e banda, o que melhora a qualidade e diminui a latência. O reinvite só ocorre quando a chamada é atendida. Portanto, é normal constar reinvite='no' antes que a chamada seja completada.)

9.1.2 ­ Usuarios conectados IAX

Possibilita verificar os usuários IAX que estão conectados no momento. Para chegar nele entre em “Asterisk console” no menu “Manutenção”, em seguida clique em “Usuários conectados SIP”.

Um pouco mais  simples  que  o  anterior  ele  mostra  o  nome/username, ip/host, a máscara de rede, a porta em que se conecta e o status, assim como o anterior.

38

Page 40: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

9.1.3 ­ Chamadas em andamento: 

Nessa opção pode­se constatar quais as chamadas estão em andamento. Para chegar nele entre em “Asterisk console” no menu “Manutenção”, em seguida clique em “Usuários conectados SIP”. 

A saber temos: origem e o nome associado daquele que fez a chamada, O número discado pelo mesmo, o  tempo de  ligação ocorrido  até  o  momento,  o codec que está sendo utilizado pelo usuário, se o reinvite está ativado, o status do sip friend, e se deseja desligar/terminar com a ligação, útil no caso de uma ligação travada.

9.1.4 ­ Matar ligações e reiniciar Asterisk 

Cuidado com essa opção, use­a somente se tiver certeza do que está fazendo pois erros podem ocorrer em caso de travamento.

9.2 ­ Ping

Nessa página você pode fazer o teste de ping para qualquer servidor. O teste de ping compara o tempo de envio e resposta de pacotes pela internet. No caso de compara entre servidores voips, até 400ms é um tempo aceitável.

9.3 ­ Gráficos

O monitoramento é feito por gráficos, os quais mostram o uso do sistema em relação ao asterisk, ao uso do disco (hd), ao banco de dados (mysql), ao tráfego nas placas de rede, ao uso do e­mail no sistema (postfix), aos processos do sistema e ao próprio voip.

39

Page 41: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

10 ­ Revendas

10.1 ­ Revenda por Comissão

Revenda por Comissão é a forma de revenda utilizado atualmente, onde, ao   criar   o   revendedor,   o   administrador   deve   selecionar   os   tariffgroups   que   o revendedor poderá utilizar para seus clientes.

       Esse tipo de revenda é  baseado em comissão, portanto o lucro do revendedor é calculado com base na porcentagem de comissão definido na criação deste tipo de revenda.     Com relação aos créditos dos clientes,  nos pré­pagos o crédito  é  dado pelo revendedor e conforme o cliente utiliza vai descontando de seu saldo; assim que o saldo do cliente chega a zero ou é insuficiente para que o cliente realize uma ligação este deve contactar o revendedor para recarga de créditos.  Já  nos pós­pagos o revendedor define o limite que o saldo do cliente pode ficar negativo e não deve ser inserido créditos à ele para que ele fique com saldo positivo. Conforme o cliente faz ligações o crédito do revendedor é debitado, e se o saldo do revendedor chegar a zero todos clientes pós­pagos serão desativados automaticamente pelo sistema, por isso é importante que quando o revendedor trabalhar com clientes pós­pagos ele se mantenha sempre com saldo de créditos positivo.

10.1.1 ­ Adicionar Revenda Comissionada

Nessa área você irá criar uma nova Revenda Comissionada. Os campos diferentes da Revenda Master são:

– Login: "username" que o revendedor irá utilizar para acessar sua área no billing.– Senha: senha que será utilizada com o "username" informado no login.– %Comissão:  Insira a porcentagem de ganho do revendedor. Caso você defina 

uma   comissão,   ao  gerar   relatórios   tanto   você   quanto  o   revendedor   verão  o cálculo de lucro baseado no movimento de ligações dos clientes do revendedor e no movimento de créditos comprados. Você pode deixar 0 e assim o sistema não efetuará o cálculo dessas comissões.

– Créditos: Crédito inicial da revenda.

40

Page 42: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– Ver Ligações Detalhadas: Essa opção habilita, ou não, que o revendedor veja as ligações detalhadas de seus clientes.

– Acesso   ao   Asterisk   Console   (Monitoramento):  Permite   ao   revendedor observar em tempo real os usuários conectados e as chamadas em andamento dos mesmos.

– Ver Valor de Compra: O revendedor será capaz de ver o valor que você paga na compra das ligações. Normalmente você irá negar a ele essa informação.

– Pemissão de Criação: Define se, ao criar um cliente o revendedor poderá definir um   status  para   a   conta   do   cliente.   ativo,   pode   ser   usada   automaticamente, inativo, necessitará  ser ativada pelo administrador responsável e nenhum, não vai definir nenhum status para a conta do cliente.

– Campanhas de Áudio: Permite a revenda ativar campanhas de áudio para seus clientes.

– Campanhas de SMS:  Permite a revenda ativar campanhas de sms para seus clientes.

– Callcenter: Permite a revenda disponibilizar o callcenter para seus clientes.– Tariffgroup:  Define   quais   os   tariffgroups  que  o   revendedor   criado   irá   poder 

utilizar junto aos seus clientes.– A   partir   do   campo  Nome,   insira   os   dados   que   achar   necessário   para   a 

identificação de seu revendedor.

10.2 ­ Revenda­Master

Revenda que especifica o valor de venda. Ela é de certa forma autônoma, one ela não ganha uma comissão, já que ela mesma define por quanto irá revender (obtendo assim seu próprio lucro).

O funcionamento desta revenda deve proceder como descrito abaixo:         1 ­ O administrador deve criar Ratecards para servirem de modelo 

para o dos revendedores.      OBS1: A criação do Ratecard modelo é igual a de qualquer Ratecard. 

O  preço  de  venda  especificado  nas   tarifas  deste  Ratecard  será   o  preço  que  o revendedor vai pagar ao administrador.

           OBS2: Após ter sido criado o Ratecard modelo, quando for  feita alguma alteração nele (preço de compra, billingbllock, ou qualquer outro campo), o sistema atualizará todas as tarifas que foram originadas a partir daquele modelo.

2 ­ Agora é necessário criar um novo revendedor (utilizar a nova opção de criação de revendedores). Nele o administrador deve especificar quais os modelos 

41

Page 43: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

de   Ratecard   (tarifas)   que   o   revendedor   terá   acesso   para   poder   criar   as   suas próprias.

Pronto, a nova revenda está criada, agora vamos para a área do novo revendedor:

1­ A primeira coisa que o revendedor deve fazer é abrir o menu "Tarifas" e selecionar a opção "Criar novo Ratecard". Nele o revendedor especificará o nome do ratecard e qual ratecard modelo será usado. 

          2   ­  Ao  criar  um novo   ratecard  o   revendedor   será   redirecionado automaticamente  para  a   área  de edição  de   tarifas   (o  novo  ratecard  criado pelo revendedor já estará selecionado e pronto para que ele defina o valor de venda).

3 ­ O revendedor deve definir qual o preço de venda, por padrão será igual ao preço de compra até que um valor seja definido. Ele pode editá­las uma a uma através do botão editar de cada tarifa ou editar várias de uma vez através do campo "Preço de venda" no fim da página.

4 ­ Com os ratecards criados e o preço de venda das tarifas definidos, o revendedor  deve criar  um novo   tariffgroup através do menu "Criar   tariffgroup"  e selecionar quais ratecards fazem parte deste tariffgroup. 

Pronto,   com   os   tariffgroups   criados   o   revendedor   já   pode   criar   seus clientes com os seus próprios tariffgroups. Sempre que um de seus clientes efetuar uma ligação o valor tarifado será aquele que o revendedor definiu.   Com relação aos créditos dos clientes, a revenda­master pode creditar livremente seus clientes, e toda ligação que eles fizerem, quer seja pré­pago ou pós­pago, será reduzido do saldo atual da revenda­master. Se o saldo ficar igual ou menor que zero o sistema desativará todos os clientes do revendedor, portanto é importante que o revendedor mantenha seu saldo de créditos sempre com valor positivo.

10.2.1 ­ Adicionar Revenda Master

Nessa área você   irá  criar uma nova Revenda Master. Os campos para preenchimento são:

– Login: "username" que o revendedor irá utilizar para acessar sua área no billing.– Senha: senha que será utilizada com o "username" informado no login.– Créditos: Crédito inicial da revenda.

42

Page 44: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– Ver Ligações Detalhadas: Essa opção habilita, ou não, que o revendedor veja as ligações detalhadas de seus clientes.

– Acesso   ao   Asterisk   Console   (Monitoramento):  Permite   ao   revendedor observar em tempo real os usuários conectados e as chamadas em andamento dos mesmos.

– Pemissão de Criação: Define se, ao criar um cliente o revendedor poderá definir um   status  para   a   conta   do   cliente.   ativo,   pode   ser   usada   automaticamente, inativo, necessitará  ser ativada pelo administrador responsável e nenhum, não vai definir nenhum status para a conta do cliente.

– Campanhas de Áudio: Permite a revenda ativar campanhas de áudio para seus clientes.

– Campanhas de SMS:  Permite a revenda ativar campanhas de sms para seus clientes.

– Gera Boleto: Permite a revenda gerar boletos com dados próprios.– Callcenter: Permite a revenda disponibilizar o callcenter para seus clientes.– Modelo de Tarifa: Aqui você vai definir qual o modelo de tarifa que será aplicada 

a essa revenda.– A   partir   do   campo  Nome,   insira   os   dados   que   achar   necessário   para   a 

identificação de seu revendedor.

10.3 ­ Listar Revenda Master/Comissionada

Nesta opção você pode consultar as revendas já criadas em seu sistema. Para isso clique em Listar Comissionadas ou Listar Masters para que seja exibida a listagem. Caso seja necessário alguma alteração, é possível utilizar o botão “editar” ou caso necessário remover uma revenda basta utilizar o botão “deletar”.

10.4 Deletar Revenda

Ao deletar uma revenda, todos os dados referentes a ela serão apagados de maneira irreversível , ou seja, cartões, configurações (SMTP, Boleto, etc), planos e grupos de tarifas, tarifas, créditos e pagamentos.

43

Page 45: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

11 ­ Configuração dos Administradores11.1 ­ Adicionar

Crie seus administradores aqui, tenha por preferência preencher todos os campos.

11.2 ­ Adicionar Admin Parcial

Você pode também criar administradores parciais que podem "administrar" apenas certas configurações de seu servidor. Seguem os campos necessários para o cadastro de um administrador parcial:– Login: "username" que o administrador parcial irá utilizar para acessar sua área 

no billing.– Senha: senha que será utilizada com o "username" informado no login.– Permissões:  aqui são definidas quais as áreas que este administrador parcial 

terá acesso. As opções são:– Clientes:  tem   permissão   de   acesso   e   configuração   no   menu 

“Clientes”.– Billing: tem permissão de acesso e configuração no menu “Billing”.– Tarifas: tem permissão de acesso e configuração no menu “Tarifas”.– Troncos:  tem   permissão   de   acesso   e   configuração   no   menu 

“Troncos”.– Relatórios: tem permissão para acessar o menu “Relatórios”.– Execuções Periódicas:  tem permissão de acesso e configuração no 

menu “Execuções Periódicas”.– Administradores: tem permissão de acesso e configuração no menu 

“Adminstradores”.– Revenda:  tem   permissão   de   acesso   e   configuração   no   menu 

“Revendas”.– Manutenção:  tem   permissão   de   acesso   e   configuração   no   menu 

“Manutenção”.– Monitoramento:  tem permissão de acesso e configuração no menu 

“Monitoramento”.– Permissão  para  Creditar:  define   se  este  administrador   parcial   pode  efetuar 

créditos aos clientes.

44

Page 46: Manual Sistema VoIP Virgos - Centro de Suportesuporte.virgos.com.br/downloads/manual.pdf · Manual – Sistema Voip Virgos – Versão Tarifador Atualização: 10/12/10 Introdução

Manual – Sistema Voip Virgos – Versão Tarifador

Atualização: 10/12/10

– Callcenter(*): define se este administrador parcial pode liberar o callcenter aos clientes.

– Nome, Endereço, CEP, Estado, Telefone, Fax: insira nestes campos os dados cadastrais que você julgar importantes.

11.3 ­ Listar Admin e Admin Parcial

Aqui   você   pode   listar   os   admnistradores   bem   como   editar   suas configurações ou deletá­los.

45