Skip to end of metadata
Go to start of metadata

 

MÓDULO PORTABILIDADE  - MANUAL DO USUÁRIO


Versão 1.1

 

Disponível para Snep versões :

Série 1.3: >= 1.3.10

Série 2: >= 2.0

Série 3: >= 3.0-betha-rc2

 

Todos os direitos são reservados. É vedada, no todo ou em parte, a sua reprodução por toda a sorte de formas e meios conhecidos. Seu conteúdo tem caráter técnico-informativo e os editores se reservam ao direito de revisar as versões, de modo a aproveitar a totalidade ou parte deste trabalho, sem necessidade de qualquer forma de aviso prévio.

Palhoça, abril de 2015.

 

1 - Introdução

 

O SNEP é uma família de soluções capaz de transformar a comunicação das Empresas, integrando voz, dados e sistemas.

Na função de um PBX IP Híbrido (digital, Analógico e IP), Gerenciador de Contact e Call Center , Monitoramento de qualidade de atendimento e Gateway de voz, o SNEP é um forte aliado para reduzir os custos com comunicação e aumentar a eficiência nas relações empresariais.

Solução completa de telefonia para atuar como PBX IP e TDM, Gestão de CallCenter e ContactCenter.

O módulo Portabilidade tem o objetivo de efetuar a consulta do número(celular) antes da ligação. Essa consulta é feita através de uma requisição RestFull no serviço do portabilidade Opens.

 

Importante: O módulo Portabilidade versão 1.0 depende de um cliente cadastrado em https://itc.opens.com.br para funcionar e este manual irá mostrar somente as funcionalidades adicionais fornecidas pelo módulo. 

 

Seja bem vindo!

Família Snep

 

2 - Funcionamento

 

O módulo Portabilidade provê o serviço de consulta de números de telefone celular a uma base de dados. O retorno será o mesmo número enviado, porém acrescido de um sufixo que representa o código RN1 da Operadora (Veja item 5.3 deste documento).

Para o uso deste módulo do SNEP o cliente deverá possuir, aém do próprio SNEP (versão 2.0 ou maior), uma conta no endereço https://itc.opens.com.br  (veja item 3 - Intercomunexão abaixo). Para poder efetuar consultas, é necessário ter  créditos disponíveis.

No SNEP, é necessário a criação de uma regra contendo a ação "Portability", que efetua a consulta de Portabilidade. Após a consulta, e retornado o código da operadora junto com o número enviado. A partir deste momento a chamada é encaminhada para uma próxima regra que, por sua vez, deverá tratar este código.

IMPORTANTE: Para o funcionamento da consulta, todos os números pesquisados devem estar no formado DDD + número. Exemplo: 4899998888. 

 

3 - Intercomunexão


Para cadastrar um usuário na Intercomunexão, acesse o endereço   https://itc.opens.com.br e clique em cadastrar. Após finalizar o cadastro do usuário, será disponibilizado no Dashboard da Intercomunexão o serviço de Portability, onde conterá todos os dados necessários para acompanhamento do serviço como relatórios de consumo, suporte e opção de comprar pacotes de consultas.

 

 

 

4 - Instalação na versão 1.3.X do Snep

 

ATENÇÃO

Icon
IMPORTANTE: Compatível apenas com SNEP versões 1.3.10 ou mais recentes

4.1 Manual

4.2 - Via instalador


5 - Instalação na versão 2.0 do Snep.

5.1 Manual

5.2 - Via instalador

 

6 - Instalação na versão 3.0 do Snep

ATENÇÃO

Icon
IMPORTANTE: Compatível apenas com SNEP versões 3.0-betha-rc2 ou mais recentes

6.1 Manual

6.2 - Via instalador

7 - Configuração : Snep 1.3.X e Snep 2.0

O módulo introduz uma nova ação chamada Portability, onde possuirá alguns parâmetros de configuração. Abaixo segue um exemplo de uma regra de consulta da Portabilidade. Esta regra deve abranger a todos os números a serem consultados.

 

Os dados da Chave do cliente, Chave da API e UUID do Snep são fornecidos em https://itc.opens.com.br nas guias Chave API e Dispostivos, conforme figura abaixo.

 



8 - Configuração : Snep 3

O módulo introduz uma nova ação chamada Portability, onde possuirá alguns parâmetros de configuração. Abaixo segue um exemplo de uma regra de consulta da Portabilidade. Esta regra deve abranger a todos os números a serem consultados.

 

Diferentemente do módulo portabilidade das versões anteriores do Snep, esta versão não necessita que o cliente tenha que informar suas chaves na ação, sendo que esse valor já é informado na consulta pelo próprio Snep ao se conectar com o ITC.

A ação portabilidade possui como configuração os seguintes campos:

  • Tratamento de números inexistentes: Essa configuração faz com que caso algum número consultado não encontre nenhuma operadora, poderá escolher por tocar um áudio informando ou inserir um prefixo ao número informando, fazendo com que esse número retorne para uma regra específica.
  • Prefixo para tratamento de números inexistentes: Ao escolher a opção "Inserir prefixo para tratamento" no item anterior, é necessário informar este prefixo. O valor deve obrigatoriamente conter 5 dígitos. É obrigatório criar uma regra de negócios tratando este prefixo. 

9 - Retornos

Ao efetuar a consulta é retornado 4 tipos de resultado conforme a solicitação

  • Sucesso -> A consulta identifica a operadora do número informado e retorna o valor da operadora. Por exemplo: É feito uma consulta do número 4899998888,  o serviço retorna o valor 553204899998888, onde:

                 O valor 55 é o código nacional.

                 O valor 320 é o código da Operadora.

                 4899999999 é o número informado. 

  • Erro 1 -> A consulta informará um erro quando as chaves informadas na consulta não serem compatíveis com a do cadastro no sistema. 
  • Erro 2 -> A consulta informará um erro quando o usuário não possuir créditos disponíveis.
  • Erro 3 -> A consulta informará um erro quando o número informado não esteja no formato especificado (DDD+Número).

 

IMPORTANTE: Quando o retorno é do tipo Sucesso, a regra envia o número para o contexto default, onde o Snep deverá possuir uma regra para tratamento deste número. 
Quando o retorno é algum erro, é informado um áudio de erro no processo na ligação.

9.1 - Fluxo de Consulta e Roteamento dentro do SNEP

Gliffy Zoom Zoom Fluxo Portabilidade

9.2  - Tratamento de consultas

Quando é retornado a operadora do número informado a ligação é reenviada para o contexto Default, onde deverá cair na regra que abrange aquele número. Deverá ser criada regras para tratamento das operadoras. 

Exemplo: Ao efetuar a consulta por o número 4899998888, a API retornará 553204899998888. O código 320 pertence a operadora Vivo, então no Snep deverá conter uma regra identificando o destino como alias = 55320. , onde a saída será efetuada pelo Chip Vivo, por exemplo.

No módulo se encontra um arquivo que contém algumas regras padrões, onde é necessário somente mudar as ações escolhendo a melhor rota possível.

9.3 - Código das Operadoras

Abaixo segue a tabela de códigos retornados pelo serviço de Portabilidade e suas respectivas operadoras para tratamento da regra.

9.3.1 Códigos RN1 das Operadoras Telefone Móvel

CódigoOperadora
55314 BRASILTELECOM - (PR E SC)
55324AMAZONIA CELULAR S.A. (PA)
55321AMERICEL S.A.
55321BCP S.A.
55312CTBC CELULAR S.A.
55301DATORA TELECOMUNICAÇÕES LTDA
55391FALKLAND TECNOLOGIA EM TELECOMUNICAÇÕES LTDA
55393GLOBALSTAR DO BRASIL S/A
55392IRIDIUM SUDAMÉRICA - BRASIL S/A
55351NEXTEL SERVIÇOS DE TELECOMUNICAÇÕES LTDA.
55377NEXTEL
55349OPTIONS COMP & ELET LTDA
55302PORTO SEGURO TELECOMUNICAÇÕES S.A.
55343SERCOMTEL CELULAR S.A.
55303SISTEER DO BRASIL TELECOMUNICAÇÕES LTDA
55375SUPERCHIP TELECOMUNICAÇÕES LTDA
55390TELCOM TELECOMUNICACOES DO BRASIL LTDA
55323TELEMIG CELULAR S.A.
55304TERAPAR PARTICIPAÇÕES LTDA
55341TIM CELULAR S.A. (REGIÃO III)
55341TIM NORDESTE S.A. - BA E SE
55341TIM NORDESTE S.A. - MG
55331TNL PCS S.A.
55337UNICEL
55305VIRGIN MOBILE TELECOMUNICAÇÕES LTDA
55320VIVO S.A.

Fonte: Anatel

 

9.3.2 Códigos RN1 das Operadoras Telefone Fixo

CódigoOperadora
55225A. P. OLIVEIRA
55222ADP3 TEELCOMUNICAÇÕES LTDA
55176ADYL NET ACESSO A INTERNET LTDA
55127AEROTECH TELECOMUNICACOES LTDA
55173ALPHA
55106AMERICA NET LTDA
55146AMIGO TELECOMUNICAÇÕES LTDA
55216AMPERNET TELECOMUNICAÇÕES LTDA
55148AUE PROVEDOR DE INTERNET LTDA
55205AVA TELECOMUNICAÇÕES LTDA
55149BBS OPTIONS
55232BCMG INTERNET LTDA
55252BLUE TELECOMUNICAÇÕES LTDA
55208BMBB SERVIÇOS DE COMUNICAÇÃO LTDA
55157BR GROUP TELECOMUNICAÇÕES LTDA
55235BRASIL DIGITAL TELECOMUNICAÇÕES LTDA
55114BRASIL TELECOM FILIAL/AC
55114BRASIL TELECOM FILIAL/DF
55114BRASIL TELECOM FILIAL/GO
55114BRASIL TELECOM FILIAL/MS
55114BRASIL TELECOM FILIAL/MT
55114BRASIL TELECOM FILIAL/PR
55114BRASIL TELECOM FILIAL/RO
55114BRASIL TELECOM FILIAL/RS(CRT)
55114BRASIL TELECOM FILIAL/RS(CTMR)
55114BRASIL TELECOM FILIAL/SC
55114BRASIL TELECOM
55231BRASILFONE COMUNICAÇÃO LTDA - ME
55254BRASREDE TELECOMUNICAÇÕES LTDA
55147BT COMMUNICATIONS DO BRASIL LTDA
55152CABO SERVIÇOS DE TELECOMUNICAÇÕES LTDA
55150CAMBRIDGE TELECOMUNICAÇÕES LTDA
55213CARVALHAES INFORMÁTICA LTDA ME
55160CGB VOIP INFORMÁTICA E COMUNICAÇÃO LTDA
55203CIA ITABIRANA DE TELECOMUNICAÇÕES LTDA
55112CIA TELECOMUNICAÇÕES DO BRASIL CENTRAL
55223CITTÀ TELECOM LTDA
55236CONECTA S J DEL-REI LTDA
55189CONECTA TELECOMUNICACOES S.A
55132CONVERGIA
55234CORDIA COMUNICAÇÕES S/A
55206DESKTOP SIGMANET COMUNICAÇÃO MULTIMÍDIA LTDA
55124DIALDATA TELECOMUNICAÇÕES LTDA
55202DIGI SOLUÇÕES DE COMUNICAÇÃO LTDA
55103DIGITAL DESIGN - SEVIÇOS DE INFORMÁTICA LTDA - DIPELNET
55104DIOGENES BAYDE IMPORTADORA E EXPORTADORA LTDA
55136DSLI
55197EAD - ENSINO À DISTÂNCIA LTDA
55135EASYTONE
55121EMBRATEL
55110ENCANTO TELECOM COM. E SERV. EM TELECOMUNICAÇÕES LTDA
55156ENGEVOX
55199ENSITE BRASIL TELECOMUNICAÇÕES LTDA
55214EQUANT BRASIL LTDA
55155ESPAS TELECOMUNICAÇÕES LTAD
55134ETML - EMPRESA DE TELEFÔNIA MULTIUSUÁRIO LTDA
55191FALKLAND TECNOLOGIA EM TELECOMUNICAÇÕES LTDA
55116FIDELITY TELECOMUNICAÇÕES E MULTIMÍDIA S.A
55113FONAR TELECOM
55154G30 TELECOM SERVIÇOS DE TELECOMUNICAÇÕES LTDA
55221GGNET TELECOMUNICAÇÕES LTDA
55145GLOBAL CROSSING COMUNICACOES DO BRASIL LTDA
55108GLOBAL OSI BRASIL TELECOMUNICAÇÕES E CONECTIVIDADE LTDA
55228GLOBAL TELECOM EIRELI
55125GLOBAL VILLAGE TELECOM
55137GOLDEN LINE TELECOM LTDA
55218GRANDI SISTEMAS DE INFORMAÇÕES LTDA
55204GRUPO G1 TELECOMUNICAÇÕES LTDA
55142GT GROUP INTERNATIONAL BRASIL TELECOMUNICAÇÕES LTDA
55120GTI TELECOMUNICAÇÕES LTDA
55163HELLO BRAZIL TELECOMUNICACOES LTDA
55201HIT TELECOMUNIAÇÕES LTDA
55251HOINASKY E SKLASKY LTDA - ME
55140HOJE SISTEMAS DE INFORMÁTICA LTDA
55111IBITURUNA TV POR ASSINATURA LTDA
55126IDT
55241INFORMÁTICA ITAPIRANGA LTDA EPP
55123INTELIG TELECOMUNICACOES LTDA
55144IPÊ INFORMÁTICA LTDA
55122ITAVOICE SERVIÇOS DE TELECOMUNICAÇÕES LTDA
55196IVATI INOVAÇÃO E INTERATIVIDADE S/A
55229JOSÉ FELIPE GORNISKI
55151LAFAIETE PROVEDOR DE INTERNET E TELECOMUNICAÇÕES LTDA
55102LIFE SERVIÇOS DE COMUNICAÇÃO MULTIMÍDIA LTDA
55198LIGUE TELECOMUNICAÇÕES LTDA
55250LINKTEL TELECOMUNICAÇÕES DO BRASIL LTDA
55159LOCAL
55170LOCAWEB TELECOM TELECOMUNICAÇÕES LTDA
55109MAHA-TEL TELECOMUNICAÇÕES LTDA
55237MARCELO MOREIRA DIONÍSIO GOIÁS TELECOM
55184METROWEB TELECOMUNICAÇÕES LTDA
55238MHNET EMPREENDIMENTOS LTDA
55210MORANGO TELECOMUNICAÇÕES LTDA
55162MUNDIVOX
55195NEBRACAM - CAMARA BRASILEIRA DE NEGÓCIOS
55207NEOLINK TELECOMUNICAÇÕES LTDA
55246NEOTELECOM TELECOMUNICAÇÕES LTDA
55139NETGLOBALIS TELECOMUNICAÇÕES DO BRASIL LTDA
55253NETWORK TELECOMUNICAÇÕES LTDA-EPP
55133NETWORLD PROVEDOR E SERVIÇO DE INTERNET LTDA
55161NEXUS TELECOM
55239NOGUEIRA
55178NORTELPA
55177OPÇÃONET INFORMÁTICA LTDA
55153OSTARA TELECOMUNICACOES LTDA
55243OTOGROUP SERVIÇOS DE TELECOMUNICAÇÕES LTDA
55179OTS - OPTION TELECOM SERVIÇOS DE TELECOMUNICAÇÕES LTDA
55255OXMAN TECNOLOGIA LTDA
55180PLUMIUM COMUNICAÇÃO E MARKETING LTDA
55200PORTO VELHO TELECOMUNICAÇÕES LTDA
55219POWERSAT SERVIÇOS DE TELECOMUNICAÇÕES
55240PREDLINK REDE DE TELECOMUNICAÇÕES LTDA
55230R S T SERVIÇOS DE TELECOMUNICAÇÕES LTDA
55182RCR ENGENHARIA LTDA
55247RED TELECOM EIRELI
55169REDEVOX
55164REMOTA
55165RN BRASIL - SERVIÇOS DE PROVEDORES LTDA
55233S.O. DO BRASIL TELECOMUNICAÇÕES LTDA-EPP
55183SDW TECNOLOGIA E TELECOMUNICAÇÕES LTDA
55143SERCOMTEL
55181SERMATEL
55167SIGNALLINK INFORMATICA LTDA
55128SIMTERNET TECNOLOGIA DA INFORMAÇÃO LTDA
55227SITECNET INFORMÁTICA LTDA -ME
55194SMART VOIP TELECOMUNICAÇÕES LTDA
55118SPIN TELECOMUNICAÇÕES LTDA
55158STELLAR S.A
55224SUL AMERICANA SERVIÇO DE TELEFONIA LTDA
55220SUPERIMAGEM TECNOLOGIA EM ELETRÔNICA LTDA
55168SUPORTE
55101TELECALL BRASIL SERVIÇOS DE TELECOMUNICAÇÕES LTDA
55138TELECOM SOUTH AMERICA S.A.
55172TELECOMDADOS SERVIÇOS LTDA - ME
55215TELECOMUNICAÇÕES DE SÃO PAULO S.A - TELESP - REGIÕES I E II
55171TELECOMUNICAÇÕES DOLLARPHONE DO BRASIL LTDA
55174TELEFREE
55131TELEMAR/AL
55131TELEMAR/AM
55131TELEMAR/AP
55131TELEMAR/BA
55131TELEMAR/CE
55131TELEMAR/ES
55131TELEMAR/MA
55131TELEMAR/MG
55131TELEMAR/PA
55131TELEMAR/PB
55131TELEMAR/PE
55131TELEMAR/PI
55131TELEMAR/RJ
55131TELEMAR/RN
55131TELEMAR/RR
55131TELEMAR/SE
55115TELESP
55186TELETEL CALLIP TELECOMUNICAÇÕES LTDA
55217TERAPAR PARTICIPAÇÕES LTDA
55141TIM CELULAR S.A. (REGIÃO III)
55188TINERHIR
55129T-LESTE TELECOMUNICAÇÕES LESTE DE SÃO PAULO LTDA
55175TMAIS
55245TOQUE TELECOMUNICAÇÕES LTDA- ME
55105TPA INFORMÁTICA
55117TRANSIT
55185ULTRANET TELECOMUNICAÇÕES LTDA
55226UNIVERSAL TELECOM S.A
55211UNIVERSO SERVIÇOS DE TELECOMUNICAÇÕES LTDA
55190VIA TELECOM INFORMÁTICA E TELECOMUNICAÇÕES LTDA
55192VIACOM NEXT GENERATION
55107VIPNET BAIXADA TELECOMUNICAÇÕES E INFORMÁTICA LTDA
55193VIPWAY SERVIÇOS DE TELECOMUNICAÇÕES LTDA
55119VISÃONET TELECOM LTDA
55249VOCE TELECOMUNICAÇÕES LTDA
55212VOXBONE BRAZIL TELECOMUNICAÇÕES LTDA
55209WIRELESS COMM SERVICES LTDA
55244WIRELESSCONECTION SERVIÇOS DE TELECOMUNICAÇÕES LTDA - ME
55130WKVE ASSESSORIA EM SERVIÇOS DE INFORMÁTICA E TELECOMUNICAÇÕES LTDA
55248YIP TELECOMUNICAÇÕES LTDA

Fonte: Anatel

10 - Logs

Todos os retornos da consulta da API estão disponíveis no log do Asterisk, conforme imagem abaixo:

Log da consulta com retorno da operadora:

 

 

 

 

Log da consulta com retorno de consulta não autorizada:

 

 

 

 

 

 

  • No labels