MANUAL DE GERENCIAMENTO
SISTEMA VOIP VIRGOS (TARIFADOR)
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
Sumário
Introdução..............................................................................................................3
1 – Visão Geral......................................................................................................4
2 – Cadastrando Clientes.......................................................................................8
2.1- Criando contas no sistema......................................................................................................................... 8
2.2-Criando um acesso SIP/IAX (número voip)............................................................................................. 12
3 – Cadastrando Troncos (Operadoras)...............................................................16
3.1 - Cadastrando as informações de conexão para um tronco (ip,usuário, senha, etc...)
...................................................................................................................................................................... 16
3.2 – Cadastrando o tronco............................................................................................................................. 16
4 – Tarifação........................................................................................................18
4.1 – Descrição geral...................................................................................................................................... 18
4.2 – Tariffgroup............................................................................................................................................ 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 – Ratecard................................................................................................................................................ 19
4.3.1 – Criando um Ratecard..........................................................................................................................19
4.3.2 – Listando Ratecard's cadastrados........................................................................................................20
4.3.3 – Associando um Ratecard a um Tariffgroup........................................................................................20
4.4 – Tarifas (rotas)........................................................................................................................................ 20
4.4.1 – Criando uma Tarifa............................................................................................................................21
4.4.2 – Listando e editando tarifas existentes.................................................................................................22
4.5 - Importando uma tabela de tarifas de uma planilha..................................................................................22
5 - Agendamento de tarefas para débito/crédito de clientes periodicamente......26
6 - Billing.............................................................................................................29
6.1 - Creditando um cliente............................................................................................................................ 29
6.2 - Cadastrando pagamentos efetuados pelos clientes.................................................................................. 29
6.3-Visualizando pagamentos......................................................................................................................... 29
6.4-Verificando a situação financeira dos clientes..........................................................................................29
6.5-Vouchers................................................................................................................................................. 30
6.5.1-Descrição...............................................................................................................................................30
6.5.2-Criando um Voucher.............................................................................................................................30
1
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
6.5.3-Criando vouchers em lote......................................................................................................................31
7- Relatórios........................................................................................................32
7.1 - Relatório geral....................................................................................................................................... 32
7.2 - Fatura.................................................................................................................................................... 33
7.3 - Comparar Ligações................................................................................................................................ 33
7.4 - Tráfego mensal...................................................................................................................................... 33
7.5 - Tráfego diário........................................................................................................................................ 33
7.6 - Relatório por cliente............................................................................................................................... 34
8 - Manutenção....................................................................................................35
8.1 - Backup / Download............................................................................................................................... 35
8.2 - Logs....................................................................................................................................................... 35
8.3 - Teste de DTMF...................................................................................................................................... 35
8.4 - Customizar Layout do Cliente................................................................................................................ 36
8.5 - Configurações........................................................................................................................................ 36
8.5.1 - Chave de Acesso ao WebService.........................................................................................................36
8.5.3 - Exibição do tempo de chamadas ........................................................................................................36
8.5.4 - Configurações SMTP...........................................................................................................................36
8.5.5 - Dados para emissão de Boleto(*).......................................................................................................37
8.5.6 - Pesonalizar os logos da Área Administrativa.....................................................................................37
8.5.7. - Valor Mínimo para Fechamento Automático.....................................................................................37
9 - Monitoramento ..............................................................................................38
9.1 - Asterisk Console.................................................................................................................................... 38
9.1.1 - Usuários conectados SIP.....................................................................................................................38
9.1.2 - Usuarios conectados IAX....................................................................................................................38
9.1.3 - Chamadas em andamento: .................................................................................................................39
9.1.4 - Matar ligações e reiniciar Asterisk ....................................................................................................39
9.2 - Ping....................................................................................................................................................... 39
9.3 - Gráficos................................................................................................................................................. 39
10 - Revendas......................................................................................................40
10.1 - Revenda por Comissão......................................................................................................................... 40
10.1.1 - Adicionar Revenda Comissionada.....................................................................................................40
10.2 - Revenda-Master................................................................................................................................... 41
10.2.1 - Adicionar Revenda Master................................................................................................................42
10.3 - Listar Revenda Master/Comissionada.................................................................................................. 43
10.4 Deletar Revenda..................................................................................................................................... 43
11 - Configuração dos Administradores..............................................................44
11.1 - Adicionar............................................................................................................................................. 44
11.2 - Adicionar Admin Parcial...................................................................................................................... 44
11.3 - Listar Admin e Admin Parcial.............................................................................................................. 45
2
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
Introdução
Este manual apresenta as principais funcionalidades do sistema Voip Virgos, versão tarifador. O sistema é baseado no software a2billing (www.asterisk2billing.org) e é distribuído sob licença GPL, assim como o original. Não é tratado neste documento passos para instalação do sistema e sim para o seu gerenciamento.
Esta documentação, desenvolvida pela Virgos, pode ser distribuída gratuitamente, desde que mantida sua forma e a referência à empresa­autora.
Verifique sempre a última versão disponível deste documento em http://suporte.virgos.com.br/downloads/manual.pdf Customizações, consultorias, treinamentos e outros serviços sempre podem ser solicitados conosco. O contato pode ser feito via:
Virgos Tecnologia da Informação S/S
Episcopal, 1763 – São Carlos ­ SP
(16) 2107­8647 – www.virgos.com.br
3
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
1 – Visão Geral
O sistema trabalha basicamente com o cadastramento de troncos de saída para as chamadas, rotas e clientes.
É possível trabalhar com várias operadoras simultaneamente no sistema, onde cada operadora será um tronco no sistema.
O que torna isto possível é o cadastramento de rotas no sistema, rotas são definidas atráves de prefixos de discagem e para cada rota definimos um tronco de saída. As rotas possuem diversas propriedades, como por exemplo, valor pago por minuto na rota e valor que será cobrado pela rota.
Abaixo um diagrama mostrando a relação entre cliente, rotas e troncos.
No cadastro de clientes, é cadastrado primeiramente uma conta que detém as informações do cliente, como: nome, endereço, enfim, os dados cadastrais do cliente. É nesta conta que atribuímos os créditos ao cliente.
Para cada conta existente podemos criar vários números voip, estes conhecidos no sistema como sip/iax­friends. Os termos SIP e IAX indicam o protocolo de comunicação utilizado pelo dispositivo (ata, softphone, voipphone) utilizado na comunicação.
Observamos também no digrama acima outros dois termos: tariffgroup e ratecard. 4
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
Os ratecard's são na verdade um grupo de tarifas (rotas). No cadastramento das tarifas umas das propriedades indicadas é em qual dos ratecard's existentes no sistema ela será inserida.
Os tariffgroup's podem ser considerados como os planos de venda praticados no sistema, dentro dos tariffgroup's inserimos os ratecard's criados no sistema.
Com o cadastro de tariffgroup's e ratecard's podemos então associar um cliente a um tariffgroup.
Desta forma, poderíamos por exemplo, criar um plano com tarifas reduzidas para clientes empresariais e manter clientes residenciais em um tariffgroup com tarifação comum.
Abaixo é apresentado outro diagrama, agora demonstrando o funcionamento do sistema com um cadastramento básico de clientes, rotas e troncos.
5
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
1 ­ ATA configurado para conectar­se ao servidor com os dados do acesso criado no servidor (sip­friend). Considerando que o ATA esteja autenticado no servidor, quando o cliente efetuar uma ligação o ATA enviará número discado para o servidor.
2 ­ O sistema verificará então que este acesso sip está associado ao cliente 'Empresa1'.
3 ­ Nesta fase é verificado a qual tariffgroup o cliente 'Empresa1' está associado, que no caso é o tariffgroup 'Empresarial'.
4 ­ O sistema fará uma comparação do número discado pelo cliente com todas as tarifas existentes nos ratecard's atribuídos ao tariffgroup Empresarial, vale ressaltar que sempre será selecionada a tarifa que seja mais completa em relação ao número discado pelo usuário.
Por exemplo, caso o usuário disque 01140634771, será procurada por tarifas cujo prefixo definido seja 01140634771, caso não exista, serão procuradas por tarifas 6
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
0114063477, depois 011406347, depois 01140634, depois 0114063 e assim sucessivamente, até que algo seja encontrado.
Caso exista mais de uma tarifa cadastrada com o mesmo prefixo, será escolhida a de menor custo.
Selecionada a tarifa, o sistema então enviará a chamada para o tronco correspondente a tarifa selecionada.
5 ­ Chegamos então ao final do processo, onde já sabemos para qual tronco enviar a ligação. Basta agora resgatarmos as informações de autenticação do tronco escolhido, tais informações estão no sip­friend determinado no campo 'ip ou nome do friend' no cadastro do tronco.
6 ­ E aqui, finalmente enviamos a chamada para a operadora.
7
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
2 – Cadastrando Clientes
2.1­ Criando contas no sistema
Para cadastrar um cliente, vá em 'Adicionar Cliente' que está localizado no menu 'Clientes'. Abaixo a descrição dos campos disponíveis no formulário de cadastro:
–
–
–
–
–
–
–
–
–
–
Número: Número gerado automaticamente pelo sistema, código único para identificação da conta
Apelido: É o nome de usuário utilizado para o cliente acessar a interface de consulta de saldo desta conta. Este campo só aceita caracteres numéricos.
Senha via Web: Senha utilizada para acesso a interface de consulta de saldo.
Crédito: Este campo possibilita definir um crédito inicial para o cliente, porém o sistema não contabiliza o valor como um crédito a ser pago pelo cliente.
Aviso de crédito: Valor para o aviso de crédito baixo. Revendedor: Este campo determina à quem este cliente pertence. Caso seja selecionado algum revendedor, ele terá acesso a este cliente.
Língua: idioma do cliente.
Tariffgroup: Neste campo é definido qual tariffgroup o cliente utilizará para efetuar suas ligações.
Campanhas de Áudio(*): Este campo define se este cliente tem acesso às campanhas de áudio.
Campanhas de SMS(*): Este campo define se este cliente tem acesso às campanhas de sms.
8
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
Callcenter(*): Este campo define se este cliente tem acesso ao Callcenter.
–
Ativo: estado da conta, possíveis valores:
–
–
–
–
–
–
–
–
–
sim: conta ativada, ligações feitas normalmente (caso o cliente tenha créditos).
–
não: conta desativada, utilização da conta bloqueada.
Acesso simultâneo: Defina se esta conta poderá realizar mais de um acesso simultâneo.
Moeda: moeda corrente do cliente.
Executar tarefas periódicas: o sistema permite o agendamento de tarefas de débito, caso exista alguma, defina aqui se tais tarefas serão aplicadas nesta conta.
Tipo: tipo de conta, Pré­Pago ou Pós­Pago.
Limite de Crédito: Caso a conta seja do tipo pós­pago, deve­se definir aqui um limite de utilização de crédito.
Data primeiro uso: data da primeira utilização da conta. Inserido automati­
camente pelo sistema.
Data da última chamada realizada: data da última vez que o cliente efetuou uma chamada. Inserido automaticamente pelo sistema.
Ativar expiração: É possível definir uma data para expiração da conta. As seguintes opções estão disponíveis:
–
Não expirar: A conta nunca expira.
9
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
–
–
Expirar em uma data: a conta expira na data informada no campo “data de expiração”.
–
Expirar alguns dias após o primeiro uso: A conta expira após o número de dias informado no campo “dias para expirar”, contando após o data do primeiro uso.
–
Expirar alguns dias após a criação: Expira a conta após o número de dias informado no campo “dias para expirar”, contando após a data de criação (cadastro).
Data de expiração: Defina uma data de expiração para a conta, se o campo “Ativar expiração” estiver ativo.
Dias para expirar: Defina o número de dias para a conta expirar, calculo baseado na definição do campo “Ativar expiração”.
–
Sobrenome: sobrenome do cliente.
–
Primeiro nome: primeiro nome do cliente.
–
Email: E­mail do cliente.
–
Email2: Campo adicional para e­mail do cliente, caso seja necessário.
–
Endereço: Endereço do cliente.
–
Bairro: Bairro do cliente.
–
Cidade: Cidade do cliente.
–
Estado: Estado do cliente.
–
País: País do cliente.
10
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
–
CEP: CEP do cliente.
DDD: Área do telefone do cliente. Informando a área local, o cliente não precisará discá­lo para efetuar chamadas para localidades com este DDD.
–
Telefone: Telefone do cliente.
–
Telefone2: Campo adicional para telefone do cliente, caso seja necessário.
–
Pessoa para contato: Nome da pessoa para quando for necessário fazer contato.
–
FAX: Fax do cliente.
–
Documento (CPF/CNPJ): CPF/CNPJ do cliente.
–
Empresa: Nome da empresa do cliente.
–
Inscrição Estadual: Número da inscrição estadual do cliente.
–
–
–
–
–
Em uso: Usado para debug, este valor será maior que 0 se o cartão estiver em uso. Caso a aplicação trave por algum motivo então o ficara marcado como >0. Neste caso, pode­se marcar de volta ao 0 para liberar o uso futuro.
Gravação(*): Ativar a gravação de chamadas para este cliente.
Data do último Fechamento: Data em que ocorreu o último fechamento da conta deste cliente. Inserido automaticamente pelo sistema.
Período de Fechamento: Período de dias entre cada fechamento. Disponível apenas se a conta for do tipo pós­paga.
Período de Vencimento: Período de dias para vencimento do boleto. Disponível apenas se foi selecionado um Período de Fechamento.
11
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
Observações: Campo livre onde pode ser inserido observações sobre o cliente.
(*) ­ Necessário adquirir estes serviços. Entre em contato com nosso Setor Comercial para maiores detalhes.
2.2­Criando um acesso SIP/IAX (número voip)
É neste cadastro que criamos os acessos que serão utilizados nos dispositivos. Para cadastrar um acesso, no menu “Clientes” clique em “Adicionar SIP­friend” (para um dispositivo que utilize o protocolo SIP) ou em “Adicionar IAX­
friend” (para um dispositivo que utilize o protocolo IAX).
–
–
–
Name: identificação do acesso. É através deste número que o acesso receberá chamadas.
Tipo: tipo de sip­friend, no caso de clientes utilize o padrão “friend”, a definição “peer” é utilizada somente no cadastramento de operadoras.
Username: nome de usuário que será utilizado para este acesso se autenticar no sistema. Normalmente igual a 'name'.
–
Cartão associado: número da conta à qual este acesso será associado.
–
Regexten: Se for preenchido deve ser igual ao username.
–
Callerid: Identificação do usuário, a que aparece na BINA.
–
Amaflags: Deixe como 'billing' para as chamadas serem registradas.
–
Senha: senha que será utilizada para autenticação deste acesso no sistema.
–
MD5Secret: Senha pré­criptografada (quase não usado).
–
NAT: defina se o dispositivo que utilizará este acesso esta em uma rede que utilize NAT.
12
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
–
–
–
–
–
DTMFMode: Deixe como RFC2833.
Qualify: se habilitada, o sistema irá fazer uma verificação do status deste acesso regularmente. Se a latência do servidor for muito alta ou ele não suportar 'qualify' ele pode se tornar UNREACHABLE, impedindo que ligações saim pela operadora usada. Desabilite e ele deverá funcionar.
Canreinvite: Determina se durante uma chamada, o sistema deve tentar fazer com que origem e destino comuniquem­se diretamente, com o objetivo de liberar o tráfego do sistema.
Disallow: Codecs que não serão permitidos, deixe como 'all'.
Allow: define quais codecs poderão ser utilizados por este acesso. Os codecs mais conhecidos estão definidos em ordem de prioridade.
Host: Deixe dynamic no caso de usuários com ip dinâmico. Você precisa preecher este campo apenas no caso das operadoras/troncos.
–
Callgroup: Deixe em branco.
–
Context: Contexto ao que o SIP está atrelado, normalmente 'callingcard'.
–
–
–
–
Defaultip: Usado para definir um IP para um SIP antes que o ATA se registre com o Asterisk. Normalmente deixado em branco.
Fromuser: Se estiver cadastrando uma operadora/tronco, coloque aqui o mesmo valor do campo USERNAME, isto é, o usuário que vc usa para conectar­
se nela.
Fromdomain: Força um domínio nas mensagens entre os SIPs.
Insecure: Define como manipular a conexão entre os peers. Normalmente 'no' (default) para SIPs e pode ser 'very' para alguns troncos/operadoras.
13
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
Language: Código de duas letras indicando o país, isto influencia nos toques e tons usados. Para o Brasil é br, normalmente fica em branco.
–
Mailbox: Extensão do VoiceMail, válido apenas para SIPs do tipo peer.
–
Permit, Deny, Mask: Restringem ou permitem IPs.
–
Pickupgroup: Grupo que pode pegar chamadas de outros usuários usando *8. É necessário que a extensão *8 esteja configurada corretamente.
–
Port: Porta em que o SIP responde.
–
Restrictcid: Não é usado.
–
–
–
–
RTPTimeout: Termina uma chamada se houver mais de N segundos de inatividade na chamada quando o telefone não estiver em espera. Válido somente para SIPs do tipo igual a peer.
RTPHoldTimeout: Termina uma chamada depois de N segundos de inatividade em uma chamada em espera.
Musiconhold: Uma das classes especificadas no arquivo musiconhold.conf. Normalmente não usado aqui.
Regseconds: Número de segundos antes do peer se registrar. Válido apenas para entradas em tempo real e normalmente é deixado em branco.
–
IP Addr: IP do SIP, válido para conexões em tempo real. Deixe em branco.
–
CanCallForward: Deixe em yes.
–
DDD: Código da área deste SIP/IAX.
–
Call­limit: Limite de chamadas que este SIP/IAX pode efetuar simultaneamente.
14
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
15
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
3 – Cadastrando Troncos (Operadoras)
3.1 ­ Cadastrando as informações de conexão para um tronco (ip,usuário, senha, etc...)
Este cadastro é normalmente utilizado para troncos que fazem autenticação através de usuário e senha. Para este cadastro insira um SIP client (veja em “2.2­Criando um acesso SIP/IAX (número voip)”). Abaixo a descrição dos campos necessários. –
–
–
–
–
Name: nome para identificação do tronco no sistema, livre escolha.
Tipo: o tipo de acesso que estamos cadastrando, no caso de operadoras defina “peer”.
Username: insira o nome de usuário fornecido pela operadora. Caso a autenticação seja feita através do IP do servidor, deixe este campo em branco.
Senha: insira a senha oferecida pela operadora. Caso a autenticação seja feita através do IP do servidor, deixe este campo em branco.
Qualify: Defina se o sistema deve fazer uma verificação regularmente do status da operadora. Algumas operadoras não suportam este parâmetro, se este for o caso defina 'no' neste campo.
–
Host: insira o IP ou o domínio da operadora.
–
Fromuser: Defina o mesmo valor informado no campo username.
3.2 – Cadastrando o tronco
16
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
Para criar um novo tronco, clique em “Adicionar” localizado no menu “Troncos”. Abaixo a descrição dos campos utilizados:
–
–
–
–
–
–
–
–
Código do tronco: insira um nome para identificação deste tronco.
Adicionar prefixo: algumas operadoras necessitam do prefixo '011' antes do número discado, este campo possibilita que o prefixo seja adicionado automaticamente ao número discado (*).
Remover prefixo: remove um ou mais dígitos discados pelo usuário.
Protocolo: Tipo de protocolo usado para conectar­se ao tronco. Sua operadora lhe fornecerá este parametro. Os valores possíveis são: SIP, IAX2 e ZAP.
IP ou nome do friend: indique aqui o nome do sip­friend criado para esta operadora, ou informe o IP ou domínio caso a operadora possua a facilidade de autenticação através do IP.
Parametros Adicionais: Usados nos comandos Dial do asterisk. Geralmente não é necessário.
Tronco secundário, em caso de falhas: podemos definir aqui tronco dentre os cadastrados no sistema para que assuma as chamadas destinadas a este (cadastro atual), caso ele não consiga completa­las.
Crédito no tronco: usado para controlar quanto crédito você tem com a operadora. Conforme as ligações saírem pelo tronco o crédito diminui. Quando você colocar mais créditos na operadora você atualiza aqui. Este campo serve apenas para seu controle não influenciando no sistema de tarifas.
17
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
4 – Tarifação
4.1 – Descrição geral
A tarifação é constituída por 3 elementos, tariffgroup's, ratecard's e tarifas, onde os tariffgroup' são os planos de venda do sistema, a cada cliente do sistema é associado um tariffgroup. Associamos então a um tariffgroup um ou mais ratecard's, que são grupos de tarifas.
Inserimos então, dentro dos ratecard's, as tarifas, que são uma definição de cada rota (prefixo) que desejamos permitir ligações dentro do sistema. As tarifas possuem diversas propriedades, como: prefixo, valor de compra e venda na rota, tronco de destino para a rota, dentre outras.
Veja abaixo uma figura demonstrando a associação como deve ser feita no sistema.
4.2 – Tariffgroup
4.2.1 – Criando um Tariffgroup
Para criar um Tariffgroup, clique em “Adicionar Tariffgroup” no menu “Tarifas”. Abaixo a descrição do formulário de cadastro de um tariffgroup.
–
Nome: defina o nome do Tariffgroup.
18
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
–
Tipo: este campo define como o sistema deve agir quando encontrar duas rotas iguais, porém com tarifas diferenciadas. As opções são: LCR opta pela rota que possua o menor custo para você, LCD opta pela rota que possua o menor custo para seu cliente.
Remover prefixo internacional: defina se as tarifas dos ratecard's que serão associados a este Tariffgroup possuem os prefixos internacionais '011' ou '00'.
4.2.2 – Listando Tariffgroup's cadastrados
Para listar os Tariffgroup's cadastrados no sistema, vá em “Listar/Editar Tariffgroup”, localizado no menu “Tarifas”.
Será apresentada a lista de todos os Tariffgroup's cadastrados no sistema e suas principais informações. É possível editar e apagar qualquer tariffgroup criado clicando nos botões 'editar' e 'deletar'.
4.2.3 – Associando um Tariffgroup a um cliente.
A associação dos clientes com os Tariffgroup's é feita editando o cadastro no cliente (menu “Clientes”, “Lista de Clientes/Cartões”) e alterando o campo Tariffgroup do cliente.
4.3 – Ratecard
4.3.1 – Criando um Ratecard
Para criar um novo ratecard, clique em criar “Adicionar Ratecard”, localizado no menu “Tarifas”. Os campos envolvidos no cadastro estão descritos abaixo.
–
Nome: defina o nome que será utilizado para identificar o Ratecard.
19
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
Data inicial: inicio da validade deste Ratecard.
–
Data final: final da validade do Ratecard.
–
–
–
Tronco: define­se um tronco padrão para as tarifas que estarão dentro do Ratecard. Porém isso não restringe que todas as tarifas dentro do ratecard saiam pelo tronco definido aqui. O tronco de cada tarifa pode ser editado na própria tarifa.
Descrição: apenas um campo para comentários explicativos do ratecard. Não é obrigatório.
DNID: não deve ser alterado o valor padrão.
4.3.2 – Listando Ratecard's cadastrados
Para listar os Ratecard's cadastrados no sistema, vá em “Listar/Editar Ratecard”, localizado no menu “Tarifas”.
Será apresentada a lista de todos os Ratecard's cadastrados no sistema e suas principais informações. É possível editar e apagar qualquer ratecard criado clicando nos botões 'editar' e 'deletar'.
4.3.3 – Associando um Ratecard a um Tariffgroup
Isto é feito na edição do Tariffgroup em que o Ratecard será associado. Um tariffgroup pode possuir uma lista de ratecard associados, que também são conhecidos como tariffplan's.
Na edição do tariffgroup temos a lista de ratecards associados, pode­se remover os ratecards já associados e associar novos ratecards.
4.4 – Tarifas (rotas)
20
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
4.4.1 – Criando uma Tarifa
Para criar uma nova tarifa, clique em “Adiconar Tarifa” no menu “Tarifas”. No cadastramento de tarifas é definido para onde o sistema fará ligações (prefixos), qual operadora utilizar e os valores praticados para cada destino. Abaixo a descrição dos campos do formulário de cadastro da tarifa:
–
–
Ratecard: defina a qual ratecard a tarifa deve ser inserida.
Prefixo de Discagem: defina o prefixo da rota. É possível criar tanto rotas mais abrangentes e rotas mais especificas, dependendo da necessidade de diferenciação na tarifação. Por exemplo, poderíamos criar uma rota para todos os destinos do Brasil informando neste campo apenas o '55'. Outra possibilidade seria criar uma rota para cada DDD, ex: 5516, 5511. Caso queira diferenciar tarifas com destinos celular ou fixo, é preciso criar rotas específicas que determinem essa diferença, alguns exemplos: 55119, 55118, 55219 e 55218.
–
Destino: uma descrição para a rota, ex: Brasil.
–
Por quanto você compra: defina o valor pago na rota à operadora.
–
–
–
–
–
Tempo mínimo que você paga na chamada: defina o tempo mínimo de tarifação aplicado pela operadora. Ex: Uma operadora que aplique uma tarifa nos primeiros 30 segundos, após isso a cada 6 segundos.
Em blocos de quantos segundos você paga: o período de tempo em que a tarifa é aplicada após a tarifação mínima.
Quanto você cobra?: O valor que será aplicado ao cliente nesta rota.
Tempo mínimo de tarifação: o tempo mínimo em que a tarifa será aplicada ao cliente.
De quantos em quantos segundos você tarifa o cliente: defina o período em que será feita a tarifação no cliente após o período mínimo.
21
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
–
Custo por conexão: possibilita tarifar o cliente na conexão da chamada, além do tempo total utilizado.
Custo por desconexão: possibilita tarifar o cliente na desconexão da chamada, além do tempo total utilizado.
–
Data inicial: data de inicio do período de validade da tarifa.
–
Data final: data final do período da validade da tarifa.
–
Dias de semana: dias da semana em que a tarifa será válida.
–
Tronco: define para qual tronco a chamada deve ser redirecionada.
–
Música de espera: altera o tom de discagem para uma música. O valor “No music on hold” mantém o tom de discagem convencional.
4.4.2 – Listando e editando tarifas existentes
Após o cadastramento das tarifas, alterações poderão ser feitas atráves do menu “Editar Ratecard”, localizado no menu “Tarifas”. Um campo de seleção contendo os ratecards existentes no sistema é apresentado. Listadas as tarifas de um Ratecard temos a opção de editá­las ou apagá­las, clicando nos respectivos botões. Os campos são os mesmos da criação da tarifa.
4.5 ­ Importando uma tabela de tarifas de uma planilha
O sistema oferece também, a funcionalidade de fazer o cadastramento das tarifas baseando­se em dados de planilha eletrônica (Excel, OpenOffice). Abaixo o modelo da tabela de tarifas:
55163
55168
São Carlos­Fixo
São Carlos­Celular
0.1 30
0.5 30
6
6
0.05
0.30
30
30
6
6
22
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
55169 São Carlos­Celular 0.5 30
5511
São 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 então uma tabela com algumas rotas definidas. Veja que foram definidos os mesmos campos do cadastramento comum de uma tarifa, são eles: prefixo, destino, preço de venda, tempo mínimo de venda, tempo adicional de venda, preço de compra, tempo mínimo de compra e tempo adicional de compra.
O último passo na preparação da tabela é salvá­la no formato de arquivo “csv”. Para isso, utilizamos a opção “salvar como” geralmente localizada no menu “arquivo”. No Excel, selecione o tipo de arquivo “CSV (MS­DOS)”, é normal o Excel emitir alguns avisos portanto confirme­os para finalizar a operação. Em outro editor, selecione a opção “Texto CSV”, edite as configurações de filtro deixando “;” como delimitador de campo e delimitador de texto em branco.
Com a planilha salva no formato CSV, podemos executar a importação. No menu “Tarifas”, vá em “Importar Ratecard”, os passos são descritos abaixo:
–
–
Escolha qual ratecard quer importar: Selecione o ratecard em que as tarifas da tabela serão importadas.
Tronco a usar: Determine qual será o tronco de saída para as tarifas.
Em seguida devemos informar como as informações estão dispostas no arquivo csv. As primeiros 3 colunas do arquivo já estão pré­selecionadas e são campos obrigatórios para a importação, são eles:
–
Dialprefix: prefixo de discagem (ex.: 5511).
–
Destination: uma descrição para a tarifa (ex.: Brasil – São Paulo).
–
Rate intial: o preço de venda aplicado na rota.
Na seqüência, podemos informar alguns dados opcionais, como:
23
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
Buyrate: o preço de compra para rota.
–
Buyrateinitblock: tempo mínimo de compra aplicado na rota.
–
Buyrateincrement: o tempo adicional de compra aplicado na rota.
–
Initblock: tempo mínimo de venda aplicado na rota.
–
Billingblock: tempo adicional de venda aplicado na rota.
–
Connect charge: taxa de conexão.
–
Disconnect charge: taxa de desconexão.
Considerando a utilização de arquivo seguindo o modelo aqui apresentado, teríamos a seguinte seqüência a determinar.
●
campos obrigatórios
1 – dialprefix.
2 – destination.
3 – rateinitial.
●
campos opcionais
4 – initblock.
5 – billingblock.
6 – buyrate.
7 – buyrateinitblock.
8 – buyrateincrement.
Feito isso, indicamos ao sistema qual o arquivo a utilizar na importação, para isso clique no botão “arquivo”, em seguida clique em importar.
A tela seguinte nos apresenta uma comparação entre o que foi determinado na tela anterior e os valores encontrados na primeira linha do arquivo csv. Estando tudo certo, carregue o arquivo novamente e clique em 'continuar importação' para finalizar o processo.
24
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
25
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
5 ­ Agendamento de tarefas para débito/crédito de clientes periodicamente
Esta é uma funcionalidade em que podemos agendar tarefas para realizar débito ou crédito dos clientes automaticamente, em um intervalo de tempo determinado.
Para criar uma tarefa periódica, vá em “Adicionar Tarefas” no menu “Execuções Periódicas”, abaixo a descrição dos campos disponíveis no cadastro da tarefa:
–
–
Nome: Defina um nome para a tarefa.
Valor: Defina o valor que será debitado/creditado de cada cliente. As opções são:
–
–
–
Ação no cartão: Nesta opção é possível escolher se o cartão do cliente deve ser desativado e se seus créditos serão retirados quando ele for afetado pela tarefa periódica. As opções são:
–
–
–
–
–
–
–
valores positivos: debita créditos das contas atingidas pela execução.
valores negativos: credita as contas atingidas pela execução.
Apenas retirar os créditos acima inseridos.
Apenas desativar o cartão sem retirar os créditos.
Desativar e retirar os créditos acima inseridos.
Retirar todos os créditos acima inseridos.
Periodicidade: o intervalo de tempo em que a tarefa deve ser executada. Ex: diariamente, a cada 10 dias, a cada 30 dias, todo dia x do mês e etc...
Dia: Caso tenha sido selecionada a opção “Todo dia X do mês” no item anterior, deve­se indicar neste campo em qual dia ela será executada.
Regra: É determinar também que a tarefa somente seja executada caso a regra aqui definida seja verdadeira, as opções são:
–
O usuário não usa o cartão desde N dias.
26
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
–
–
–
–
–
–
–
–
Número de dias: campo utilizado para definição de “N dias” do campo regra. Caso for utilizada a regra “Apenas neste tariffgroup”, deve­se definir neste campo qual o ID do tariffgroup que a tarefa afetará. Caso for utilizada a regra “Usuário efetuou menos de N recargas no mês passado”, deve­se definir neste campo o número de recargas que será utilizada.
Parar de executar: Não executa a tarefas nos clientes que se encaixem da regra aqui definida
–
–
–
–
–
–
–
O usuário usou o cartão nos últimos N dias.
Recarga de créditos não realiazada nos últimos N dias.
Cartão possui apenas 1 sip­friend.
Cartão possui 2 ou mais sip­friends.
Apenas neste tariffgroup.
Movimentação em aberto vencido por N dias.
Usuário efetuou menos de N recargas no mês passado.
Nunca.
O crédito da conta chegou a zero.
Máximo de execuções alcançado.
Máximo de execuções por cartão: determina o valor para o campo “máximo de execuções alcançado”, da opção parar de executar.
Tipos dos cartões: Este campo define o tipo do cartão que a tarefa irá afetar. Suas opções são:
–
Pré­pago;
–
Pós­pago;
–
Ambos.
Status: estado da tarefa, ativa ou inativa.
E­mail para envio de relatório: indique um envio de um relatório contendo os resultados da execução da tarefa.
27
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
OBS: a tarefa somente será aplicada aos clientes que estiverem com a opção “Executar tarefas periódicas” ativada em seu cadastro.
28
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
6 ­ Billing
6.1 ­ Creditando um cliente
Para creditar um cliente, vá em “Creditar cliente”, localizado no menu “Billing”. Indique o número do cliente e a quantia a ser creditada. Pode ser inserido também um comentário junto ao crédito que está sendo efetuado. Em seguida clique em “Creditar valor ao cartão associado”.
6.2 ­ Cadastrando pagamentos efetuados pelos clientes
O cadastramento de pagamentos dos clientes é efetuado para facilitar o gerenciamento do sistema, quanto a quantias pagas e quantias à pagar.
Está localizado no menu “Billing” em “Cadastrar pagamentos”. Para cadastrar uma pagamento informamos o username do cliente que efetuou o pagamento e a quantia que foi paga, além de ser possível também inserir um comentário sobre o pagamento. É possível escolher o username do cliente clicando no botão laranja, onde será exibida uma lista para seleção.
6.3­Visualizando pagamentos
Nesta opção, localizada no menu “Billing” em “Listar Pagamentos”, podemos conferir todos os pagamentos efetuados no sistema, com os dados do cliente que efetuou o pagamento, a data do pagamento, o valor pago e o comentário associado. Caso você possua o serviço de boletos(*), aparecerá também o campo “Status” do pagamento, que indica se o boleto já está “pago” ou “à confirmar”.
6.4­Verificando a situação financeira dos clientes
Nesta tela podemos visualizar todas as informações relacionadas a questões financeiras para cada cliente do sistema. A opção chama­se “Situação Financeira” e esta localizada no menu “Billing”.
Temos então listados todos os clientes do sistema, o total de crédito atual, a quantia total já creditada, o total pago e o valor total à pagar.
29
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
Em “detalhes” podemos visualizar a data e valor de cada crédito e pagamento efetuado pelo cliente.
OBS: o campo “crédito” definido no cadastro do cliente, não consta como valor à pagar para o cliente.
6.5­Vouchers
6.5.1­Descrição
Vouchers podem ser comparados com os cartões de recarga de celulares pré­pagos, onde através de um código digitado do celular o cliente é automaticamente creditado.
O sistema gera um código de voucher aleatório, para o qual é definido um valor de crédito. O cliente que possuir este código poderá digita­lo na interface de consulta de saldo para obter os créditos.
Considerações sobre Vouchers:
­ um voucher só poderá ser utilizado uma única vez.
­ somente serão aceitos os códigos cadastrados no sistema e seu status estiver como Ativo.
­ após sua utilização o voucher é automaticamente desativado.
6.5.2­Criando um Voucher
Para criar um voucher, vá em “Adicionar Voucher”, localizado no menu “Billing”. Abaixo a descrição dos campos:
–
Voucher: código aleatório gerado para o voucher.
–
Credit: crédito associado a este voucher.
–
Activated: estado do voucher.
–
Currency: moeda utilizada para o crédito.
30
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
Expiration date: data de expiração para o voucher.
6.5.3­Criando vouchers em lote
Há a opção de criar vários vouchers em um único processo, bastando apenas indicar a quantidade de vouchers à criar, a valor que será associado, a moeda utilizada nos créditos e a data de expiração.
Esta opção chama­se “Adicionar Vouchers (em lote)” e está localizada no menu “Billing”.
31
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
7­ Relatórios
O sistema disponibiliza uma série de relatórios que mostram de várias maneiras as chamadas efetuadas pelos clientes. Abaixo a descrição dos relatórios disponíveis.
Diversos filtros podem ser aplicados ao relatório, como: listar chamadas de apenas um cliente, chamadas em um determinado intervalo de meses, filtrar as chamadas através do Destino da rota ou filtrar através do número que originou a chamada. Há também a opção de fazer uma combinação dos diversos filtros disponíveis.
7.1 ­ Relatório geral
Um dos principais relatórios do sistema é o Relatório geral. Nele conseguimos listar todas as chamadas efetuadas pelos clientes através do sistema, onde são mostradas as seguintes informações:
Data da chamada
– Origem
– Número chamado
– Destino
– Duração
– Cliente/Cartão
– Status
– $/min (compra)
– $/min (venda)
– Custo
– Total
– Tronco
– Tarifa Caso o serviço de gravações(*) do asterisk estiver ativo, aparecerá também o ícone de um microfone, onde ao ser clicado é possível fazer o download da gravação da chamada correspondente. Você ainda pode remover a entrada no log clicando em “Apagar”.
–
32
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
7.2 ­ Fatura
O relatório “Fatura”, apresenta vários dados e sub relatórios. Nele você pode ver o 'Serviço de Fatura', 'Evolução da Conta' e 'Detalhe das Ligações'.
No 'Serviço de Fatura' você pode ver um gráfico mostrando as ligações para destinos mais usados, com os dados de duração, número de ligações e custo total.
No 'Evolução da Conta' é exibido um gráfico relacionando número de ligações e duração com os dias pedidos no relatório. Ainda é exibido o dado do custo total.
No 'Detalhes das Ligações' são apresentados detalhes na seguinte ordem:
–
–
–
–
–
–
–
Data da ligação
Origem
Número chamado
Destino
Tempo
Cartão
Total
7.3 ­ Comparar Ligações
Apresenta um gráfico mostrando a utilização do sistema no decorrer no dia. Útil para verificar em quais horários há uma maior demanda na utilização do sistema. Existe também a possibilidade de comparar o dia selecionado com os dias anteriores (“Quantidade de dias para comparar”).
7.4 ­ Tráfego mensal
Exibe um gráfico em pizza relacionando os meses anteriores e o atual com os minutos usados. Você pode escolher de 1 mês a 6 meses na opção “Quantidade de meses para comparar”.
7.5 ­ Tráfego diário
33
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
Exibe um gráfico em pizza relacionando os meses anteriores e o atual com os minutos usados. Você pode escolher de 1 mês a 6 meses na opção “Quantidade de meses para comparar”.
7.6 ­ Relatório por cliente
Exibe um relatório por cliente com os seguintes dados para cada entrada:
–
–
–
–
–
–
–
–
Usuário
Nome
Sobrenome
Tipo
Ligações
Valor de Venda
Valor de Compra
Lucro lucro.
No fim do relatório mostra o total de ligações, de venda, de compra e de 34
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
8 ­ Manutenção
8.1 ­ Backup / Download
A primeira opção aqui permite que se faça um backup em formato tar.gz da base de dados e do sistema de billing e cliente.
A segunda opção permite que se faça backup dos usuários do sistema em um arquivo xls. Algo como uma exportação dos dados dos usuários..
8.2 ­ Logs
Nessa opção você pode fazer o log de alguns arquivos de log do sistema.
São eles:
–
–
–
–
–
full: Log geral de uso do asterisk.
revenda_pospago.log: Log de desativacao de clientes pos­pagos quando o revendedor associado fica com credito negativo.
log_mudanca_plano.txt: Log de alteracao automatica de plano dos clientes ao atingirem determinado consumo em ligacoes celular.
a2billing.log: Log de processamento do sistema billing.
Master.csv: CDR de chamadas. Todas as chamadas do sistema ficam registradas neste arquivo. Porém, NAO é do billing, nao tem associacao com tarifas ou planos. 8.3 ­ Teste de DTMF
Utilizado para testar se determinada operadora é capaz de fazer callback.
35
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
8.4 ­ Customizar Layout do Cliente
Aqui é possível customizar certos aspectos da área do cliente. Para isso, é possível utlizar os seguintes recursos:
–
–
Arquivo CSS: Efetue o upload de um arquivo CSS para alterar o estilo da área do cliente;
Imagem do Topo: Imagem que será exibida no topo da página na área do cliente.
8.5 ­ Configurações
8.5.1 ­ Chave de Acesso ao WebService
Configure essa chave para usar em aplicações externas que precisem de acesso ao billing.
8.5.3 ­ Exibição do tempo de chamadas Você pode configurar para que seja exibido o tempo real de conexão ou o tempo em blocos. Detalhe que pode ocorrer discrepância de tempo em comparação com as operadoras se usar o tempo real, pois comumente elas configuram a exibição por blocos de 30 (trinta) segundos.
8.5.4 ­ Configurações SMTP
Configurações utilizadas para o envio de e­mail do sistema.
36
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
8.5.5 ­ Dados para emissão de Boleto(*)
Insira aqui os dados para a emissão de boletos diretamente pela área do cliente. Seguem abaixo os campos que devem ser configurados:
– Banco: Selecione aqui o banco de sua preferência;
– Número do Convênio: Número do convênio junto ao banco;
– Número da Agência: Número da agência de seu banco;
– Carteira: Número da carteira junto ao banco;
– Taxa do Boleto: Caso houver, insira aqui a taxa cobrada pela emissão do boleto.
– Instruções: Instruções que serão impressas junto ao boleto (Ex: “Pagável em qualquer agência bancária.”);
– Nome da sua Empresa, Endereço, Cidade, Estado, CPF: Informações que aparecerão junto ao boleto.
– Valores: Valores disponíveis que o cliente terá acesso para escolher.
8.5.6 ­ Pesonalizar os logos da Área Administrativa
Nesta configuração é possível fazer o upload de uma imagem que aparecerá na interface da área administrativa do Billing. Caso for necessário, existe também a opção de voltar o logo padrão do sistema, basta apenas clicar no botão “Voltar Logo Padrão”.
8.5.7. ­ Valor Mínimo para Fechamento Automático
Onde é determinado o valor mínimo do saldo gasto pelo cliente para a ativação automática do pagamento. O fechamento automático só está disponível para clientes pós­pago. Caso nenhum valor seja especificado o sistema utiliza o valor padrão de 150,00. Segue abaixo o campo que devem ser configurado:
–
Valor: Valor mínimo para ativar o fechamento automático. Para valores decimais, utilizar o ponto (.) ao invés da virgula (,).
37
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
9 ­ Monitoramento 9.1 ­ Asterisk Console
9.1.1 ­ Usuários conectados SIP
Este relatório possibilita ver os usuários sip que estão conectados no momento. Para chegar nele entre em “Asterisk console” no menu “Manutenção”, em seguida clique em “Usuários conectados SIP”. No relatório você terá algo como:
–
–
–
–
–
–
–
–
Nome/User do sipfriend
Cartão associado
Nome do cliente
IP do sipfriend
Porta de conexão
Se o reinvite está habilitado
Status da conexão do sipfriend (tempo em milisegundos da conexão, desconhecido (UNKNOW), inalcançável (UNREACHABLE) ou não monitorado, quando o qualify está desabilitado nas configurações do sip friend).
Reinvite (siginifica que o tráfego de voz da ligação não passa pelo servidor, economizando processamento e banda, o que melhora a qualidade e diminui a latência. O reinvite só ocorre quando a chamada é atendida. Portanto, é normal constar reinvite='no' antes que a chamada seja completada.)
9.1.2 ­ Usuarios conectados IAX
Possibilita verificar os usuários IAX que estão conectados no momento. Para chegar nele entre em “Asterisk console” no menu “Manutenção”, em seguida clique em “Usuários conectados SIP”.
Um pouco mais simples que o anterior ele mostra o nome/username, ip/host, a máscara de rede, a porta em que se conecta e o status, assim como o anterior.
38
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
9.1.3 ­ Chamadas em andamento: Nessa opção pode­se constatar quais as chamadas estão em andamento. Para chegar nele entre em “Asterisk console” no menu “Manutenção”, em seguida clique em “Usuários conectados SIP”. A saber temos: origem e o nome associado daquele que fez a chamada, O número discado pelo mesmo, o tempo de ligação ocorrido até o momento, o codec que está sendo utilizado pelo usuário, se o reinvite está ativado, o status do sip friend, e se deseja desligar/terminar com a ligação, útil no caso de uma ligação travada.
9.1.4 ­ Matar ligações e reiniciar Asterisk Cuidado com essa opção, use­a somente se tiver certeza do que está fazendo pois erros podem ocorrer em caso de travamento.
9.2 ­ Ping
Nessa página você pode fazer o teste de ping para qualquer servidor. O teste de ping compara o tempo de envio e resposta de pacotes pela internet. No caso de compara entre servidores voips, até 400ms é um tempo aceitável.
9.3 ­ Gráficos
O monitoramento é feito por gráficos, os quais mostram o uso do sistema em relação ao asterisk, ao uso do disco (hd), ao banco de dados (mysql), ao tráfego nas placas de rede, ao uso do e­mail no sistema (postfix), aos processos do sistema e ao próprio voip.
39
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
10 ­ Revendas
10.1 ­ Revenda por Comissão
Revenda por Comissão é a forma de revenda utilizado atualmente, onde, ao criar o revendedor, o administrador deve selecionar os tariffgroups que o revendedor poderá utilizar para seus clientes.
Esse tipo de revenda é baseado em comissão, portanto o lucro do revendedor é calculado com base na porcentagem de comissão definido na criação deste tipo de revenda.
Com relação aos créditos dos clientes, nos pré­pagos o crédito é dado pelo revendedor e conforme o cliente utiliza vai descontando de seu saldo; assim que o saldo do cliente chega a zero ou é insuficiente para que o cliente realize uma ligação este deve contactar o revendedor para recarga de créditos. Já nos pós­pagos o revendedor define o limite que o saldo do cliente pode ficar negativo e não deve ser inserido créditos à ele para que ele fique com saldo positivo. Conforme o cliente faz ligações o crédito do revendedor é debitado, e se o saldo do revendedor chegar a zero todos clientes pós­pagos serão desativados automaticamente pelo sistema, por isso é importante que quando o revendedor trabalhar com clientes pós­pagos ele se mantenha sempre com saldo de créditos positivo.
10.1.1 ­ Adicionar Revenda Comissionada
Nessa área você irá criar uma nova Revenda Comissionada. Os campos diferentes da Revenda Master são:
–
–
–
–
Login: "username" que o revendedor irá utilizar para acessar sua área no billing.
Senha: senha que será utilizada com o "username" informado no login.
%Comissão: Insira a porcentagem de ganho do revendedor. Caso você defina uma comissão, ao gerar relatórios tanto você quanto o revendedor verão o cálculo de lucro baseado no movimento de ligações dos clientes do revendedor e no movimento de créditos comprados. Você pode deixar 0 e assim o sistema não efetuará o cálculo dessas comissões.
Créditos: Crédito inicial da revenda.
40
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
–
–
–
–
–
–
–
–
Ver Ligações Detalhadas: Essa opção habilita, ou não, que o revendedor veja as ligações detalhadas de seus clientes.
Acesso ao Asterisk Console (Monitoramento): Permite ao revendedor observar em tempo real os usuários conectados e as chamadas em andamento dos mesmos.
Ver Valor de Compra: O revendedor será capaz de ver o valor que você paga na compra das ligações. Normalmente você irá negar a ele essa informação.
Pemissão de Criação: Define se, ao criar um cliente o revendedor poderá definir um status para a conta do cliente. ativo, pode ser usada automaticamente, inativo, necessitará ser ativada pelo administrador responsável e nenhum, não vai definir nenhum status para a conta do cliente.
Campanhas de Áudio: Permite a revenda ativar campanhas de áudio para seus clientes.
Campanhas de SMS: Permite a revenda ativar campanhas de sms para seus clientes.
Callcenter: Permite a revenda disponibilizar o callcenter para seus clientes.
Tariffgroup: Define quais os tariffgroups que o revendedor criado irá poder utilizar junto aos seus clientes.
A partir do campo Nome, insira os dados que achar necessário para a identificação de seu revendedor.
10.2 ­ Revenda­Master
Revenda que especifica o valor de venda. Ela é de certa forma autônoma, one ela não ganha uma comissão, já que ela mesma define por quanto irá revender (obtendo assim seu próprio lucro).
O funcionamento desta revenda deve proceder como descrito abaixo:
1 ­ O administrador deve criar Ratecards para servirem de modelo para o dos revendedores.
OBS1: A criação do Ratecard modelo é igual a de qualquer Ratecard. O preço de venda especificado nas tarifas deste Ratecard será o preço que o revendedor vai pagar ao administrador.
OBS2: Após ter sido criado o Ratecard modelo, quando for feita alguma alteração nele (preço de compra, billingbllock, ou qualquer outro campo), o sistema atualizará todas as tarifas que foram originadas a partir daquele modelo.
2 ­ Agora é necessário criar um novo revendedor (utilizar a nova opção de criação de revendedores). Nele o administrador deve especificar quais os modelos 41
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
de Ratecard (tarifas) que o revendedor terá acesso para poder criar as suas próprias.
Pronto, a nova revenda está criada, agora vamos para a área do novo revendedor:
1­ A primeira coisa que o revendedor deve fazer é abrir o menu "Tarifas" e selecionar a opção "Criar novo Ratecard". Nele o revendedor especificará o nome do ratecard e qual ratecard modelo será usado. 2 ­ Ao criar um novo ratecard o revendedor será redirecionado automaticamente para a área de edição de tarifas (o novo ratecard criado pelo revendedor já estará selecionado e pronto para que ele defina o valor de venda).
3 ­ O revendedor deve definir qual o preço de venda, por padrão será igual ao preço de compra até que um valor seja definido. Ele pode editá­las uma a uma através do botão editar de cada tarifa ou editar várias de uma vez através do campo "Preço de venda" no fim da página.
4 ­ Com os ratecards criados e o preço de venda das tarifas definidos, o revendedor deve criar um novo tariffgroup através do menu "Criar tariffgroup" e selecionar quais ratecards fazem parte deste tariffgroup. Pronto, com os tariffgroups criados o revendedor já pode criar seus clientes com os seus próprios tariffgroups. Sempre que um de seus clientes efetuar uma ligação o valor tarifado será aquele que o revendedor definiu.
Com relação aos créditos dos clientes, a revenda­master pode creditar livremente seus clientes, e toda ligação que eles fizerem, quer seja pré­pago ou pós­pago, será reduzido do saldo atual da revenda­master. Se o saldo ficar igual ou menor que zero o sistema desativará todos os clientes do revendedor, portanto é importante que o revendedor mantenha seu saldo de créditos sempre com valor positivo.
10.2.1 ­ Adicionar Revenda Master
Nessa área você irá criar uma nova Revenda Master. Os campos para preenchimento são:
–
–
–
Login: "username" que o revendedor irá utilizar para acessar sua área no billing.
Senha: senha que será utilizada com o "username" informado no login.
Créditos: Crédito inicial da revenda.
42
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
–
–
–
–
–
–
–
–
Ver Ligações Detalhadas: Essa opção habilita, ou não, que o revendedor veja as ligações detalhadas de seus clientes.
Acesso ao Asterisk Console (Monitoramento): Permite ao revendedor observar em tempo real os usuários conectados e as chamadas em andamento dos mesmos.
Pemissão de Criação: Define se, ao criar um cliente o revendedor poderá definir um status para a conta do cliente. ativo, pode ser usada automaticamente, inativo, necessitará ser ativada pelo administrador responsável e nenhum, não vai definir nenhum status para a conta do cliente.
Campanhas de Áudio: Permite a revenda ativar campanhas de áudio para seus clientes.
Campanhas de SMS: Permite a revenda ativar campanhas de sms para seus clientes.
Gera Boleto: Permite a revenda gerar boletos com dados próprios.
Callcenter: Permite a revenda disponibilizar o callcenter para seus clientes.
Modelo de Tarifa: Aqui você vai definir qual o modelo de tarifa que será aplicada a essa revenda.
A partir do campo Nome, insira os dados que achar necessário para a identificação de seu revendedor.
10.3 ­ Listar Revenda Master/Comissionada
Nesta opção você pode consultar as revendas já criadas em seu sistema. Para isso clique em Listar Comissionadas ou Listar Masters para que seja exibida a listagem. Caso seja necessário alguma alteração, é possível utilizar o botão “editar” ou caso necessário remover uma revenda basta utilizar o botão “deletar”.
10.4 Deletar Revenda
Ao deletar uma revenda, todos os dados referentes a ela serão apagados de maneira irreversível , ou seja, cartões, configurações (SMTP, Boleto, etc), planos e grupos de tarifas, tarifas, créditos e pagamentos.
43
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
11 ­ Configuração dos Administradores
11.1 ­ Adicionar
Crie seus administradores aqui, tenha por preferência preencher todos os campos.
11.2 ­ Adicionar Admin Parcial
Você pode também criar administradores parciais que podem "administrar" apenas certas configurações de seu servidor. Seguem os campos necessários para o cadastro de um administrador parcial:
– Login: "username" que o administrador parcial irá utilizar para acessar sua área no billing.
– Senha: senha que será utilizada com o "username" informado no login.
– Permissões: aqui são definidas quais as áreas que este administrador parcial terá acesso. As opções são:
– Clientes: tem permissão de acesso e configuração no menu “Clientes”.
– Billing: tem permissão de acesso e configuração no menu “Billing”.
– Tarifas: tem permissão de acesso e configuração no menu “Tarifas”.
– Troncos: tem permissão de acesso e configuração no menu “Troncos”.
– Relatórios: tem permissão para acessar o menu “Relatórios”.
– Execuções Periódicas: tem permissão de acesso e configuração no menu “Execuções Periódicas”.
– Administradores: tem permissão de acesso e configuração no menu “Adminstradores”.
– Revenda: tem permissão de acesso e configuração no menu “Revendas”.
– Manutenção: tem permissão de acesso e configuração no menu “Manutenção”.
– Monitoramento: tem permissão de acesso e configuração no menu “Monitoramento”.
– Permissão para Creditar: define se este administrador parcial pode efetuar créditos aos clientes.
44
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
–
–
Callcenter(*): define se este administrador parcial pode liberar o callcenter aos clientes.
Nome, Endereço, CEP, Estado, Telefone, Fax: insira nestes campos os dados cadastrais que você julgar importantes.
11.3 ­ Listar Admin e Admin Parcial
Aqui você pode listar os admnistradores bem como editar suas configurações ou deletá­los.
45