c-voip - commcorp.com.br · imagem 5 – listagem de grupos. 8 1.2 canais também chamados de...
TRANSCRIPT
C-VOIP
COMMCORP VOIP PLATFORM
MANUAL REVENDAS
Última Atualização:
Florianópolis, 3 de Novembro de 2009
2
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
3
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).
4
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 (tar ifas)
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
5
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 q ue será cadastrado
Imagem 4 –Gerenciamento - Grupos
6
4 – Cadastro de Cliente (Wizard) - Criando clientes e canais(linhas/ramais) VoIP
Imagem 3 – Cadastro de Clientes (Wizard)
7
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
8
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.
9
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
10
1.6 Clientes Acesso à relação e cadastro de clientes.
Imagem 11 - Clientes Editando um cliente:
11
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.
12
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)
13
• 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
14
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
15
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
16
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
17
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
18
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
19
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
20
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
21
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
22
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
23
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
24
3.13 Uso Cliente x Dia Relatório de Utilização diária por cliente.
Imagem 40 – Uso Cliente Dia
25
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?log in=seulogin&pwd=suasenha&leg1=554833434500&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/panel-cc/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
26
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.
27
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
28
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 mu danç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 comprometimen to 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 clien tes? 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 p reç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 Preço
minuto _L_days_
week_ _L_hh_sta
rt_ _L_hh_en
d_ _L_specia
l_date_ _L_prefix_
code_ min inc ANDORRA
3765
0,1135
1234567
0 24 ANDORRA-PREMIUM
60 6
29
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: Gerenciam ento -> "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 re venda? Para ver o histórico de créditos (recargas) de sua revenda, acesse
http://panel.commcorp.com.br com o login e senha de sua revenda. No menu de crédito, acesse a opção “Histórico”.
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.