Manual de Operação Administrator

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