You are on page 1of 46

MANUAL DE GERENCIAMENTO SISTEMA VOIP VIRGOS (TARIFADOR)

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Sumrio
Introduo..............................................................................................................3 1 Viso Geral......................................................................................................4 2 Cadastrando Clientes.......................................................................................8
2.1- Criando contas no sistema......................................................................................................................... 8 2.2-Criando um acesso SIP/I ! "n#mero $oi%&............................................................................................. 12

3 Cadastrando 'roncos "(%eradoras&...............................................................1)


3.1 - Cadastrando as in*orma+es de cone,o %ara um tronco "i%-usu.rio- sen/a- etc...& ...................................................................................................................................................................... 1) 3.2 Cadastrando o tronco............................................................................................................................. 1)

4 'ari*ao........................................................................................................18
4.1 0escrio 1eral...................................................................................................................................... 18 4.2 'ari**1rou%............................................................................................................................................ 18 4.2.1 Criando um Tariffgroup......................................................................................................................18 4.2.2 Listando Tariffgroup's cadastrados....................................................................................................19 4.2.3 Associando um Tariffgroup a um cliente............................................................................................19 4.3 2atecard................................................................................................................................................ 13 4.3.1 Criando um Ratecard..........................................................................................................................19 4.3.2 Listando Ratecard's cadastrados........................................................................................................2 4.3.3 Associando um Ratecard a um Tariffgroup........................................................................................2 4.4 'ari*as "rotas&........................................................................................................................................ 24 4.4.1 Criando uma Tarifa............................................................................................................................21 4.4.2 Listando e editando tarifas e!istentes.................................................................................................22 4.5 - Im%ortando uma ta6ela de tari*as de uma %lanil/a..................................................................................22

5 - 1endamento de tare*as %ara d76ito/cr7dito de clientes %eriodicamente......2) ) - 8illin1.............................................................................................................23


).1 - Creditando um cliente............................................................................................................................ 23 ).2 - Cadastrando %a1amentos e*etuados %elos clientes.................................................................................. 23 ).3-Visuali9ando %a1amentos......................................................................................................................... 23 ).4-Veri*icando a situao *inanceira dos clientes..........................................................................................23 ).5-Vouc/ers................................................................................................................................................. 34 ".#.1$%escri&'o...............................................................................................................................................3 ".#.2$Criando um (ouc)er.............................................................................................................................3

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10 ".#.3$Criando *ouc)ers em lote......................................................................................................................31

:- 2elat;rios........................................................................................................32
:.1 - 2elat;rio 1eral....................................................................................................................................... 32 :.2 - <atura.................................................................................................................................................... 33 :.3 - Com%arar =i1a+es................................................................................................................................ 33 :.4 - 'r.*e1o mensal...................................................................................................................................... 33 :.5 - 'r.*e1o di.rio........................................................................................................................................ 33 :.) - 2elat;rio %or cliente............................................................................................................................... 34

8 - >anuteno....................................................................................................35
8.1 - 8ac?u% / 0o@nload............................................................................................................................... 35 8.2 - =o1s....................................................................................................................................................... 35 8.3 - 'este de 0'><...................................................................................................................................... 35 8.4 - Customi9ar =aAout do Cliente................................................................................................................ 3) 8.5 - Con*i1ura+es........................................................................................................................................ 3) 8.#.1 $ C)a*e de Acesso ao +e,-er*ice.........................................................................................................3" 8.#.3 $ .!i,i&'o do tempo de c)amadas ........................................................................................................3" 8.#.4 $ Configura&/es -0T1...........................................................................................................................3" 8.#.# $ %ados para emiss'o de 2oleto345.......................................................................................................36 8.#." $ 1esonali7ar os logos da 8rea Administrati*a.....................................................................................36 8.#.6. $ (alor 09nimo para :ec)amento Autom;tico.....................................................................................36

3 - >onitoramento ..............................................................................................38
3.1 - steris? Console.................................................................................................................................... 38 9.1.1 $ <su;rios conectados -=1.....................................................................................................................38 9.1.2 $ <suarios conectados =A>....................................................................................................................38 9.1.3 $ C)amadas em andamento? .................................................................................................................39 9.1.4 $ 0atar liga&/es e reiniciar Asteris@ ....................................................................................................39 3.2 - Pin1....................................................................................................................................................... 33 3.3 - Gr.*icos................................................................................................................................................. 33

14 - 2e$endas......................................................................................................44
14.1 - 2e$enda %or Comisso......................................................................................................................... 44 1 .1.1 $ Adicionar Re*enda Comissionada.....................................................................................................4 14.2 - 2e$enda->aster................................................................................................................................... 41 1 .2.1 $ Adicionar Re*enda 0aster................................................................................................................42 14.3 - =istar 2e$enda >aster/Comissionada.................................................................................................. 43 14.4 0eletar 2e$enda..................................................................................................................................... 43

11 - Con*i1urao dos dministradores..............................................................44


11.1 - dicionar............................................................................................................................................. 44 11.2 - dicionar dmin Parcial...................................................................................................................... 44 11.3 - =istar dmin e dmin Parcial.............................................................................................................. 45

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Introduo
Este manual apresenta as principais funcionalidades do sistema Voip Virgos, verso tarifador. O sistema baseado no software a2billing (www.asterisk2billing.org) e distribudo sob licena GPL, assim como o original. No tratado neste documento passos para instala o do sistema e sim para o seu gerenciamento. Esta documentao, desenvolvida pela Virgos, pode ser distribu da gratuitamente, desde que mantida sua forma e a referncia empresa-autora. Verifique sempre a ltima verso disponvel deste documento em http://suporte.virgos.com.br/downloads/manual.pdf Customizaes, consultorias, treinamentos e outros servi os sempre podem ser solicitados conosco. O contato pode ser feito via: Virgos Tecnologia da Informao S/S Episcopal, 1763 So Carlos - SP (16) 2107-8647 www.virgos.com.br

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

1 Viso Geral
O sistema trabalha basicamente com o cadastramento de troncos de sada para as chamadas, rotas e clientes. possvel trabalhar com vrias operadoras simultaneamente no sistema, onde cada operadora ser um tronco no sistema. O que torna isto possvel o cadastramento de rotas no sistema, rotas so definidas atrves de prefixos de discagem e para cada rota definimos um tronco de sada. 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 relao entre cliente, rotas e troncos.

No cadastro de clientes, cadastrado primeiramente uma conta que detm as informaes do cliente, como: nome, endere o, enfim, os dados cadastrais do cliente. nesta conta que atribumos os crditos ao cliente. Para cada conta existente podemos criar vrios nmeros voip, estes conhecidos no sistema como sip/iax-friends. Os termos SIP e IAX indicam o protocolo de comunicao utilizado pelo dispositivo (ata, softphone, voipphone) utilizado na comunicao. Observamos tambm no digrama acima outros dois termos: tariffgroup e ratecard.

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Os ratecard's so 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, poderamos por exemplo, criar um plano com tarifas reduzidas para clientes empresariais e manter clientes residenciais em um tariffgroup com tarifao comum. Abaixo apresentado outro diagrama, agora demonstrando o funcionamento do sistema com um cadastramento b sico de clientes, rotas e troncos.

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 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 ligao o ATA enviar nmero discado para o servidor. 2 - O sistema verificar ento 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 comparao do nmero discado pelo cliente com todas as tarifas existentes nos ratecard's atribudos ao tariffgroup Empresarial, vale ressaltar que sempre ser selecionada a tarifa que seja mais completa em rela o ao nmero discado pelo usurio. Por exemplo, caso o usurio disque 01140634771, ser procurada por tarifas cujo prefixo definido seja 01140634771, caso no exista, sero procuradas por tarifas 6

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 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 ento enviar a chamada para o tronco correspondente a tarifa selecionada. 5 - Chegamos ento ao final do processo, onde j sabemos para qual tronco enviar a ligao. Basta agora resgatarmos as informa es de autenticao do tronco escolhido, tais informaes esto 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.

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 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 descrio dos campos disponveis no formulrio de cadastro:

Nmero: Nmero gerado automaticamente pelo sistema, cdigo nico para identificao da conta Apelido: o nome de usurio utilizado para o cliente acessar a interface de consulta de saldo desta conta. Este campo s aceita caracteres numricos. Senha via Web: Senha utilizada para acesso a interface de consulta de saldo. Crdito: Este campo possibilita definir um crdito inicial para o cliente, porm o sistema no contabiliza o valor como um crdito a ser pago pelo cliente. Aviso de crdito: Valor para o aviso de crdito baixo. Revendedor: Este campo determina quem este cliente pertence. Caso seja selecionado algum revendedor, ele ter acesso a este cliente. Lngua: idioma do cliente. Tariffgroup: Neste campo definido qual tariffgroup o cliente utilizar para efetuar suas ligaes. 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

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Callcenter(*): Este campo define se este cliente tem acesso ao Callcenter. Ativo: estado da conta, possveis valores:

sim: conta ativada, ligaes feitas normalmente (caso o cliente tenha crditos). no: conta desativada, utilizao da conta bloqueada.

Acesso simultneo: Defina se esta conta poder realizar mais de um acesso simultneo. Moeda: moeda corrente do cliente. Executar tarefas peridicas: o sistema permite o agendamento de tarefas de dbito, caso exista alguma, defina aqui se tais tarefas ser o aplicadas nesta conta. Tipo: tipo de conta, Pr-Pago ou Ps-Pago. Limite de Crdito: Caso a conta seja do tipo ps-pago, deve-se definir aqui um limite de utilizao de crdito. Data primeiro uso: data da primeira utilizao da conta. Inserido automaticamente pelo sistema. Data da ltima chamada realizada: data da ltima vez que o cliente efetuou uma chamada. Inserido automaticamente pelo sistema. Ativar expirao: possvel definir uma data para expirao da conta. As seguintes opes esto disponveis:

No expirar: A conta nunca expira.

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Expirar em uma data: a conta expira na data informada no campo data de expirao. Expirar alguns dias aps o primeiro uso: A conta expira aps o nmero de dias informado no campo dias para expirar, contando ap s o data do primeiro uso. Expirar alguns dias aps a criao: Expira a conta aps o nmero de dias informado no campo dias para expirar, contando ap s a data de criao (cadastro).

Data de expirao: Defina uma data de expirao para a conta, se o campo Ativar expirao estiver ativo. Dias para expirar: Defina o nmero de dias para a conta expirar, calculo baseado na definio do campo Ativar expirao. 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. Endereo: Endereo do cliente. Bairro: Bairro do cliente. Cidade: Cidade do cliente. Estado: Estado do cliente. Pas: Pas do cliente. 10

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

CEP: CEP do cliente. DDD: rea do telefone do cliente. Informando a rea local, o cliente no 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 necessrio fazer contato. FAX: Fax do cliente. Documento (CPF/CNPJ): CPF/CNPJ do cliente. Empresa: Nome da empresa do cliente. Inscrio Estadual: Nmero da inscrio estadual do cliente. Em uso: Usado para debug, este valor ser maior que 0 se o carto estiver em uso. Caso a aplicao trave por algum motivo ento o ficara marcado como >0. Neste caso, pode-se marcar de volta ao 0 para liberar o uso futuro. Gravao(*): Ativar a gravao de chamadas para este cliente. Data do ltimo Fechamento: Data em que ocorreu o ltimo fechamento da conta deste cliente. Inserido automaticamente pelo sistema. Perodo de Fechamento: Perodo de dias entre cada fechamento. Dispon vel apenas se a conta for do tipo ps-paga. Perodo de Vencimento: Perodo de dias para vencimento do boleto. Dispon vel apenas se foi selecionado um Perodo de Fechamento. 11

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Observaes: Campo livre onde pode ser inserido observa es sobre o cliente.

(*) - Necessrio adquirir estes servios. Entre em contato com nosso Setor Comercial para maiores detalhes.

2.2-Criando um acesso SIP/IAX (nmero 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 IAXfriend (para um dispositivo que utilize o protocolo IAX).

Name: identificao do acesso. atravs deste nmero que o acesso receber chamadas. Tipo: tipo de sip-friend, no caso de clientes utilize o padr o friend, a definio peer utilizada somente no cadastramento de operadoras. Username: nome de usurio que ser utilizado para este acesso se autenticar no sistema. Normalmente igual a 'name'. Carto associado: nmero da conta qual este acesso ser associado. Regexten: Se for preenchido deve ser igual ao username. Callerid: Identificao do usurio, a que aparece na BINA. Amaflags: Deixe como 'billing' para as chamadas serem registradas. Senha: senha que ser utilizada para autenticao deste acesso no sistema. MD5Secret: Senha pr-criptografada (quase no usado). NAT: defina se o dispositivo que utilizar este acesso esta em uma rede que utilize NAT. 12

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

DTMFMode: Deixe como RFC2833. Qualify: se habilitada, o sistema ir fazer uma verificao do status deste acesso regularmente. Se a latncia 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 trfego do sistema. Disallow: Codecs que no sero permitidos, deixe como 'all'. Allow: define quais codecs podero ser utilizados por este acesso. Os codecs mais conhecidos esto definidos em ordem de prioridade. Host: Deixe dynamic no caso de usurios com ip dinmico. 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 usurio que vc usa para conectarse nela. Fromdomain: Fora um domnio nas mensagens entre os SIPs. Insecure: Define como manipular a conexo entre os peers. Normalmente 'no' (default) para SIPs e pode ser 'very' para alguns troncos/operadoras. 13

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Language: Cdigo de duas letras indicando o pas, isto influencia nos toques e tons usados. Para o Brasil br, normalmente fica em branco. Mailbox: Extenso do VoiceMail, vlido 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. necessrio que a extenso *8 esteja configurada corretamente. Port: Porta em que o SIP responde. Restrictcid: No usado. RTPTimeout: Termina uma chamada se houver mais de N segundos de inatividade na chamada quando o telefone n o estiver em espera. Vlido 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 no usado aqui. Regseconds: Nmero 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, vlido para conexes em tempo real. Deixe em branco. CanCallForward: Deixe em yes. DDD: Cdigo da rea deste SIP/IAX. Call-limit: Limite de chamadas que este SIP/IAX pode efetuar simultaneamente. 14

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

15

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

3 Cadastrando Troncos (Operadoras)


3.1 - Cadastrando as informaes de conexo para um tronco (ip,usurio, senha, etc...)
Este cadastro normalmente utilizado para troncos que fazem autenticao atravs de usurio e senha. Para este cadastro insira um SIP client (veja em 2.2-Criando um acesso SIP/IAX (nmero voip)). Abaixo a descrio dos campos necessrios.

Name: nome para identificao 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 usurio fornecido pela operadora. Caso a autenticao seja feita atravs do IP do servidor, deixe este campo em branco. Senha: insira a senha oferecida pela operadora. Caso a autentica o seja feita atravs do IP do servidor, deixe este campo em branco. Qualify: Defina se o sistema deve fazer uma verificao regularmente do status da operadora. Algumas operadoras n o suportam este parmetro, se este for o caso defina 'no' neste campo. Host: insira o IP ou o domnio da operadora. Fromuser: Defina o mesmo valor informado no campo username.

3.2 Cadastrando o tronco


16

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Para criar um novo tronco, clique em Adicionar localizado no menu Troncos. Abaixo a descrio dos campos utilizados:

Cdigo do tronco: insira um nome para identificao deste tronco. Adicionar prefixo: algumas operadoras necessitam do prefixo '011' antes do nmero discado, este campo possibilita que o prefixo seja adicionado automaticamente ao nmero discado (*). Remover prefixo: remove um ou mais dgitos discados pelo usurio. Protocolo: Tipo de protocolo usado para conectar-se ao tronco. Sua operadora lhe fornecer este parametro. Os valores possveis so: 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 domnio caso a operadora possua a facilidade de autenticao atravs do IP. Parametros Adicionais: Usados nos comandos Dial do asterisk. Geralmente no necessrio. Tronco secundrio, 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 no consiga completa-las. Crdito no tronco: usado para controlar quanto crdito voc tem com a operadora. Conforme as ligaes sarem pelo tronco o crdito diminui. Quando voc colocar mais crditos na operadora voc atualiza aqui. Este campo serve apenas para seu controle no influenciando no sistema de tarifas.

17

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

4 Tarifao 4.1 Descrio geral


A tarifao constituda por 3 elementos, tariffgroup's, ratecard's e tarifas, onde os tariffgroup' so os planos de venda do sistema, a cada cliente do sistema associado um tariffgroup. Associamos ento a um tariffgroup um ou mais ratecard's, que so grupos de tarifas. Inserimos ento, dentro dos ratecard's, as tarifas, que so uma definio 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 descrio do formulrio de cadastro de um tariffgroup.

Nome: defina o nome do Tariffgroup. 18

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Tipo: este campo define como o sistema deve agir quando encontrar duas rotas iguais, porm com tarifas diferenciadas. As opes so: 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 informaes. possvel editar e apagar qualquer tariffgroup criado clicando nos botes 'editar' e 'deletar'. 4.2.3 Associando um Tariffgroup a um cliente. A associao dos clientes com os Tariffgroup's feita editando o cadastro no cliente (menu Clientes, Lista de Clientes/Cartes) 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

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Data inicial: inicio da validade deste Ratecard. Data final: final da validade do Ratecard. Tronco: define-se um tronco padro para as tarifas que estaro dentro do Ratecard. Porm isso no 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. Descrio: apenas um campo para comentrios explicativos do ratecard. No obrigatrio. DNID: no deve ser alterado o valor padro.

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 informaes. possvel editar e apagar qualquer ratecard criado clicando nos botes 'editar' e 'deletar'. 4.3.3 Associando um Ratecard a um Tariffgroup Isto feito na edio do Tariffgroup em que o Ratecard ser associado. Um tariffgroup pode possuir uma lista de ratecard associados, que tamb m so conhecidos como tariffplan's. Na edio do tariffgroup temos a lista de ratecards associados, pode-se remover os ratecards j associados e associar novos ratecards.

4.4 Tarifas (rotas)

20

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 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 ligaes (prefixos), qual operadora utilizar e os valores praticados para cada destino. Abaixo a descri o dos campos do formulrio de cadastro da tarifa:

Ratecard: defina a qual ratecard a tarifa deve ser inserida. Prefixo de Discagem: defina o prefixo da rota. possvel criar tanto rotas mais abrangentes e rotas mais especificas, dependendo da necessidade de diferenciao na tarifao. Por exemplo, poderamos 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 especficas que determinem essa diferena, alguns exemplos: 55119, 55118, 55219 e 55218. Destino: uma descrio para a rota, ex: Brasil. Por quanto voc compra: defina o valor pago na rota operadora. Tempo mnimo que voc paga na chamada : defina o tempo mnimo de tarifao aplicado pela operadora. Ex: Uma operadora que aplique uma tarifa nos primeiros 30 segundos, aps isso a cada 6 segundos. Em blocos de quantos segundos voc paga: o perodo de tempo em que a tarifa aplicada aps a tarifao mnima. Quanto voc cobra?: O valor que ser aplicado ao cliente nesta rota. Tempo mnimo de tarifao: o tempo mnimo em que a tarifa ser aplicada ao cliente. De quantos em quantos segundos voc tarifa o cliente : defina o perodo em que ser feita a tarifao no cliente aps o perodo mnimo. 21

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Custo por conexo: possibilita tarifar o cliente na conexo da chamada, alm do tempo total utilizado. Custo por desconexo: possibilita tarifar o cliente na desconexo da chamada, alm do tempo total utilizado. Data inicial: data de inicio do perodo de validade da tarifa. Data final: data final do perodo da validade da tarifa. Dias de semana: dias da semana em que a tarifa ser vlida. Tronco: define para qual tronco a chamada deve ser redirecionada. Msica de espera: altera o tom de discagem para uma m sica. O valor No music on hold mantm o tom de discagem convencional.

4.4.2 Listando e editando tarifas existentes Aps o cadastramento das tarifas, alteraes podero ser feitas atrves do menu Editar Ratecard, localizado no menu Tarifas. Um campo de seleo 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 botes. Os campos so os mesmos da criao da tarifa.

4.5 - Importando uma tabela de tarifas de uma planilha


O sistema oferece tambm, 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 55168 So Carlos-Fixo So Carlos-Celular 0.1 30 0.5 30 6 6 0.05 0.30 30 30 6 6 22

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

55169 So Carlos-Celular 0.5 30 5511 So Paulo-Geral 0.08 30 5516 Rio de Janeiro-Geral 0.08 30

6 6 6

0.30 0.04 0.04

30 30 30

6 6 6

Temos ento uma tabela com algumas rotas definidas. Veja que foram definidos os mesmos campos do cadastramento comum de uma tarifa, s o eles: prefixo, destino, preo de venda, tempo mnimo de venda, tempo adicional de venda, preo de compra, tempo mnimo de compra e tempo adicional de compra. O ltimo passo na preparao da tabela salv-la no formato de arquivo csv. Para isso, utilizamos a opo 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 opo Texto CSV, edite as configuraes 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 so descritos abaixo:

Escolha qual ratecard quer importar: Selecione o ratecard em que as tarifas da tabela sero importadas. Tronco a usar: Determine qual ser o tronco de sada para as tarifas.

Em seguida devemos informar como as informa es esto dispostas no arquivo csv. As primeiros 3 colunas do arquivo j esto pr-selecionadas e so campos obrigatrios para a importao, so eles:

Dialprefix: prefixo de discagem (ex.: 5511). Destination: uma descrio para a tarifa (ex.: Brasil So Paulo). Rate intial: o preo de venda aplicado na rota. Na seqncia, podemos informar alguns dados opcionais, como: 23

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Buyrate: o preo de compra para rota. Buyrateinitblock: tempo mnimo de compra aplicado na rota. Buyrateincrement: o tempo adicional de compra aplicado na rota. Initblock: tempo mnimo de venda aplicado na rota. Billingblock: tempo adicional de venda aplicado na rota. Connect charge: taxa de conexo. Disconnect charge: taxa de desconexo.

Considerando a utilizao de arquivo seguindo o modelo aqui apresentado, teramos a seguinte seqncia a determinar.

campos obrigatrios 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 boto 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 importao' para finalizar o processo. 24

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

25

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

5 - Agendamento de tarefas para dbito/crdito de clientes periodicamente


Esta uma funcionalidade em que podemos agendar tarefas para realizar dbito ou crdito dos clientes automaticamente, em um intervalo de tempo determinado. Para criar uma tarefa peridica, v em Adicionar Tarefas no menu Execues Peridicas, abaixo a descrio dos campos disponveis 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 so:

valores positivos: debita crditos das contas atingidas pela execuo. valores negativos: credita as contas atingidas pela execu o.

Ao no carto: Nesta opo possvel escolher se o carto do cliente deve ser desativado e se seus crditos sero retirados quando ele for afetado pela tarefa peridica. As opes so:

Apenas retirar os crditos acima inseridos. Apenas desativar o carto sem retirar os crditos. Desativar e retirar os crditos acima inseridos. Retirar todos os crditos acima inseridos.

PeriodicidadeB 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 opo Todo dia X do ms no item anterior, deve-se indicar neste campo em qual dia ela ser executada. Regra: determinar tambm que a tarefa somente seja executada caso a regra aqui definida seja verdadeira, as opes so:

O usurio no usa o carto desde N dias. 26

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10


O usurio usou o carto nos ltimos N dias. Recarga de crditos no realiazada nos ltimos N dias. Carto possui apenas 1 sip-friend. Carto possui 2 ou mais sip-friends. Apenas neste tariffgroup. Movimentao em aberto vencido por N dias. Usurio efetuou menos de N recargas no ms passado.

Nmero de dias: campo utilizado para definio 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 Usurio efetuou menos de N recargas no ms passado, deve-se definir neste campo o nmero de recargas que ser utilizada. Parar de executar: No executa a tarefas nos clientes que se encaixem da regra aqui definida

Nunca. O crdito da conta chegou a zero. Mximo de execues alcanado.

Mximo de execues por carto: determina o valor para o campo mximo de execues alcanado, da opo parar de executar. Tipos dos cartes: Este campo define o tipo do carto que a tarefa ir afetar. Suas opes so:

Pr-pago; Ps-pago; Ambos.

Status: estado da tarefa, ativa ou inativa. E-mail para envio de relatrio: indique um envio de um relatrio contendo os resultados da execuo da tarefa. 27

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

OBS: a tarefa somente ser aplicada aos clientes que estiverem com a opo Executar tarefas peridicas ativada em seu cadastro.

28

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

6 - Billing
6.1 - Creditando um cliente
Para creditar um cliente, v em Creditar cliente, localizado no menu Billing. Indique o nmero do cliente e a quantia a ser creditada. Pode ser inserido tambm um comentrio junto ao crdito que est sendo efetuado. Em seguida clique em Creditar valor ao carto 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, alm de ser possvel tambm inserir um comentrio sobre o pagamento. possvel escolher o username do cliente clicando no boto laranja, onde ser exibida uma lista para seleo.

6.3-Visualizando pagamentos
Nesta opo, 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 servio de boletos(*), aparecer tambm o campo Status do pagamento, que indica se o boleto j est pago ou confirmar.

6.4-Verificando a situao financeira dos clientes


Nesta tela podemos visualizar todas as informa es relacionadas a questes financeiras para cada cliente do sistema. A op o chama-se Situao Financeira e esta localizada no menu Billing. Temos ento 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

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Em detalhes podemos visualizar a data e valor de cada cr dito e pagamento efetuado pelo cliente. OBS: o campo crdito definido no cadastro do cliente, n o consta como valor pagar para o cliente.

6.5-Vouchers
6.5.1-Descrio Vouchers podem ser comparados com os cartes de recarga de celulares pr-pagos, onde atravs de um cdigo digitado do celular o cliente automaticamente creditado. O sistema gera um cdigo de voucher aleatrio, para o qual definido um valor de crdito. O cliente que possuir este cdigo poder digita-lo na interface de consulta de saldo para obter os crditos. Consideraes sobre Vouchers: - um voucher s poder ser utilizado uma nica vez. - somente sero aceitos os cdigos cadastrados no sistema e seu status estiver como Ativo. - aps sua utilizao o voucher automaticamente desativado. 6.5.2-Criando um Voucher Para criar um voucher, v em Adicionar Voucher, localizado no menu Billing. Abaixo a descrio dos campos:

Voucher: cdigo aleatrio gerado para o voucher. Credit: crdito associado a este voucher. Activated: estado do voucher. Currency: moeda utilizada para o crdito. 30

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Expiration date: data de expirao para o voucher.

6.5.3-Criando vouchers em lote H a opo de criar vrios vouchers em um nico processo, bastando apenas indicar a quantidade de vouchers criar, a valor que ser associado, a moeda utilizada nos crditos e a data de expirao. Esta opo chama-se Adicionar Vouchers (em lote) e est localizada no menu Billing.

31

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

7- Relatrios
O sistema disponibiliza uma srie de relatrios que mostram de vrias maneiras as chamadas efetuadas pelos clientes. Abaixo a descri o dos relatrios disponveis. 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 atravs do Destino da rota ou filtrar atravs do nmero que originou a chamada. H tambm a opo de fazer uma combinao dos diversos filtros disponveis.

7.1 - Relatrio geral


Um dos principais relatrios do sistema o Relatrio geral. Nele conseguimos listar todas as chamadas efetuadas pelos clientes atrav s do sistema, onde so mostradas as seguintes informaes: Data da chamada Origem Nmero chamado Destino Durao Cliente/Carto Status $/min (compra) $/min (venda) Custo Total Tronco Tarifa Caso o servio de gravaes(*) do asterisk estiver ativo, aparecer tambm o cone de um microfone, onde ao ser clicado possvel fazer o download da gravao da chamada correspondente. Voc ainda pode remover a entrada no log clicando em Apagar.

32

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

7.2 - Fatura
O relatrio Fatura, apresenta vrios dados e sub relatrios. Nele voc pode ver o 'Servio de Fatura', 'Evoluo da Conta' e 'Detalhe das Ligaes'. No 'Servio de Fatura' voc pode ver um grfico mostrando as ligaes para destinos mais usados, com os dados de dura o, nmero de ligaes e custo total. No 'Evoluo da Conta' exibido um grfico relacionando nmero de ligaes e durao com os dias pedidos no relatrio. Ainda exibido o dado do custo total. No 'Detalhes das Ligaes' so apresentados detalhes na seguinte ordem:

Data da ligao Origem Nmero chamado Destino Tempo Carto Total

7.3 - Comparar Ligaes


Apresenta um grfico mostrando a utilizao do sistema no decorrer no dia. til para verificar em quais horrios h uma maior demanda na utilizao do sistema. Existe tambm a possibilidade de comparar o dia selecionado com os dias anteriores (Quantidade de dias para comparar).

7.4 - Trfego mensal


Exibe um grfico em pizza relacionando os meses anteriores e o atual com os minutos usados. Voc pode escolher de 1 ms a 6 meses na opo Quantidade de meses para comparar.

7.5 - Trfego dirio


33

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

Exibe um grfico em pizza relacionando os meses anteriores e o atual com os minutos usados. Voc pode escolher de 1 ms a 6 meses na opo Quantidade de meses para comparar.

7.6 - Relatrio por cliente


Exibe um relatrio por cliente com os seguintes dados para cada entrada:

Usurio Nome Sobrenome Tipo Ligaes Valor de Venda Valor de Compra Lucro No fim do relatrio mostra o total de ligaes, de venda, de compra e de

lucro.

34

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

8 - Manuteno
8.1 - Backup / Download
A primeira opo aqui permite que se faa um backup em formato tar.gz da base de dados e do sistema de billing e cliente. A segunda opo permite que se faa backup dos usurios do sistema em um arquivo xls. Algo como uma exportao dos dados dos usurios..

8.2 - Logs
Nessa opo voc pode fazer o log de alguns arquivos de log do sistema. So 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. Porm, 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

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

8.4 - Customizar Layout do Cliente


Aqui possvel customizar certos aspectos da rea do cliente. Para isso, possvel 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 pgina na rea do cliente.

8.5 - Configuraes
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 - Exibio 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 comparao com as operadoras se usar o tempo real, pois comumente elas configuram a exibio por blocos de 30 (trinta) segundos.

8.5.4 - Configuraes SMTP


Configuraes utilizadas para o envio de e-mail do sistema.

36

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

8.5.5 - Dados para emisso de Boleto(*)


Insira aqui os dados para a emisso de boletos diretamente pela rea do cliente. Seguem abaixo os campos que devem ser configurados: Banco: Selecione aqui o banco de sua prefer ncia; Nmero do Convnio: Nmero do convnio junto ao banco; Nmero da Agncia: Nmero da agncia de seu banco; Carteira: Nmero da carteira junto ao banco; Taxa do Boleto: Caso houver, insira aqui a taxa cobrada pela emiss o do boleto. Instrues: Instrues que sero impressas junto ao boleto (Ex: Pag vel em qualquer agncia bancria.); Nome da sua Empresa, Endereo, Cidade, Estado, CPF: Informaes que aparecero junto ao boleto. Valores: Valores disponveis que o cliente ter acesso para escolher.

8.5.6 - Pesonalizar os logos da rea Administrativa


Nesta configurao possvel fazer o upload de uma imagem que aparecer na interface da rea administrativa do Billing. Caso for necess rio, existe tambm a opo de voltar o logo padro do sistema, basta apenas clicar no bot o Voltar Logo Padro.

8.5.7. - Valor Mnimo para Fechamento Automtico


Onde determinado o valor mnimo do saldo gasto pelo cliente para a ativao automtica do pagamento. O fechamento automtico s est disponvel para clientes ps-pago. Caso nenhum valor seja especificado o sistema utiliza o valor padro de 150,00. Segue abaixo o campo que devem ser configurado:

Valor: Valor mnimo para ativar o fechamento automtico. Para valores decimais, utilizar o ponto (.) ao invs da virgula (,).

37

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

9 - Monitoramento
9.1 - Asterisk Console
9.1.1 - Usurios conectados SIP Este relatrio possibilita ver os usurios sip que esto conectados no momento. Para chegar nele entre em Asterisk console no menu Manuten o, em seguida clique em Usurios conectados SIP. No relatrio voc ter algo como:

Nome/User do sipfriend Carto associado Nome do cliente IP do sipfriend Porta de conexo Se o reinvite est habilitado Status da conexo do sipfriend (tempo em milisegundos da conex o, desconhecido (UNKNOW), inalcanvel (UNREACHABLE) ou no monitorado, quando o qualify est desabilitado nas configuraes do sip friend). Reinvite (siginifica que o trfego de voz da ligao no passa pelo servidor, economizando processamento e banda, o que melhora a qualidade e diminui a latncia. 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 usurios IAX que esto conectados no momento. Para chegar nele entre em Asterisk console no menu Manuten o, em seguida clique em Usurios conectados SIP. Um pouco mais simples que o anterior ele mostra o nome/username, ip/host, a mscara de rede, a porta em que se conecta e o status, assim como o anterior. 38

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

9.1.3 - Chamadas em andamento: Nessa opo pode-se constatar quais as chamadas esto em andamento. Para chegar nele entre em Asterisk console no menu Manuten o, em seguida clique em Usurios conectados SIP. A saber temos: origem e o nome associado daquele que fez a chamada, O nmero discado pelo mesmo, o tempo de ligao ocorrido at o momento, o codec que est sendo utilizado pelo usurio, se o reinvite est ativado, o status do sip friend, e se deseja desligar/terminar com a liga o, til no caso de uma ligao travada. 9.1.4 - Matar ligaes e reiniciar Asterisk Cuidado com essa opo, use-a somente se tiver certeza do que est fazendo pois erros podem ocorrer em caso de travamento.

9.2 - Ping
Nessa pgina 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 aceitvel.

9.3 - Grficos
O monitoramento feito por grficos, os quais mostram o uso do sistema em relao 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 prprio voip.

39

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

10 - Revendas
10.1 - Revenda por Comisso
Revenda por Comisso 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 comisso, portanto o lucro do revendedor calculado com base na porcentagem de comisso definido na criao deste tipo de revenda. Com relao aos crditos dos clientes, nos pr-pagos o crdito 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 ps-pagos o revendedor define o limite que o saldo do cliente pode ficar negativo e n o deve ser inserido crditos ele para que ele fique com saldo positivo. Conforme o cliente faz ligaes o crdito do revendedor debitado, e se o saldo do revendedor chegar a zero todos clientes ps-pagos sero desativados automaticamente pelo sistema, por isso importante que quando o revendedor trabalhar com clientes p s-pagos ele se mantenha sempre com saldo de crditos positivo. 10.1.1 - Adicionar Revenda Comissionada Nessa rea voc ir criar uma nova Revenda Comissionada. Os campos diferentes da Revenda Master so:

Login: "username" que o revendedor ir utilizar para acessar sua rea no billing. Senha: senha que ser utilizada com o "username" informado no login. %Comisso: Insira a porcentagem de ganho do revendedor. Caso voc defina uma comisso, ao gerar relatrios tanto voc quanto o revendedor vero o clculo de lucro baseado no movimento de liga es dos clientes do revendedor e no movimento de crditos comprados. Voc pode deixar 0 e assim o sistema no efetuar o clculo dessas comisses. Crditos: Crdito inicial da revenda. 40

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10


Ver Ligaes Detalhadas: Essa opo habilita, ou no, que o revendedor veja as ligaes detalhadas de seus clientes. Acesso ao Asterisk Console (Monitoramento): Permite ao revendedor observar em tempo real os usurios 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 ligaes. Normalmente voc ir negar a ele essa informao. Pemisso de Criao: 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 responsvel e nenhum, no 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 necessrio para a identificao de seu revendedor.

10.2 - Revenda-Master
Revenda que especifica o valor de venda. Ela de certa forma autnoma, one ela no ganha uma comisso, j que ela mesma define por quanto ir revender (obtendo assim seu prprio 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 criao do Ratecard modelo igual a de qualquer Ratecard. O preo de venda especificado nas tarifas deste Ratecard ser o preo que o revendedor vai pagar ao administrador. OBS2: Aps ter sido criado o Ratecard modelo, quando for feita alguma alterao nele (preo de compra, billingbllock, ou qualquer outro campo), o sistema atualizar todas as tarifas que foram originadas a partir daquele modelo. 2 - Agora necessrio criar um novo revendedor (utilizar a nova op o de criao de revendedores). Nele o administrador deve especificar quais os modelos 41

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

de Ratecard (tarifas) que o revendedor ter acesso para poder criar as suas prprias. 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 opo "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 edio 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 padro ser igual ao preo de compra at que um valor seja definido. Ele pode edit-las uma a uma atravs do boto editar de cada tarifa ou editar vrias de uma vez atravs do campo "Preo de venda" no fim da pgina. 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 prprios tariffgroups. Sempre que um de seus clientes efetuar uma ligao o valor tarifado ser aquele que o revendedor definiu. Com relao aos crditos dos clientes, a revenda-master pode creditar livremente seus clientes, e toda ligao que eles fizerem, quer seja pr-pago ou ps-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 crditos sempre com valor positivo.

10.2.1 - Adicionar Revenda Master Nessa rea voc ir criar uma nova Revenda Master. Os campos para preenchimento so:

Login: "username" que o revendedor ir utilizar para acessar sua rea no billing. Senha: senha que ser utilizada com o "username" informado no login. Crditos: Crdito inicial da revenda. 42

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10


Ver Ligaes Detalhadas: Essa opo habilita, ou no, que o revendedor veja as ligaes detalhadas de seus clientes. Acesso ao Asterisk Console (Monitoramento): Permite ao revendedor observar em tempo real os usurios conectados e as chamadas em andamento dos mesmos. Pemisso de Criao: 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 responsvel e nenhum, no 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 prprios. 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 necessrio para a identificao de seu revendedor.

10.3 - Listar Revenda Master/Comissionada


Nesta opo 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 necessrio alguma alterao, possvel utilizar o boto editar ou caso necessrio remover uma revenda basta utilizar o boto deletar.

10.4 Deletar Revenda


Ao deletar uma revenda, todos os dados referentes a ela ser o apagados de maneira irreversvel , ou seja, cartes, configuraes (SMTP, Boleto, etc), planos e grupos de tarifas, tarifas, crditos e pagamentos.

43

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10

11 - Configurao dos Administradores


11.1 - Adicionar
Crie seus administradores aqui, tenha por prefer ncia preencher todos os campos.

11.2 - Adicionar Admin Parcial


Voc pode tambm criar administradores parciais que podem "administrar" apenas certas configuraes de seu servidor. Seguem os campos necessrios 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. Permisses: aqui so definidas quais as reas que este administrador parcial ter acesso. As opes so: Clientes: tem permisso de acesso e configurao no menu Clientes. Billing: tem permisso de acesso e configurao no menu Billing. Tarifas: tem permisso de acesso e configurao no menu Tarifas. Troncos: tem permisso de acesso e configurao no menu Troncos. Relatrios: tem permisso para acessar o menu Relatrios. Execues Peridicas: tem permisso de acesso e configurao no menu Execues Peridicas. Administradores: tem permisso de acesso e configurao no menu Adminstradores. Revenda: tem permisso de acesso e configurao no menu Revendas. Manuteno: tem permisso de acesso e configurao no menu Manuteno. Monitoramento: tem permisso de acesso e configurao no menu Monitoramento. Permisso para Creditar: define se este administrador parcial pode efetuar crditos aos clientes. 44

Manual Sistema Voip Virgos Verso Tarifador Atualizao: 10/12/10


Callcenter(*): define se este administrador parcial pode liberar o callcenter aos clientes. Nome, Endereo, 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 configuraes ou delet-los.

45