C-VOIP
COMMCORP VOIP PLATFORM
MANUAL REVENDAS
Última Atualização:
Florianópolis, 3 de Novembro de 2009
C-VOIP – PLATAFORMA REVENDA
Conceitos Gerais..................................................................................................................................................... 3
Como Adquirir........................................................................................................................................................ 3
Funcionamento ....................................................................................................................................................... 3
Configuração Inicial ............................................................................................................................................... 4
1. Menu Gerenciamento ......................................................................................................................................... 7
1.1 Grupos ...................................................................................................................................................... 7
1.2 Canais....................................................................................................................................................... 8
1.3 DID x Canal ............................................................................................................................................. 9
1.4 Usuários ................................................................................................................................................... 9
1.5 Logo.......................................................................................................................................................... 9
1.6 Clientes ................................................................................................................................................... 10
1.7 Alterar Senha.......................................................................................................................................... 12
1.8 Customer Wizard .................................................................................................................................... 12
1.9 Recarga................................................................................................................................................... 15
2. Menu Provisionamento..................................................................................................................................... 16
2.1 Equipamento........................................................................................................................................... 16
2.2 DIDs (números entrantes) ...................................................................................................................... 17
2.3 Templates de Pacotes ............................................................................................................................. 17
2.4 Tabelas de Preços................................................................................................................................... 18
3. Relatórios.......................................................................................................................................................... 19
3.1 Cliente x Pacotes .................................................................................................................................... 19
3.2 CDR x Canal........................................................................................................................................... 19
3.3 CDR x Cliente......................................................................................................................................... 20
3.4 CDR Recebido ........................................................................................................................................ 20
3.5 Did x Customer....................................................................................................................................... 20
3.6 CDR x Cliente X Vendedor x Grupo....................................................................................................... 21
3.7 Clientes x Histórico de Crédito .............................................................................................................. 21
3.8 Cliente x Total por período .................................................................................................................... 21
3.9 Suporte ao Cliente .................................................................................................................................. 22
3.10 COS....................................................................................................................................................... 22
3.11 COS por Prefixo ................................................................................................................................... 23
3.12 Conta Corrente..................................................................................................................................... 23
3.13 Uso Cliente x Dia ................................................................................................................................. 24
4. Ferramentas Avançadas.................................................................................................................................... 25
4.1 Integração do Click2Dial............................................................................................................................ 25
4.2 WebService................................................................................................................................................. 26
5. Glossário........................................................................................................................................................... 27
6. Dúvidas Freqüentes (FAQ)............................................................................................................................... 28
6.1. Se meu crédito estiver acabando e eu não puder depositar a tempo, meus clientes serão bloqueados?
...................................................................................................................................................................... 28
6.2. Como faço para solicitar uma nova tabela? A mudança é automática? .............................................. 28
6.3. O que ocorre se eu não atingir o comprometimento mínimo?.............................................................. 28
6.4. Ligações internas são bilhetadas? ........................................................................................................ 28
6.5. Posso Bilhetar ligações internas de meus clientes?.............................................................................. 28
6.6. O que são todas aquelas colunas na tabela de preço? ......................................................................... 28
6.7. Como crio um cliente de cabine (callshop) ? ........................................................................................ 29
6.8. Como contatar o suporte técnico? ........................................................................................................ 29
6.9. Preciso de um servidor para ter meu painel? ....................................................................................... 29
6.10. Como vejo o histórico de créditos de minha revenda? ....................................................................... 29
6.11 Como coloco créditos para um cliente meu? ....................................................................................... 29
2
Conceitos Gerais
Commcorp Revenda é uma plataforma completa para operadoras Voip que desejam focar
seus esforços na venda do produto. Toda a tarefa de roteamento fica a cargo da Commcorp. O
proprietário da revenda adquire créditos e utiliza a terminação de qualidade garantida pela
Commcorp Telecom para os seus clientes.
Como Adquirir
Para se tornar um revendedor Commcorp, é necessário efetuar o cadastro disponível no site
(www.commcorp.com.br) e adquirir créditos para sua revenda. A partir deste ponto o dono da
revenda recebe login e senha para acessar a interface administrativa da revenda
(http://billing.commcorp.com.br).
Funcionamento
Para utilização da plataforma é necessário conhecer alguns conceitos empregados no
sistema.
Para efetuar chamadas voip é necessário possuir um login e senha em um servidor proxy,
que se encarregará de completar as ligações. Neste sistema, um acesso ao servidor proxy é
chamado de CANAL ou Linha. Um Cliente pode possuir um ou mais Canais.
Para que o cliente possa efetuar ligações, a conta deve estar ATIVA e o cliente deve possuir
CRÉDITO ou ser PÓS-PAGO. Uma conta ativa significa que os canais ou linhas deste cliente
estarão habilitados a efetuar chamadas.
Para que as chamadas sejam tarifadas, o cliente deve possuir um PACOTE e este pacote
deve possuir uma TABELA DE PREÇOS. A tabela de preços contém os nomes e os prefixos dos
destinos com seus respectivos preços.
Para iniciar o uso do sistema, então, é necessário primeiro Cadastrar tabelas de Preços,
depois criar os pacotes e por fim cadastrar os clientes e canais (o Customer wizard cadastra cliente
e canais ao mesmo tempo).
3
Configuração Inicial
Para Iniciar a utilização do sistema é necessário seguir a ordem lógica de arranjo dos
elementos. Abaixo é apresentada uma ordem tradicional SIMPLIFICADA para configuração de um
cliente.
1 - Primeira etapa – Crie as tabelas de preços (tarifas)
Imagem 1 – Criando Tabela de Preços
Obs: Deixe selecionada a opção de “Criar automaticamente um ‘Template de Pacote’” ou crie
manualmente através do passo 2
Imagem 2 – Tabela de Preços Criada
4
2 – Criação do Template de Pacote (caso não tenha selecionado a criação automática)
Imagem 3 – Criando Template de Pacote
Imagem 4 –Template de Pacote criado
3 – Passo Opcional – Crie um grupo para o cliente que será cadastrado
Imagem 4 –Gerenciamento - Grupos
5
4 – Cadastro de Cliente (Wizard) - Criando clientes e canais(linhas/ramais) VoIP
Imagem 3 – Cadastro de Clientes (Wizard)
6
1. Menu Gerenciamento
Imagem 4 – Menu Gerenciamento
1.1 Grupos
Grupos servem basicamente para agrupamentos em relatórios. É possível criar seus clientes
definindo um grupo específico, grupo de clientes do nordeste, por exemplo. Esta separação permitirá
produzir relatórios com clientes deste grupo posteriormente.
Imagem 5 – Listagem de Grupos
7
1.2 Canais
Também chamados de linhas. Um canal contém as informações de registro para ser utilizado
no softphone ou ATA
Imagem 6 – Pesquisa Canais
Imagem 7 – Adicionando um Canal
Detalhamento dos campos:
• Cliente - Cliente dono do canal
• Configurações Regionais – Padrão de moeda, data-hora e língua para este canal
• Equipamento – Utilizado no provisionamento automático
• Descrição – Nome ou descrição do canal
• Login: Login para acesso ao painel apenas com dados referentes a este canal
• Senha: Senha para acesso ao painel
• Quantidade – Quantidade de canais a serem criados. A senha é gerada automaticamente.
• Save Provisioning – Apenas funcional quando o auto provisionamento for utilizado.
8
1.3 DID x Canal
Exibe a relação de Números entrantes (DIDs) associados a canais. Para que um número
entrante funcione ele deve estar associado a um canal ou linha.
Nesta relação é possível associar e desassociar DIDs de canais.
Imagem 8 – DID x Canal
1.4 Usuários
Usuários com permissão de acesso ao sistema.
Imagem 9 - Usuários
1.5 Logo
Imagem em formato jpg, gif ou png para ser exibida no cabeçalho de todas as páginas da
administração
Imagem 10 - Logo
9
1.6 Clientes
Acesso à relação e cadastro de clientes.
Imagem 11 - Clientes
Editando um cliente:
10
Imagem 12 – Editando Cliente
Dados configuráveis:
• Vendedor – Vendedor responsável (para ser utilizado em relatórios). O cadastro de Vendedores está no
cadastro de usuários. Um usuário pode ser um vendedor.
• Status – Active / Blocked. Para que o cliente pssa efetuar chamadas, deve estar Active.
• Configurações Regionais – Padrão de moeda, data-hora, etc.
• Voicemail – Se ativo, o cliente poderá configurar voicemail no painel (panel.commcorp.com.br)
• Grupo – Grupo para relatórios
• Plano de Discagem – Esta opção permite ativar um plano de discagem local para os canais do cliente. O
plano de discagem funciona da seguinte forma:
Exemplo Plano de discagem Brasil-2-SC-48:
Ligações longa distância: 0+ddd+número (ex.: 01133454545)
Ligações internacionais: 00+número com código (ex.: 00195412125478)
Ligações Locais: número local (ex.: 33434512 -> completará chamada para 554833434512)
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Habilitar Cabine – Se esta opção estiver marcada, este cliente terá acesso ao sistema de cabines
(http://callshop.commcorp.com.br)
Primeiro nome – Primeiro nome do cliente
Sobrenome – Sobrenome do cliente
Email – Endereço de email do cliente
Habilitar Click2dial – Click2dial é um sistema que permite efetuar chamadas a partir da internet. Para
que ele esteja disponível no painel (panel.commcorp.com.br) é necessário ativar aqui antes. A Ativação
compreende em selecionar um dos canais do cliente para que seja o canal base para tarifação das
chamadas.
Tipo de cobrança – Pré-pago ou pós-pago. Clientes pré possuem crédito decrementado
automaticamente. Clientes pós devem ser cobrados manualmente (com base nos relatórios de
utilização).
Data de início – Data de criação do cliente
Data fim – Clientes ativos devem estar com data fim maior do que o dia corrente.
Painel Login – Login para acesso ao painel (http://panel.commcorp.com.br)
Painel Senha – Senha para acesso painel
Tipo de cobrança – Pós-pago ou pré-pago
Crédito – Crédito inicial para clientes pré-pagos
Endereço1 – Endereço do cliente
Endereço2 – Endereço do cliente
Número – Número endereço
Código Postal – CEP
Cidade
Estado
País
Nome para cobrança – Responsável pelo pagto
Telefone para cobrança – Tel de contato cobrança
Pacote – São os planos de tarifação do cliente. Um cliente pode possuir diversos planos.
11
1.7 Alterar Senha
Permite trocar a senha do usuário logado no momento.
Imagem 13 – Alterar Senha
1.8 Customer Wizard
Um Passo-a-Passo para criação de novos clientes e canais.
Imagem 14 – Wizard 1
Dados configuráveis:
• Vendedor – Vendedor responsável (para ser utilizado em relatórios). O cadastro de Vendedores está no
cadastro de usuários. Um usuário pode ser um vendedor.
• Status – Active / Blocked. Para que o cliente pssa efetuar chamadas, deve estar Active.
• Configurações Regionais – Padrão de moeda, data-hora, etc.
• Grupo – Grupo para relatórios
• Cabine – Se esta opção estiver marcada, este cliente terá acesso ao sistema de cabines
(http://callshop.commcorp.com.br)
12
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Primeiro nome – Primeiro nome do cliente
Sobrenome – Sobrenome do cliente
Email – Endereço de email do cliente
Login – Login para acesso ao painel (http://panel.commcorp.com.br)
Senha – Senha para acesso painel
Tipo de cobrança – Pós-pago ou pré-pago
Crédito – Crédito inicial para clientes pré-pagos
Endereço1 – Endereço do cliente
Endereço2 – Endereço do cliente
Número – Número endereço
Código Postal – CEP
Cidade
Estado
País
Nome para cobrança – Responsável pelo pagto
Telefone para cobrança – Tel de contato cobrança
Imagem 15 – Wizard 2
Dados configuráveis:
• Template de Pacote – Plano de cobrança do cliente
• Nome – Nome do pacote – copiado do template
• Tipo de limite – Minuto / Sem limite. Um pacote pode ter um limite de minutos, significando que a
tabela associada será utilizada até o limite de minutos do plano (renovável mensalmente). Por exemplo:
Um plano com 400 minutos de limite e uma tabela de tarifa com preço 0 para São Paulo Significa que
durante um mês, até o limite de 400 minutos, as ligações para São Paulo serão gratuitas.
• Valor de limite – Valor de minutos – se utilizado
• Prioridade – Um cliente pode possuir vários planos. Eles são processador de acordo com a prioridade
• Dia de vencimento – Dia do mês em que o plano volta ao valor original
• Preço mensal – Preço a decrementar mensalmente do cliente com este plano
• Setup Price – Preço inicial
13
Imagem 18 – Wizard 3
Dados configuráveis:
• Descrição – Descrição / Nome do canal(linha/ramal) VoIP
• Quantidade – Quantos canais devem ser criados
Imagem 19 – Wizard 4
Imagem 160 – Wizard 5
14
1.9 Recarga
Recarga de Créditos da Revenda. No canto superior direito é exibido o saldo atual da conta
de Revenda
Imagem 171 – Recarga
Imagem 182 – Recarga Site
15
2. Menu Provisionamento
Imagem 19 – Menu Provisionamento
2.1 Equipamento
Neste item é feito o cadastro dos ATAs ou telefones IP que possuam sistema de
provisionamento por http. É necessário fornecer acesso a um aparelho de testes para homologação
prévia no sistema de provisionamento automático.
Imagem 20 – Equipamento - Listagem
Imagem 21 – Adicionando Equipamento
16
2.2 DIDs (números entrantes)
Os Números entrantes previamente liberados para a revenda estarão disponíveis neste item.
Imagem 22 – Relação DIDs
2.3 Templates de Pacotes
Templates de pacotes são os planos para venda aos clientes.
Imagem 23 – Template Pacotes
Imagem 24 – Adicionando Template Pacotes
17
2.4 Tabelas de Preços
Tabelas de preços contém as tarifas para todos os destinos oferecidos.
Imagem 25 – Relação Tabela de Preços
Imagem 26 – Adicionando Tabela de Preços
18
3. Relatórios
Imagem 27 – Menu Relatórios
3.1 Cliente x Pacotes
Relatório de Planos – Pacotes por Clientes
Imagem 28 – Relatório Cliente x Pacotes
3.2 CDR x Canal
Relatório de Ligações Efetuadas detalhadas (CDR = Call Detail Record) por Canal.
Imagem 29 – CDR x Canal
19
3.3 CDR x Cliente
Relatório de Ligações Efetuadas detalhadas (CDR = Call Detail Record) por Cliente.
Imagem 30 – CDR x Cliente
3.4 CDR Recebido
Relatório de Ligações Recebidas detalhadas (CDR = Call Detail Record)
Imagem 31 – CDR Recebido
3.5 Did x Customer
Relatório de números entrantes (DIDs) por Clientes.
Imagem 32 – DID x Customer
20
3.6 CDR x Cliente X Vendedor x Grupo
Relatório de CDR com filtros de Cliente, Vendedor e Grupo.
Imagem 33 – CDR x Cliente x Vendedor x Grupo
3.7 Clientes x Histórico de Crédito
Relatório de Recargas e estornos ou ajustes de crédito por clientes.
Imagem 34 – Clientes x Histórico Crédito
3.8 Cliente x Total por período
Relatório agrupado de consumo por cliente para um determinado período.
Imagem 35 – Cliente x Total Período
21
3.9 Suporte ao Cliente
Relatório de detalhes dos clientes para contato por time de tele atendimento.
Imagem 36 – Suporte ao Cliente
3.10 COS
Relatório de Margem de Lucro.
Imagem 37 – Margem de Lucro Dia
22
3.11 COS por Prefixo
Relatório de Margem de lucro por destino. Permite descobrir a margem de lucro para cada
destino cadastrado e identificar locais com melhor ou pior margem de lucro.
Imagem 38 – COS Prefixo
3.12 Conta Corrente
Relatório de utilização – saldo por cliente
Imagem 39 – Conta Corrente
23
3.13 Uso Cliente x Dia
Relatório de Utilização diária por cliente.
Imagem 40 – Uso Cliente Dia
24
4. Ferramentas Avançadas
As informações contidas neste capítulo se destinam a técnicos e engenheiros de sistema.
As ferramentas click2dial (disponível no painel – http://panel.commcorp.com.br) e funcionalidades da
plataforma (consulta a saldo, cadastro de clientes, resumo de ligações e demais funções) podem ser
acessadas a partir de sistemas externos utilizando os métodos propostos a seguir.
4.1 Integração do Click2Dial
Para utilizar o sistema de click2dial externamente basta efetuar um GET conforme segue:
http://panel.commcorp.com.br/autoclick2dial.php?login=seulogin&pwd=suasenha&leg1=5548
33434500&leg2=554833434501
Ainda fornecemos um exemplo completo de um cliente em php integrado com o click2dial.
<html>
<body>
<h1>Click 2 Dial</h1>
<form action="click2dial_dial.php" method="post">
Discar de: <input type="text" name="leg1"> para <input type="text"
name="leg2">
<br>
<input type="submit" value="Enviar">
</form>
</body>
</html>
Tabela 1 – Código fonte click2dial.html
<?php
###################################################
#################CONFIGURE#########################
###################################################
$login = "login do cliente - customer";
$pwd = "senha";
###################################################
####################FIM############################
###################################################
$leg1 = $_POST['leg1'];
$leg2 = $_POST['leg2'];
$res = fopen("http://panel.commcorp.com.br/panelcc/autoclick2dial.php?login=$login&pwd=$pwd&leg1=$leg1&leg2=$leg2", 'r');
$result = fread($res, 8190);
echo '<pre>';
print_r($result);
echo '</pre>';
?>
Tabela 2 – Código-fonte do click2dial_dial.php
25
4.2 WebService
Webservice é uma maneira de integrar seu sistema diretamente à interface de Revendas da
Commcorp. Com o uso de SOAP 1.2, todas as funções estão disponíveis externamente.
Com o Webservice é possível enviar e receber informações da Plataforma C-Voip como, por
exemplo, enviar comandos para criação de clientes e canais e receber informações de saldo de
clientes pré-pagos. A utilização de integração com Webservices está disponível mediante
solicitação. Um documento técnico de apoio é fornecido no momento da liberação.
26
5. Glossário
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Carrier: Operadora de telefonia que transporta/interconecta chamadas
CODEC: Codificador / Decodificador. Padrão de encapsulamento.
Proxy: Serve como intermediário para transporte de chamadas. Faz o papel de Session
Border Controller.
VoiceMail: Caixa postal de chamadas
OLAP: Online Analytical Processing
Forward: Encaminhamento de chamadas
LCR: Less Cost Route – Rota de menor custo.
ASR: Average Success Rate
ACD: Average Call Duration – Duração media das chamadas
IVR: Interactive Voice Response.
DTMF: Dual Tone MultiFrequential. Tons de duas freqüências utilizados em telefonia.
SMS: Short Message Service
POST: No sentido web, envio de formulários através do protocolo http.
SSL: Secure Sockets Layer
ATA: Adaptador de telefone analógico
27
6. Dúvidas Freqüentes (FAQ)
6.1. Se meu crédito estiver acabando e eu não puder depositar a tempo, meus clientes serão
bloqueados?
O sistema pode ser configurado para emitir um aviso por e-mail quando o crédito estiver
perto do fim. Se mesmo assim ocorrer um descuido no controle do crédito, existe a opção de se
efetuar uma recarga por Cartão de Crédito e receber o crédito imediatamente.
6.2. Como faço para solicitar uma nova tabela? A mudança é automática?
A mudança não é automática. Caso deseje migrar para um plano mais agressivo, deve
solicitar por e-mail a [email protected]
6.3. O que ocorre se eu não atingir o comprometimento mínimo?
Caso não atinja o comprometimento mínimo após o período de carência, o mês de apuração
será re-bilhetado de acordo com a tabela imediatamente anterior nesta ordem: Zero-500-1000. Esta
será a nova tabela a partir deste momento.
6.4. Ligações internas são bilhetadas?
Ligações internas não são bilhetadas em nenhum plano de revendas. O único limite é o da
revenda zero, que possui até 50 ramais para ligação interna. Os planos 500 e 1000 possui número
ilimitado de ramais internos.
6.5. Posso Bilhetar ligações internas de meus clientes?
Sim. Para fazer isso, cadastre na tabela de preço do cliente uma linha contendo o código
assim: “INTRA” – sem as aspas – informando o valor por minuto.
6.6. O que são todas aquelas colunas na tabela de preço?
Nome – Nome da rota
Code – Código do destino
Preço minuto – Preço por minuto
_L_days_week_ - Dias da semana em que a tarifa é válida (1234567 significa todos os dias). O
número 1 é segunda. (http://www.ietf.org/rfc/rfc3339.txt)
_L_hh_start_ - Hora de início desta tarifa (0 é o padrão)
_L_hh_end_ - Hora de término desta tarifa (24 é o padrão)
_L_special_date_ - Datas especiais para funcionamento da tarifa
_L_prefix_code – Não é necessário preencher, o sistema preenche automaticamente de acordo com
o nome padrão de seu custo.
Min – Mínimo (ex.: 60 segundos)
Inc – Incremento (ex.: 6 segundos)
Nome
Code
ANDORRA 3765
Preço
minuto
0,1135
_L_days_
week_
1234567
_L_hh_sta _L_hh_en
rt_
d_
0
24
_L_specia _L_prefix_
l_date_
code_
ANDORRA
-PREMIUM
min
60
inc
6
28
6.7. Como crio um cliente de cabine (callshop) ?
Para criar um cliente de callshop siga os passos:
-- Entrando no billing.commcorp.com.br
1) Gerenciamento -> Clientes -> Adicionar Cliente
Preencha os campos e marque a opção "Habilitar Cabine [ x ] "
Preencha os campos de login e senha (recomendamos informar um login mais elaborado por
exemplo "nome.sobrenome" ou o email do cliente)
2) Gerenciamento -> Canais -> Adicionar Canal
- Selecione o cliente que você acabou de criar
- Quantidade informe a quantidade de canais (cada canal representa uma cabine) (Não
recomendamos criar mais de 12 cabines por cliente)
- Na descrição você pode informar "Cabine (#)" (os símbolos "(#)" serão substituídos por um
número incremental)
* Uma opção mais prática é usar o Wizard: Gerenciamento -> "Customer Wizard"
-- Aguarde de 10 a 20 minutos para as cabines serem ativadas
3) Após esse período você conseguirá logar no sistema de callshop
(http://callshop.commcorp.com.br) utilizando as informações de login e senha informados no
cadastro do cliente.
Para maiores informações consulte nosso manual, o link encontra-se no sistema do billing e é
representado por um ícone com uma interrogação "( ? )".
6.8. Como contatar o suporte técnico?
Opções:
Email: [email protected]
Telefone PSTN: +55 48 3343-4500
Número VOIP: 2000. Basta registrar uma conta no sps2.commcorp.com.br qualquer e telefonar sem
custos para o suporte.
6.9. Preciso de um servidor para ter meu painel?
Não é necessário nada para utilizar a plataforma de revenda Commcorp. Toda a estrutura,
servidores, gerenciamento de roteamento é feito pela Commcorp. O painel dos usuários é
disponibilizado em estrutura da própria Commcorp.
Caso você deseje montar um site de venda para seus clientes e fazer a integração com
webservices será necessário possuir um local para hospedagem do seu site de venda apenas.
6.10. Como vejo o histórico de créditos de minha revenda?
Para
ver
o
histórico
de
créditos
(recargas)
de
http://panel.commcorp.com.br com o login e senha de sua revenda.
No menu de crédito, acesse a opção “Histórico”.
sua
revenda,
acesse
6.11 Como coloco créditos para um cliente meu?
Para inserir crédito, entre na tela de relação de clientes em Gerenciamento/Clientes. Clique
em cima do valor do crédito e então no botão “Adicionar Crédito”. Preencha o valor e a descrição e
clique em enviar. Se o cliente estiver bloqueado, ele continuará bloqueado. Para desbloquear,
acesse o formulário do cliente, mude para ativo e clique em enviar.
29