Escolar Documentos
Profissional Documentos
Cultura Documentos
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
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
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
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
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.
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.
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
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.
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
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:
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
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
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.
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
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
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
15
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.
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
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.
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.
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.
20
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
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.
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
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
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.
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
25
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 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
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:
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
OBS: a tarefa somente ser aplicada aos clientes que estiverem com a opo Executar tarefas peridicas ativada em seu cadastro.
28
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.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.
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
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
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.
32
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:
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.
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
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.
35
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.
36
Valor: Valor mnimo para ativar o fechamento automtico. Para valores decimais, utilizar o ponto (.) ao invs da virgula (,).
37
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
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
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
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
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
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.
43
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.
45