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