Upload
phungkien
View
217
Download
1
Embed Size (px)
Citation preview
Manual de Operação
Administrator
Telefonia Convergente
Novembro – 2014
Introdução
A ferramenta Administrator foi criada para facilitar a integração com a plataforma
Zeus, suas funcionalidades vão desde a criação de um assinante até a geração de
faturamento e consulta a base de dados de portabilidade numérica.
Todo acesso no Administrator é monitorado por senhas de acesso, portanto guarda
bem sua senha e em caso de passar para outra pessoa recomendamos substituir
imediatamente.
Os usuários tem através de módulo centralizado o seu acesso restrito a algumas telas,
que quando são bloqueadas não aparecem no menu para acesso.
Somente os funcionários TIP têm permissão de acesso para criação de senhas e
usuários, portanto sempre que necessitar criar um usuário faça isso através do site:
www.tipbrasil.com.br
Qualquer problema com essa aplicação também deverá ser informada pelo site
www.tipbrasil.com.br.
Prezamos-nos pela segurança de nossas plataformas, com isso, o acesso através de
um client foi vital para aumentar o nosso grau de segurança. Todas as consultas,
principalmente aos módulos gráficos dos DashBoards podem ser realizadas através da
WEB, somente quando existe a necessidade de interação com a plataforma isso é
realizado através do console Administrator.
Versão de Software utilizada – 2.3.6
Instalação
Para instalar o administrator e as demais ferramentas Windows da plataforma Zeus é
necessário antes instalar os drivers do ODBC.
Versão:
CPUs – 32 bits
Mysql-connector-odbc-5.1.8-winx32
CPUs – 64 bits
Mysql-connector-odbc-5.1.8-winx64
Tela Principal
Login
Todas as senhas e os usuários ficam centralizados em servidores da TIP, com isso a
criação de usuários deve ser realizada através do site www.tipbrasil.com.br, com a
abertura de chamado específico para essa finalidade.
No primeiro acesso o sistema solicita automaticamente a substituição da senha.
Menu - Funcional
Nesse menu são cadastrados todos os itens de parametrização da plataforma.
Rotas
A tela de Rotas tem a função de auxiliar e facilitar na criação do Dial Plan
(Encaminhamento). Visando a automatização do cadastro dos gateways no Dial Plan da
plataforma deve se preencher essa plataforma com os campos designados.
Tipo – O campo tipo deve ter os seguintes valores:
-LDN
-VC2
-VC3
-0800
-0300
- ESPECIAL
Lista de GWs – Deve ser preenchida com os gateways lógicos a serem usados para a
terminação dessa modalidade de ligações.
EX: 62,67,34
Dessa forma o sistema em caso de erro no GW 62 tentará usar o GW 67 e também em
caso de falha deverá tentar usar o GW 34. Essa reseleção de GW somente acontecerá
para falhas que sejam passíveis de recuperação. Falhas como 404 (Número inválido) ou
por exemplo 486 (Ocupado) não serão consideradas para reseleção. No anexo I tabela
com os códigos de fim de seleção SIP.
Cadastro de Prefixos
Aqui são cadastrados os prefixos locais.
Juntamente ao cadastro dos prefixos são associados os códigos locais das operadoras.
Esse código local, também denominado EOT são utilizados para cálculo do
DETRAF/DETRAT.
O cadastro dos prefixos pode ser feito de forma automática, sendo que o sistema pode
importar as tabelas provenientes do CADUP, contendo as informações de prefixos
locais de todo o Brasil.
Nesse cadastro é importante que sejam cadastrados todos os prefixos de telefones
fixos e os prefixos de telefones móveis.
Após realizado todo o cadastro dos prefixos ou a importação através da CADUP, pode
se gerar o Dial Plan (Encaminhamento) de forma automática, basta pressionar o botão
colorido com um circulo, o sistema dará início a criação e exibirá na barra de progresso
a porcentagem já completada.
É importante informar o Grupo, Cidade, Estado e caso seja necessário o formato E164
(Ex. 5551), e o CN (Código Nacional).
É possível gerar diversos Planos de encaminhamento, permitindo que um determinado
cliente tenha um plano de encaminhamento especifico. Bastando para isso criar um
grupo diferente e associar esse grupo ao cliente em especificado.
Modelo – Arquivo de importação
Arquivo deve estar no formato (CSV-DOS)
Cadastro de Operadoras
Esse cadastro é extremamente importante para a operação correta do sistema é um
dos grandes responsáveis pelo sucesso da plataforma Zeus, com esse cadastro é
praticamente possível fazer 90% do nosso encaminhamento (Dial Plan).
Nesse cadastro são inseridas todas as operadoras com prefixo local na localidade de
utilização da plataforma. Caso a plataforma seja utilizada em diversas localidades, aqui
devem ser colocadas todas as operadoras e seus respectivos códigos (EOT) para cada
localidade. Note que toda operadora é seguida pelo GW e o GW Port, o GW é gateway
lógico por onde as chamadas devem ser entregues e o GW Port é por onde os números
portados para essa operadora devem ser enviados.
Check Box – Atualizar Portabilidade clicado, o Administrator deverá atualizar todos os
números da tabela de portabilidade com o GW Port.
Check Box – Atualizar Dial Plan clicado, o Administrator deverá atualizar todos os
encaminhamentos com o GW.
Check Box – Formato E164 – É para tratar somente os números e prefixos que
estiverem no formato E164.
Ramais
No cadastro de ramais podem ser cadastrados os ramais internos de um cliente,
permitindo a emissão de contas detalhadas por ramal. Vale lembrar que o PABX deve
enviar o número do ramal completo para que essa função possa ser utilizada. Em caso
do PABX enviar sempre o tronco chave essa função também não poderá ser utilizada
com sucesso.
Cadastro de Planos
O cadastro de planos é bastante flexível e pode conter um plano para cada cliente. Na
realidade isso pode ser tratado como tabelas de preços individuais.
Os planos devem bater com os planos cadastrados nos sistemas de gestão, uma vez
que toda a empresa precisa conhecer esses planos e valores.
O campo Código do Plano é alfanumérico e pode ser preenchido de forma a manter a
padronização com o sistema de gestão.
O campo Franquia será utilizado como um valor fixo a ser adicionado a fatura do
cliente.
Os campos subsequentes de minutos locais, LDN, VC1, VC2/VC3 são utilizados para
determinar a quantidade de minutos fazem parte desse pacote de franquia. Por
exemplo: Uma franquia de R$ 14,10 com 100 minutos locais já inclusos. Preenchemos
o campo Minutos Locais com 100 e dessa forma o sistema quando o cliente atingir
esse valor passará a cobrar pelo excedente, estipulado no campo a baixo.
Cadência – É a cadência como serão cobrados os minutos após o mínimo.
Mínimo – É o valor mínimo em segundos que uma ligação terá, e pode ser
estabelecido por tipo de ligação.
Grupos Internacionais – Os países são agrupados de acordo com o custo de suas
terminações, dessa forma os preços de terminação para os usuários finais também
segue essa mesma modalidade.
Locação – Podemos incluir ainda um valor mensal para a locação de equipamentos que
poderá ser cobrada na fatura de telefonia do cliente.
Grupos Internacionais
Visando facilitar a composição de preços e o controle de terminação, os países são
agrupados de acordo com o seu custo de terminação. E essa tabela é responsável por
esse ajuste nos grupos.
Regras de Faturamento
Nessa tabela devem ser colocados todos os períodos de faturamento a serem seguidas
pela plataforma.
A data de vencimento do cliente deve estar associada a um período de corte, em
algumas operações pode existir apenas uma data de corte, mesmo para múltiplas das
de vencimentos. Em outros casos os dias de corte podem ser diferentes.
Uma vez colocada a data de vencimento, e associada uma data de corte, o sistema
verifica através do Mediator toda ligação realizada para verificar a qual faturamento a
chamada pertence. Isso acontece em tempo real, dessa forma se uma data de corte for
escolhida para o vencimento todas as chamadas serão classificadas de acordo com a
data de corte. Por exemplo, uma chamada com corte 05 realizada no dia 17 será
classificada para o faturamento do mês subsequente. Uma chamada realizada em
Dezembro será classificada para o faturamento de Janeiro.
Parâmetros
O preenchimento desses parâmetros é fundamental para o funcionamentos integrado
de todos os módulos uma vez que define parâmetros básicos para o funcionamento de
módulos como billing.
Áreas Locais
A atualização da tabela de portabilidade depende diretamente dessa tabela de áreas
locais, bem como a importação da CADUP para os prefixos locais. Essa tabela deve
estar preenchida para que a importação de prefixos possa acontecer.
Faturamento
O faturamento é fechado na data programada nas regras de faturamento e são
são separados por período e data de vencimento. Os faturamentos passados ficam
congelados e podem ser acessados através do campo Mês.
A pesquisa no arquivo pode ser realizada tanto pelo NAP quanto pelo número do
contrato, não sendo necessário especificar o campo, basta digitar a informação no
campo Pesquisa e o sistema posiciona o cursor no primeiro registro que satisfizer os
requisitos da pesquisa, ou ao mais próximo possível.
Gerar arquivo – Permite gerar um arquivo no formato CSV com as informações do
faturamento.
Faturamento de Assinantes - Analítico
Essa opção permite apenas que os bilhetes dentro do mês corrente sejam analisados.
Para uma análise de todos os CDRs do cliente no período desejado é necessário
acessar o botão correspondente no lado direito da tela de faturamento, onde será
apresentada a tela de Conta Detalhada.
Conta Detalhada
Essa opção permite a impressão da conta detalhada do assinante através da
plataforma.
Arquivo CSV
Linha_Numero;Version_ID;TN;RN1;SPID;EOT;DATA_ATIVACAO;LNP_TYPE;OPERACAO;T
IPO_LINHA;NEW_CNL;DATA_INICIO_JANELA;OPERACAO
6000002;18441162;6599171494;55321;0321;057;19/01/2012
10:25:06;lspp;new;Basic;;19/01/2012 10:25:00;INSERT;
6000003;18454103;6596898809;55321;0321;057;19/01/2012
10:25:09;lspp;new;Basic;;19/01/2012 10:25:00;INSERT;
Importação da base de portabilidade
Cadastro encaminhamento especial
Caso seja necessário o rotear de um número específico, essa função pode ser utilizada.
Basta inserir o número, Grupo e GW para qual a chamada deverá ser direcionada.
Consulta a BDO
Permite a consulta aos números portados.
Essa opção permite que sejam consultados os números portados dentro da área local
estabelecida na opção áreas locais.
Também podem ser eventualmente alteradas as informações, incluindo o GW de
saída, basta realizar a consulta, efetuar a modificação e clicar no símbolo ao lado do
botão de sair.
Menu Plataforma
Cadastro de Encaminhamento (Dial Plan)
Esse é o coração da plataforma, todo o encaminhamento de chamadas é definida aqui.
O encaminhamento está diretamente ligado ao faturamento e ao detraf.
Grupo - Fundamental para o encaminhamento das chamadas, nunca devendo ser igual
a zero. A menos que o destino se restringido.
O campo grupo pode contar uma lista de grupos ao qual é permitida o
encaminhamento de chamadas. Ex: 1,2,3
Prefixo – É o Dial Plan que será analisado a cada ligação efetuada na plataforma.
Gateway – Determina qual a terminação ou provedor de saída a chamada deverá ser
encaminhada, também permite a colocação de listas, dessa forma em caso de falha na
tentativa de envio para o primeiro a chamada é automaticamente encaminhada para o
GW subsequente. São permitidos até 10 tentativas de encaminhamento por ligação.
Tipo de ligação – Esse campo é importantíssimo para o processo de tarifação e deve
sempre seguir o padrão e as siglas já determinadas.
Domínios
A plataforma permite que você utilize um domínio, e também endereço IP, dessa
forma essa tabela deve será preenchida com as opções escolhidas.
Trusted IP
Essa tabela é responsável pela criação dos SIP Trunking.
Identificação – É um campo que pode ser utilizado para identificação do cliente dentro
da Plataforma.
Tronco Chave – Informação de identificador de chamadas
Endereço IP – Endereço IP do PABX
Tech Prefix – Senha a ser inserida por chamada
Contrato – Número do contrato do cliente
Grupo – Grupo a qual pertence o cliente
Plano – Plano ou tabela a qual o cliente deve ser associado.
Cadastro de Clientes SIP
Campos
ID – Gerado automaticamente pelo sistema
Cliente SIP – Número do telefone
Domínio – Domínio ou IP
Senha – Senha da conta SIP (As senhas serão convertidas pelo sistema de
provisionamento e devem passar para o formato de Hash Code, através de MD5)
Contrato – Número do Contrato, utilizado para indexar ao sistema de SMS, ERP, BSS,
OSS ou outros.
E-mail – Campo opcional onde pode ser informado o e-mail do cliente
Para cadastrar um assinante SIP (ATA / MTA ou qualquer outro device SIP, essa tela
deverá ser utilizada)
Os campos em vermelho são de preenchimento obrigatório.
Ao inserir um assinante usando esse botão, o mesmo é cadastrado nas tabelas de
assinante e na tabela de profile, onde ficam armazenados os dados adicionais do
assinante.
Na tela SVA, podem ser cadastrados alguns serviços de valor adicionado.
Também pode ser utilizado um arquivo do tipo csv para a importação de linhas
externas. Ao importar um arquivo o sistema inseri automaticamente o assinante nas
02 tabelas. Assinantes e Profile.
Essa arquivo deve ter o seguinte formato:
Após pressionar o botão de importação ira aparecer na tela um espaço para que o
caminho ao arquivo seja informado. Como sugestão colocar o arquivo em diretório
próximo ao raiz.
O arquivo deve estar no formato csv (MS-DOS)
Ex: C:\TVN\assinantes.csv
Cadastro Profile de usuários
Campos
Vencto – Data de vencimento do cliente, certifique-se de que essa data esteja
cadastrada na tabela de vencimentos.
Ativação – Data de ativação, utilizada para cobrar proporcional a franquia do cliente
no primeiro mês.
Usuário – NAP e o domínio do usuário
Contrato – Número do Contrato, utilizado para indexar ao sistema de SMS, ERP, BSS,
OSS ou outros.
Tech Prefix – Utilizado atualmente para bloqueio dos usuários, o número colocado
pode direcionar a chamada para um Call Center.
Grupos – Determina o grupo ao qual pertence o cliente.
Limite – Limite de crédito do usuário.
Minutos Locais – Quantidade de minutos locais utilizados até o momento, essa
informação é utilizada para determinar a cobrança de minutos excedentes.
Minutos Locais – Quantidade de minutos locais utilizados até o momento.
Gateways - Lógicos
Campos
GW ID – Identificação do GW
Descrição – Descrição do GW
Endereço IP – Endereço IP
Strip – Quantidades de dígitos devem ser retirados no início dos dígitos
Adicionar Dígitos – Dígitos a serem inseridos
Operadora – Código da Operadora (EOT)
Taxa – Descrição da taxa
Valor – Valor da taxa
Taxa – Descrição da taxa
Valor – Valor da taxa
Moeda – Moeda
ASR – Média de completamento de chamadas
Taxa – Descrição da taxa
ACD – Média de duração das chamadas
Usuários – SIP Registrados
Essa tabela apresenta os clientes registrados na plataforma
Buffer de Chamadas
Esses são os CDRs brutos antes de serem tratados pelo Mediator. Após serem tratados
pelo Mediator eles são removidos. A tendência e o ideal é que essa tabela fique
praticamente vazia.
Billing
Os bilhetes tratados são armazenados nessa tabela e podem ser consultados. Essas
tabelas são mensais, portanto a cada dia 01 uma nova tabela é gerada. Esse
mecanismo é utilizado visando manter as tabelas sempre menores e de fácil
manipulação.
Chamadas não completadas
Os bilhetes que tiveram algum problema ou onde as ligações não tiveram duração são
armazenadas nessa tabela, que tem a função de auxiliar a registrar possíveis
problemas de tarifação. Ou falhas crônicas na plataforma.
Trace de chamadas
É possível o rastreamento das mensagens SIP em tempo real, possibilitando o
diagnóstico de problemas.
A plataforma permite que mais de um assinante seja rastreado, entretanto a
localização das mensagens fica um pouco mais complicada a localização das chamadas.
ANEXO I
Código de respostas - SIP
SIP response class1
SIP response codes, class 1: Provisional messages
These are sent within a SIP dialogue
* 100 Trying
* 180 Ringing
* 181 Call Is Being Forwarded
* 182 Queued
* 183 Session Progress
SIP Response class2
SIP Response codes: 2xx class
The 2xx class of responses indicates a success
* 200 OK
* 202 accepted: Used for referrals
SIP Response class3
SIP response codes, class 3xx
The 3xx class of responses indicates a redirection of the call
* 300 Multiple Choices
* 301 Moved Permanently
* 302 Moved Temporarily
* 305 Use Proxy
* 380 Alternative Service
SIP Response class4
SIP responses, class 4: Request failures
* 400 Bad Request
* 401 Unauthorized: Used only by registrars. Proxys should use proxy authorization
407
* 402 Payment Required (Reserved for future use)
* 403 Forbidden
* 404 Not Found: User not found
* 405 Method Not Allowed
* 406 Not Acceptable
* 407 Proxy Authentication Required
* 408 Request Timeout: Couldn't find the user in time
* 409 Conflict
* 410 Gone: The user existed once, but is not available here any more.
* 413 Request Entity Too Large
* 414 Request-URI Too Long
* 415 Unsupported Media Type
* 416 Unsupported URI Scheme
* 420 Bad Extension: Bad SIP Protocol Extension used, not understood by the server
* 421 Extension Required
* 422 Session Interval Too Small
* 423 Interval Too Brief
* 480 Temporarily Unavailable
* 481 Call/Transaction Does Not Exist
* 482 Loop Detected
* 483 Too Many Hops
* 484 Address Incomplete
* 485 Ambiguous
* 486 Busy Here
* 487 Request Terminated
* 488 Not Acceptable Here
* 491 Request Pending
* 493 Undecipherable: Could not decrypt S/MIME body part
SIP Response class5
SIP responses, class 5: Server failures
* 500 Server Internal Error
* 501 Not Implemented: The SIP request method is not implemented here
* 502 Bad Gateway
* 503 Service Unavailable
* 504 Server Time-out
* 505 Version Not Supported: The server does not support this version of the SIP
protocol
* 513 Message Too Large
SIP Response class6
SIP response codes, class 6: Global failures
* 600 Busy Everywhere
* 603 Decline
* 604 Does Not Exist Anywhere
* 606 Not Acceptable
Anexo II
Testes de chamadas