Upload
others
View
2
Download
0
Embed Size (px)
Citation preview
1
GUIA DO USUÁRIO
PLATAFORMA CONTROL CENTER
CONFIDENCIAL
©2015 Jasper Technologies, Inc. Todos os direitos reservados. As informações contidas neste documento
são confidenciais e de propriedade da Jasper Technologies, Inc. e suas afiliadas (coletivamente "Jasper").
Nenhuma parte deste documento pode ser distribuída ou divulgada sob qualquer forma a terceiros sem
prévia permissão por escrito da Jasper. As informações neste documento estão sujeitas a alterações a
qualquer momento sem aviso e não representam uma garantia ou um compromisso de qualquer tipo. Versão 2.0
2
SUMÁRIO
1. CONCEITOS DA PLATAFORMA CONTROL CENTER .................................................................................................... 5
1.1 Usuários ...................................................................................................................................................................... 6
1.2 Funções ....................................................................................................................................................................... 8
1.3 SERVIÇOS .................................................................................................................................................................. 10
1.4 Planos de comunicação ............................................................................................................................................ 10
1.5 Planos de tarifas ....................................................................................................................................................... 10
1.6 SIMs e dispositivos .................................................................................................................................................... 11
2. PRIMEIRO ACESSO .................................................................................................................................................. 13
2.1 Página Inicial ............................................................................................................................................................. 14
2.2 Tipos de páginas típicas ............................................................................................................................................ 14
2.3 Filtragem de dados .................................................................................................................................................... 17
2.4 Edição de dados ........................................................................................................................................................ 22
2.5 Exportação de dados ................................................................................................................................................. 24
2.6 Personalização do Control Center ............................................................................................................................. 25
3. USUÁRIOS ............................................................................................................................................................... 28
3.1 Criação de usuários ................................................................................................................................................... 28
3.2 Modificação de usuários ........................................................................................................................................... 30
3.3 Redefinição de senhas .............................................................................................................................................. 31
3.4 Edição de perfis do usuário ....................................................................................................................................... 32
3.5 Definição de restrições de endereço IP..................................................................................................................... 33
3.6 Controle do acesso dos usuários ............................................................................................................................... 34
3.7 Como usar um grupo de contas padrão .................................................................................................................... 39
3.8 Gerenciamento de cliente Final ................................................................................................................................ 40
3.9 Criando clientes ......................................................................................................................................................... 40
4. DISPOSITIVOS .......................................................................................................................................................... 42
4.1 Gerenciamento do ciclo de vida ............................................................................................................................... 42
4.2 Estados de SIM .......................................................................................................................................................... 43
4.3 Controle de transições de estado do SIM ................................................................................................................ 46
4.4 Como obter informações do dispositivo .................................................................................................................. 49
4.5 Localização de um MSISDN de dispositivo ............................................................................................................... 56
4.6 Localização de um APN de dispositivo ..................................................................................................................... 57
4.7 Como usar o menu Ação Rápida............................................................................................................................... 58
4.8 Rastreando IMEIs de dispositivos ............................................................................................................................. 65
5. REGRAS DE AUTOMAÇÃO ...................................................................................................................................... 67
3
5.1 Casos de uso comuns ................................................................................................................................................ 68
5.2 Gatilhos ..................................................................................................................................................................... 72
5.3 Ações ......................................................................................................................................................................... 75
5.4 Como usar regras ...................................................................................................................................................... 79
5.5 Limites ....................................................................................................................................................................... 85
5.6 Parâmetros de pesquisa ............................................................................................................................................ 87
5.7 Filtros de uso ............................................................................................................................................................. 87
5.8 Como evitar intervenção manual .............................................................................................................................. 88
5.9 Regras diárias ............................................................................................................................................................ 89
6. SOLUÇÃO DE PROBLEMAS .................................................................................................................................... 106
6.1 Assistente de diagnósticos ................................................................................................................................. 107
6.2 Noções básicas dos resultados de teste ........................................................................................................... 111
6.3 Spotlight ................................................................................................................................................................ 114
6.4 Noções básicas dos conceitos básicos de rede ................................................................................................ 116
6.5 Acesso ao Spotlight ............................................................................................................................................. 119
6.6 Lista de verificação de conectividade de dados .............................................................................................. 137
7. FATURAMENTO .................................................................................................................................................... 139
7.1 O processo de faturamento .................................................................................................................................... 140
7.2 Planos de tarifas ...................................................................................................................................................... 140
7.3 Fatura ...................................................................................................................................................................... 145
7.4 Resolução de dúvidas sobre faturamento .............................................................................................................. 149
8. RELATÓRIOS.......................................................................................................................................................... 153
8.1 Relatório de cobranças mensais ............................................................................................................................. 153
8.2 Relatório de Volume Mensal de Dados .................................................................................................................. 154
9. APIs ....................................................................................................................................................................... 155
9.1 Como usar as APIs ................................................................................................................................................... 155
9.2 Processo de desenvolvimento de API .................................................................................................................... 156
9.3 Padrões de código .................................................................................................................................................. 158
9.4 Processamento de erros ......................................................................................................................................... 159
9.5 Práticas recomendadas .......................................................................................................................................... 160
9.6 Funções de API ........................................................................................................................................................ 161
9.7 Casos de uso de API ................................................................................................................................................ 165
9.8 Perguntas frequentes (APIs) ................................................................................................................................... 169
10. SUPORTE .......................................................................................................................................................... 172
10.1 Suporte ao produto ........................................................................................................................................... 172
10.2 Suporte para desenvolvedores de M2M ........................................................................................................ 173
11. REFERÊNCIA ..................................................................................................................................................... 174
4
11.1 Automação ............................................................................................................................................................ 174
11.2 Assistente de Regras ............................................................................................................................................. 176
11.3 Faturamento ......................................................................................................................................................... 186
11.4 Lista de Usos ......................................................................................................................................................... 202
11.5 Lista de Planos de Tarifas ...................................................................................................................................... 206
11.6 Dispositivos ........................................................................................................................................................... 210
12. GLOSSÁRIO ....................................................................................................................................................... 217
5
Capítulo 1
1. CONCEITOS DA PLATAFORMA CONTROL CENTER Esta seção apresenta termos e conceitos importantes para utilizar a plataforma Control
Center de forma de forma eficaz. Visão geral do produto O Control Center possibilita a implantação,
gerenciamento e rentabilização dos seus dispositivos
e aplicativos conectados em uma escala global.
Tornar-se uma empresa bem-sucedida de IoT
voltada para serviços requer quatro elementos-chave:
Dispositivos com conectividade
Redes para que esses dispositivos se
conectem
Aplicativos e sistemas de TI para viabilizar operações
Uma plataforma de gerenciamento dinâmico de serviços que possibilite que empresas
realize interações contínuas e em tempo real.
A plataforma Control Center é a plataforma de serviços IOT: oferece automação com configuração única para todo o ciclo de vida dos serviços de IoT, oferece inteligência de rede em tempo real, com monitoramento contínuo das condições dinâmicas da rede e do comportamento dos dispositivos.
6
1.1 Usuários A plataforma Control Center possui uma hierarquia de três tipos de usuários: provedor de serviços (Claro), conta (cliente corporativo) e cliente (cliente final, distribuidor ou unidade de negócios interna). Cada tipo de usuário possui uma exibição diferente de dados da plataforma. Por exemplo, um provedor de serviços pode exibir todos os dispositivos pertencentes a todas as suas contas, cada conta pode exibir seus próprios dispositivos e qualquer um controlado por seus clientes, enquanto que clientes podem exibir somente seus próprios dispositivos.
Lançamento mais rápido no mercado
Configure o Control Center rapidamente para atender às suas necessidades de negócios específicas com apenas alguns cliques.
Obtenha visibilidade em tempo real
Veja todos os dispositivos em tempo real e responda de forma imediata a condições dinâmicas da rede e uso.
Solucione e corrija problemas rapidamente
Identifique e responda a comportamentos incomuns de dispositivos antes que eles se tornem um problema. Reduza o Tempo médio de reparo (MTTR) com ferramentas de solução de problemas de autoajuda.
Controle custos Acompanhe atividades em tempo real para automatizar o gerenciamento de custos e utilização de dados entre dispositivos.
Expansão Integre o Control Center aos seus sistemas através de APIs baseadas em padrões e APIs de push orientadas a regras.
7
Esta abordagem em vários níveis é particularmente útil em cadeias de valores distribuídas. Por exemplo, uma empresa poderia fornecer aos seus distribuidores visibilidade e controle sobre seu conjunto de dispositivos. Ou, uma empresa pode distribuir controle a cada uma de suas unidades de negócios. De forma semelhante, se a empresa for um revendedor, seus clientes também teriam acesso aos dados e recursos do Control Center. Os clientes apenas podem exibir e controlar dispositivos atribuídos a eles pela conta, enquanto a conta pode exibir e controlar todos os dispositivos
Tipo de usuário Descrição
Provedor de
serviços
No topo da hierarquia de usuários do Service Manager, a Claro - chamada de
provedor de serviços, controla o acesso e define classificações para serviços sem
fio que habilitam vários dispositivos. Um provedor de serviços possui e gerência
contas através do Service Manager.
Conta
Em geral, uma conta possui e gerencia dispositivos que usam os serviços sem fio.
Contas usam o Control Center para analisar e controlar seus dispositivos.
Cliente O nível de cliente é usado quando a conta d i s p o n i b i l i z a a c e s s o a o s s e u s
c l i e n t e s i n t e r n o s .
Quando a Claro cria uma nova conta, também é criado um usuário administrador de contas único. Este
usuário também pode criar usuários adicionais com acesso ao Control Center que podem exibir e gerenciar
os dispositivos na rede global da conta. Embora uma conta corporativa não possa criar outras contas, ela
pode editar seu próprio perfil de conta.
Para cada um de seus clientes de fluxo inferior, um administrador de conta pode criar um novo cliente do
Control Center junto com seu próprio usuário administrativo. Este usuário administrativo pode, por sua
vez, criar quaisquer usuários de clientes adicionais.
Desse modo, a plataforma Control Center capacita cada entidade a gerenciar seus próprios usuários e
informações. Todas as informações de usuário estão localizadas na guia Admin. Para obter mais
informações sobre usuários, consulte Gerenciamento de usuários.
8
1.2 Funções
Cada usuário possui uma única função que define quais recursos e dados ele pode acessar na plataforma. Funções podem permitir ou restringir o acesso a áreas inteiras do aplicativo e elas podem controlar o acesso a campos ou ações individuais em uma página. Por exemplo, a guia Faturamento não seria exibida para um usuário com função de suporte técnico. Você atribui uma função ao criar um novo usuário e será possível alterá-la a qualquer momento no futuro. Com base em sua função, o Control Center determina se você pode criar usuários e quais funções você pode atribuir a eles.
Funções de conta – Cliente
Nome da função Descrição
AccountAdmin
Administrador de contas geral com autoridade para exibir e provisionar
dispositivos, exibir planos de tarifas e faturas, criar usuários de contas e
clientes, criar clientes, criar pedidos de SIM e criar regras de negócios. Ao
configurar uma nova conta, a Claro normalmente cria um único usuário de
conta com a função AccountAdmin. Em seguida, esse usuário criará todos
os usuários de suporte adicionais necessários para a conta.
AccountAPIOnly Usuário com acesso ao Control Center através da API, mas não através da
interface da Web. A finalidade desta função é p e r m i t i r a i n t e g r a ç ã o
d e s i s t e m a s d o c l i e n t e à p l a t a f o r m a .
AccountFinance
Usuário financeiro que pode exibir dispositivos e faturas.
criação e publicação de planos de tarifas de varejo. Na plataforma está
prevista a consulta do faturamento Claro
criação e publicação de planos de tarifas de varejo. Na plataforma está
prevista a consulta do faturamento Claro
AccountFinanceReadOnly Usuário financeiro que pode exibir dispositivos, usuários e faturas.
AccountOrgAdmin Usuário de conta administrativa com essencialmente os mesmos
privilégios de AccountAdmin, exceto aqueles que não podem exibir
faturas.
9
AccountReadOnly Usuário de conta que pode exibir dispositivos, uso de dispositivos e
clientes.
AccountUser Usuário de conta geral que pode exibir dispositivos, faturas e planos
de tarifas. Este usuário também pode criar clientes e usuários de
clientes.
Funções de cliente - Cliente final
Nome da função Descrição
CustomerAdmin Administrador de cliente geral que pode exibir e provisionar dispositivos,
exibir faturas de varejo e uso de dispositivos, exibir planos de tarifas de
varejo (via faturas de varejo), além de criar usuários de clientes. Ao
configurar um novo cliente, o administrador da conta normalmente cria um
único usuário de cliente com a função CustomerAdmin. Em seguida, esse
Usuário criará quaisquer usuários de suporte adicionais
necessários para o cliente
CustomerSupervisor Usuário do cliente que pode exibir e provisionar dispositivos, exibir faturas
e uso de dispositivos.
CustomerTerminalEdit Usuário do cliente que pode exibir e provisionar dispositivos e exibir
o uso de dispositivos.
CustomerTrialUser Usuário do cliente que pode exibir e provisionar dispositivos, exibir o
uso de dispositivos e criar usuários de clientes.
CustomerUser Usuário geral do cliente que pode exibir dispositivos e seus usos.
10
1.3 SERVIÇOS
A plataforma Control Center oferece suporte a 02 tipos de serviços sem fio: dados e SMS (Short Message Service ou textos), bem como outros serviços. Os serviços disponíveis para cada dispositivo são definidos no plano de comunicação associado ao dispositivo (consulte Planos de comunicação para obter mais informações). Dados
Geralmente, dispositivos IoT dependem de serviços de dados para se comunicarem com o
servidor de aplicativos da conta.
SMS
O Control Center divide o serviço de SMS em dois tipos:
• SMS MT (mensagens de terminação móvel enviadas ao dispositivo)
• SMS MO (mensagens de origem móvel enviadas a partir do dispositivo)
1.4 Planos de comunicação
Um plano de comunicação determina quais serviços (dados, SMS) estão disponíveis para um dispositivo.
Um plano de comunicação também define os APNs disponíveis (nomes de pontos de acesso) que um
dispositivo pode usar após uma conexão de rede ser estabelecida.
Cada dispositivo possui um plano de comunicação. Será definido pela Claro um único plano de
comunicação para uma conta que poderá ser usado por todos os seus dispositivos.
1.5 Planos de tarifas
O plano de tarifas contratado determina quanto custará para um dispositivo acessar os diversos
serviços sem fio. O plano de tarifas especifica a tarifa básica da assinatura, juntamente com os valores
de uso incluídos e as cobranças por excedente. Um dispositivo deve apresentar o status ativo (um
estado de SIM Ativado) para acessar os diversos serviços e começar a efetuar cobranças. Para obter
mais informações sobre estados do SIM, consulte Estados de SIM.
Você pode exibir os planos de tarifas disponíveis sob a guia Faturamento no Control Center. Para obter
mais informações sobre gerenciamento de planos de tarifas, consulte Faturamento.
11
1.6 SIMs e dispositivos
Um dispositivo é um componente de hardware que usa serviços sem fio. Cada dispositivo contém um
cartão físico chamado SIM (módulo de identidade do assinante) que permite que o dispositivo se
comunique sem fio. Cada dispositivo está associado a uma única conta. No Control Center, os termos
dispositivo e SIM são usados de forma intercambiável. Diversos outros termos também são usados para
descrever um dispositivo: ICCID, MSISDN, IMSI, terminal e até mesmo assinante.
Termo Definição
SIM Um SIM é um cartão físico em um dispositivo que permite que ele se comunique sem fio.
Cada SIM possui um status que descreve sua prontidão de uso (por exemplo, Inventário,
Teste pronto, Ativado e Removido; consulte Estados de SIM). A não ser que haja motivos
específicos para fazer uma distinção entre um cartão SIM e um dispositivo, a
documentação usará o termo dispositivo.
ICCID ICCID é o identificador exclusivo primário para um SIM no Control Center. Como um número
de série, geralmente, o ICCID está impresso no cartão SIM em si e não pode ser alterado.
MSISDN Um MSISDN é um número de telefone associado a um dispositivo. Ao longo de um
período de tempo, é possível usar o número de telefone de amostra para dispositivos
múltiplos, por exemplo, se você remover o dispositivo original para um modelo mais
recente. Portanto, o Control Center não usa o MSISDN para identificar um dispositivo de
forma exclusiva.
IMSI Um IMSI é um identificador exclusivo que associa um cartão SIM a uma rede móvel
específica. Este código é composto por um código de país, um código de rede móvel e
um número de identificação de assinatura móvel.
12
Assinante
Assinante é um termo de faturamento que identifica um dispositivo que usa um plano
de tarifas. As faturas do Control Center usam este termo para fazer referência a
dispositivos. Em geral, por questões de clareza e consistência, a documentação usa o
termo dispositivo em vez de assinante.
Terminal Terminal é outro termo para um dispositivo ou SIM com acesso a serviços sem fio. Você
encontrará este termo no nome de várias chamadas de funções de API
Você pode acessar todas as informações de dispositivos através da guia Dispositivos. Para obter mais informações, consulte Dispositivos.
13
Capítulo 2
2. PRIMEIRO ACESSO
Login
Esta seção explica como acessar o Control Center, desde o login até a compreensão e a personalização da interface do usuário. O acesso à plataforma Control Center é através do link:
https//embratel.jasper.com/provision/jsp/login.jsp
Tela de login de exemplo para a plataforma
Insira seu login e senha e clique no botão ‘Registre-se’ para acessar a página inicial do Control Center.
*Navegadores com suporte. O Control Center pode ser executado no Internet Explorer versão 8.0 e superior. Também nos empenhamos em testar e oferecer suporte ao aplicativo na versão mais recente do Firefox.
14
2.1 Página Inicial A página inicial oferece uma visão geral do aplicativo. As guias e os botões do módulo o conduzem a áreas funcionais diferentes no aplicativo. Sua função determina quais recursos estão disponíveis.
Em alguns casos, as guias e os módulos o conduzem ao mesmo lugar, mas nem sempre. Para obter mais
informações sobre os controles no canto superior direito da página, consulte Tipos de páginas típicas.
2.2 Tipos de páginas típicas
O Control Center possui três tipos de páginas: resumo, detalhe e relatório.
Página de resumo
Uma página de resumo contém uma lista de itens. Frequentemente, você pode encontrar as
informações necessárias ao pesquisar, classificar ou filtrar a lista. Em várias páginas de resumo, você
pode clicar em um item específico em uma linha para obter ainda mais detalhes.
15
Controle de interface Descrição
Filtros de pesquisa Se você usar um recurso de pesquisa avançada para filtrar a lista, o Control
Center exibirá os valores de filtro no canto superior esquerdo da página
(consulte Pesquisa avançada).
Controles de pesquisa Você pode executar pesquisas por palavras-chave nas colunas mostradas no
campo de entrada de texto (consulte Pesquisa por palavra-chave). O botão
Avançado permite que você filtre os dados por determinados valores pré-
definidos (consulte Pesquisa avançada).
Controles de sessão Esta seção da página mostra o nome, a conta e o fuso horário padrão do
usuário atual. Links para fazer logout e obter ajuda também estão localizados
aqui.
Controles de registro Estes números informam a quantidade total de registros e quais registros
são exibidos na página atual. Clique nas setas para exibir outras páginas na
lista.
Ícone de atividade Este ícone gira para alertá-lo quando o Control Center está funcionando.
Exportar Clique neste botão para exportar todos os registros, incluindo os que
estiverem em páginas subsequentes (consulte Exportação de dados).
Hiperlinks Na tabela, quaisquer itens vinculados serão mostrados em azul-claro. Clique
em um link para exibir a página de detalhes relacionada ao item. No
exemplo acima, você pode clicar em um ID de fatura ou nome de conta para
obter detalhes sobre o item específico.
16
Página de detalhes
Cada objeto no sistema, desde dispositivos a usuários e faturas, possui uma página de detalhes. Vários
objetos contêm informações que a página de detalhes apresenta como subguias que exibem informações
adicionais. Você pode pesquisar e filtrar dados nas subguias da mesma forma que manipula os dados nas
páginas de resumo. Itens vinculados são exibidos com texto em azul.
Página de detalhes típica
17
Página de relatório
O Control Center também possui várias páginas de relatório que não cabem no molde da página de resumo
ou página de detalhes. A página Logística de dispositivo é um exemplo:
2.3 Filtragem de dados
O Control Center oferece a você várias opções para personalizar os dados exibidos em várias páginas
de resumo. Você pode escolher as colunas a serem exibidas na tabela, classificar os dados nessas
colunas e filtrar os registros.
18
Escolha das colunas de dados
Para escolher as colunas que você deseja exibir, mova o mouse sobre qualquer título de coluna e, em
seguida, clique com o botão direito do mouse. Uma lista de colunas disponíveis será exibida. Selecione
a caixa ao lado de cada coluna que você deseja exibir. Clique fora da lista de colunas para removê-la da
exibição.
Você pode reordenar as colunas ao arrastar o cabeçalho da coluna até um novo local.
19
Você pode reordenar as colunas ao arrastar o cabeçalho da coluna até um novo local.
Classificação de dados Para classificar os dados em uma coluna específica, mova o
mouse sobre o título da coluna até que uma seta para baixo
seja exibida. Clique na seta para abrir as opções de
classificação. Clique na opção desejada.
Você pode alternar entre ordens de classificação crescente e
decrescente ao clicar no cabeçalho da coluna. A seta azul indica
se a ordem de classificação é crescente ou decrescente.
Pesquisa por palavra-chave
Sempre que dados forem exibidos em formato de tabela, você pode filtrá- los usando controles de
pesquisa.
Dependendo da página sendo exibida, o Control Center poderá pesquisar uma ou mais colunas de
dados. As colunas de pesquisa de destino serão exibidas na caixa de pesquisa com texto cinza-claro. Por
exemplo, ao exibir a página Lista de dispositivos, o Control Center exibe "ICCID primário, SIM, ID do
dispositivo, Número de série, Funcionário" e muito mais neste campo. O Control Center tentará
encontrar o texto pesquisado em todas essas colunas.
Insira a cadeia de pesquisa no campo de entrada de texto e clique no botão Pesquisar. O Control Center
procurará qualquer ocorrência do texto pesquisado como uma palavra inteira, com um espaço à
esquerda e um espaço à direita, em qualquer lugar nos valores da coluna de destino. A pesquisa não
diferencia letras maiúsculas de minúsculas.
Por exemplo, se o usuário inserir "acme" como termo de pesquisa na Lista de dispositivos, a lista de
resultados incluirá registros com as seguintes correspondências:
• Valor de ID do dispositivo = "Acme widgets"
• Valor de ID do dispositivo = "123 acme inc"
• Valor de ID do modem = "123 ACME"
20
O Control Center não corresponderá um registro com o valor de ID do dispositivo "AcmeX", pois
não há espaço à direita de "Acme".
Você também pode usar o caractere curinga "*" em termos de pesquisa para corresponder palavras
parciais, bem como palavras inteiras.
Os resultados retornados pela pesquisa por palavra-chave mostrarão o texto correspondente
realçado em azul.
Redefinição de dados. Você pode apagar quaisquer parâmetros de pesquisa ao clicar no botão
Apagar. Em seguida, clique no botão Pesquisar para atualizar os dados.
21
Pesquisa avançada
Usando o recurso de pesquisa Avançada, é possível aplicar vários filtros aos dados na maioria das tabelas.
Selecione o botão Avançado para exibir uma lista dos filtros disponíveis para a tabela de dados atual.
Você pode cancelar a pesquisa avançada ao clicar no botão Avançado novamente.
Especifique os filtros desejados e clique no botão Pesquisar. Os filtros escolhidos serão exibidos no
canto superior esquerdo da página após os resultados da pesquisa serem retornados.
Se você inserir uma cadeia de pesquisa e um ou mais filtros avançados, o Control Center usará ambos
durante o processo de pesquisa. Primeiro, o Control Center filtra os dados por pesquisa de palavras-
chave e, em seguida, restringe os resultados ainda mais usando filtros avançados. O botão Apagar limpa
todos os termos de pesquisa, tanto para filtragem avançada quanto por palavras-chave.
22
2.4 Edição de dados
Dependendo de sua função, talvez você possa alterar dados no sistema. O Control Center oferece algumas
maneiras diferentes de acessar os campos de edição.
Primeiro, abra a página de resumo com o item que deseja alterar. Em seguida, você poderá marcar a
caixa de seleção próxima ao registro do item e clicar no botão Editar. Faça as alterações desejadas no
formulário de edição e clique em OK para salvar.
Ou, você pode abrir a página de resumo e clicar em um link na tabela. Esse link o conduzirá à página de
detalhes para o item selecionado. Na página de detalhes, você pode clicar no botão Editar para abrir o
formulário de edição.
23
Edições múltiplas. Em alguns casos, você pode editar mais de um registro ao mesmo tempo. Na página de
resumo, marque a caixa de seleção próxima a cada registro que deseja alterar e clique no botão Editar. Os
campos de ID e nome devem ser editados individualmente e não estarão disponíveis para edição de vários
registros.
Alguns objetos contêm dados em suas subguias que podem ser editados. Nesse caso, você deverá navegar
para a página de detalhes, selecionar a subguia e clicar no botão Editar.
24
2.5 Exportação de dados
Se desejar analisar ou formatar dados em suas próprias ferramentas, você poderá exportar os dados em
qualquer página de resumo para um arquivo do Microsoft Excel (XLS) ou um arquivo de texto separado
por vírgulas. O operador configurará sua conta para usar um ou outro como um padrão. Frequentemente,
contas corporativas usam este recurso para extrair dados de faturas para seus próprios sistemas
financeiros.
Basta clicar no ícone Exportar no canto superior direito da tela. O Control Center criará um arquivo com todos os dados na lista de resultados atual, incluindo quaisquer dados que tenham extravasado para páginas secundárias.
Também é possível usar APIs para extrair informações do Control Center com programas criados por você.
25
2.6 Personalização do Control Center
O Control Center oferece a opção de personalizar vários nomes de campos do Control Center para
correspondência à terminologia de sua empresa. Você também pode capturar informações adicionais
sobre SIMs ao adicionar campos personalizados à interface.
Alteração de rótulos dos campos Você pode reforçar a terminologia com a qual seus usuários estão familiarizados ao alterar os rótulos
no Control Center para objetos usados com frequência como:
• Dispositivo (e Dispositivos)
• ID do dispositivo
• ICCID
• MSISDN
• ID do modem
• ID do cliente final
• Cliente (e Clientes)
As alterações entrarão em vigor assim que você pressionar a tecla Enter para salvar os novos rótulos.
Seus usuários verão os rótulos na próxima vez que eles fizerem login no Control Center. Saiba que o
Control Center não traduzirá esses rótulos em outro idioma. Eles serão exibidos exatamente como você
cria-los, independente da preferência de idioma que seus usuários escolherem.
Local: Admin > Personalizar etiquetas
26
Adição de campos de dispositivo personalizados
Os operadores e as contas podem capturar e rastrear informações adicionais sobre dispositivos no sistema ao adicionar campos de texto personalizados ao Control Center. Esses campos usam o tipo de dados VARCHAR e podem conter até 2000 caracteres. Operadores podem criar até cinco campos
personalizados e contas podem criar dez.
Esses campos são exibidos nas páginas Lista de dispositivos (como colunas classificáveis) e Detalhes do
dispositivo. Usuários podem editar valores de campo e usá-los para filtrar dispositivos com o recurso de
pesquisa Avançado. Além disso, os campos de dispositivos criados pela conta são exibidos como opções
de filtro em determinadas regras de automação.
Local: Admin > Personalizar campos
Selecione um tipo de campo (caixa de combinação ou texto). Insira um rótulo de campo personalizado
e quaisquer valores personalizados se o tipo de campo for uma caixa de combinação. Certifique-se de
ativar o campo ao concluir.
Para editar qualquer campo, clique na célula da tabela. As alterações entrarão em vigor assim que você
clicar em qualquer outro lugar na página. As alterações serão exibidas para os usuários do Control Center
na próxima vez em que eles fizerem login.
Edição em massa. Se editar registros de dispositivos em massa ao carregar arquivos de lote, você deverá
usar nomes padrão para os campos personalizados. Os campos personalizados criados por uma conta
assumem estes nomes padrão: Personalização 1, Personalização 2 e assim por diante. Os campos
personalizados criados por um operador assumem estes nomes padrão: Personalização SP 1,
Personalização SP 2 e assim por diante.
27
Filtros de regra de campos personalizados.
Saiba que, se você qualificar uma regra de automação com um filtro que use um campo personalizado e,
posteriormente esse campo personalizado for desativado na interface do usuário, o filtro continuará a
funcionar embora o campo personalizado não seja mais exibido na caixa de diálogo de filtro. Essa situação
poderá produzir resultados inesperados se os campos personalizados contiverem dados. Você pode
consultar a coluna Filtros na página Lista de regras para verificar quais campos personalizados estão em
uso.
28
Capítulo 3
3. USUÁRIOS
Esta seção fornece informações para a pessoa de operações que gerencia contas de usuário e o acesso
de conta do Control Center. Geralmente, o administrador de uma conta com uma função AccountAdmin
executa essas tarefas. Consulte Funções de conta para obter mais informações sobre quais funções têm
acesso a essas funcionalidades.
Gerenciamento de usuários
Esta seção explica tudo o que você precisa saber sobre gerenciamento de usuários no Control Center.
Para obter mais informações sobre os tipos de usuário e funções de usuário, consulte Conceitos da
plataforma Control Center.
3.1 Criação de usuários
Apenas administradores podem criar usuários. Ao criar um usuário, você deve fornecer um nome de
usuário exclusivo e informações básicas de contato da pessoa, incluindo um endereço de e-mail válido. O
novo usuário recebe um e-mail de boas-vindas com um link para o Control Center, onde ele será solicitado
a configurar uma senha.
Por motivos de segurança, o e-mail de boas-vindas contém um código de confirmação que é transmitido
automaticamente para o sistema quando o usuário define a senha. Esse código de confirmação expira
depois de um período configurável; 72 horas é o padrão. Se o usuário não configurar uma senha dentro
do período, um usuário administrativo precisará redefinir a senha do usuário para gerar um novo código
de confirmação.
Você pode criar e gerenciar usuários usando a guia Admin. Local: Admin > Usuários > botão Criar Novo
29
Use as informações na tabela a seguir para ajudar no preenchimento do formulário. Quando tiver
concluído, clique no botão OK para criar o novo usuário. O novo usuário receberá um e-mail de boas-
vindas com seu nome de usuário e um link para o aplicativo, onde ele será solicitado a definir uma senha.
Nome do campo Descrição do campo
Nome do Usuário O Nome do Usuário é um identificador exclusivo da pessoa no Control Center.
Um usuário deve fornecer esse nome de usuário e uma senha para se conectar
ao Control Center. O nome deve ter de 6 a 25 caracteres alfanuméricos, sem
caracteres especiais ou pontuação. O nome de usuário deve ser exclusivo em
todas as contas do Control Center.
Nome/Sobrenome Esses campos contêm o nome e o sobrenome do novo usuário.
E-mail O Control Center usa esse endereço de e-mail para enviar um e-mail de boas-
vindas ao novo usuário com um link para a página de definição da senha.
Telefone É possível fornecer um número de telefone (opcional) para o novo usuário.
Idioma O Control Center usa o idioma selecionado para exibir todo o texto na interface
de usuário. O novo usuário poderá alterar essa configuração em seu perfil.
30
Nome do campo Descrição do campo
3.2 Modificação de usuários
Os administradores podem editar determinadas informações sobre um usuário existente. Esteja
ciente de que você não pode alterar o nome de usuário ou da conta de um usuário.
Local: Admin > Usuários > Detalhes da Conta > botão Editar
Atualizações Live Sempre que os dados de um dispositivo forem alterados enquanto você estiver
visualizando o dispositivo, o Control Center enviará automaticamente as
alterações para sua tela, sem exigir uma atualização de página manual. Por
exemplo, se um dispositivo anteriormente inativo estabelecer uma sessão
ativa enquanto você estiver visualizando o registro do dispositivo, o campo
Em Sessão será automaticamente atualizado para Sim na tela. Se não desejar
visualizar atualizações em tempo real durante a sessão de aplicativo, você
poderá definir essa chave para Não.
Acesso à Associação de
Conta
Esse campo indica se um usuário que possui várias contas do Control Center
com provedores de serviço diferentes pode fazer um único logon para
acessá-las.
Conta O Control Center preenche automaticamente esse campo com o nome
da sua conta.
Cliente Aplica-se apenas a contas que usam clientes e somente se esse novo usuário
for um usuário do cliente. Caso contrário, deixe esse campo em branco.
Nome da Função O nome da função define os privilégios no aplicativo para o usuário.
Consulte Funções, para obter uma descrição de cada função.
Fuso Horário O Control Center usa esse valor para determinar a exibição de data e hora na
interface do Control Center. O novo usuário poderá alterar essa configuração
em seu perfil.
31
Exclusão de usuários. E possível excluir um usuário marcando a caixa de seleção correspondente na página de lista Usuário e clicando no botão Excluir.
3.3 Redefinição de senhas
Um administrador pode redefinir a senha para um ou mais usuários. Em seguida, o Control Center enviará
uma notificação por e-mail a cada usuário com um link para a página de logon de redefinição da senha.
Esteja ciente de que o usuário precisará se lembrar do respectivo nome de usuário.
Quando o usuário segue o link Redefinir a Senha no e-mail do Control Center, ele vê uma tela de logon com alguns campos adicionais. O usuário deve fornecer a senha atual para que possa definir uma nova.
32
Cada usuário também pode redefinir a própria senha usando a função Esqueceu a senha? Na página
de logon ou pela página do perfil (consulte Edição de perfis do usuário). O Control Center envia ao
usuário um e-mail com um link para a página de logon de redefinição de senha.
3.4 Edição de perfis do usuário
Cada usuário tem acesso a uma página de perfil na qual ele pode exibir e editar alguns detalhes sobre as suas informações pessoais. O perfil do usuário é disponibilizado clicando no nome de usuário exibido no canto superior direito de cada página. O usuário pode editar as preferências de idioma e fuso horário, bem como a senha. Local: Nome do Usuário > botão Editar
Nome do campo Descrição do campo
Idioma O Control Center usa o idioma selecionado para exibir todo o texto na
interface do usuário.
Fuso Horário O Control Center usa esse fuso horário para exibir informações de data
e hora padrão em todo o aplicativo
Atualizações Live Essa chave determina se as alterações do dispositivo aparecerão ou não
em tempo real.
33
3.5 Definição de restrições de endereço IP
Para melhorar a segurança, você pode restringir os endereços IP que podem ser usados durante o
logon. Você pode definir restrições para usuários de sua conta, mas não para os usuários de seus
clientes.
Se um logon de usuário falhar porque o endereço IP não se enquadra dentro do alcance aceito, o Control Center fornecerá a mesma mensagem de logon inválido que você veria se tivesse inserido as credenciais incorretas. Intencionalmente, não é possível determinar qual problema causou a falha: credenciais incorretas ou endereço IP inválido. Não queremos alertar hackers potenciais usando um endereço IP não aprovado em que eles tenham credenciais válidas.
As restrições de endereço IP não são aplicáveis quando você espelha outro usuário ou usa o recurso de
concessão de acesso para mudar de uma conta de usuário para outra. (Consulte Controle do acesso dos
usuários para obter detalhes sobre esses recursos.) Se o usuário principal tiver acesso a outras contas de
usuário, o endereço IP do usuário principal não precisará se enquadrar dentro do alcance de endereços IP
aprovados para a outra conta de usuário.
Local: Admin > Perfil de Conta > subguia Segurança de Logon > botão Criar Novo
Insira endereços IP mínimo e máximo (inclusivos) separados por um hífen. Você pode inserir vários
intervalos. Quando estiver pronto para aplicar as restrições, você deverá ativar o recurso de segurança
clicando no botão Editar e selecionando o valor Ativado.
Mostrar Nova
Interface de Usuário
Defina essa chave para Não se desejar reverter para a interface de
usuário clássica.
34
3.6 Controle do acesso dos usuários
O Control Center possui vários recursos que permitem exibir dados como se você fosse outro usuário
ou exibir várias contas sem exigir um novo logon.
Recurso Descrição
Concessão de acesso a um
usuário diferente
Qualquer usuário pode permitir que outro usuário visualize sua conta sem
fornecer suas credenciais. Um usuário com várias contas também pode
usar esse recurso para configurar a conexão única e, dessa forma, fazer
login apenas uma vez. Consulte Concessão de acesso a um usuário
diferente.
Espelhamento de um usuário
diferente
Usuários administrativos podem oferecer suporte a outros usuários da
comunidade ao exibir o Control Center como se eles estivessem
conectados como um usuário diferente. Consulte Espelhamento de um
usuário diferente.
Como usar um grupo de
contas padrão
Ao usar um grupo de contas, uma Operadora pode fornecer acesso para
todos os usuários em uma conta corporativa aos dados em outra conta
corporativa. Consulte Como usar um grupo de contas padrão.
35
Concessão de acesso a um usuário diferente
O recurso Conceder acesso permite que cada usuário configure um logon único para uso pessoal,
além de fornecer acesso temporário à sua conta para outro usuário.
Logon único. Por vários motivos, alguns usuários do Control Center possuem várias contas de
usuário. Para obter uma experiência mais integrada, você pode escolher uma conta para atuar
como a conta principal e, em seguida, conceder a ela acesso a todas as suas outras contas. Ao
fazer login na conta principal, você terá acesso a todas as outras contas também, sem a
necessidade de repetir o login em cada uma delas.
Acesso temporário. Em certas situações, talvez você queira conceder acesso temporário para
outro usuário à sua própria conta. Essa abordagem é uma rápida maneira de conceder os seus
privilégios a um usuário sem precisar fornecer as suas credenciais. Quando o usuário não precisar
mais desse acesso, basta removê-lo da lista de acesso. Nesse caso, a conta do outro usuário é a
conta principal, e você concede acesso para esse usuário à sua própria conta.
Dependendo da sua função, você pode ter acesso a contas de usuários dentro da sua própria conta
corporativa, em outra conta corporativa ou até mesmo em um provedor de serviços diferente. Você
deve alternar entre as várias visualizações da conta; o Control Center não agrega todas as visualizações
em uma única exibição.
A concessão de acesso é um processo de duas etapas. Em primeiro lugar, a conta secundária deve
conceder acesso à conta principal. Em seguida, a conta principal deve aceitar o acesso.
Nesse ponto, o Control Center apresenta a conta principal com um menu suspenso de opções de conta
de usuário.
Disponível para todos os usuários. Embora esse recurso esteja localizado na guia Admin, praticamente
todos os usuários têm acesso a ele, podendo configurar o logon único para si próprios ou fornecer
acesso a outros usuários.
Designação de acesso
Independentemente de você conceder acesso a outra pessoa ou suas próprias contas de usuário,
você deverá identificar a conta principal.
Se você conceder acesso a outro usuário, a conta principal será a conta desse usuário.
36
Se você configurar o logon único para si mesmo, a conta principal será a conta usada com mais
frequência.
Cada conta secundária deve conceder acesso à conta principal.
Local: Admin > Acesso Amplo > botão Conceder Acesso
Faça logon no Control Center usando uma conta secundária. Navegue até Admin > Acesso Amplo e clique no botão Conceder Acesso.
Forneça o nome de usuário e escolha Claro no provedor de serviço da conta principal e clique em
OK para salvar.
O Control Center solicita que você insira a senha da conta secundária e, em seguida, gera um token que
a conta principal deve usar para aceitar o acesso.
Anote o token. O Control Center também enviará um e-mail com o token Se estiver concedendo acesso
a outra pessoa, você deverá fornecer o token a essa pessoa para que ela o utilize quando aceitar o
acesso.
Na página Acesso Amplo, você verá que o link para a conta principal está pendente.
37
Aceitação de acesso
Faça logoff da conta secundária e repita o logon usando a conta principal. Se você tiver concedido acesso
a outra pessoa, esta deverá fazer login em sua própria conta e seguir essas instruções. Certifique-se de
que você, ou a pessoa que está aceitando o acesso, tenha o token criado pelo Control Center durante o
processo de concessão de acesso.
Local: Admin > Acesso Amplo > botão Aceitar Acesso
Insira o nome de usuário e o provedor de serviços da conta secundária, juntamente com o token.
Clique em OK para salvar.
O Control Center adiciona a conta secundária à lista de Links Acessíveis. É possível acessar essa conta
imediatamente clicando no link Acesso. Da próxima vez em que fizer login na conta principal, você
também terá a opção de mudar para uma conta diferente no menu suspenso de usuários. Consulte
Conexão com logon único.
38
Conexão com logon único
Faça logon no Control Center usando a conta principal. No canto
superior direito, você verá seu nome de usuário e o nome do
provedor de serviços.
Para mudar para uma conta de usuário diferente, clique na seta para baixo.
Selecione a conta que deseja usar. O Control Center mudará para a conta desejada, exibindo as
informações apropriadas dessa conta.
Para voltar à conta principal, clique no link Retornar. Esteja ciente de que ao mudar para a visualização
de conta secundária, você não terá opção de Acesso Amplo.
39
Espelhamento de um usuário diferente
Para fins de suporte, talvez você deseje fazer logon na conta de outro usuário para exibir o mesmo que
ele. O Control Center permite aos usuários com os devidos privilégios espelhar outro usuário sem
conhecer suas credenciais. Os usuários do provedor de serviços podem espelhar usuários da conta e
estes, por sua vez, podem espelhar usuários do cliente. Em cada caso, o usuário principal vê exatamente
o que os usuários espelhados vêem.
A função de espelhamento é temporária. Assim que o usuário principal retornar à sua própria
conta, as informações do usuário espelhado desaparecerão.
Local: Admin > Acesso Amplo > botão Usuário Espelho
Selecione o nome de usuário e o nome da conta da pessoa que deseja espelhar. O Control Center lista
apenas os usuários cujas contas você tem permissão para ver. Clique no botão Usuário Espelho para
ter acesso imediato à conta dessa pessoa. Quando terminar, clique no link Retornar localizado no
canto superior direito.
3.7 Como usar um grupo de contas padrão
Um grupo de contas permite que todos os usuários em uma conta corporativa exibam dados de várias
contas corporativas com a Claro. Esse recurso é particularmente conveniente para empresas que
mantêm várias contas Claro.
Primeiramente, a Claro cria um grupo de contas contendo todas as contas da empresa e, em seguida,
anexa esse grupo de contas à conta principal. Desse ponto em diante, todos os usuários da conta
corporativa principal podem ver as informações nas outras contas. Cada usuário vê as informações
apropriadas para a sua função na conta principal. Todos os dados aparecem em uma única tela. Não há
40
necessidade de selecionar uma conta diferente quando você deseja visualizar os dados. Eles sempre
estão lá.
3.8 Gerenciamento de cliente Final
As contas podem optar por criar "clientes" no Control Center para representar suas organizações de
clientes diretos (por exemplo, distribuidores, filiais, integradores de sistemas etc.). Essa configuração será
útil se uma conta trabalhar com outras organizações para distribuir, revender ou gerenciar subconjuntos
de suas implantações de dispositivos conectados. Os usuários da conta do Control Center podem visualizar
e gerenciar a conectividade e os cálculos de faturamento para os clientes da conta. As contas também
podem criar usuários do Control Center associados a seus clientes, concedendo acesso a cada cliente e
permitindo que eles assumam a responsabilidade de suporte de primeira linha sobre suas próprias
implantações sem fio.
Observação: Nem todas as tarefas de gerenciamento de contas estarão disponíveis para todos os
usuários, conforme os privilégios baseados em função do Control Center atribuídos a cada usuário.
As tarefas de gerenciamento de clientes são realizadas na seção Clientes, localizada na guia Admin do
Control Center. A lista de clientes fornece uma visão geral de todos os clientes que uma conta gerencia
no Control Center. A criação de clientes está disponível nessa página de lista de clientes. A edição de
clientes está disponível na página de detalhes do cliente. Para usar esse recurso, faça primeiro uma busca
detalhada em um cliente clicando no seu nome e, em seguida, clique no botão Editar.
3.9 Criando clientes
Administradores de conta criam um novo cliente clicando no botão Novo da página de lista de clientes
na guia Admin. Isso apresenta uma caixa de diálogo de criação simples na qual o usuário insere
informações de contato básicas, incluindo:
• Nome do cliente (necessário)
• Nome e informações de contato para até quatro contatos individuais do cliente
• Informação de endereços de faturamento e envio
• Pergunta e resposta de segurança. Essa informação está disponível aos usuários da conta para
referência, mas não é imposta pela plataforma Control Center.
41
Uma vez criado o cliente, os administradores da conta poderão criar usuários do Control Center
associados a esse cliente. Esses usuários terão visibilidade e privilégios de controle sobre os SIMs
atribuídos ao cliente de acordo com as funções designadas a eles.
Edição de clientes
Administradores de conta podem editar um cliente existente, primeiramente, fazendo uma busca
meticulosa nos detalhes do cliente de destino, ao clicar no nome do cliente vinculado na lista de clientes
e, em seguida, clicar no botão Editar. A caixa de diálogo de edição do cliente tem os mesmos campos
que a caixa de diálogo de novo cliente. Com exceção do nome do cliente e do nome da conta, todos
esses campos são editáveis.
42
Capítulo 4
4. DISPOSITIVOS
O gerenciamento de dispositivos no Control Center ocorre na guia Dispositivos.
Na terminologia um dispositivo é uma máquina que contém um SIM que usa a
plataforma para gerenciar a conectividade sem fio (consulte SIMs e
dispositivos).
Terminologia personalizada. A guia Dispositivos pode ser personalizada por
conta para exibir uma terminologia diferente na interface de usuário do Control
Center. Consulte Personalização do Control Center, para obter detalhes.
4.1 Gerenciamento do ciclo de vida
Por exemplo, os dispositivos na fase de teste de manufatura recebem uma quantidade configurável de
serviços classificados como zero, permitindo que você identifique e conserte dispositivos que, de alguma
forma, poderiam chegar inativos ao destino, baixando os custos de suporte e aumentando a satisfação
do cliente. O Control Center também oferece um processo de ativação sem interação humana que coloca
um dispositivo em funcionamento automaticamente e inicia o faturamento assim que o dispositivo é
ativado, o que significa que você não terá cobranças de conectividade por dispositivos em inventário ou
em trânsito até o respectivo destino final.
43
Em cada estágio do ciclo de vida do serviço, uma combinação de atributos de dispositivo determina o
comportamento do dispositivo:
• Estado do SIM. Controla o estado da conectividade do dispositivo (ativado ou desativado).
Consulte Controle de transições de estado do SIM
• Plano de comunicação. Controla os serviços e limitações de roaming disponíveis. Consulte
Gerenciamento de atribuição do plano de comunicação
• Plano de tarifas. Controla os limites de uso e o custo do serviço.
Algumas transições são baseadas nas configurações no nível de conta acordadas entre a Claro e você a serem definidas durante o processo de recepção da conta. Outras transições podem ser controladas por meio das regras de automação comercial que você define por sua conta (consulte Regras de automação). Em muitos casos, a transição não requer interação humana, o que significa que você pode dimensionar seus negócios sem dimensionar proporcionalmente o orçamento ou os recursos.
4.2 Estados de SIM
Cada dispositivo tem um estado que determina sua capacidade de estabelecer conectividade de
dados na rede e define se o dispositivo é faturável. O diagrama abaixo mostra um ciclo de vida típico
de um dispositivo. Você pode fazer a transição de um estado para outro em um dispositivo, sujeito a
determinadas restrições.
44
A tabela a seguir descreve o comportamento típico de faturamento e conectividade de cada estado SIM.
Esteja ciente de que para algumas contas, os compromissos contratuais podem alterar o comportamento
de faturamento padrão. Além disso, alguns estados são controlados pela conta, alguns pela Claro e
outros ainda pelo Control Center.
Teste Pronto
O estado Teste Pronto é uma franquia bônus para que o Cliente execute testes
em seus dispositivos e assegure a funcionalidade fim a fim de seu sistema. A
linha será criada neste status e a cobrança se inicia após atingir um dos limites a
seguir:
Dados – 20 KB
SMS – 2 mensagens
30 dias após criação da linha
Assim que o dispositivo ultrapassar o limite (20k ou 2 SMSs), ele fará a transição
para o status Ativação Pronta e mais nenhum tráfego de teste gratuito estará
disponível para qualquer serviço.
Após 30 dias da data de criação da linha no CPC/Mobile, este dispositivo será
considerado faturável, mesmo que não tenha utilizado a franquia (dados ou
SMS.
a transição para o estado Ativação Pronta e mais nenhum tráfego de teste
gratuito estará disponível para qualquer serviço. Após 30 dias, este
dispositivo será considerado faturável, independentemente de ter utilizado
a franquia bônus de dados ou SMS ou estar em status diferente de Ativo.
45
Ativação Pronta
Trata-se de um status de transição utilizado entre Teste Pronto e Ativo. Serve
para sinalizar que um simcard foi testado e já pode ser utilizado. Quando um
dispositivo no status Ativação Pronta fizer uma conexão de dados ou enviar um
SMS, a plataforma Control Center alterará automaticamente seu status para
Ativo.
Inventário
Status não disponível.
Se utilizado este status, será alterado automaticamente para o status Ativo a
‘zero hora’ do dia seguinte.
Ativo
Um dispositivo Ativado está apto a estabelecer conexões de dados e
envio de SMS.
Inativo
O estado Inativo não permite que um dispositivo estabeleça conexões de
dados e envie SMS. Corresponde à Suspensão Voluntária Gratuita. Uma
linha poderá ser desativada uma vez a cada 12 meses e por até 120 dias
consecutivos sem cobrança.
IMPORTANTE: Durante a suspensão da linha, o período de carência será
congelado e após a restituição da linha haverá a continuidade da carência.
Removido
Equivale à solicitação de cancelamento da linha, onde serão aplicadas regras
de rescisão contratual. Ao alterar o dispositivo para este status os serviços
serão suspensos imediatamente e o Atendimento iniciará o processo de
cancelamento da linha.
46
4.3 Controle de transições de estado do SIM
O Control Center fornece diferentes formas de alterar o estado do SIM de um dispositivo, de modo
manual ou automático.
Privilégios de usuários. Lembre-se de que nem todos os usuários têm acesso a todas as funções.
Mesmo que uma conta corporativa como um todo tenha acesso às informações do estado SIM,
algumas funções de usuário, não. Se essas ações não estiverem disponíveis para você, isso significa
que você não tem os privilégios necessários.
Padrões de estado do SIM
A Claro trabalha com você para determinar quais transições de estado do SIM padrão fazem sentido
para seu respectivo modelo de negócios.
Essas configurações são controladas pela Claro:
• Estado de SIM padrão para todos os dispositivos novos transferidos para a conta corporativa é
Teste Pronto.
• O estado SIM padrão depois de Teste Pronto. Geralmente, o padrão é Ativação Pronta
Alteração manual do estado SIM
Você pode alterar o estado do SIM de um dispositivo manualmente na página Lista de dispositivos.
Local: Dispositivos > Lista de dispositivos > caixa suspensa Ações do dispositivo > Alterar estado
SIM
47
Consulte Edição dos detalhes do dispositivo para obter mais informações sobre as várias maneiras de
editar atributos de dispositivo manualmente, incluindo o estado SIM
Alteração de estado do SIM por regras
Você pode criar várias regras que alteram o estado de um SIM em resposta a um acionador específico.
Por exemplo, se um SIM se conecta à rede com mais frequência do que o normal, talvez seja conveniente
desativar o SIM. Ou, se o Control Center detectar comportamento de SIM fraudulento, você pode
desativar o SIM. Consulte Regras de automação para obter mais informações sobre como criar regras e
os vários tipos de regras que estão disponíveis.
Local: Automação > Regras > botão Criar Novo
48
Alteração de estado do SIM por API Você pode alterar o estado do SIM de um dispositivo juntamente com muitos outros atributos por
meio da API EditTerminal. Essa abordagem permite a você integrar a funcionalidade do Control Center
em seus próprios sistemas back-end. Consulte APIs para obter mais informações sobre as APIs
disponíveis.
Gerenciamento da atribuição de planos de tarifas No caso de alteração do seu plano de tarifas contratado, entre em contato com o Atendimento ou solicite uma visita de seu Gerente de Conta.
Gerenciamento do comportamento de limite de uso
Cada dispositivo possui um limite de uso associado equivalente a 10 vezes a franquia contratada por linha, tendo seu serviço bloqueado ao atingir este limite, trazendo segurança em caso anormalidades de consumo. Caso deseje permitir tráfego acima deste limite, edite o campo Cancelamento do Limite de Uso para o comportamento desejado. Consulte Substituição do limite de uso de um único dispositivo
Substituição de SIMs Para substituição de SIM Cards, favor entrar em contato com o Atendimento. Em caso de aquisição de novos SIM Cards para posterior troca, contate seu Gerente de Conta.
49
4.4 Como obter informações do dispositivo
O Control Center oferece uma quantidade enorme de informações sobre seus dispositivos e como eles
estão funcionando no mundo todo. As páginas principais para o trabalho com dispositivos são Lista de
dispositivos e Detalhes do Dispositivo. Essas páginas seguem o modelo de navegação padrão usado por
todo o Control Center. Leia para saber mais sobre os vários tipos de dados de dispositivo.
Identificação e organização de dispositivos
Há vários campos disponíveis no objeto de dispositivo para identificar e organizar dispositivos no Control
Center. Alguns deles são valores estáticos preenchidos automaticamente no Control Center quando uma
conta recebe SIMs. Outros podem ser editados pelos usuários da conta com o objetivo de rastrear e
organizar SIMs da maneira que melhor corresponda aos negócios da conta.
Campos estáticos de identificação do SIM
Campos estáticos de identificação armazenam atributos fixos que descrevem um SIM. Esses campos
são automaticamente preenchidos pelo sistema e seus valores não podem ser alterados por usuários
de conta.
• ICCID – Esse é o identificador exclusivo primário para um SIM no Control Center. Em geral, o ICCID
está impresso no próprio cartão SIM. A etiqueta "ICCID" pode ser personalizada (consulte os
detalhes abaixo).
• MSISDN – O MSISDN é o número da linha
• IMEI – Esse valor identifica exclusivamente o dispositivo
Campos editáveis de identificação do SIM
Vários campos editáveis permitem que as contas insiram, para cada SIM, atributos descritivos que
correspondem aos seus negócios e que auxiliam na organização e na localização desses SIMs. Cada um
dos campos a seguir pode ser editado por usuários de conta e está disponível para pesquisa por palavra-
chave. As etiquetas de cada um desses campos podem ser personalizadas por administradores de conta.
• ID do Dispositivo – Campo descritivo aberto que permite a entrada de texto livre. ID do Dispositivo
está disponível para exibição por qualquer usuário.
• ID do Modem – Campo descritivo aberto que permite a entrada de texto livre. ID do Modem está
disponível para exibição por qualquer usuário.
50
• Personalização 1, Personalização 2 e Personalização 3 – Campos descritivos abertos que
permitem a entrada de texto livre. Esses são campos de extensão que os administradores de conta
podem optar para expor aos usuários de conta. Consulte os detalhes em Adição de campos de
dispositivo personalizados
Página Lista de dispositivos
A Lista de dispositivos é a página inicial típica para trabalhar com dispositivos manualmente na interface
de usuário do Control Center. Aqui você verá uma lista de todos os dispositivos visíveis para o usuário,
opcionalmente filtrada por critérios de busca especificados pelo usuário.
Local: Dispositivos > Lista de dispositivos
Lista de dispositivos com destaques de recursos
Essa página apresenta as mesmas ferramentas de pesquisa e filtragem que você encontrará em todas as
páginas de lista, juntamente com a capacidade de mostrar e ocultar colunas e movê-las para outros
locais. Consulte Filtragem de dados para obter uma descrição detalhada desses recursos. Além disso, a
página Lista de dispositivos oferece várias opções específicas de dispositivo:
Recurso Descrição
51
Recurso Descrição
Link Detalhes do dispositivo ICCID
Ao clicar no link ICCID, os usuários podem iniciar uma janela pop-up com detalhes
sobre o dispositivo.
Menu Ações No menu Ações, você pode alterar o estado SIM de um dispositivo. Também
é possível acessar o Assistente de Diagnósticos e o Spotlight, que permitem
ocultar essas colunas na página de resumo e criar mais espaço para outras
colunas mais úteis.
Link de diagnóstico Ao clicar no ícone Diagnóstico de um dispositivo, os usuários com privilégios
apropriados podem iniciar uma ferramenta de assistente de diagnóstico para
analisar a conectividade do dispositivo atual.
Nota. Nem todos os usuários terão acesso a esse recurso. O acesso dependerá
das permissões concedidas por suas respectivas funções de usuário.
Link do Spotlight Ao clicar no ícone do Spotlight de um dispositivo, os usuários com privilégios
apropriados podem iniciar a ferramenta de diagnóstico Spotlight para
visualizar um histórico completo e a linha do tempo de atividades de rede e
provisionamento do dispositivo.
Nota. Nem todos os usuários terão acesso a esse recurso. O acesso dependerá
das permissões concedidas por suas respectivas funções de usuário.
Identificadores Essas colunas exibem os identificadores ICCID, MSISDN e IMSI do dispositivo.
Você pode clicar em qualquer link de ICCID para analisar detalhadamente a
página Detalhes do Dispositivo correspondente.
52
Página Detalhes do dispositivo
A página Detalhes do dispositivo fornece informações adicionais sobre um determinado dispositivo.
Você pode acessar a página clicando no ICCID vinculado para um dispositivo na página Lista de
dispositivos; ou em qualquer outro lugar no aplicativo em que um ICCID vinculado é exibido.
Conectividade As colunas Estado do SIM e Em Sessão fornecem informações do tipo: se o
dispositivo pode se conectar à rede e se o dispositivo está em uma sessão live
no momento atual.
Uso e tarifação Estas três colunas (Uso No Mês Até Hoje, Limite de Uso Atingido e Plano de
Tarifas) fornecem informações sobre o uso de dados do dispositivo durante o
ciclo de faturamento atual.
Indicador de
atualização
dinâmica
Por padrão, o Control Center automaticamente envia por push todas as
alterações no dispositivo para a tela sem exigir uma atualização manual da
página. Todas as alterações aparecem em amarelo. Você pode desativar as
atualizações live no perfil do usuário.
53
Página de detalhes do dispositivo com destaques de recursos
Detalhes do Dispositivo
Os principais atributos de detalhes do dispositivo são exibidos na parte superior da página Detalhes do
Dispositivo. Essas informações incluem o ICCID, o ID do dispositivo, o estado SIM, o nome do cliente que
está usando o dispositivo (se houver), o plano de tarifas e se o dispositivo está ou não em sessão no
momento.
Sessão Atual
Se o dispositivo estiver em sessão no momento, o bloco da sessão atual ficará visível com detalhes
sobre a sessão de dados atual, entre eles:
• Início da Sessão – A data e a hora em que a sessão começou
• Endereço IP do Dispositivo – O endereço IP atribuído ao dispositivo quando a sessão
começou
• APN – O nome do ponto de acesso pelo qual o dispositivo está atualmente conectado
54
O botão Dados da Conexão Atual, visível no bloco da sessão atual quando um SIM está em uma sessão
de dados ativa, inicia a caixa de diálogo Dados da Conexão Atual, com detalhes adicionais em tempo
real. Além das informações incluídas na página padrão de bloco da sessão atual, a caixa de diálogo
Dados da Conexão Atual exibe as seguintes informações em tempo real sobre a sessão de dados atual:
• Último Acesso – A data e a hora em que o SIM transmitiu dados pela última vez na conexão ativa
atual
• Bytes Enviados – Bytes reais enviados do dispositivo (uplink)
durante a sessão atual
• Bytes Recebidos – Bytes reais recebidos pelo dispositivo (downlink)
durante a sessão atual
Informações adicionais
Se um usuário precisar ver os detalhes completos disponíveis sobre um dispositivo, clicar no controle de
informações adicionais expandirá uma região dobrável da página com os atributos restantes disponíveis
para o dispositivo, além daqueles exibidos no bloco de detalhes. Clicar novamente no ícone de
informações adicionais recolherá a região para maximizar o espaço na tela.
55
Subguias
Subguias estão disponíveis na seção inferior da página de detalhes do dispositivo. Cada subguia contém
detalhes relacionados importantes. Clique no link da subguia na tabela abaixo para ver mais informações
de referência.
Subguia Descrição
Conexões Mostra uma exibição gráfica do histórico de conexão do dispositivo, organizada
por período de faturamento. Consulte Dispositivos > Conexões
Histórico de
conexões
Contém o histórico de conexão do dispositivo, listado por sessão de dados. O
histórico da sessão de dados é organizado por período de faturamento. Por
padrão, o histórico não faturado do dispositivo é exibido. O usuário pode
visualizar o histórico da sessão de dados referente a outro período de
faturamento no passado selecionando o período de destino no filtro suspenso
Ciclo de Faturamento. Registros de histórico de conexão são exibidos conforme
são recebidos pela plataforma Control Center. Consulte Dispositivo > Histórico de
conexões
SMS > SMS Live Mostra uma listagem de todas as mensagens SMS enviadas ou recebidas pelo
dispositivo de destino, bem como seus respectivos estados (recebidas ou com
falha). Consulte Dispositivo > SMS > SMS Live
SMS > Histórico de
Mensagens
Mostra uma lista de mensagens via SMS recebidas ou enviadas pelo dispositivo
de destino em um ciclo de faturamento específico. Consulte Dispositivo > SMS
> Histórico de Mensagens
SMS > Mensagens
Não Entregues
Mostra um histórico de mensagens via SMS que não foram entregues. Consulte
Dispositivo > SMS > Mensagens Não Entregues
Cliente final Mostra informações básicas de contato sobre a pessoa
ou organização que possui o dispositivo, para auxiliar no suporte ao dispositivo.
Consulte Dispositivo > Cliente final
56
Alterações
Programadas
Mostra todas as edições iminentes nos atributos do dispositivo que foram
programadas para o dispositivo. Consulte Dispositivo > Alterações Programadas
Rastreamento de
Auditoria
Mostra um histórico de todas as alterações feitas nas informações de
detalhes do dispositivo. Consulte Dispositivo > Rastreamento de Auditoria
Classificação Mostra as configurações atuais que controlam a tarifação do dispositivo.
Consulte Dispositivo > Tarifação
Conexões Mostra uma exibição gráfica do histórico de conexão do dispositivo, organizada
por período de faturamento. Consulte Dispositivos > Conexões
Histórico de
conexões
Contém o histórico de conexão do dispositivo, listado por sessão de dados. O
histórico da sessão de dados é organizado por período de faturamento. Por
padrão, o histórico não faturado do dispositivo é exibido. O usuário pode
visualizar o histórico da sessão de dados referente a outro período de
faturamento no passado selecionando o período de destino no filtro suspenso
Ciclo de Faturamento. Registros de histórico de conexão são exibidos conforme
são recebidos pela plataforma Control Center. Consulte Dispositivo > Histórico
de conexões
4.5 Localização de um MSISDN de dispositivo
Para se comunicar com um dispositivo usando SMS, você precisará saber o MSISDN - número da linha
do dispositivo. O MSISDN (Phone Number) é exibido na página Lista de dispositivos, bem como na
página Dispositivo Detalhes.
Local: Dispositivos > Lista de dispositivos
57
Saiba que você pode controlar a colocação da coluna MSISDN (Phone Number) na Lista de dispositivos.
Se você desejar obter acesso rápido aos números de telefone de dispositivos, arraste essa coluna para
a esquerda de forma que ela sempre esteja visível na janela do navegador.
4.6 Localização de um APN de dispositivo
Um APN ou Nome de ponto de acesso define onde um dispositivo conectará à Internet. No Control
Center, cada dispositivo tem um plano de comunicação que especifica quais APNs o dispositivo pode usar
para serviços de dados. Para que um dispositivo se conecte de forma bem- sucedida à Internet, o
aplicativo do dispositivo deverá usar uma APN que seja permitida pelo plano de comunicação do
dispositivo.
Local: Dispositivos > Lista de dispositivos > Detalhes do dispositivo >botão Spotlight
58
Para algumas instalações de rede, o Control Center também exibe a APN em uso sempre que o
dispositivo está em sessão. As informações são exibidas na página Dispositivo Detalhes na caixa Sessão
atual.
Edição dos detalhes do dispositivo
Os usuários com privilégios de edição podem editar registros de dispositivos de uma das três
formas:
• Menu de ação rápida. Clique com o botão direito do mouse em um registro de dispositivo na página
Lista de dispositivos e selecione uma ação no menu de ação rápida (para ações de provisionamento
frequentemente acessadas).
• Página Lista de dispositivos. Destaque um registro (ou vários) na lista e clique no botão Editar.
• Página Detalhes do Dispositivo. Navegue até a página Detalhes do
Dispositivo do dispositivo de destino e clique no botão Editar.
O Control Center também permite editar registros de dispositivo, um por vez, como um grupo, ou em
massa por meio de um arquivo carregado.
4.7 Como usar o menu Ação Rápida
O Control Center fornece um menu de ações para cada dispositivo, permitindo que os usuários alterem
rapidamente o estado do SIM ou plano de tarifas diretamente na lista de dispositivos. Basta clicar na seta
para baixo Ações ao lado do dispositivo desejado. Todas as alterações entrarão em vigor imediatamente.
59
No menu, você também pode iniciar o Assistente de diagnósticos ou o Spotlight para solucionar
problemas de conectividade imediatamente. Se você acessar essas ferramentas no menu Ações, você
poderá optar por ocultar as colunas Diagnóstico e Spotlight na página de lista para liberar espaço e
exibir outras colunas de dados.
Edição de dispositivos
Os usuários com os devidos privilégios baseados em função podem editar os atributos de um dispositivo
ao fazer o seguinte:
• Selecionando um ou mais dispositivos na página Lista de dispositivos e clicando no botão Editar
Selecionado
• Clicando no botão Editar na página Detalhes do Dispositivo
O Control Center exibe o formulário de edição, o que permite ao usuário especificar alterações em
qualquer campo editável disponível para o dispositivo. Em seguida, o usuário clica em OK para aceitar as
alterações ou em Cancelar para descartá-las.
Se o usuário aceitar a Data Efetiva padrão (sempre a data atual), todas as modificações de dispositivo
ocorrerão imediatamente. Se o usuário especificar uma data no futuro como a data efetiva, as alterações
serão aplicadas automaticamente na data especificada (no horário UTC). Todas as alterações programadas
para o futuro ficarão visíveis na subguia Alterações Programadas, na página de detalhes do dispositivo de
destino.
60
Note que essa captura de tela mostra três campos de dispositivo personalizados: Alerta de Serviço,
Local e Agenda. Sua implementação provavelmente não conterá esses campos.
Edição de vários dispositivos
Observe que os campos ID do Dispositivo e ID do Modem não estão disponíveis para edição usando a
edição de vários registros, já que sua finalidade original é representar descritores exclusivos de cada
dispositivo identificados pela conta. Os campos de extensão personalizados estarão disponíveis na
edição de vários registros se tiverem sido habilitados por um administrador de conta.
Edição em massa
O recurso Atualização em Lote permite que os usuários com privilégios baseados em função
apropriados editem informações do dispositivo em massa. Ao usar um arquivo de planilha do Excel (.xls,
não .xlsx), você pode atualizar qualquer uma das combinações de campos editáveis em um único
arquivo.
Local: Dispositivos > Atualização em lote > botão Arquivo de upload
Quando você clica no botão Fazer upload do arquivo na página Atualização em lote, o Control Center
exibe uma caixa de diálogo de seleção de arquivos. Arraste e solte um arquivo no campo Nome do
Arquivo e clique no botão Fazer Upload para iniciar o processo. Para obter informações detalhadas
sobre como estruturar o arquivo, consulte a seção abaixo, Diretrizes de formato de arquivo do Excel.
61
Lista de atualizações em lote mostrando trabalhos de upload anteriores
A página Atualização em Lote exibe uma lista de trabalhos antigos de upload de arquivos, incluindo
nome de arquivo, data e estado do upload. Uploads bem-sucedidos mostram o estado Concluído. Se
houver um problema com um upload, o valor do estado Falhou se transformará em um hiperlink que
direciona para uma lista de erros encontrados durante a tentativa de upload.
Diretrizes de formato de arquivo do Excel
O arquivo de upload do Excel deve seguir as regras de formatação descritas abaixo. Atualmente, o
Control Center oferece suporte a arquivos do Excel com o formato .xls, e não o mais recente .xlsx.
Formato de upload de amostra de um arquivo do Excel (.xls) para a edição de registros de dispositivo em massa
Dica. Uma forma rápida de gerar um arquivo de upload em lote é exportar as informações atuais sobre
os dispositivos que deseja editar. Filtre a página de lista Dispositivos para que apenas os dispositivos
desejados sejam mostrados, em seguida, clique no botão Exportar para criar um arquivo do Excel. Use
esse arquivo como um ponto de partida para suas alterações.
62
Diretriz Descrição
Linha de cabeçalho A primeira linha da planilha deve conter os nomes de campos como
cabeçalhos de coluna. Os nomes de campo não diferenciam maiúsculas de
minúsculas; qualquer combinação de caracteres maiúsculos e minúsculos
funcionará. Consulte a seção Campos editáveis para obter uma lista
completa de campos que podem ser atualizados.
Coluna principal Uma coluna deve ter o cabeçalho "ICCID". Essa coluna pode aparecer em
qualquer lugar na tabela.
Colunas adicionais Outras colunas devem usar os nomes padrão em inglês dos campos que
devem ser atualizados pelo arquivo de upload. Se houver colunas adicionais
que não representam nomes padrão em inglês reconhecidos de campos de
dispositivos, o processo do arquivo de upload falhará.
Nomes de campo em inglês Os arquivos de upload devem usar os nomes padrão em inglês para o ICCID
e as colunas de destino, independentemente da preferência de idioma do
usuário ou de qualquer personalização de etiquetas em vigor para a conta
do usuário. Por exemplo, se você tiver renomeado o campo MSISDN para
Número de Telefone, será preciso usar "MSISDN" como o cabeçalho da
coluna no arquivo de upload.
Campos personalizados da
conta
Os nomes padrão em inglês para os dez campos personalizados fornecidos
no objeto de dispositivo (veja Adição de campos de dispositivo personalizados
são: "Personalização 1", "Personalização 2" e assim por diante até 10. Esses
são os títulos que devem aparecer no arquivo de upload do Excel quando
você atualiza os campos personalizados por meio do processo de atualização
em lote.
Campos personalizados do
cliente
Para atualizar qualquer um dos cinco campos de dispositivo personalizados
no nível de cliente, você deve usar os nomes padrão em inglês para
identificar os valores no arquivo de upload: "Personalização do Cliente 1",
"Personalização do Cliente 2" e assim por diante até 5.
63
Linhas de não
cabeçalho
Cada linha depois da primeira deve conter o ICCID de um único registro de
dispositivo a ser editado (na coluna "ICCID") e os valores de destino para
todos os campos editáveis que serão atualizados para esse registro. Se
mais de uma linha de dados especificar o mesmo ICCID, o upload falhará.
Valores alvo Os valores alvo diferenciam maiúsculas de minúsculas e devem
corresponder aos valores que aparecem no aplicativo. Por exemplo, os
valores do estado SIM usam uma combinação de maiúsculas e minúsculas,
como: "Ativado", "Ativação Pronta".
Formatação de célula do Excel Todos os dados nas células devem ser formatados como "Texto" no
arquivo do Excel, incluindo dados numéricos.
Campos editáveis
Veja aqui uma lista completa de campos que podem ser atualizados em um processo de atualização em
lote. Esteja ciente de que nem todas as funções podem atualizar todos os campos. Se for possível editar
o campo na interface da Web, você poderá editá-lo por meio de um processo de atualização em lote.
Detalhes do Dispositivo
• ICCID
• MSISDN
• IMSI
• SIM Status
• Replaced ICCID
• Replacement ICCID
• Terminal ID
Informações adicionais do dispositivo
• Customer Name
• Device ID
• Modem ID
• Effective Date (a data em que você deseja que as alterações entrem em vigor)
• End Consumer ID • Migrated SIM
• NAC ID (Configuração de Acesso à Rede, também chamada de plano de comunicação) • Overage Limit Override • Plano de tarifas
• SecureSIM Password Copy Rule (valores válidos: Nenhum, Copiar Sempre, Bloqueado, Copiar Uma Vez)
64
• SecureSIM Username Copy Rule
(valores válidos: Nenhum, Copiar Sempre, Bloqueado, Copiar Uma
Vez)
• SIM Notes
• SimProfileId
• Usage Limit Override (valores válidos: Nenhum, Ciclo Atual, Contínuo)
Informações do Cliente Final
• Billing Address Line 1
• Billing Address Line 2
• Billing Address City
• Billing Address State/Region
• Billing Address Country
• Billing Address PostalCode
• Contact Email
• Contact Fax
• Contact Phone
• End Consumer Name
• PPU Address Line 1
• PPU Address Line 2
• PPU Address City
• PPU Address State/Region
• PPU Address Country
• PPU Address PostalCode
• Primary Contact
• Security Question
• Security Answer
• Shipping Address Line 1
• Shipping Address Line 2
• Shipping Address City
• Shipping Address State/Region
• Shipping Address Country
• Shipping Address PostalCode
Campos personalizados
• Custom 1
• Custom 2
• Custom 3
• Customer Custom 1
• Customer Custom 2
• Customer Custom 3
65
Personalização do ambiente de dispositivo
Você pode personalizar o ambiente de dispositivo ao adicionar campos personalizados e alterar
rótulos de campo. Para obter mais informações, consulte Personalização do Control Center
Prevenção de fraudes
Para algumas empresas, a prevenção e a detecção de fraudes são questões de extrema importância. A
última coisa que você deseja é um usuário final retirando um cartão SIM do seu dispositivo e usando-o
em outro lugar, por exemplo um tablet.
Para monitorar o uso de dispositivos e tomar as medidas apropriadas em caso de atividades
suspeitas, consulte Rastreando IMEIs de dispositivos.
4.8 Rastreando IMEIs de dispositivos
Cada dispositivo tem uma IMEI (International Mobile Station Equipment Identity) exclusiva. Esse
identificador está associado ao dispositivo, e não ao SIM. O Control Center fornece uma regra de
automação (Alteração de IMEI) que permite associar cada SIM à IMEI de um dispositivo para que você
possa tomar medidas se esse IMEI mudar.
Quando você ativa a regra Alteração de IMEI, o Control Center examina automaticamente a IMEI do
dispositivo sempre que um SIM se conecta à rede. Se o SIM estiver se conectando à rede pela
primeira vez, o Control Center armazenará o valor da IMEI. Se o SIM já tiver se conectado, o Control
Center fará a comparação do valor atual da IMEI com o valor armazenado. Em caso de
incompatibilidade, o Control Center realizará a ação especificada na regra.
Local: Automação > Regras > botão Criar Novo > categoria Segurança >acionador Alteração de IMEI
66
Selecione a ação apropriada e defina filtros para limitar o escopo da regra. Consulte Regras de
automação para obter mais informações sobre como criar regras.
INCREMENTO DE LINHA Pedidos de novas linhas deverão ser solicitados ao Gerente de Contas.
67
Capítulo 5
5. REGRAS DE AUTOMAÇÃO
Regras de automação permitem que você garanta confiabilidade de serviços, gerencie custos e dimensione
seus negócios com mais rapidez por meio do controle programático de dispositivos, sem realizar qualquer
tipo de programação. Você pode definir regras personalizadas com rapidez e facilidade diretamente na
interface de usuário do Control Center, instruindo a plataforma a monitorar seus dispositivos e, se
acionadores específicos ocorrerem, tomar as medidas apropriadas automaticamente e de maneira
imediata.
As regras de amostra incluem:
• Desativar automaticamente um SIM quando ele atinge um limite de uso para garantir que
dispositivos que não estejam funcionando corretamente não elevem os custos.
• Enviar uma chamada de API por push ao sistema corporativo quando um dispositivo se conectar mais
ou menos frequentemente do que o esperado em um determinado período de tempo para realçar
um possível problema.
Funções com acesso. Em geral, se você consegue visualizar as informações monitoradas por um
acionador de regra específico, isso significa que é possível definir uma regra de automação para os
dados. Alguns recursos no sistema de regras também podem estar restritos a determinadas funções.
68
5.1 Casos de uso comuns
As regras de automação do Control Center se dividem em quatro categorias de uso: Gerenciamento do
ciclo de vida, Controles de custos, Confiabilidade do serviço e Prevenção de abusos. Esta seção descreve
cada categoria de casos de uso e fornece alguns exemplos específicos.
Gerenciamento do ciclo de vida
• Definir o ciclo de vida de conectividade do
dispositivo
• Automatizar provisionamento de serviços • Controlar acesso a redes e serviços
Controles de custos
• Automatizar controles de uso
• Evitar excessos
Confiabilidade do serviço
• Monitorar disponibilidade do serviço
• Identificar comportamento de dispositivo invasor
• Solucionar problemas e evitar possíveis
interrupções do serviço
• Integrar eventos de serviços nos principais
processos de negócios
Prevenir abusos
• Prevenir acesso não autorizado
• Detectar uso fraudulento com base em local
• Detectar e prevenir uso fraudulento com base em
padrões de uso
69
Casos de uso de ciclo de vida
Controlar estado do SIM
Uma empresa automotiva deve gerenciar conectividade para o ciclo de vida exclusivo de um veículo. Por
exemplo, enquanto o carro está no showroom, ela deseja oferecer suporte a demonstrações de
conectividade com dados limitados a uma tarifa reduzida. Assim que o veículo é vendido, ela deseja
ativar o dispositivo e começar a cobrar do cliente.
Regra Alteração de campo personalizado do SIM
Limite Nenhum
Filtro Pelo plano de tarifas de demonstração
Por um campo personalizado
Ação Fazer push em uma API
Notas Use um campo personalizado Status Vendido para acionar a regra. Quando o
valor do campo for alterado para Vendido, use a API EditTerminal para ativar o
dispositivo e associar o plano de tarifas e o plano de comunicação apropriados.
Casos de uso de confiabilidade do serviço
Conectividade sempre ativa
Uma empresa de segurança doméstica deve garantir que seus dispositivos sempre estejam ativos e
funcionais. Se um dispositivo se tornar offline, a empresa deverá receber essa informação e tomar
medidas.
Regra Fim da sessão
Limite Nenhum
Filtro Nenhum
Ação Fazer push em uma API
Notas Quando a empresa receber a push API, ela iniciará seu processo de solução de
problemas interno para executar diagnósticos no dispositivo e, em seguida,
determinar o curso de ação.
70
Monitorar conexões
Uma empresa de serviços públicos monitora de forma proativa qualquer indicação de falha em
dispositivos de forma que ela possa solucionar o problema imediatamente. Ela verifica conexões
demais ou insuficientes durante um período de tempo especificado.
Regra Número de conexões de sessão (24 horas)
Limite 5
Filtro Estado do SIM = Ativado
Ação Fazer push em uma API
Notas Quando a empresa receber a push API, ela iniciará seu processo de solução
de problemas interno para executar diagnósticos no dispositivo e, em seguida,
determinar o curso de ação.
Casos de uso de prevenção de abusos
Controlar valores de IMEI
Uma empresa de serviços de saúde que fornece dispositivos médicos para monitoramento remoto de
pacientes usa regras para detectar quando um cartão SIM é movido de um dispositivo para outro.
Regra Alteração de IMEI
Limite Nenhum
Filtro Nenhum
Ação Enviar um e-mail
Notas A empresa envia um email para uma equipe de suporte que investiga se
ocorreu alguma fraude.
71
Monitorar uso diário
Uma empresa de caminhões monitora o uso diário em seus dispositivos de controle de frota. Se o uso
exceder a expectativa, a empresa desativará o dispositivo.
Regra Uso de dados recente (24 horas)
Limite 40 KB
Filtro Nenhum
Ação Desativar o dispositivo
Notas A empresa também possui uma regra que envia um email de aviso a uma
equipe interna quando qualquer dispositivo atinge 20 KB em um período de 24
horas.
Noções básicas sobre regras
Uma regra de automação possui quatro componentes básicos que você deve especificar ao criar
uma nova regra.
• Gatilho. O acionador identifica a situação geral que você deseja monitorar. Acionadores de regras
tendem a ser divididos em categorias relacionadas a uso, dispositivos e assinaturas. Consulte
Gatilhos para obter uma descrição de todas as regras.
• Evento. Um evento é uma condição ou um limiar que faz com que uma regra entre em vigor.
Algumas regras exigem a definição de um valor específico ou de um conjunto de valores para
72
determinar totalmente o evento de acionamento. Outras regras são mais genéricas e não exigem
nenhuma informação além do acionador de regra básico.
• Ação. Quando um evento ocorre, o Control Center responde com uma ação que é definida para a
regra. Em geral, você pode enviar um e- mail, um SMS ou uma mensagem da Push API para um dos
sistemas
de back-end. Dependendo da regra e das suas permissões, você também pode alterar o plano de
comunicação, o plano de tarifas ou o estado do SIM do dispositivo. Consulte Ações para obter mais
detalhes.
• Filtro. Uma regra pode ter um ou mais filtros que limitam os dispositivos por ela monitorados. Por
exemplo, você pode filtrar regras por plano de tarifas. Muitas regras permitem a filtragem por
cliente ou outros campos. Consulte Filtros para obter mais detalhes.
Observação: Gatilhos de regras, ações e filtros são adicionados ao Control Center regularmente. Para exibir uma lista completa dos acionadores disponíveis, acesse Automação > Regras > botão Criar novo. Você pode cancelar o processo caso prefira não salvar a nova regra
5.2 Gatilhos
As regras de automação do Control Center se dividem em quatro categorias básicas (veja abaixo). Para
cada acionador de regra, é possível definir um evento específico que fará com que o Control Center
execute uma ação específica.
• Provisionamento de SIM. Monitore alterações no plano de tarifas ou status de dispositivos (Teste
pronto, Ativado, Inativo, Removido e assim por diante) e execute uma ação quando for apropriado.
Consulte Provisionamento de SIM
73
Segurança. Realizam ações quando um dispositivo não fornece as informações corretas de nome de usuário e/ou senha durante uma tentativa de acessar serviços de rede. Consulte Segurança
Gerenciamento de assinaturas. Controlam os períodos de assinatura dos seus dispositivos. Realizam ações quando um dispositivo atinge ou está prestes a atingir o final de sua assinatura.
• Monitoramento de uso. Supervisionam o comportamento de uso e conexão dos seus
dispositivos e realizam ações com base em limites de uso ou padrões de conexão. Consulte
Monitoramento de uso
O Control Center agrupa as regras usadas com mais frequência em uma categoria conveniente
denominada Frequentemente usado. As regras exibidas nesta categoria estão baseadas no uso
por várias contas diferentes do Control Center e não apenas da conta atualmente selecionada.
Todas as regras usadas com frequência também aparecem nas categorias principais.
Provisionamento de SIM
Acionador de regra Executado quando…
Alteração do estado do SIM Um dispositivo muda de um estado de SIM (Teste pronto, Ativação pronta,
Ativado etc.) para outro. Você deve especificar ambos os estados De e Para.
Por exemplo, essa regra pode fornecer uma notificação quando um SIM é
ativado pela primeira vez. Dependendo de como a sua conta foi configurada,
talvez você não possa alterar o status de Ativado para Ativação pronta.
Alteração de campo
personalizado do SIM
O valor de qualquer campo personalizado especificado para a conta muda
para um dispositivo. Por exemplo, você pode usar um campo personalizado
para armazenar informações sobre o nível de água em um tanque. Ao usar
uma notificação push API, você pode criar um aplicativo para tomar as
medidas adequadas quando o nível da água aumentar ou diminuir.
Segurança
Acionador de regra Executado quando…
Alteração de IMEI O valor atual da IMEI do dispositivo é diferente do valor anterior.
Consulte Rastreando IMEIs de dispositivos para obter detalhes.
74
Monitoramento de uso
Acionador de regra Executado quando…
Início da sessão Um dispositivo inicia uma conexão à rede sem fio.
Fim da sessão Um dispositivo fecha uma conexão à rede sem fio.
Muitas conexões (ciclo até a
data)
Um dispositivo excede o número máximo de sessões permitidas dentro
de um ciclo de faturamento.
Número de Conexões de
Sessão (24 horas)
Um dispositivo tem mais ou menos que o número de sessões diárias
que você especifica.
Sem conexão Um dispositivo não consegue estabelecer nenhuma conexão durante um
período especificado, definido em horas.
Acionador de regra Executado quando…
Uso de Dados no Ciclo até a
Data
Um dispositivo usa certa quantidade de dados durante o ciclo de
faturamento atual. Você define o limite independentemente do plano de
tarifas do dispositivo. Uma regra de ciclo de uso até a data será acionada
apenas uma vez durante o ciclo de faturamento atual para um
determinado dispositivo.
Uso de dados em uma zona no
ciclo até a data
Um dispositivo usa certa quantidade de dados em uma determinada zona
durante o ciclo de faturamento atual. Você define o limite
independentemente do plano de tarifas do dispositivo. Como o acionador
do ciclo de uso até a data, essa regra será acionada apenas uma vez no
ciclo atual.
Uso mensal de dados
compartilhado
Todos os dispositivos em um plano de tarifas compartilhado mensal
usam uma quantidade total de dados que corresponde a um determinado
percentual em cada zona.
Uso de dados recente
(24 horas)
Um dispositivo usa certa quantidade de dados durante um período de 24
horas com base na hora de início diária. A hora padrão meia-noite UTC é
atribuída, mas a Claro pode ajustá-la para cada conta.
75
Uso recente de SMS Um dispositivo envia e/ou recebe um determinado número de mensagens
durante o ciclo de faturamento atual ou em um período de 24 horas.
Uso mensal de SMS
compartilhado
Todos os dispositivos em um plano de tarifas compartilhado mensal
usam uma quantidade total de mensagens que atende a um
determinado percentual de uso de SMS incluído do pool.
Acionador de regra Executado quando…
SMS MO recebido Um dispositivo envia um SMS para um shortcode. Você pode encaminhar o conteúdo da mensagem e informações relacionadas via email ou push API.
5.3 Ações
Quando um evento aciona uma regra de automação, o Control Center executa a ação que você definiu
para essa regra. Essas ações incluem notificação simples (envio de um SMS ou email), alteração dos
atributos do dispositivo (estado do SIM ou plano de comunicação) ou envio de uma API por push, que
permite que a empresa realize virtualmente qualquer ação em resposta. Em alguns casos, é possível
especificar várias ações de acompanhamento, o que permite fazer alterações temporárias no
comportamento do dispositivo em resposta a condições de negócios temporárias.
*Plano de tarifas em construção
Nem todas as ações estão disponíveis para todas as regras. Quando você cria uma regra, o Control Center permite a seleção apenas das ações que são apropriadas para o acionador de regra atual com base em sua função.
76
Notificação por e-mail
Notificação por e-mail é uma das ações que você pode atribuir a uma regra de automação. O Control
Center enviará uma mensagem de e-mail a um ou mais endereços de e-mail ou para o usuário final
associado ao dispositivo.
Selecione a opção Enviar um e-mail e insira um endereço de e-mail. Para vários destinatários, você deve
separar os endereços com vírgulas. Se você desejar contatar o usuário do dispositivo selecione a opção
Enviar um e-mail para o cliente final. O Control Center usará o endereço de e-mail para o consumidor
final associado ao dispositivo (guia Detalhes do dispositivo > Cliente final). Para obter mais informações,
consulte Dispositivo > Cliente final.
Saiba que Notificações por e-mail usam texto sem formatação e não aceitam links dinâmicos.
SMS
O Control Center pode enviar um SMS diretamente ao seu dispositivo quando acionado por um
determinado evento. Alguns dispositivos estão programados para serem ativados ou retornarem
informações de diagnósticos a um servidor quando recebem um SMS. Dependendo de como os seus
dispositivos estão programados, a ação de SMS pode ajudar você a interagir diretamente com eles em
campo.
77
Após selecionar a opção Enviar um SMS, você poderá redigir uma mensagem de texto. O Control Center
permite incluir informações variáveis. Basta clicar em um botão de variável, como ICCID ou
CustomerName, para inserir a variável no local do cursor no texto da mensagem
Push API
Outra opção de notificação é impulsionar uma mensagem de API. Quando você escolher essa opção, o
Control Center enviará uma mensagem programática a um URL especificado quando a regra for acionada.
Você deve configurar um dos seus servidores para escutar essas mensagens de API, interpretá-las e tomar
as medidas apropriadas. Frequentemente, as contas criarão programas que usam as APIs do Control
Center para examinar ou fazer uma alteração no banco de dados ao receberem determinadas mensagens
da Push API
Alteração do status do SIM
Você também pode alterar o estado do SIM de um dispositivo quando uma regra é acionada. Por
exemplo, suponha que você tenha um dispositivo que deve se conectar apenas uma vez por dia, mas
que, na verdade, se conecta várias vezes em um período de 24 horas. Você pode usar a regra Muitas
conexões para detectar a discrepância e, em seguida, desativar o dispositivo para que você possa
investigar o problema.
Para algumas regras, você também pode alterar o estado do SIM em um determinado horário (apenas
UTC). Nesse caso, o Control Center aguardará até o horário especificado antes de alterar o status do
SIM. Por exemplo, se um SIM for alterado de Ativado para Removido, você poderá instruir o Control
Center a alterar o estado do SIM para Retirado às 18h00 UTC.
78
Essa ação permite definir uma ação de acompanhamento, além da alteração do estado do SIM. Neste
exemplo, a regra especifica uma ação de acompanhamento que retorna o estado do SIM ao valor
anterior no final do ciclo de faturamento.
Alteração do plano de tarifas –Funcionalidade em construção Você também pode alterar o plano de tarifas base de um dispositivo quando uma regra é acionada. Por
exemplo, se um dispositivo usar mais dados do que o esperado, o Control Center poderá alternar do seu
plano de tarifas padrão para um plano de tarifas premium. O plano premium pode ter uma taxa de
assinatura mais alta, mas pode ajudar a eliminar cobranças por excedente ainda maiores do que se o
dispositivo permanecesse no plano padrão.
Alteração do plano de comunicação Funcionalidade em construção Para contas com acesso a informações de plano de comunicação, o Control Center oferece suporte a
regras que alteram automaticamente o plano de comunicação de um dispositivo quando um acionador
específico ocorre. Por exemplo, se um consumidor comprar um plano de tarifas com serviços adicionais,
talvez você deseje alterar o plano de comunicação do dispositivo para um que permita serviços
adicionais.
79
Filtros
É possível ajustar uma regra de automação limitando ou filtrando os dispositivos que estão sujeitos a essa regra. Exemplo: Você pode criar uma regra que informa sobre dispositivos que não estabeleceram uma conexão nas últimas 24 horas. Nesse caso, você provavelmente restringiria a regra apenas aos dispositivos com um status de SIM Ativado. Claramente, você não desejará ser notificado quando um dispositivo Removido parar de estabelecer conexões.
Cada acionador de regra tem o seu próprio conjunto de filtros. Os filtros comuns incluem Plano de
tarifas, Estado do SIM, Cliente e Campos personalizados.
Filtragem de campos personalizados. Saiba que se você adicionar um filtro de regra para um campo
personalizado e, em seguida, desativar esse campo personalizado na interface do usuário, o filtro
continuará a funcionar embora o campo personalizado não seja mais exibido na caixa de diálogo de
filtro. Essa situação poderá produzir resultados inesperados se os campos personalizados contiverem
dados. Você pode consultar a coluna Filtros na lista Regras para verificar quais campos personalizados
estão em uso.
5.4 Como usar regras
Esta seção explica como executar várias tarefas de automação como criar uma regra e exibir
atividades da regra
Exibição de regras
Você pode exibir todas as regras de automação atualmente disponíveis para a sua conta na página de
lista Regras. Para acessar essa página, clique no ícone Mecanismo de automação na página inicial do
Control Center ou clique na guia Automação. Esta tabela fornece informações sobre a definição da regra,
incluindo o acionador de regra, o evento, as ações e os filtros.
Local: Automação > Regras
80
Você pode pesquisar, filtrar e classificar a lista como faria com qualquer outra tabela no Control Center.
Consulte a página Automação na seção de referência para obter mais informações sobre as colunas
nesta tabela.
Para obter informações sobre regras que foram executadas, clique no link Atividade da Regra na parte
superior esquerda da página. Consulte Monitoramento de atividades de regras para obter mais
informações.
Monitoramento de atividades de regras
A tabela Atividade da regra mostra quando as várias regras foram acionadas e fornece detalhes sobre o evento de acionamento e o dispositivo envolvido.
Para acessar essa tabela, clique no ícone Automação > Mecanismo na página inicial do Control Center e, em
seguida, clique no link Atividade da regra na parte superior da página. Você também pode exibir a atividade
de uma regra específica ao clicar no valor Ação para um acionador de regra na lista Regras.
Local: Automação > Atividade de regras
81
Para obter mais informações sobre as colunas nesta tabela, consulte Lista Atividade da Regra
Criar uma regra
O formulário Criar nova regras (consulte Assistente de regras) orienta você através de um processo passo
a passo para definir uma nova regra.
Local: Automação > Regras > botão Criar novo
Clique em uma categoria de regra para ver os acionadores de regra que ela inclui. Você pode exibir uma
lista completa de todos os acionadores de regras ao clicar no botão Ver todos os acionadores de regra.
82
Clique em um acionador de regra para selecioná-lo e especifique as informações do evento (Quando isso
acontece...) e a ação (Faça isso...).
Insira as informações do evento necessárias para o acionador de regra em questão. Em seguida, selecione
uma ação e forneça qualquer informação adicional necessária para essa ação. Consulte Ações para obter
mais detalhes sobre as várias ações
Endereços de email/URLs. Certifique-se de verificar os dados inseridos manualmente. O Control Center
não edita os dados para formatação adequada.
83
Clique no botão Editar filtros para especificar quais dispositivos serão afetados pela regra.
As opções do filtro dependerão do acionador de regra selecionado. É possível inserir valores para todas
as opções para nenhuma ou algumas delas. Clique em OK para retornar ao formulário Criar.
Insira um nome para a regra que seja suficientemente descritivo para ser entendido até por alguém
sem conhecimento sobre essa regra.
Clique em Ativar regra para salvar a regra.
Edição de uma regra
O formulário Criar nova regra permite que você edite regras além de criá-las. É possível modificar
qualquer uma das informações de definição de regra, exceto a categoria e o acionador da regra. Todas
as alterações entrarão em vigor imediatamente.
Local: Automação > Regras > caixa de seleção Regra botão Editar
84
No formulário Editar regra, faça as alterações desejadas e clique no botão Ativar regra para salvar as informações.
Desativação de uma regra
Você pode desativar temporariamente uma regra sem excluí-la do sistema.
Local: Automação > Regras > Desativar link
Localize a regra que você deseja desativar e clique no link Desativar na coluna Ativo. Você pode
restaurar a regra mais tarde ao clicar no link Ativar no mesmo local.
85
Exclusão de uma regra
Excluir uma regra a remove definitivamente do banco de dados. Local: Automação > Regras > caixa de seleção regra > botão Excluir
Selecione uma regra e clique em Sim para confirmar a exclusão.
Práticas recomendadas
A experiência de trabalho com empresas em diferentes mercados verticais nos ajudou a definir várias
práticas recomendadas de automação. Esta seção descreve nossas recomendações e fornece exemplos
para elas.
Limites:
• Parâmetros de pesquisa
• Filtros de uso
• Como evitar intervenção manual
• Regras diárias
• Antecipar comportamento de cronograma
5.5 Limites Várias regras permitem que você defina limites que devem ser atendidos antes que a regra seja acionada.
É importante ler as informações de limites com cuidado antes de fazer uma seleção. Frequentemente, se
86
supõe que uma regra funcione com base no que se deseja, porém há regras semelhantes com resultados
distintos: Por exemplo, uma regra pode confiar em um limite de uso do plano de tarifas, enquanto outra
utiliza o uso incluído. Embora os termos sejam semelhantes, eles se referem a números completamente
distintos.
Por exemplo: Uso de dados no ciclo até a data
Uso de dados no ciclo até a data permite que você controle o uso do dispositivo e tome medidas se o
uso for muito alto.
Seguem pontos de atenção para definição de regras:
Vários usuários assumem que o Control Center mede todo o uso de dados em MB. Nessa regra,
no entanto, a unidade de medida é KB, não MB.
Embora as duas opções de regras pareçam semelhantes, de fato elas são bem diferentes e
levam a resultados diferentes. Certifique-se de ler a linguagem de regras com cuidado e
compreender as implicações de cada opção:
Excede um limite de dados especificado> Você especifica o limite de dados. O uso deve
exceder o limite de dados antes que a regra seja acionada.
Se aproxima do seu limite de uso de dados> O plano de tarifas do dispositivo especifica o
limite de dados. O uso se aproxima, mas não excede o limite de dados quando a regra é
acionada.
Nenhuma opção controla o percentual de uso incluído. Se este valor for importante para seu
caso de uso, considere usar Uso mensal de dados combinados como alternativa.
87
5.6 Parâmetros de pesquisa Se uma regra usar dados de qualquer outro lugar no Control Center, você deverá garantir que os
dados estejam ativos e sejam apropriados para o caso de uso, agora e no futuro. Para fins de
flexibilidade, o Control Center imporá algumas restrições sobre criação de regras. Como resultado,
você precisará ter cuidado ao montar os componentes da regra para garantir que ela funcione da
maneira pretendida.
5.7 Filtros de uso
Filtros de regras permitem que você especifique quais dispositivos são afetados por cada regra. Por
exemplo, você pode criar regras personalizadas para dispositivos pertencentes a um determinado
cliente ou para dispositivos que usem um plano de tarifas específico. Você pode até mesmo usar um
campo de dispositivo personalizado como um filtro. Usar filtros é uma maneira eficaz de minimizar
consequências não pretendidas.
Por exemplo: Número de conexões de sessão (24 horas)
Várias empresas usam mais de um tipo de dispositivo conectado em seus negócios. Por exemplo, uma
empresa de energia pode usar medidores de serviços públicos conectados para medir uso de clientes e
eles poderão fornecer tablets a suas equipes de suporte de campo. Esses dispositivos executam
funções vastamente diferentes e demonstram comportamentos diversos.
Suponha que a empresa de energia deseje saber se um medidor de serviço público faz muitas conexões durante um período de 24 horas, um sinal de que o dispositivo está com problemas. Eles criam uma regra que executa push de uma API de volta para a empresa sempre que o dispositivo conecta mais de 5 vezes em um único dia. Em backend, um processo automatizado captura os dados de push API, desativa o dispositivo e, em seguida, envia uma mensagem para o representante de serviço apropriado.
88
Primeiramente, esta regra soluciona vários problemas de fluxo de trabalho. No entanto, como escrito, a
regra desativará automaticamente qualquer tablet na sexta vez que ocorrer uma conexão de rede durante
um único dia. Certamente, esse não é o comportamento que a empresa pretende.
Você pode solucionar este problema ao usar um filtro que limite o efeito da regra apenas aos dispositivos
apropriados. Se os filtros padrão (plano de tarifas, cliente, estado do SIM) não fornecerem informações
suficientes para identificar diferentes tipos de dispositivos, você poderá criar campos de dispositivos
personalizados que acompanharão os dados necessários.
5.8 Como evitar intervenção manual
Algumas regras permitem que você execute ações de acompanhamento após a ação inicial. Geralmente,
essas ações de acompanhamento assumem que o dispositivo mantém um estado conhecido até que a
ação de acompanhamento ocorra. Se alterar manualmente o estado antes da execução da ação de
acompanhamento, você poderá causar um resultado inesperado; a ação de acompanhamento poderá
não ser acionada de forma alguma ou não produzir o resultado pretendido. Nessas situações, é
importante permitir que regras de automação processem o trabalho em vez de intervir manualmente.
89
5.9 Regras diárias
Uma regra diária é acionada no máximo uma vez em um período de 24 horas, mesmo se as condições
para essa regra ocorrerem várias vezes. Você pode identificar facilmente uma regra diária através da
string "24 horas" no nome da regra, por exemplo, Uso de voz recente (24 horas). Cada conta possui uma
hora de início diária que o mecanismo de automação usa para determinar quando regras diárias devem
ser acionadas.
Por exemplo: Uso de dados recente (24 horas)
Suponha que você possua uma regra que desative um
dispositivo quando ele usar 512 KB de dados em um
período de 24 horas. Um dia após o evento, a regra
restaurará o estado de SIM original do dispositivo.
Se a hora de início diária for 15:00 UTC e a regra acionar às 6:00 UTC, a ação de acompanhamento ocorrerá às 00:00 UTC no próximo dia —apenas 18 horas após o acionamento, não 24 horas.
Para regras diárias, recomendamos que você considere
vários cenários, usando horas de acionamento e configurações
de acompanhamento diferentes, antes de estabelecer uma única solução.
Fatores de tempo
Diversos fatores de tempo influenciam o comportamento das regras.
Fator Descrição
Atrasos de CDR
A Claro possui seus próprios processos para gerar CDRs e enviá-los ao
Control Center. A duração desses processos pode impactar a função das
regras com tempo crítico.
90
Frequência de regras Diferentes regras possuem diversos eventos de origem e frequências de
avaliação. Por exemplo, algumas regras são acionadas quando um
evento específico ocorre, outras com base em horários. Certifique-se de
compreender a frequência das regras que você está usando e a
natureza do evento de origem.
Ações de
acompanhamento
O mecanismo de regras permite que você especifique quando deseja que
uma ação de acompanhamento ocorra: o fim do ciclo de faturamento,
um número especificado de dias após o evento de acionamento (às
00:00 UTC nesse dia) ou um horário UTC especificado após o evento de
acionamento.
Hora de início diária A hora de início diária determina quando o mecanismo de regras inicia e
termina a avaliação de uma regra diária.
Alteração do plano de tarifas do SIM Funcionalidade em construção > No caso de solicitação de alteração de plano, entre em contato
com seu Gerente de Contas.
Alteração do estado do SIM
Categoria Provisionamento de SIM
Descrição Executa quando um dispositivo muda de um estado de SIM
(Teste pronto, Ativação pronta, Ativado etc.) para outro.
Evento de origem O estado do SIM pode ser alterado para um dispositivo
através da interface da Web ou API.
Frequência de
avaliação
Por evento
91
Ações • Enviar um e-mail • Alterar o estado do SIM em uma hora determinada • Alterar plano de comunicação
• Enviar um SMS
• Impulsionar uma mensagem de API
Filtros • Plano de tarifas base • Cliente • Campos personalizados
Detalhes adicionais Você deve especificar ambos os estados De e Para.
Dependendo de como a sua conta foi configurada, talvez
você não possa alterar o status de Ativado para Ativação
pronta.
Casos de uso comuns Gerenciamento do ciclo de vida
Alteração de campo personalizado do SIM
Categoria Provisionamento de SIM
Descrição Executa quando o valor de qualquer campo personalizado
especificado para uma conta é alterado para um dispositivo. Por
exemplo, você pode usar um campo personalizado para
armazenar informações sobre o nível de água em um tanque.
Ao usar uma notificação push API, você pode criar um aplicativo
para tomar as medidas adequadas quando o nível da água
aumentar ou diminuir.
Evento de origem Altere o valor de um campo personalizado para um
dispositivo, através da interface da Web ou API
Frequência de
avaliação
Por evento
92
Ações • Alterar plano de comunicação • Impulsionar uma mensagem de API
Filtros • Plano de tarifas base • Cliente • Campos personalizados
Detalhes adicionais Como você não pode especificar o campo personalizado ou
os valores originais/novos nesta regra, geralmente, empresas
usam o filtro de campos personalizados para definir o campo de
interesse e, em seguida, usam uma notificação push API para
enviar os valores alterados a um programa backend para
processamento.
Casos de uso comuns Gerenciamento do ciclo de vida
Alteração de IMEI
Categoria Segurança
Descrição Executa quando o valor de IMEI do dispositivo atual é
diferente do valor anterior. Consulte Rastreando IMEIs de
dispositivos para obter detalhes.
Evento de origem Solicitação de sessão
Ações • Enviar um e-mail • Alterar estado SIM • Impulsionar uma mensagem de API
• Enviar um SMS
Filtros • Plano de tarifas base • Estado do SIM • Cliente
Detalhes adicionais Quando você ativa a regra Alteração de IMEI, o mecanismo de
automação examina automaticamente a IMEI do dispositivo
sempre que um SIM solicita uma conexão à rede. Se o SIM
estiver se conectando à rede pela primeira vez, o mecanismo
de automação armazenará o valor de IMEI. Se o SIM já tiver se
conectado, o mecanismo de automação comparará o valor
atual de IMEI ao valor armazenado. Se houver uma
incompatibilidade, o mecanismo de automação realizará
qualquer ação especificada.
93
Saiba que a rede da sua Operadora deve estar configurada
para transmitir a IMEI do dispositivo durante o processo de
conexão. Consulte > Lista de dispositivos para verificar se os
dispositivos possuem valores de IMEI que o sistema já esteja
capturando. Em caso positivo, a regra Alteração de IMEI
funcionará. Se você não puder usar esta regra, considere usar
SIM seguro.
Casos de uso comuns Prevenção de abusos. Empresas usam esta regra para
evitar fraudes. Se o dispositivo for facilmente acessível a
outras pessoas e o SIM não estiver soldado no lugar, esta
regra será um bom seguro contra roubos.
Início da sessão
Categoria Monitoramento de uso
Descrição Executa quando um dispositivo inicia uma conexão com a
rede sem fio.
Evento de origem Início da sessão
Ações • Enviar push API
Filtros • Plano de tarifas base • Cliente • Campos personalizados
Detalhes adicionais O Início da sessão gera um processamento intenso.
Fim da sessão
Categoria Monitoramento de uso
Descrição Executa quando um dispositivo fecha uma conexão com a
rede sem fio.
Evento de origem Fim da sessão
94
Ações • Alterar plano de comunicação • Enviar um SMS • Enviar push API
Filtros • Plano de tarifas base • Cliente • Campos personalizados
Detalhes adicionais
Saiba que a regra poderá não ser acionada se uma sessão for
encerrada de forma anormal.
A regra é acionada no fim de uma sessão regular, mas não
no fim de quaisquer sessões parciais subsequentes.
Casos de uso comuns Confiabilidade do serviço. Se um dispositivo tiver que manter uma conexão constante para funcionar corretamente, esta regra o alertará quando a conexão for interrompida
Muitas conexões (do início do ciclo até a data)
Categoria Monitoramento de uso
Descrição Executa quando um dispositivo excede o número de sessões
especificado em um ciclo de faturamento.
Evento de origem Início da sessão
Ações • Enviar um e-mail
• Impulsionar uma mensagem de API
• Alterar estado SIM
Filtros • Plano de tarifas base • Estado do SIM • Cliente
Detalhes adicionais Nenhum
Casos de uso comuns • Confiabilidade do serviço • Prevenção de abusos
Esta regra permite que você monitore dispositivos que se
conectam de forma infrequente durante o mês. Ao controlar o
número de conexões ao longo do ciclo de faturamento, você
95
poderá executar uma ação se o dispositivo enfrentar mais
atividades do que o uso.
Número de conexões de sessão (24 horas)
Categoria Monitoramento de uso
Descrição Executa quando um dispositivo possui mais ou menos
sessões diárias do que o número especificado.
Evento de origem Início da sessão
Frequência de
avaliação
Diariamente
96
Ações • Enviar um e-mail • • Impulsionar uma mensagem de API
• Alterar estado SIM
Filtros • Plano de tarifas base • Estado do SIM • Cliente
Detalhes adicionais Sempre que uma sessão de dispositivo começar, o
mecanismo de regras somará o número de conexões feitas
pelo dispositivo durante as 24 horas anteriores. (Essas
informações também estão visíveis no Spotlight.) A regra
será acionada se as condições forem atendidas.
Após o acionamento da regra, o mecanismo de automação
inibirá quaisquer ações adicionais até que o relógio diário
seja reiniciado. Como resultado, você receberá até uma
notificação para cada dispositivo por dia.
Saiba que esta regra não o alertará se um dispositivo perder
conectividade. Para garantir uma conexão "sempre ativa", você
deverá usar a regra Fim da sessão.
Casos de uso comuns Confiabilidade do serviço. Esta regra permite que você
monitore a confiabilidade do serviço ao controlar as conexões
diárias de um dispositivo. Talvez você deseje criar duas regras,
uma que execute uma ação se um dispositivo não conectar
com frequência suficiente e outra que execute uma ação se o
dispositivo se conectar muito frequentemente.
Sem conexão
Categoria Monitoramento de uso
Descrição Executa quando um dispositivo não consegue conectar
durante um período especificado, definido em horas.
Evento de origem Início da sessão
Frequência de
avaliação
Por hora
97
Ações • Enviar um e-mail
• Impulsionar uma mensagem de API
• Alterar estado SIM
Filtros • Plano de tarifas base • Estado do SIM • Cliente
Detalhes adicionais Esta regra é acionada uma vez por hora e determina se o
dispositivo efetuou uma conexão no período de tempo
especificado na regra. Por exemplo, se o número especificado
de horas for 3, o mecanismo de regras determinará se o
dispositivo efetuou conexões nas últimas 3 horas. Em caso
negativo, a regra executará a ação especificada.
O mecanismo de regras verifica apenas dispositivos com um
estado de SIM Ativado. Se o dispositivo possuir outro estado
além de Ativado durante o período de tempo especificado, o
mecanismo de regras não subtrairá o tempo gasto nesses
estados. Por exemplo, suponha que um novo dispositivo
tenha estado no estado Ativação pronta por várias semanas e
migre para o estado Ativado às 11:30. Assumindo que o período
da regra seja 3 horas, a regra será acionada ao meio- dia
embora o dispositivo tenha tido apenas 30 minutos para
estabelecer uma conexão.
Você pode usar essa regra para verificar falta de conectividade
por um período de dias, bem como horas. Basta inserir o
número de dias em horas (por exemplo, 168 horas = 1
semana).
Saiba que esta regra não o alertará se um dispositivo perder
conectividade. Para garantir uma conexão "sempre ativa", você
deverá usar a regra Fim da sessão.
Casos de uso comuns Confiabilidade do serviço. Como outras regras de conexão, essa permite que
você mantenha guias sobre confiabilidade do serviço. Se um dispositivo tiver que conectar várias vezes
durante o dia, esta regra será mais útil do que Número de conexões de sessão, pois Número de conexões
de sessão será executada somente uma vez ao dia, enquanto que esta regra será executada a cada hora.
98
Uso de dados no ciclo até a data
Categoria Monitoramento de uso
Descrição Executado quando um dispositivo usa certa quantidade de
dados durante o ciclo de faturamento atual.
Evento de origem CDR de dados
Frequência de
avaliação
Por evento
99
Ações • Enviar um e-mail • Enviar um e-mail para o cliente final •
• Alterar estado SIM
• Enviar um SMS
• Impulsionar uma mensagem de API
Filtros • Plano de tarifas base • Estado do SIM • Cliente
• Campos de dispositivo personalizados
Detalhes adicionais Uma regra de ciclo de uso até a data será acionada apenas
uma vez durante o ciclo de faturamento atual para um
determinado dispositivo mesmo se ele continuar a atender o
critério da regra.
Ao usar a opção excede um limite de dados especificado de,
você define o limite de dados independente do plano de
tarifas do dispositivo.
Saiba que a opção se aproxima do seu limite de uso de dados
de examina o valor do limite de uso do plano de tarifas do
dispositivo, não o valor de uso incluído.
Atrasos no processamento de CDR podem afetar o
cronograma desta regra.
Uso mensal de dados compartilhados
Categoria Monitoramento de uso
Descrição Executado quando todos os dispositivos em um plano de
tarifas mensal compartilhado usam uma quantidade total de
dados correspondente a um determinado percentual de
dados incluídos no pool
Evento de origem CDR de dados
Frequência de
avaliação
A cada 30 minutos
100
Ações • Enviar um e-mail • Impulsionar uma mensagem de API
Filtros • Plano de tarifas base • Estado do SIM
Detalhes adicionais Embora o Control Center avalie esta regra a cada meia hora, a
regra será acionada apenas uma vez por desde que não haja
alterações no pool. Se o número de dispositivos no pool for
alterado, a regra será acionada novamente.
Saiba que a métrica de uso de dados compartilhado mensal
pode rapidamente se tornar vencida quando o seguinte
cenário ocorrer:
• Um percentual desproporcional de dispositivos no pool
migrar de um estado Teste pronto ou Ativação pronta
para um estado Ativado.
• Dispositivos migrarem para ou do pool regularmente
como resultado de uma intervenção manual ou processo
de ciclo de vida automatizado.
Como resultado, é importante reavaliar excesso nesses pools
ao final do ciclo de faturamento.
Atrasos no processamento de CDR podem afetar o
cronograma desta regra.
Casos de uso comuns Controles de custos. Você pode usar esta regra para
controlar custos para dispositivos que usam planos de
tarifas combinados.
Uso de dados recente (24 horas)
Categoria Monitoramento de uso
Descrição Executado quando um dispositivo usa uma determinada
quantidade de dados durante um período de 24 horas.
Evento de origem CDR de dados
Frequência de avaliação
Por evento
101
Ações • Enviar um e-mail
• Alterar estado SIM
• Enviar um SMS
• Impulsionar uma mensagem de API
Filtros • Plano de tarifas base • Estado do SIM • Cliente
Detalhes adicionais Sempre que um CDR de dados é recebido, o mecanismo de
automação verifica o uso total de dados para o dispositivo no
período de 24 horas atual na hora de início diária da conta. A
regra será acionada se o uso total for igual ou exceder a
quantidade especificada na regra.
Após o acionamento da regra, o mecanismo de automação
inibirá quaisquer ações adicionais até que o relógio diário
seja reiniciado. Como resultado, você receberá até uma
notificação para cada dispositivo por dia.
Atrasos no processamento de CDR podem afetar o
cronograma desta regra.
Casos de uso comuns • Controles de custos. Você pode usar esta regra para
controlar custos para dispositivos que usam mais dados do
que o antecipado. • Confiabilidade do serviço/Prevenção de abusos. A
regra permite que você detecte picos de uso que podem
indicar dispositivos com falhas ou roubo.
Uso recente de SMS
Categoria Monitoramento de uso
Descrição Executado quando um dispositivo envia e/ou recebe um
determinado número de mensagens durante o ciclo de
faturamento atual ou em um período de 24 horas.
Evento de origem Mensagem SMS
Frequência de
avaliação
Por evento
102
Ações • Enviar um e-mail • Enviar um e-mail para o cliente final • Alterar estado SIM
• Impulsionar uma mensagem de API
Filtros • Plano de tarifas base • Estado do SIM • Cliente
Detalhes adicionais Sempre que o dispositivo envia ou recebe uma mensagem
SMS, o mecanismo de automação verifica o número total de
mensagens enviadas e/ou recebidas pelo dispositivo durante o
período especificado. A regra será acionada se o uso total for
igual ou exceder a quantidade especificada na regra.
Se você selecionar a opção diária, o mecanismo de
automação usará a hora de início diária para definir uma
janela de 24 horas.
Após o acionamento da regra, o mecanismo de automação
inibirá quaisquer ações adicionais até que o relógio diário
seja reiniciado ou o próximo ciclo de faturamento seja
iniciado, dependendo de como você definiu a regra. Você
receberá até uma notificação para cada dispositivo por dia
ou por ciclo de faturamento.
Atrasos no processamento do arquivo de log de SMS podem
afetar o cronograma desta regra.
Casos de uso comuns • Controles de custos. Você pode usar esta regra para
controlar custos para dispositivos que usam mais dados do
que o antecipado. • Confiabilidade do serviço/Prevenção de abusos. A
regra permite que você detecte picos de uso que podem
indicar dispositivos com falhas ou roubo.
Uso mensal de SMS compartilhado
Categoria Monitoramento de uso
Descrição Executado quando todos os dispositivos em um plano de
tarifas compartilhado mensal usam um número total de
103
mensagens que atende a um determinado percentual de uso
de SMS incluído no pool.
Evento de origem Mensagem SMS
Frequência de
avaliação
A cada 30 minutos (lote)
104
Ações • Enviar um e-mail • Impulsionar uma mensagem de API
Filtros • Plano de tarifas base • Estado do SIM
Detalhes adicionais Esta regra será acionada uma vez durante o ciclo de
faturamento a menos que haja alterações no pool, por
exemplo, se você adicionar ou remover dispositivos.
Para que esta regra funcione, o plano de tarifas deve combinar
mensagens SMS, bem como dados.
Atrasos no processamento do arquivo de log de SMS podem
afetar o cronograma desta regra
Casos de uso comuns Controles de custos. Você pode usar esta regra para
controlar custos para dispositivos que usam planos de
tarifas combinados.
SMS MO recebido
Categoria Monitoramento de uso
Descrição Executado quando um dispositivo envia um SMS para um
código de atalho específico. Você pode encaminhar o
conteúdo da mensagem e informações relacionadas via
email ou push API.
Evento de origem Mensagem SMS
Frequência de
avaliação
Por evento
105
Ações • Enviar um e-mail • Impulsionar uma mensagem de API
Filtros • Plano de tarifas base • Estado do SIM • Cliente
Detalhes adicionais Atrasos no processamento do arquivo de log de SMS podem
afetar o cronograma desta regra
Casos de uso comuns Prevenção de abusos. Você pode usar esta regra para
monitorar fraudes ou abusos no uso de SMS.
106
Capítulo 6
6. SOLUÇÃO DE PROBLEMAS
Gerenciar os custos de suporte é essencialmente importante para as empresas
ao lidar com assinaturas de dispositivos ligados. As empresas podem poupar
tempo e esforço valiosos identificando imediatamente se o problema
específico de um dispositivo está relacionado ao hardware, ao software ou à
rede. Problemas de rede são facilmente diagnosticados através do Control
Center.
O Control Center fornece dois aplicativos avançados de diagnóstico, o Assistente
de Diagnósticos e o Spotlight, que permitem aos usuários ver o que está
acontecendo com um dispositivo em tempo real e analisar o comportamento
histórico. Esses aplicativos são extremamente valiosos para solução de
problemas de dispositivos durante o desenvolvimento e em produção.
Sem cobrança adicional. O Control Center extrai dados de diagnóstico
diretamente da rede da Claro sem qualquer tipo de custo para o Cliente.
107
6.1 Assistente de diagnósticos
O Assistente de Diagnósticos automatizado facilita para as equipes corporativas não técnicas monitorar,
diagnosticar e até mesmo corrigir problemas comuns de conectividade de rede. Descobrimos que uma
empresa pode resolver de 85 a 90% das questões de suporte somente com essa ferramenta. Colocar
dispositivos de volta on-line mais rapidamente significa que uma empresa pode elevar a satisfação do
cliente, garantir confiabilidade de serviço e manter as despesas baixas.
Para a equipe de suporte com mais conhecimento técnico, a ferramenta Spotlight fornece um instantâneo
detalhado do histórico de conectividade de um dispositivo dos últimos 30 dias, para que você possa
observar tendências de longo prazo. O Spotlight mostra quando a sessões de dados ocorreram, quanto
tempo duraram e se foram encerradas normalmente. O Spotlight também destaca eventos incomuns,
como as sessões de zero byte (sessão ativa sem tráfego de dados) para chamar sua atenção para possíveis
problemas.
108
Assistente de diagnósticos
O Assistente de diagnósticos é uma valiosa ferramenta de aprovação inicial para detectar possíveis
condições conhecidas que podem resultar em conectividade perdida ou reduzida. Ele pode reduzir os
tempos de resolução fornecendo orientação com antecedência em situações de suporte de nível 1, sem
exigir conhecimento técnico profundo por parte do usuário. Executado em um único dispositivo, o
assistente analisa os dados disponíveis de histórico de conexão e estado em tempo real, processando
algoritmos de solução de problemas em cada componente de conexão entre o dispositivo propriamente
dito e o aplicativo local do cliente.
Assistente de Diagnóstico para análise automatizada de um dispositivo — comportamento aparentemente normal
109
Cor Descrição
Verde (OK) O comportamento de configuração e conectividade está normal.
Amarelo (Aviso) Um comportamento normal de configuração e conectividade foi
observado no passado. Porém, o dispositivo não está conectado no
momento. (Observe que esse estado só está disponível em testes de
Conexão de Rede e IP/Internet.)
Vermelho (Erro) O comportamento atual de configuração e conectividade indica um
problema, e não há dados mostrando sucesso no passado.
Cinza (Pendente ou
Desconhecido)
Estado desconhecido. Em geral, esse estado indica que o assistente não
teve dados suficientes para realizar um diagnóstico significativo.
Se um problema for detectado, o Control Center vai sugerir as causas possíveis e oferecer instruções
para resolver o problema.
Acesso ao Assistente de diagnósticos Os usuários com os devidos privilégios baseados em função podem iniciar o Assistente de diagnósticos de qualquer uma destas maneiras:
• Ícone Diagnóstico em Tempo Real na página inicial
• Ícone Diagnóstico na página Lista de dispositivos
• Menu Ação na página Lista de dispositivos
• Botão Diagnóstico na página Detalhes do Dispositivo
Ícone Diagnóstico em Tempo Real (Página inicial)
Na página inicial, insira um ICCID, ID do Dispositivo, ou outro identificador exclusivo na barra de
pesquisa e clique no botão Diagnóstico em Tempo Real.
Local: Página Inicial > campo Pesquisar > ícone Diagnóstico em Tempo Real
Ícone Diagnóstico (Lista de dispositivos)
Na Lista de dispositivos, selecione o ícone Diagnóstico ao lado do dispositivo que deseja
analisar.
Local: Dispositivos > Lista de dispositivos > ícone Diagnóstico
Obs.A coluna Diagnóstico pode ser configurada para visualização (pode estar oculta ou não)
110
Opção do menu Ação (Lista de dispositivos) Use o menu Ação associado ao dispositivo que deseja testar.
Local: Dispositivos > Lista de dispositivos > lista suspensa Ação > Executar Diagnóstico
Botão Diagnóstico (Detalhes do Dispositivo)
Na parte superior da página Detalhes do Dispositivo, selecione o botão Diagnóstico. Local: Dispositivos > Lista de dispositivos > Detalhes do Dispositivo > botão Diagnóstico
111
6.2 Noções básicas dos resultados de teste
O Assistente de diagnósticos reporta informações básicas de dispositivo e executa lógica analítica nos componentes a seguir do perfil de conexão geral de um dispositivo.
Assistente de diagnósticos para análise automatizada de um dispositivo — aviso de IP/Internet
Estado do Dispositivo Indica a conectividade geral de um dispositivo — se no momento ele está em uma sessão de dados ativa — além do estado do SIM e se ele foi bloqueado ou suspenso. Você também poderá ver o plano de tarifas atual e o uso de dados até a data.
Provisionamento Avalia o estado de provisionamento (ou ativação) atual do dispositivo
verificando os bancos de dados do Control Center. Os possíveis resultados
do teste incluem:
• Verde – O estado atual do SIM permite a transferência de
dados
• Vermelho – O estado atual do SIM não permite a transferência de
dados
112
SIM/Dispositivo Avalia a capacidade do dispositivo de usar recursos de rede verificando sua
configuração nos bancos de dados do Control Center. Os possíveis
resultados do teste incluem:
• Verde – O dispositivo tem permissão para usar recursos de rede
sem fio.
• Vermelho O dispositivo foi bloqueado na rede. Isso pode ter ocorrido
devido a um comportamento agressivo inesperado e pode indicar o
mau funcionamento do dispositivo.
• Vermelho – O dispositivo foi suspenso devido ao uso além dos
limites em excesso configurados
Conexão de Rede Avalia a capacidade do dispositivo de se conectar à rede sem fio
verificando seu estado atual no HLR e também analisando os registros do
HLR. Os possíveis resultados do teste incluem:
• Verde – O dispositivo tem um registro válido de GPRS e GSM no HLR e
apresentou sinais de atividade nos últimos 30 dias. O registro na rede é
válido e não há indicação de problema.
• Amarelo – O dispositivo não tem registro de GSM ou GPRS no HLR. O
resultado do teste fornece mais informações sobre qual registro está
ausente.
• Amarelo – Não há um registro válido para esse dispositivo no HLR,
mas houve atividade de rede nas últimas 24 horas. Isso é normal
quando o
dispositivo entra no modo de suspensão como parte do seu ciclo diário.
• Vermelho – Não há um registro válido no HLR, nem atualizações do local
para esse dispositivo nas últimas 24 horas. O resultado do teste fornece
mais informações.
113
IP/Internet Avalia a capacidade do dispositivo de interagir com os servidores do cliente
verificando se o dispositivo tem, ou teve, sessões de GPRS bem-sucedidas.
Esse teste verifica a configuração atual do dispositivo no
servidor Radius para a autorização de GPRS, seu histórico de tentativas de
autorização e se quaisquer CDRs foram gerados. Os possíveis resultados do
teste incluem:
• Verde – O dispositivo configurou com êxito uma sessão de dados GPRS.
Verifique o Spotlight para obter detalhes adicionais sobre o tráfego de
uplink ou downlink da sessão atual. Sessões de zero byte retornarão um
resultado Verde para esse teste porque uma conexão foi estabelecida. No
entanto, no Spotlight, sessões de 0 byte aparecerão na faixa Eventos
Interessantes.
• Amarelo – O dispositivo teve sessões bem- sucedidas no passado (nos
últimos 30 dias), mas não está conectado no momento. Se o dispositivo
tentasse se conectar, a conexão seria bem-sucedida.
• Vermelho – O dispositivo não está conectado e não mostra um histórico
de sessões bem-sucedidas. Isso pode indicar um problema com as
configurações de APN ou IP no dispositivo ou a incapacidade do dispositivo
de abrir portas ou soquetes.
Realização de testes manuais
O Assistente de diagnósticos também permite que os usuários executem alguns testes manualmente
para ajudar a identificar áreas problemáticas ou a resolver problemas de conectividade dos dispositivos.
114
Nos links Próximos passos localizados na parte inferior do assistente, um usuário pode seguir vários
links.
Próximo passo Descrição
Informações do SIM Abre uma caixa de diálogo com informações sobre outros atributos do
dispositivo. Em alguns casos, você pode modificar os valores do atributo.
Enviar um SMS para o
dispositivo
Abre uma caixa de diálogo no assistente de diagnósticos que permite aos
usuários enviar um SMS diretamente a um dispositivo para verificar a
conectividade do dispositivo com o GSM e a sua capacidade de receber um
SMS.
Ir para Spotlight
Avançado
Abre o aplicativo Spotlight, no qual é possível obter ainda mais detalhes
sobre o dispositivo atual.
6.3 Spotlight
O Spotlight fornece uma visualização detalhada, relacionada à uma linha do tempo, de diversas
informações como estado de provisionamento de um dispositivo, do histórico de sinalização da rede em
tempo real e do histórico de conexão em tempo real. Essas informações são apresentadas em conjunto,
correlacionadas em uma linha do tempo da esquerda para a direita para facilitar a análise visual.
Detalhes adicionais estão disponíveis por meio de uma busca detalhada em eventos específicos na
exibição do Spotlight. Essa visualização abrangente do comportamento de um dispositivo é valiosa para a
115
solução de problemas de conectividade geral e para a otimização do desempenho e do desenvolvimento
de dispositivos.
Janela do Spotlight representando o histórico completo de um dispositivo
O Spotlight é exibido em uma janela modal, sobre qualquer janela que tenha sido aberta
anteriormente, e inclui os seguintes componentes:
Componente Descrição
ICCID O ICCID do dispositivo é exibido na barra de títulos da janela.
Preferências de
exibição
Os usuários configuram várias preferências de exibição para
personalizar a visualização de acordo com as suas necessidades.
116
Informações do SIM Dependendo da função do usuário, existem várias
configurações atuais para o SIM disponíveis.
Ações de SIM Dependendo da função do usuário, existem várias ações
disponíveis (por exemplo, Enviar SMS, Enviar Local do
Cancelamento, etc.)
Faixas Cada categoria de informações históricas é apresentada em uma
faixa (uma linha horizontal dedicada), com a mesma escala de
tempo da esquerda para a direita aplicada a cada faixa.
Para fechar o Spotlight e retornar à página anteriormente visualizada, clique no botão OK no canto inferior direito ou no botão "x" (fechar janela) no canto superior direito da janela do Spotlight.
6.4 Noções básicas dos conceitos básicos de rede
As ferramentas de diagnóstico do Control Center ajudam você a descobrir se os problemas de
comunicação dos dispositivos são o resultado de problemas de conectividade de rede ou de algum outro
problema relacionado a componentes de hardware/software. Para usar o Spotlight da melhor maneira
possível, é importante compreender alguns conceitos básicos de rede, incluindo o fluxo de rede ponta a
ponta e o processo ao longo do qual um dispositivo estabelece conectividade.
Noções básicas sobre rede e glossário
Veja a seguir um diagrama bastante simples de uma rede 3G na qual um dispositivo com SIM se conecta
a um aplicativo de cliente. As definições dos vários componentes de rede são apresentadas a seguir.
117
Diagrama de rede sem fio 3G de alto nível
MSC Um MSC (Mobile Switching Center, Centro de comutação móvel) faz parte
da rede GSM original, fornecendo serviços móveis de voz e SMS. Vários
MSCs são necessários para dar cobertura a um país.
SGSN Um SGSN (Nó de Suporte GPRS de Atendimento) é uma extensão da rede
GSM original para fornecer serviços de dados móveis. Conexões de dados
entre um dispositivo e a Internet/VPN são estabelecidas por meio de SGSN.
Em comparação a MSCs, uma quantidade muito menor de SGSNs é
necessária para dar cobertura à área geográfica de um país.
HLR Um HLR (Home Location Register, Registrador de localização inicial)
autentica qualquer dispositivo que esteja tentando se conectar a um
MSC ou SGSN. Ele confirma se um dispositivo tem ou não permissão em
sua rede, quais serviços ele pode acessar, quais APNs ele pode usar e se
existem restrições de roaming.
GGSN Um GGSN (Nó de Suporte para GPRS de Gateway) forma o gateway entre
a arquitetura de dados sem fio e a Internet.
SMSC Um Centro de Serviços de Mensagens Curtas (SMSC) retransmite
mensagens SMS de e para os dispositivos remotos.
118
Servidor de
aplicativos
Um servidor de aplicativos é um servidor do cliente que executa os
aplicativos que processam os dados provenientes dos dispositivos remotos.
Servidor SMPP Um Servidor SMPP também é um servidor de cliente. Ele envia e
recebe mensagens SMS para e de dispositivos remotos por meio do
protocolo SMPP (Mensagens Curtas entre Pares).
Contexto de PDP Um Contexto de PDP (Packet Data Protocol) é uma estrutura de
dados presente no SGSN e GGSN que contém informações de sessão
do dispositivo quando ele está em uma sessão ativa. Quando um
dispositivo deseja usar a rede de dados, ele deve primeiro se
conectar e depois ativar um contexto de PDP.
SS7 O SS7 (Sistema de Sinalização n° 7) é um protocolo de sinalização de
telefonia de padrão internacional. Diferentes componentes da rede sem
fio se comunicam uns com os outros via SS7.
Pedidos de Autenticação
Quando um dispositivo tentar se conectar a um MSC, esse MSC entrará em contato com o HLR
de sua rede e iniciará um pedido triplo, ou seja, uma solicitação de autorização para o
dispositivo se conectar a essa rede.
O HLR informará ao MSC se o dispositivo tem permissão na rede, quais APNs ele pode usar, quais
serviços ele pode acessar e se existem restrições de roaming. Com base nessas informações, o
dispositivo pode se conectar à rede por meio do MSC três vezes antes que ele precise se
reconectar ao HLR para uma nova verificação.
Noções básicas sobre conexão com serviços de dados
Para um dispositivo estabelecer uma conexão de dados, as três etapas básicas seguintes são
necessárias, em ordem:
1. Conectar-se a um MSC da Claro. A autenticação de segurança é realizada pelo HLR.
2. Conectar-se a um SGSN da Claro. A autenticação de segurança é realizada pelo HLR.
3. Criar um Contexto de PDP (Canal de Dados) na Claro. Requer a combinação correta de APN, nome de
usuário e senha. Requer também o estado SIM correto — Teste Pronto, Ativação Pronta ou Ativado.
119
A sessão de dados será mantida enquanto estiver na Claro, por meio de um roaming entre os limites
do MSC e do SGSN:
1. À medida que o dispositivo passar de uma área de MSCs para outra, a localização do MSC desse
dispositivo será controlada por meio de procedimentos de Atualização do Local no HLR.
2. À medida que o dispositivo passar de uma área de SGSNs para outra, a localização do SGSN desse
dispositivo será controlada por meio de procedimentos de Atualização do Local no HLR.
3. Todas as sessões de dados ativas são transferidas claramente entre
SGSNs à medida que o dispositivo entra em roaming na Claro.
A conexão de Internet/VPN com o Servidor de Aplicativos também precisa estar ativa para a conclusão
do canal de dados.
Noções básicas sobre conexão com serviços de SMS
Para um dispositivo estabelecer Serviços de SMS, as seguintes etapas básicas são necessárias, em
ordem:
1. Conectar-se a um MSC da Claro. A autenticação de segurança é realizada pelo HLR.
2. Enviar/receber SMS na Claro .
A conexão SMPP de Internet/VPN com o servidor SMPP também precisa estar ativa para a conclusão
da trajetória de SMS.
6.5 Acesso ao Spotlight
Há várias maneiras de iniciar o Spotlight:
Ícone do Spotlight (Lista de dispositivos)
Local: Dispositivos > Lista de dispositivos > ícone do Spotlight
Botão do Spotlight (Detalhes do Dispositivo) Local: Dispositivos > Lista de dispositivos > Detalhes do Dispositivo > botão do Spotlight
120
Página Resultados do Diagnóstico
Local: Página de Diagnóstico > botão Ir para Spotlight Avançado
Para fechar o Spotlight e retornar à página anteriormente visualizada, clique no botão OK no canto inferior direito ou no botão "x" (fechar janela) no canto superior direito da janela do Spotlight.
121
Ajuste da exibição
Várias definições configuráveis personalizam a exibição do Spotlight de acordo com as necessidades
do usuário.
Opção de exibição Descrição
Zoom Controla a escala de tempo representada pela exibição do Spotlight. A
duração selecionada equivale à largura da página do Spotlight, com as
opções disponíveis variando de 30 dias, para a visualização de padrões de
conexão extensos, até alguns minutos, para a análise de detalhes e tempos
de transação específicos.
122
Ícones de Entrar no
Zoom/Sair do Zoom
Ícones de atalho para controlar o nível de zoom. Clicar nos ícones de lupa
"+" e "-" move a exibição para o próximo nível de zoom (mais detalhado e
menos detalhado, respectivamente).
Data Controla no dia no qual centralizar a exibição do Spotlight. Isso é útil
quando o usuário precisa se deslocar até um determinado dia para
analisar o comportamento do dispositivo correspondente a um evento
específico.
Fuso Horário Define o fuso horário para a exibição do Spotlight. Ele é definido
separadamente da configuração geral de preferência de fuso horário do
Control Center do usuário. Isso é útil para corresponder a exibição com à do
usuário do dispositivo durante a análise do comportamento desse
dispositivo.
Atualizar Atualiza os dados exibidos no Spotlight. Isso é útil ao realizar testes de
conectividade dinâmicos, pois os resultados estão disponíveis em tempo real
no Spotlight.
Como usar ações do SIM
Dependendo dos privilégios baseados em função do usuário, as seguintes ações de dispositivo podem
estar disponíveis no Spotlight.
123
Ação do SIM Descrição
Enviar SMS Inicia uma caixa de diálogo que permite ao usuário enviar uma mensagem
via SMS de formato livre para o dispositivo. Essa ação pode ser usada
para verificar a cobertura e/ou as permissões de SMS do dispositivo. Se
ela for bem-sucedida, a mensagem via SMS normalmente ficará visível
alguns segundos após a entrega e aparecerá na faixa de SMS após a
atualização da janela do Spotlight.
Enviar local do
cancelamento
Envia uma notificação ao MSC de que o dispositivo deve ser desconectado
desse MSC. Essa ação pode ser usada para verificar se, e como, um
dispositivo tenta se reconectar à rede depois de ser forçado a sair. Você
pode executar a mesma função pela API SendCancelLocation.
Atualizar Tenta recuperar as informações mais recentes do próprio
dispositivo sobre alguns de seus atributos.
Exibição de informações do SIM
Dependendo dos privilégios baseados em função do usuário, o Spotlight exibirá vários atributos de
configuração específicos do dispositivo. Esses valores, se disponíveis, serão exibidos em uma região
que pode ser recolhida na parte superior da página.
As informações de Último valor conhecido para Restrições de roaming e APN permitem que você
reconheça a operadora e APNs que o dispositivo pode usar. Para SGSN e MSC, os Últimos valores
conhecidos são endereços que correspondem aos nós da rede usados mais recentemente pelo
dispositivo.
124
O link Enviar local do cancelamento próximo às informações do MSC limpa o registro do dispositivo do
MSC/SGSN. Você pode usar esta função de solução de problemas para descobrir se, e como, um
dispositivo tentar se reconectar à rede após ser forçado sair
Interpretação das informações de faixas
Várias categorias de informações sobre o histórico e o estado de um dispositivo são correlacionadas e
exibidas simultaneamente no Spotlight. Cada categoria separada é exibida em uma faixa, uma linha
horizontal distinta que mostra eventos específicos e o tempo durante o qual cada um desses eventos
ocorreu. A representação visual de cada evento é específica para o tipo de informação. Por exemplo,
informações baseadas em sessão são exibidas como uma barra colorida que abrange o tempo durante o
qual a sessão permaneceu ativa. Eventos de ponto no tempo, como a entrega de uma mensagem SMS,
são exibidos como marcadores individuais no momento em que o evento ocorreu. Clicar em um evento
dentro de uma faixa fornece detalhes adicionais sobre o evento específico em um texto explicativo.
Os usuários podem arrastar a área de exibição do Spotlight lado a lado para visualizar detalhes que estão ocultos na página. Se o usuário arrastar e chegar ao final dos dados armazenados para a página atual do Spotlight, um indicador de seta clicável será exibido na parte superior da região da faixa, permitindo que esse usuário se mova para a página anterior ou seguinte do histórico do dispositivo.
125
Um botão Mostrar na parte superior da seção de exibição de faixa do Spotlight permite que o usuário
selecione quais das categorias de dados disponíveis ele deseja exibir de acordo com as suas necessidades
de análise.
Categorias em Mostrar indicando quais faixas devem ser exibidas no Spotlight
Faixas de MSC
Exibe o histórico conhecido de conexões do dispositivo com nós MSC nas redes da Claro. Se o dispositivo
tiver aparecido em vários MSCs durante o período em análise, a seção MSC terá várias faixas. Os dois
primeiros MSCs distintos aparecerão em suas próprias faixas dedicadas, enquanto os MSCs adicionais
serão combinados em uma terceira faixa.
126
A etiqueta de faixa para os dois primeiros MSCs mostra o nome host, bem como o GTA (endereço de
título global) do MSC. Para MSCs adicionais representados na terceira faixa de MSC, é possível exibir a
Operadora e o GTA do MSC ao clicar em um evento de conexão específico.
Representação visual
Cada conexão com um MSC é exibida como uma barra de linha do tempo cinza que se expande desde a
atualização de local inicial, quando o dispositivo apareceu no MSC, até o momento em que o local GSM
do dispositivo foi cancelado ou atualizado. Observe que, se o dispositivo ainda estiver registrado em um
MSC específico, a barra de linha do tempo de conexão terminará na data/hora atuais na exibição do
Spotlight.
Dados de eventos detalhados
Clicar em uma barra de linha do tempo de conexão do MSC mostra as seguintes informações:
• Endereço do Título Global do MSC
• Host do MSC
• IMSI do dispositivo registrado no MSC
• Data/hora de início e término da barra de linha do tempo de conexão
Faixa de sessão
Exibe CDRs (Call Detail Records, Registros de detalhes das chamadas) para as sessões de dados do
dispositivo. Uma sessão de dados pode ser representada por um único CDR ou por vários CDRs
consecutivos (chamados de CDRs parciais). Em geral, uma sessão será representada por vários CDRs
parciais se tiver permanecido ativa por um longo período ou se o dispositivo tiver enviado/recebido um
alto volume de dados durante essa sessão. CDRs adicionais também poderão ser gerados se o dispositivo
for transferido de um SGSN para outro durante uma única sessão.
127
Representação visual
Cada CDR é exibido como uma barra de linha de tempo que se expande pelas datas/horas de abertura
e encerramento do CDR. Diferentes barras de linha do tempo coloridas representam o seguinte:
• Barra preta – Representa o CDR inicial de uma sessão. Em situações nas quais vários CDRs parciais
são exibidos no Spotlight, as barras pretas representam os pontos em que novas sessões de dados
foram estabelecidas.
• Barra cinza-clara – Representa um CDR parcial que não é o primeiro CDR da sessão de
dados principal
• Barra cinza-escura – Representa a sessão atual do dispositivo e se baseia nos registros de
contabilização de área (não em CDRs). A intenção desse indicador de sessão de dados especial é
mostrar as informações mais recentes sobre o histórico de sessões conhecido de um dispositivo,
mesmo que os CDRs ainda não tenham sido processados
Linha do tempo de CDR/dados de eventos detalhados
Clicar na linha do tempo mostra as seguintes informações:
• ID de Cobrança do CDR
• O número entre parênteses indica o número de sequência do CDR referente à sessão de dados principal
• Causa de encerramento do CDR; as seguintes causas de encerramento podem ser exibidas:
• 0 – Conexão encerrada pelo dispositivo; término da sessão • 4 - Conexão encerrada pela rede local (ou seja, falha local, liberação anormal); término
da sessão
• 16 – Limite de dados de CDR atingido; sessão mantida • 17 – Limite de tempo de CDR atingido; sessão mantida
• 18 – Transferência normal de SGSN para SGSN; sessão mantida
• 19 – "Condição de alteração máxima". Em geral, indica uma sessão descartada como
resultado de uma transferência entre SGSNs; término da sessão
• 20 - Conexão encerrada por intervenção da Claro; término da sessão • 22 - Alteração na tecnologia de acesso a rádio; indica uma alteração de classe de serviço para
outra (por exemplo, GPRS para UMTS); término da sessão
• IMSI do dispositivo • Endereço IP do dispositivo
• Operadora do SGSN de atendimento
128
• APN usado pelo dispositivo
• Bytes enviados (uplink) e recebidos (downlink) pelo dispositivo
• Duração do CDR (sessão ou sessão parcial)
• Nome do GGSN por meio do qual o dispositivo foi conectado
• Data/hora de início e término do CDR
Linha do tempo de sessões/dados de eventos detalhados
Clicar na linha de tempo exibe as seguintes informações:
• ID da sessão
• IMSI do dispositivo
• Endereço IP do dispositivo
• Operadora do SGSN de atendimento
• APN em uso pelo dispositivo
• Bytes enviados (uplink) e recebidos (downlink) pelo dispositivo
• Duração da sessão
• Endereço IP do GGSN por meio do qual o dispositivo foi conectado
• Data/hora de início e término da sessão
Faixa de Sessão mostrando o CDR inicial
Faixa de sessão exibindo o CDR parcial da sessão atual
129
Faixa de sessão exibindo a sessão atual
Faixa de SMS
Exibe eventos de mensagens SMS do dispositivo.
Representação visual
Cada mensagem SMS é exibida como um ícone de evento. Diferentes combinações de ícones
coloridos e etiquetas representam o seguinte:
• Ícone azul/ Entregue – Representa um SMS enviado ao dispositivo no Control Center
• Ícone azul/ Recebido – Representa um SMS enviado do dispositivo e recebido com êxito pelo
Control Center
• Ícone cinza/ SMS MT – Representa uma mensagem via SMS recebida pelo dispositivo de outro
cliente de SMS (não do Control Center)
• Ícone cinza/ SMS MO – Representa uma mensagem via SMS enviada pelo dispositivo para outro
cliente de SMS (não para Control Center)
Dados de eventos detalhados/ícone azul
Clicar em um ícone azul (SMS entre o dispositivo e o Control Center) mostra as seguintes informações:
Se o SMS foi Entregue pelo Control Center ao dispositivo, ou Recebido do dispositivo
130
• Texto da mensagem; observe que o texto da mensagem é exibido somente para
mensagens via SMS trocadas entre o Control Center e o dispositivo. Em geral, essas
mensagens são usadas para fins de diagnóstico.
Data/hora de entrega da mensagem
Se o SMS foi Entregue pelo Control Center ao dispositivo, ou Recebido Do dispositivo
Texto da mensagem; observe que o texto da mensagem é exibido somente para mensagens via SMS trocadas entre o Control Center e o dispositivo. Em geral, essas mensagens são usadas para fins de diagnóstico.
Data/hora de entrega da mensagem
Dados de eventos detalhados/ícone cinza
Clicar em um ícone cinza (SMS entre clientes de SMS que não são do Control Center) mostra as seguintes informações:
• Se o SMS foi recebido pelo dispositivo (SMS MT indicando "terminação móvel") ou enviado pelo
dispositivo (SMS MO indicando "origem móvel")
• Status de entrega da mensagem • Enviado ao endereço; pode ser um MSISDN ou um código de atalho
• Enviado do endereço; pode ser um MSISDN ou um código de atalho
• Data/hora de entrega da mensagem
Faixa de Estado do SIM
Exibe o estado de provisionamento do dispositivo com base no seu histórico do estado SIM no Control Center:
131
Representação visual O estado de provisionamento do dispositivo é representado como uma barra de linha de tempo
contínua. As seções em verde e vermelho da barra de linha do tempo do estado SIM representam os
períodos em que o dispositivo foi aprovisionado para permitir ou proibir o tráfego de dados,
respectivamente. O estado de provisionamento de um dispositivo é controlado principalmente pelo seu
estado SIM, embora outras condições, como o bloqueio de dispositivos abusivos, falhas do SIM seguro e
cotas de excesso de dados, também possam afetar a autorização do dispositivo para estabelecer
conectividade de dados.
Dados de eventos detalhados
Clicar em uma seção da barra de linha do tempo do estado SIM mostra as seguintes informações:
• Estado do SIM
• Estado SIM Bloqueado (verdadeiro/falso)
• Limite de excesso atingido (verdadeiro/falso)
• Data/hora de início e término da seção selecionada da barra da linha do tempo
Faixa de pedido de autenticação
Exibe um resumo dos pedidos de autenticação do dispositivo na rede GSM. Isso indica com que
frequência o dispositivo está solicitando acesso à rede GSM. Se um dispositivo for excessivamente
agressivo em suas tentativas de acesso, ele poderá exercer pressão sobre a rede, o que pode indicar um
dispositivo com mau funcionamento.
Representação visual
Os dados resumidos de autenticação são exibidos como um mapa de atividades. As barras coloridas
representam períodos de tempo em que houve atividade de pedido de autenticação. A codificação por
cores de cada seção do mapa de atividades (verde, amarelo ou vermelho) representa se as atividades no
período permaneceram acima ou abaixo de um limite predefinido.
Os valores do limite variam de acordo com o nível de zoom em vigor. Os valores do limite de atividades
atuais são mostrados nos dados de eventos detalhados (veja abaixo).
• Verde representa as atividades durante o período, mas em níveis consistentes com o
comportamento esperado
132
• Amarelo representa atividades que estão acima dos níveis esperados durante o período
• Vermelho representa as atividades que estão significativamente acima do comportamento esperado,
indicando muito provavelmente um dispositivo com mau funcionamento
Dados de eventos detalhados
Clicar em uma seção do mapa de atividades de autenticação mostra as seguintes informações:
• Número de solicitações de autenticação durante o período selecionado
• Limite aceitável é o limite com o qual o número real de pedidos de autenticação é comparado
(varia com o nível de zoom)
• Datas/horas de início e término da seção selecionada do mapa de atividades
Faixas de ativação de sessão
Exibe um resumo das solicitações do dispositivo para estabelecer sessões de dados. Isso indica a
frequência com que o dispositivo solicita acesso a dados no servidor Radius em um determinado APN. Se
um dispositivo for excessivamente agressivo em suas tentativas de acesso, ele poderá exercer pressão
sobre a rede, o que pode indicar um dispositivo com mau funcionamento.
Representação visual
Dados de resumo de ativação de sessão são exibidos ao longo de duas faixas como um mapa de atividades.
A primeira faixa, Falhas de ativação de sessão, mostra barras coloridas que representam períodos de
tempo em que houve atividades de solicitação de autorização. A codificação por cores de cada seção do
mapa de atividades (verde, amarelo ou vermelho) representa se as atividades no período permaneceram
acima ou abaixo de um limite predefinido.
Os valores limite variam de acordo com o nível de zoom em vigor; os valores limite de atividades
atuais são mostrados nos dados de eventos detalhados (veja abaixo)
• Verde representa as atividades durante o período, mas em níveis consistentes com o
comportamento esperado
133
• Amarelo representa atividades que estão acima dos níveis esperados durante o período
• Vermelho representa as atividades que estão significativamente acima do comportamento esperado,
indicando muito provavelmente um dispositivo com mau funcionamento
A segunda faixa, Ativações de sessão, é exibida como uma série de ícones de evento. Diferentes ícones
coloridos representam se uma solicitação de ativação está atualmente em uma sessão ativa.
• Ícone vermelho – Representa uma solicitação de ativação de sessão que não está mais ativa
• Ícone azul – Representa uma solicitação de ativação de sessão que foi permitida para a sessão atual
Dados de eventos detalhados
Clicar em uma seção no mapa de atividades de ativação de sessão exibe as seguintes informações:
• Número de solicitações de autenticação durante o período selecionado
• Limite aceitável é o limite com o qual o número real de solicitações de sessão é comparado (varia com
o nível de zoom)
• APN no qual as solicitações ocorreram
• Datas/horas de início e término da seção selecionada do mapa de atividades
Clicar em um ícone de evento na faixa Ativações de sessão exibe as seguintes informações:
• O estado Permitido ou Não ativo de uma solicitação de ativação de sessão
• IMSI do dispositivo • Operadora do SGSN de atendimento
• Nome do GGSN por meio do qual o dispositivo foi conectado
• Data/hora da solicitação
Faixa de Registros HLR Brutos
Exibe eventos individuais nos quais o dispositivo interagiu com o HLR no que diz respeito ao acesso à rede
GSM. Esses eventos incluirão as atualizações de local do HLR que são usadas para representar o histórico
de conexões GSM do dispositivo nas faixas de MSC e SGSN, bem como os pedidos de autenticação que
estão resumidos na faixa Pedidos de Autenticação. A diferença aqui é que cada evento de HLR distinto é
exibido para uma análise mais aprofundada.
134
Representação visual
Cada atividade do HLR é exibida como um ícone de evento.
Dados de eventos detalhados
Clicar em um evento de log HLR bruto mostra as seguintes informações:
• Endereço de título global do MSC ou SGSN que está informando o evento
• Tipo de atividade (por exemplo, Atualização de Local ou Cancelar Local conforme o dispositivo muda de local, pedido de autenticação se o dispositivo solicitar autorização GSM) • Nome do host do MSC ou SGSN que está gerando o relatório • IMSI do dispositivo
• Data/hora em que a atividade ocorreu
Faixa de Sessões Interessantes
Embora o objetivo geral do Spotlight seja analisar o comportamento abrangente do dispositivo,
determinados padrões e comportamentos podem ser indícios de classes conhecidas de comportamentos
inesperados do dispositivo. Para acelerar o diagnóstico de algumas dessas condições, a faixa Sessões
Interessantes procura padrões no histórico do dispositivo e exibe eventos ou sessões que podem justificar
investigações adicionais.
Observação: Exemplos de padrões atuais detectados pela faixa Sessões Interessantes estão descritos a
seguir. Essa lista pode mudar com o passar do tempo, à medida que surgirem novos padrões capazes de
auxiliar no diagnóstico do dispositivo.
Representação visual Sessões de 0 byte: sessões de dados com 0 bytes transmitidos como carga de pacote são detectadas e
representadas como barras de linha do tempo vermelha - Encerramento incomum da sessão de CDR:
135
CDRs com determinadas causas de encerramento inesperado são detectados e representados como
ícones de evento. Atualmente, as seguintes causas de encerramento sinalizarão uma sessão para
inclusão aqui:
4 - Conexão encerrada pela rede local (ou seja, falha local, liberação anormal); término da sessão
20 - Conexão encerrada por intervenção da Claro; término da sessão
22 - Alteração na tecnologia de acesso a rádio; indica uma alteração de classe de serviço para outra (por exemplo, GPRS para UMTS); término da sessão
Dados de eventos detalhados
Clicar em um ícone de evento ou em uma barra de linha do tempo de sessões interessantes
mostra as seguintes informações:
• Causa de encerramento do CDR
• Bytes enviados e recebidos para o CDR
• ID de Cobrança do CDR
• IMSI do dispositivo
• Endereço IP do dispositivo
• Host do SGSN
• APN usado pelo dispositivo
• Duração coberta pelo CDR
Faixa de observações
Exibe observações individuais sobre o histórico do dispositivo que foram criadas por usuários do
Spotlight para descrever ou simplesmente fazer anotações em um ponto específico no histórico do
dispositivo. Observações criadas por um usuário ficam visíveis para outros usuários do Spotlight
com acesso ao dispositivo e os devidos privilégios baseados em função.
O usuário pode criar uma nova observação ao clicar no botão Adicionar abaixo do rótulo de faixa.
136
Representação visual
Ícones de evento de observação pontual
Dados de eventos detalhados
Clicar em uma observação mostra as seguintes informações:
• Título da observação
• Texto da observação
• Links Editar/Excluir para editar o texto da observação ou remover a observação, respectivamente
• Data/hora indicadas pela observação
137
6.6 Lista de verificação de conectividade de dados
Os problemas de suporte técnico mais comuns estão relacionados à conectividade. Você pode
identificar rapidamente o principal ponto de falha (provisionamento, cobertura, dispositivo ou SIM)
ao responder às perguntas na lista de verificação a seguir. Se você responder Sim, vá para a próxima
pergunta, a menos que as instruções determinem de outra forma. Se responder Não a uma pergunta,
você encontrou o problema. Siga as instruções para corrigir o problema.
Provisionamento
1. O dispositivo tem permissão para usar a rede?
Use o Assistente de diagnóstico para descobrir rapidamente se o dispositivo está suspenso,
bloqueado ou atingiu seu limite de uso: Dispositivos > Lista de dispositivos > menu Ações >
Executar diagnóstico > campos Estado do dispositivo. Se qualquer um destes três campos de Estado
do dispositivo assumir um valor Sim, siga as instruções:
Suspenso Se o dispositivo for suspenso, contate a Claro para obter
assistência.
SIM bloqueado
Se o dispositivo for bloqueado, entre em contato com a
Claro .
Limite de uso atingido Se o dispositivo tiver atingido o limite de uso definido no plano de
tarifas associado, haverá várias opções para p e r m i t i r a
c o nt in u i da d e aumentar a utilização. Você poderá substituir
manualmente o limite de uso.
2. O dispositivo tem permissão para transmitir tráfego?
Verifique se o dispositivo possui um estado de SIM que permita tráfego: Teste pronto, Ativação pronta e
Ativado. Você pode verificar o estado do SIM do dispositivo na Lista de dispositivos ou no Assistente de
diagnóstico (exatamente acima do campo Suspenso). Para alterar o estado do SIM, consulte Alteração
manual do estado.
Cobertura
3. O dispositivo possui cobertura?
Verifique se há cobertura em sua localização atual.
138
4. Há outros dispositivos funcionando na mesma área?
Se houver, provavelmente a cobertura estará OK.
5. A intensidade do sinal pode ser melhorada ao mover o dispositivo?
Mesmo quando o mapa exibir cobertura em uma área específica, você poderá observar problemas
de intensidade de sinal localizados, particularmente se um dispositivo estiver dentro de um edifício.
Perfis de terreno também poderão causar interferência em sinais. Tente aproximar o dispositivo de
uma janela ou mova-o para fora.
6. A intensidade do sinal é forte o suficiente?
Se o dispositivo possuir um medidor de intensidade de sinal, verifique a leitura. Em caso negativo,
experimente verificar a intensidade do sinal usando um celular na mesma rede nessa área.
7. Você pode fazer uma conexão de SMS?
Use o assistente de diagnóstico para enviar um SMS para o dispositivo: Dispositivos > Lista de
dispositivos > menu Ações > Executar diagnóstico > botão Enviar um SMS para o dispositivo. Se
isso funcionar, o dispositivo poderá fazer uma conexão GSM com a rede.
Dispositivo
8. O dispositivo está sendo alimentado?
9. Se o dispositivo estiver funcionando com bateria, há carga suficiente?
Pouca carga em alguns dispositivos pode afetar conectividade. Certifique-se de que o dispositivo
esteja completamente carregado ou conectado a um carregador ao solucionar problemas.
10. O APN está correto?
Certifique-se de que o dispositivo esteja usando o APN correto. Para localizar o APN do dispositivo,
consulte Localização de um APN de dispositivo..
11. O problema persiste ao desligar e ligar o dispositivo?
Desligue o dispositivo por pelo menos 60 segundos e ligue-o novamente. Se o dispositivo estiver
sendo alimentado por bateria, remova a bateria por 60 segundos e, em seguida, reinsira a bateria.
O atraso de 60 segundos eliminará toda a alimentação no dispositivo e garantirá uma
reinicialização limpa para o aplicativo do dispositivo e hardware do modem de rádio.
12. O SIM funciona em outro dispositivo?
Se possível, remova e insira o SIM em outro dispositivo IoT ou em um celular desbloqueado.
Certifique-se de definir o APN corretamente no novo dispositivo antes de testar a conectividade. Se
o SIM funcionar em outro dispositivo, você poderá assumir que o dispositivo original está com
defeito e interromper a solução de problemas.
139
13. O problema persiste se você envia uma solicitação Cancelar local ao SIM?
Uma solicitação Cancelar local removerá o dispositivo da rede. Dependendo do aplicativo do
dispositivo, o dispositivo poderá tentar reconectar à rede automaticamente. A função Cancelar
local está localizada no Spotlight: Dispositivos > Lista de dispositivos > menu Ações > Visualizar no
Spotlight > link Enviar local do cancelamento (no canto superior direito da página).
SIM
14. O SIM está encaixado corretamente?
Às vezes um SIM é inserido incorretamente na fábrica ou desencaixado quando o dispositivo é
aberto para manutenção ou substituição da bateria.
15. Outro SIM funciona no dispositivo?
Experimente substituir o SIM por outro. Se o novo SIM funcionar, há um problema com o SIM
original.
Se você não for capaz de identificar a causa do problema de conectividade, contate a Claro para obter
assistência: Suporte > Suporte do fornecedor de serviço ou através do e-mail
Capítulo 7
7. FATURAMENTO
Redigida para o profissional financeiro de uma empresa, esta seção fornece
todas as informações de que você precisa para compreender o faturamento
de contas.
A maioria dos usuários do Control Center possui acesso somente leitura às
informações de faturamento. Cada empresa (ou conta) pode ver somente os
dados de sua própria fatura. Contas com clientes também poderão exibir dados
das faturas de seus clientes.
140
7.1 O processo de faturamento
O Control Center mantém os dados de faturamento que a Claro usa para gerar faturas para suas contas
corporativas. Uma vez por mês, o Control Center consolida os dados prontos para fatura e os exibe online
como uma "fatura" do Control Center. Esses dados incluem informações de faturamento para cada
dispositivo de conta, bem como detalhes sobre cobranças e descontos adicionais. A maior parte das
cobranças está relacionada aos planos de tarifas usados para cada dispositivo. Outras cobranças refletem
níveis de compromisso da conta, taxas de serviço, taxas de ativação de dispositivo e assim por diante.
Veja a seguir uma visão geral gráfica do processo de faturamento, mostrando todos os
participantes e suas diversas tarefas.
*Provedor de serviços = Claro
7.2 Planos de tarifas
Um plano de tarifas determina quanto custará para um dispositivo, também chamado de assinante,
acessar serviços sem fio, como uso de dados e mensagens de texto (Short Message Service, ou SMS)
Cada dispositivo possui um plano de tarifas base. Se necessário, você pode alterar esse plano de tarifas
através do Atendimento.
Cada plano de tarifas tem os mesmos componentes básicos:
• Tipo de assinatura (mensal). Determina quando os serviços são faturados.
141
• Tipo de uso incluído (individual oucompartilhado). Especifica se um dispositivo pode
compartilhar seu uso com outros dispositivos no plano de tarifas.
• Serviços (dados, SMS, , outros). Controla se os serviços sem fio disponíveis para um dispositivo são
tarifados e faturados.
• Taxa de assinatura. Determina quanto custa para um dispositivo acessar os vários serviços
durante o período.
• Alocação de uso/Cobranças por excedente. Especifica a quantidade de uso (para dados, SMS, e
outros) incluída sem custo adicional na taxa de assinatura, bem como o custo para qualquer uso além
e acima do uso incluído.
• Zonas. Definem diferentes alocações de uso e cobranças por excedente para diferentes áreas
geográficas ou tipos de conteúdo. Obs. Cliente Claro possui a mesma tarifa em todas as áreas
geográficas.
O Control Center controla informações de faturamento relacionadas a planos de tarifas (assinatura,
dados e SMS excedentes). Demais cobranças serão visualizadas na fatura da Claro.
Visão geral de planos de tarifas
O Control Center oferece suporte a vários tipos de plano de tarifas. A tabela a seguir apresenta uma
visão geral dos planos de tarifas que podem aparecer em faturas.
Plano de tarifas Descrição
Individual Cada assinante paga uma a ss i n at ur a mensal em troca de uma
franquia individual mensal (dados e sms)
Pool flex Compartilhado Cada assinante paga uma a ss i n at ur a mensal em troca de uma franquia
individual mensal de uso incluído (dados e sms). Essa franquia p o d e s e r
c o m p a r t i l h a d a e n t r e t o d o s o s a s s i n a n t e s .
142
Tipo de assinatura
O tipo de assinatura para um plano de tarifas é pós-pago e o ciclo de faturamento é mensal, começando
no dia 21 de cada mês com vencimento no dia 17.
Pós-pago mensal
Para um plano de tarifas mensal, uma conta paga todas as taxas devidas pelo dispositivo no final de cada
ciclo de faturamento. Essas taxas podem incluir uma taxa de assinatura, uma taxa de ativação, taxas por
excedente (de acordo com o plano contratado). O período do plano de tarifas continua até que o
dispositivo deixe de estar ativo. Para obter mais informações sobre como o Control Center determina se
um dispositivo é faturável ou não, consulte Dispositivos faturáveis x Dispositivos ativos
Haverá cobrança de assinatura pró-rata como em casos de troca de plano e suspensões de serviços.
Rateio do uso. Quando o Service Manager rateia uma taxa de assinatura, ele também rateia a alocação
de uso. Por exemplo, se uma conta pagar a metade da taxa de assinatura para um dispositivo no primeiro
mês, esse dispositivo receberá apenas metade do uso incluído nesse mês.
Ciclos de faturamento
Um ciclo de faturamento no Control Center tem sempre duração de um mês e tem início no dia 21 de
cada mês.
Tipo de uso incluído (Franquia)
Para cada plano, é contratada uma franquia mensal para consumo (Dados e SMS) . Quando
o dispositivo excede o uso incluído, o Control Center pode cobrar taxas por uso excedente adicional,
pode desativar totalmente o acesso a serviços sem fio ou suspender o uso caso atinja 10x a franquia
contratada.
Tipos de Plano IOT CONTROL: IOT CONTROL INDIVIDUAL – Nesta opção, o cliente contrata uma franquia para cada linha móvel, não sendo a referida franquia compartilhada entre as linhas. Após o consumo da franquia há a cobrança de excedente, individualmente, por linha que exceder ao consumo. Eventual franquia remanescente de uma linha não é disponibilizada para outra linha que tenha concluído o consumo de sua franquia, nem cumulada para o ciclo de faturamento seguinte.
143
IOT CONTROL FLEX COMPARTILHADO – Nesta opção, o cliente contrata uma franquia por linha que se
soma as franquias das demais linhas e o total da franquia contratada com base no número de linhas
contratado será compartilhada entre estas linhas. Após o consumo da franquia total do Plano , há a
cobrança de excedente, qualquer que seja a linha a realizar o consumo excedente, sendo
este somado ao consumo final para efeito de cobrança. Se houver franquia remanescente,
não será acumulado para o faturamento seguinte.
Quando um dispositivo se torna faturável, o Control Center atribui a ele um status de assinante para
informar a você por que ele é faturável. Você pode encontrar essas informações na subguia Dispositivos da
página Detalhes da fatura. Existem opções diferentes para esse campo:
Status do assinante Descrição
Ativado O dispositivo teve um status de SIM Ativado em algum ponto durante o ciclo
de faturamento.
Compromisso de período de
ativação
A Claro oferece um período de isenção de assinatura na criação da
linha com término no período acordado ou na ativação da linha.
O faturamento detalhado por eventos será obtido diretamente no Control Center (assinatura, dados e sms). Demais cobranças serão visualizadas diretamente na fatura.
Substituição do limite de uso de um único dispositivo
Por padrão, o Control Center desativa o acesso a serviços sem fio quando um dispositivo que usa um
plano de tarifas mensal atinge o limite de 10 vezes a franquia contratada. Em alguns casos, a conta pode
optar por substituir o limite de uso de um determinado dispositivo. Você pode substituir o limite
continuamente ou apenas para o ciclo atual. Em ambos os casos, o Control Center aplica quaisquer
cobranças em excesso definidas no plano de tarifas ao dispositivo.
Local: Dispositivos > Lista de dispositivos > caixa de seleção Dispositivo >botão Editar.
144
O campo Cancelamento do limite de uso possui três valores possíveis:
• Nenhum – Indica sem comportamento de cancelamento. Nesse caso, o dispositivo não poderá mais estabelecer conexões de dados até o final do ciclo de faturamento. No início do próximo ciclo de faturamento, o dispositivo poderá estabelecer conexões de dados novamente. • Ciclo atual – Permite que o dispositivo continue a estabelecer conexões de dados durante o
período de faturamento atual, independentemente da quantidade de dados usada nesse ciclo. No
início do ciclo seguinte, o cancelamento do limite de uso será redefinido com o valor Nenhum.
• Contínuo – Permite que o dispositivo continue a estabelecer conexões de dados, independentemente
da quantidade de dados usada no ciclo de faturamento. O valor Contínuo permanecerá em vigor até ser
explicitamente alterado.
Altere o valor no campo Cancelamento do limite de uso e clique em OK para salvar.
145
7.3 Fatura
O Control Center calcula dados prontos para faturamento de cada conta ao final de cada ciclo de cobrança. Apenas os dados de consumo (Assinatura, dados e SMS) estão disponíveis para exibição online através da guia Faturamento no Control Center, demais cobranças estarão disponíveis na fatura Claro e não no Control Center. A guia Faturamento é um amplo mecanismo de relatório que oferece visibilidade para todos os dados de faturamento que o Control Center mantém.
Esta seção contém informações sobre exibição e interpretação de faturas do Control Center.
Lembre-se:
O detalhamento do uso da franquia estará visível para consulta na Plataforma Control Center.
A fatura deverá ser extraída diretamente do Sistema Conta Online pelo Administrador indicado pela empresa contratante para pagamento a partir do fechamento de cada ciclo de faturamento.
Exibição de faturas
Faturas atuais e históricas estão disponíveis para exibição na página Resumo de faturas. Praticamente todas as funções de conta no Control Center podem exibir informações de fatura. Cada conta pode ver somente seus próprios dados de fatura. Contas com clientes também poderão exibir dados de fatura de seus clientes. Obs. Apenas os dados de consumo (Assinatura, dados e SMS) estarão disponíveis no Control Center.
Local: Faturamento > Faturas
146
Como ler uma fatura
Cada fatura contém uma grande quantidade de informações sobre cobranças de dispositivos, cobranças
de conta, uso e planos de tarifas. O diagrama a seguir destaca onde você encontrará essas informações
variadas.
Ajuda em nível de campo. Para obter informações sobre os campos individuais na página Detalhes da
fatura e suas subguias, consulte Detalhes da Fatura
147
Dispositivos faturáveis x
Dispositivos ativos:
Assinantes ativos referem-se ao número de dispositivos que tinham um estado
SIM Ativo em algum ponto durante o ciclo de faturamento e estão contribuindo
para esta fatura. Saiba que este número pode ser diferente do número de
dispositivos. O número de dispositivos pode incluir dispositivos que não estão
ativos, mas são faturáveis para cumprir os níveis de compromisso de uma conta.
A subguia Dispositivos fornece uma lista de todos os dispositivos que contribuem
para esta fatura. O campo Status do Assinante informará porque o dispositivo é
faturável.
Números de uso Estes campos especificam os volumes de uso total para dados e SMS
Cobranças de
instalação, Taxas
mensais, Ajustes
Compromissos em nível de
conta
O campo Outra cobrança refere-se a uma variedade de cobranças de conta,
inclusive cobranças de instalação, taxas mensais, ajustes e compromissos
em nível de conta. O campo Outra cobrança refere-se a uma variedade de
cobranças de conta, inclusive cobranças de instalação, taxas mensais,
ajustes e compromissos em nível de conta. Você pode obter um
detalhamento destas cobranças na subguia Outros custos. Obs. A referência
para cobranças adicionais é a fatura da Claro.
Compromissos no nível do
dispositivo
O campo Status do assinante na subguia Dispositivo informa se um
dispositivo é faturável porque está ativo ou está atendendo a um
compromisso.
Descontos por volume
Cobranças opcionais
Se uma conta for elegível para um desconto por volume com base em
sua receita ou no número de assinantes, o campo Desconto exibirá o
percentual usado para calcular esse desconto (com base nos valores
definidos nas configurações da conta). Se o desconto se destinar a
cobranças qualificadas, o campo Receita do serviço mostrará a soma
dessas cobranças.
O campo Desconto aplicado exibe quanto dinheiro o Control Center
subtrairá do total geral. Consulte a subguia Desconto para obter
detalhes sobre cada desconto. Obs. Funcionalidade não disponível
148
Taxas de ativação
O Custo de ativação é o número de dispositivos recentemente ativados
ou reativados multiplicado pela taxa de ativação. Se nenhum dispositivo
entrar nesta categoria durante um ciclo de faturamento, este valor será
zero. Clique na subguia Ativações para obter um detalhamento destas
cobranças.
Geração de faturas da conta
O Control Center não emite faturas ou rastreia pagamentos. A Claro oferece o serviço Control Center
como um componente de suas próprias soluções e possui seu próprio sistema de faturamento para
criar faturas com base nas informações de faturamento detalhadas do Control Center. Obs.Apenas os
dados de consumo (Assinatura, dados e SMS) estarão disponíveis no Control Center.
O Control Center oferece um conjunto completo de APIs que você pode usar para extrair dados pertinentes
do Control Center e carregá-los em seus próprios sistemas de faturamento (consulte APIs). Você também
pode usar o recurso de exportação para criar planilhas que podem ser importadas para os seus processos
de faturamento.
Recurso de exportação
Com o recurso de exportação na página de lista Faturas, você pode criar e baixar os seus próprios
relatórios personalizados. Use os controles de coluna para reordenar as colunas de dados e remover
colunas que não sejam de interesse. Você também pode filtrar os dados com a caixa de pesquisa
Avançado.
Clique no ícone Exportar no canto superior direito da tela. O Control Center criará um arquivo com todos os dados no relatório atual, incluindo quaisquer dados em páginas secundárias
149
Acesso a APIs
O Control Center também fornece uma API GetInvoice que retorna dados de faturas de alto nível para uma determinada conta e ciclo de faturamento. Este dado inclui as informações detalhadas exibidas na parte superior da página Faturamento > Faturas > Detalhes da fatura, por exemplo:
• Cobrança total por assinaturas
• Cobrança total por utilização de dados e/ou mensagens SMS além do uso incluído
• Volume de uso total faturável por todos os dispositivos faturáveis • Cobranças por ativação, se aplicáveis
• Outras cobranças como tarifas por serviços de rede
Além disso, várias APIs fornecem informações detalhadas sobre o uso de cada dispositivo durante um
determinado ciclo de faturamento. Por exemplo, você pode recuperar:
• Volume de dados total
• Volume de dados faturável
• Volume de SMS total
• Volume de SMS faturável
Consulte APIs para obter mais informações sobre as funções de APIs disponíveis.
7.4 Resolução de dúvidas sobre faturamento
O Control Center oferece inúmeras informações sobre faturas, uso de dispositivos e planos de tarifas.
Filtrando essas informações de maneira criativa, você pode responder a praticamente qualquer
pergunta sobre faturamento ou uso de dispositivos.
Perguntas frequentes:
Cobranças No ano passado, qual ciclo de faturamento teve a maioria das cobranças?
1. Vá para Faturamento > Faturas.
2. Classifique os registros por Ciclo de faturamento em ordem decrescente.
3. Compare as cobranças na coluna Cobrança total para localizar a fatura com as cobranças mais altas.
150
Que plano de tarifas tem a maior taxa de assinatura?
1. Vá para Faturamento > Planos de tarifas. 2. Classifique os registros por Preço em ordem decrescente.
Dispositivos ativos/faturáveis
Quantos dispositivos estavam ativos durante o último ciclo de faturamento?
1. Vá para Faturamento > Faturas.
2. Classifique os registros por Ciclo de faturamento com uma classificação decrescente de forma que a
fatura mais recente seja exibida primeiro. Uma alternativa é procurar a fatura mais recente ao
selecionar o ciclo de faturamento mais novo na lista suspensa próxima ao canto superior direito e,
em seguida, clicar no botão Pesquisar.
3. Anote o número de Assinantes ativos indicados na terceira coluna na página Detalhes da fatura. Esses
dispositivos possuem um status Ativo e a conta pagará uma taxa de assinatura por cada um,
independentemente de eles usarem ou não serviços sem fio.
Quais dispositivos acumularam cobranças de ativação durante o último ciclo de faturamento?
1. Vá para Faturamento > Faturas.
2. Classifique os registros por Ciclo de faturamento com uma classificação decrescente de forma que a
fatura mais recente seja exibida primeiro. Uma alternativa é procurar a fatura mais recente ao
selecionar o ciclo de faturamento mais novo na lista suspensa próxima ao canto superior direito e,
em seguida, clicar no botão Pesquisar.
Na quarta coluna da página Detalhes da fatura, o campo Custo de ativação será exibido. Esse
valor representa o custo de ativação de todos os dispositivos que se tornaram ativos durante o
ciclo de faturamento.
3. Clique na subguia Ativações para ver um detalhamento do Custo de ativação por dispositivo.
Que dispositivos são faturáveis, mas não estão ativos?
1. Vá para Faturamento > Faturas. Selecione o ciclo de faturamento de destino.
2. Na subguia Dispositivos, classifique por Status do assinante. Qualquer status diferente de Ativo
indica um dispositivo que é faturável, mas não está ativo.
151
Em um determinado ciclo de faturamento, qual plano de tarifas teve o maior número de
assinantes faturáveis?
1. Vá para Faturamento > Faturas. Selecione o ciclo de faturamento de destino.
2. Clique na subguia Plano de tarifas e classifique os registros por Assinaturas em ordem decrescente.
Uso
Para planos de tarifas individual:
1. Vá para Faturamento > Faturas. Selecione a fatura de destino e acesse a página Detalhes da fatura.
2. Na subguia Detalhe dos dados, clique no botão Avançado e escolha a opção Mensalmente - Por
Sim para Modo incluído e clique no botão Pesquisar. O Control Center exibirá todos os
dispositivos usando um plano de tarifas individual.
3. Classifique os registros por Encargos de dados em ordem decrescente.
O Control Center exibirá o dispositivo com a cobrança de dados mais alta primeiro.
Para planos de tarifas compartilhados
1. Vá para Faturamento > Faturas. Selecione a fatura de destino e acesse a página Detalhes da fatura.
2. Classifique os registros por Volume de dados em ordem decrescente.
O Control Center exibirá o dispositivo com mais utilização de dados primeiro. Um rápido exame na
coluna Encargos de dados mostrará se o dispositivo está em um plano combinado.
3. Classifique os registros por Volume de dados em ordem decrescente.
O Control Center exibirá o dispositivo com mais utilização de dados primeiro. Um rápido exame na
coluna Encargos de dados mostrará se o dispositivo está em um plano compartilhado.
Que dispositivo usou a maioria das mensagens de texto durante o último período de
faturamento? 1. Vá para Faturamento > Faturas.
2. Classifique os registros por Ciclo de faturamento com uma classificação decrescente de forma que
a fatura mais recente seja exibida primeiro. Uma alternativa é procurar a fatura mais recente ao
selecionar o ciclo de faturamento mais novo na lista suspensa próxima ao canto superior direito e,
em seguida, clicar no botão Pesquisar.
3. Clique no ID da fatura referente à fatura mais recente. A página de detalhes será exibida.
4. Verifique se a subguia Dispositivos está selecionada e se a coluna Volume de SMS está visível.
5. Faça uma classificação decrescente na coluna Volume de SMS. O dispositivo que usou a
maioria das mensagens de texto durante o ciclo de faturamento aparecerá no topo.
152
Planos de tarifas
Qual é o plano de tarifas padrão?
Vá para Faturamento > Planos de tarifas. Uma lista com todos os planos de tarifas disponíveis será
exibida. O plano de tarifas padrão terá uma marca de seleção na coluna Plano padrão.
153
Capítulo 8
8. RELATÓRIOS
O Control Center fornece um Painel que proporciona uma visão geral resumida de suas cobranças mensais
por categoria e seus volumes de tráfego de dados mensais. Para visualizar o Painel, vá para a guia Relatórios
ou clique no módulo Relatórios na Página Inicial.
8.1 Relatório de cobranças mensais
O relatório Cobranças Mensais é um gráfico de barras que mostra o total de cobranças mensais por
categoria. Passe o mouse sobre uma barra para ver o número real. Cada mês é definido por um ciclo de
faturamento que recebe um nome com base na última data do ciclo. Por exemplo, o ciclo de faturamento
de janeiro de 2015 pode durar na verdade de 15 de dezembro de 2014 a 14 de janeiro de 2015, ou até
mesmo de 2 de dezembro de 2014 a 1° de janeiro de 2015.
Local: Relatórios > Painel
Obs. Preço Voz (Funcionalidade não disponível)
154
8.2 Relatório de Volume Mensal de Dados
O relatório Volume Mensal de Dados é um gráfico de barras que mostra o volume total de tráfego de
dados para sua conta corporativa mensalmente. Se você tiver vários clientes, o Control Center somará
os volumes de dados de todos esses clientes. Passe o mouse sobre uma barra para ver o número real.
Cada mês é definido por um ciclo de faturamento que recebe um nome com base na última data do ciclo.
Por exemplo, o ciclo de faturamento de janeiro de 2015 pode durar na verdade de 15 de dezembro de
2014 a 14 de janeiro de 2015, ou até mesmo de 2 de dezembro de 2014 a 1° de janeiro de 2015.
155
Capítulo 9
9. APIs
O Control Center oferece uma interface de programação de aplicativo (API) que permite acessar e editar
dados no Control Center a partir de um aplicativo externo. Com as APIs, você pode executar várias
tarefas que podem ser processadas através da interface da Web do Control Center, incluindo:
• Gerenciar seus dispositivos
• Monitorar a utilização de dados, SMS e voz
• Enviar mensagens a um dispositivo
• Obter dados de fatura
O acesso básico à API é atualmente parte do serviço padrão do Control Center.
Dados em tempo real. A API não foi projetada para oferecer monitoramento em tempo real de uso de
serviço. Para feedback imediato, caso determinadas condições ocorram, use as regras de automação.
Para obter informações de referência sobre as funções de API individuais e código de amostra XML,
consulte a documentação técnica de API no Control Center (Página inicial > Integração de API).
9.1 Como usar as APIs
O suporte à API está incluso em todas as contas do Control Center, inclusive contas de teste. Para
fins de desenvolvimento de API, o Control Center mantém um ambiente de sandbox,
completamente separado do ambiente de produção. Nesse ambiente protegido, você pode se
familiarizar com as APIs e experimentar seus aplicativos em ambiente de teste.
Todas as vezes em que você usar uma chamada de função de API, será necessário fornecer credenciais de
logon para um usuário com permissão para realizar essa função. Se o usuário de login puder executar a
função na interface da Web do Control Center, você poderá concluir a tarefa através de uma chamada de
API. Não há qualquer função de API que garantirá acesso a todas as chamadas de função.
Recomendamos que, para fins de auditoria, contas corporativas criem um usuário do Control Center cuja
única finalidade seja executar funções de API. Na maioria dos casos, essa será uma conta AccountAdmin,
uma função que poderá executar a maioria das funções de API de conta. Para obter informações sobre
outras necessidades de API ou melhores práticas, entre em contato com a Claro.
156
Usuários de clientes também pode usufruir das APIs. O acesso a APIs de clientes reflete o acesso que
eles normalmente possuem na interface da Web.
Terminologia
Terminais. Várias funções de API referem-se a um dispositivo como um
"terminal". Os termos são intercambiáveis.
Config de acesso de rede. Este é um termo antigo do Control Center para um plano de
comunicação. Nós continuamos a usar o termo porque várias APIs duradouras usam o termo em seus
nomes de função.
Para obter informações sobre outros termos, consulte o Glossário.
9.2 Processo de desenvolvimento de API
Etapa 1: Definir ambiente de desenvolvimento
Em primeiro lugar, será necessário fazer o download dos arquivos de esquema WSDL e XML para a API.
Você pode acessar esses arquivos por meio do Control Center. Na página inicial, clique em Integração de
API para exibir a documentação técnica online. Clique em Referências técnicas > Obter arquivos WSDL.
Em seguida, siga as instruções do tutorial para seu ambiente de codificação preferido (Java, C#, Perl, PHP
ou Ruby). Você pode usar qualquer linguagem que ofereça suporte a serviços Web SOAP.
Etapa 2: Solicite uma conta de sandbox
Caso decida desenvolver no ambiente de sandbox, você deverá pedir ao seu representante de conta que
crie uma conta de teste de sandbox para você com alguns dados de amostra. Quando a conta estiver
disponível, você receberá um email de boas-vindas com instruções para configurar a conta e definir uma
senha. Você também pode usar essa conta de sandbox para acessar o Control Center através da
interface da Web ou APIs.
Etapa 3: Localize sua chave de acesso de API
Para usar qualquer chamada de API, você deve ter uma chave de licença. Cada conta tem uma chave que
pode ser encontrada na documentação online de API: Página inicial > Integração de API > canto esquerdo
superior.
157
Você precisará de chaves de licença separadas para o ambiente de sandbox e ambiente de produção. Se
você estiver usando uma conta de sandbox, seu representante de conta fornecerá a chave de licença de
sandbox.
Acesso de clientes. Saiba que o Control Center não exibe a chave de licença da API para usuários com funções de clientes. Um cliente deve solicitar a empresa (conta) que forneceu acesso à ela.
Etapa 4: Criar/testar código
A documentação técnica on-line fornece amostras de código e descrições detalhadas de função para
ajudá-lo a criar seu próprio código. Quando estiver pronto, você pode testar o código na sandbox (caso
uma conta de sandbox tenha sido criada para você) ou em sua conta de produção. Esteja ciente de que
os ambientes de sandbox e de produção são completamente separados. Quando usar o ambiente de
sandbox, não há qualquer maneira de danificar dados de produção com seu código de teste.
Etapa 5: Lançar
Se você estiver usando uma conta de sandbox para testar seu código, será necessário substituir a chave
de licença e o URL em suas chamadas quando estiver pronto para colocar seu código em produção.
Esteja ciente de que não é possível migrar dados do ambiente de sandbox para o ambiente de produção
ou vice-versa.
Advertência. A Claro/Cisco Jasper podem interromper ou remover o acesso ao ambiente (de teste)
de sandbox da API por qualquer motivo. Nós faremos nosso melhor para notificá-lo com antecedência
se anteciparmos uma interrupção de serviço. Além disso, não podemos garantir suporte contínuo para
o ambiente de sandbox.
158
9.3 Padrões de código
Esta seção oferece algumas informações de alto nível sobre como funcionam as chamadas a
APIs.
• Solicitação/resposta SOAP. Cada função de API mapeia duas funções SOAP, uma
solicitação que envia a entrada para
Control Center e uma resposta do Control Center com os dados solicitados. Este documento trata
cada par de API como uma entidade única para fins de discussão.
• Chave de licença. Cada função de API deve incluir uma chave de licença para enviar uma
solicitação ao servidor. No caso, somente é permitido acessa a Operadora Claro.
• Credenciais de logon. Todas as vezes que você fizer uma chamada de função de API, será
necessário fornecer credenciais de logon para um usuário com permissão para realizar essa
função. Se o usuário de login puder executar a função na interface da Web do Control Center,
você poderá concluir a tarefa através de uma chamada de API.
• URL. Quando usar uma função de API, você deverá enviar a solicitação a um URL específico de
operador. Entre em contato com a Claro para obter um URL apropriado. Saiba que o URL para o
ambiente de sandbox (https://apitest.jasperwireless.com) é diferente do URL para o ambiente de
produção. Use o protocolo HTTPS para a segurança dos dados.
• ID de mensagem/ID de correlação. Se você antecipar o envio de múltiplas tempo, você poderá usar
IDs de mensagem para corresponder à solicitação de função com a resposta equivalente. Na
solicitação, basta enviar uma cadeia exclusiva (chamada ID da mensagem). O Control Centerincluirá
a mesma cadeia (chamada ID de correlação) na resposta. Mesmo se você não tiver intenção de usar
esse parâmetro, será necessário fornecer um valor de espaço reservado (por exemplo, fred) em
todas as solicitações.
Número de versão Tanto a solicitação quanto a resposta de API contém um número de versão.
Na solicitação de API, o número de versão faz referência à versão da API que você está usando.
Como o Control Center não usa esta string no momento, o valor é opcional. No entanto,
recomendamos usar "1.0". Na resposta de API, o número de versão faz referência à versão atual
do Control Center, por exemplo: 6.14. Ambos os números de versão possuem um comprimento
máximo de 100 caracteres.
• ID de compilação. Cada resposta de API contém a ID de compilação da versão atual do Control
Center. Esse valor possui um comprimento máximo de 100 caracteres.
• Elementos adicionais na resposta. Ao longo do tempo, a Jasper poderá adicionar novos
elementos a uma API. Todas as respostas de API continuarão em conformidade com o esquema de
159
XML publicado, mas é importante projetar o seu código de forma que elementos inesperados na
resposta de API não causem uma falha de processo.
9.4 Processamento de erros
Quando uma falha SOAP ocorre, o Control Center retorna um elemento de Falha padrão. Consulte a
documentação de W3C para obter informações sobre padrões. O Control Center usa os campos como a
seguir. Um comprimento seguro máximo para estes campos é 100 caracteres.
faultCode Valor padrão definido pelo W3C como "SOAP-ENV:Server". Ele sempre
conterá 100 caracteres ou menos.
faultString Código de erro do Control Center, por exemplo "200100". Consulte a página
Mensagens de erro na documentação de API online (Página inicial > API
Integração > Mensagens de erro) para obter detalhes. Esta string sempre
conterá 100 caracteres ou menos.
faultActor Não usada pelo Control Center no momento.
detail Uma estrutura XML que contém detalhes de erro, destina-se a solução de
problemas. Consulte um exemplo abaixo. Isso pode conter um comprimento
arbitrário dependendo do erro. Opcional para processamento por clientes.
Assim, eles poderão ignorar este campo (ou truncar em um determinado
número de caracteres) conforme o necessário.
<detail>
<jws:requestId xmlns:jws="http://api.jasperwireless.com/ws/schema"> AM6Sm6OiMPqsiF2T
</jws:requestId>
<jws:error xmlns:jws="http://api.jasperwireless.com/ws/schema"> No terminal usage found
</jws:error>
<jws:exception xmlns:jws="http://api.jasperwireless.com/ws/schema">
com.jasperwireless.ws.ApiException
</jws:exception>
<jws:message xmlns:jws="http://api.jasperwireless.com/ws/schema">
iccid=12345
</jws:message>
</detail>
160
9.5 Práticas recomendadas
Para manter um desempenho de API eficaz para todos os usuários do Control Center, a Jasper
recomenda as seguintes práticas para qualquer código de cliente que chame as APIs do Control
Center:
Conexões
simultâneas
Limite o número de chamadas ativas a uma de cada vez. O processamento de
APIs pode atrasar o tempo de resposta de forma considerável,
especificamente quando uma solicitação de API resultar em um grande
número de registros retornados e uma atividade de banco de dados pesada.
Para manter conformidade com as práticas recomendadas da Claro, a Jasper
aconselha que as empresas evitem processamento simultâneo.
Frequência de
chamadas
Várias empresas usam as APIs para acompanhar o uso do dispositivo. Nessa
situação, é importante alinhar suas chamadas de API com a frequência das
atualizações da Claro. Por exemplo, se a Claro atualizar suas informações de
uso uma vez a cada 6 horas, não haverá necessidade de solicitar as
informações via API mais frequentemente do que uma vez a cada 6 horas.
Além disso, frequentemente haverá um atraso entre o momento em que os
dados de uso estarão disponíveis e o recebimento dos dados de uso da Claro
pelo Control Center. Em alguns casos, o atraso poderá ser tão longo quanto
24 horas. Consulte a Claro para bter mais informações sobre seus processos e
aproveitar sua agenda
.
Avisos de conta
Saiba que a Jasper pode restringir o uso de APIs para empresas com código de API que não esteja em
conformidade com as diretrizes e que causem atividade excessiva. Sempre notificaremos a empresa e a
Claro em caso de corte.
161
9.6 Funções de API
Esta seção lista todas as funções de API do Control Center por categoria.
Dispositivos
As APIs de dispositivo fornecem acesso a informações detalhadas de dispositivo (SIM), incluindo a
sessão atual. Também é possível alterar valores de atributo.
Chamada de API Descrição
GetModifiedTerminals Retorna uma lista de ICCIDs para todos os dispositivos que foram
modificados desde uma determinada data e horário. Para obter
uma lista de todos os dispositivos, basta omitir o parâmetro "since".
GetTerminalsByMsisdn Retorna uma lista de ICCIDs correspondentes a um determinado
conjunto de números de aparelhos telefônicos (MSISDNs).
GetTerminalsByIMSI Retorna uma lista de ICCIDs correspondentes a um determinado
conjunto de IMSIs de dispositivos.
GetTerminalsBySecureSimId Retorna uma lista de dispositivos correspondentes a um
determinado ID de SIM seguro.
GetTerminalDetails Retorna informações detalhadas para cada um dos dispositivos em
uma lista.
EditTerminal Altera o valor de um único atributo para um determinado dispositivo.
Você pode especificar se a alteração entrará em vigor
imediatamente ou agendá-la para uma data futura.
GetSessionInfo Retorna as informações da sessão atual (endereço IP e tempo de
início da sessão) para um ou mais dispositivos. Se o dispositivo
especificado não estiver em sessão, nenhuma informação será
retornada.
162
GetAllNetworkAccessConfigs Retorna todos os planos de comunicação disponíveis, também
chamados de Configs de acesso de rede.
GetNetworkAccessConfig
Details
Retorna os detalhes do plano de comunicação (Config de acesso de
rede) para uma determinada lista de IDs de plano de comunicação.
GetNetworkAccessConfig Retorna o ID do plano de comunicação (ID de Config de acesso de
rede) para um ou mais dispositivos.
EditNetworkAccessConfig Altera o plano de comunicação (Config de acesso de rede) associado
a um determinado dispositivo.
GetTerminalLatest
Registration
Retorna informações sobre um registro de rede mais recente de um
determinado dispositivo, incluindo o nome do operador de registro
e o endereço do título global do nó de rede. Essas informações
podem ajudá-lo a solucionar problemas de rede ao identificar
quando e onde o dispositivo se conectou com sucesso à rede pela
última vez.
Saiba que a instalação da sua rede pode afetar o comportamento
desta API. Contate a Claro em caso de dúvidas.
SendCancelLocation Força um dispositivo a sair da rede, fazendo com que ele registre
novamente. Geralmente usada para corrigir problemas de registro de
rede,
esta função está atualmente disponível no
Control Center por meio do Spotlight.
Mensagens (SMS)
As APIs de mensagem fornecem informações históricas sobre mensagens que um dispositivo específico
enviou ou recebeu. Você também pode enviar mensagens a um ou mais dispositivos.
Chamada de API Descrição
163
GetModifiedSMS Retorna uma lista de IDs para as mensagens que foram enviadas
ou recebidas por um dispositivo durante um período de tempo
especificado.
GetSMSDetails Retorna informações detalhadas sobre uma ou mais mensagens.
SendSMS Envia uma mensagem a um único dispositivo (por ID
de SIM).
SendBulkSMS Envia uma mensagem a um ou mais dispositivos (por
ID de SIM).
SendSMSToMsisdn Envia uma mensagem a um único número de telefone
(MSISDN).
SendBulkSMSToMsisdn Envia uma mensagem a um ou mais números de telefone (por
MSISDN).
Uso
Chamada de API Descrição
GetTerminalUsage Retorna a quantidade de uso de dados para um dispositivo
durante um ciclo de faturamento específico. Para acessar o
uso do dispositivo para o mês atual, use GetTerminalDetails e
examine o campo MonthToDateUsage.
GetTerminalUsageDataDetails Retorna informações sobre todas as sessões de dados que
ocorreram durante um ciclo de faturamento específico para
um determinado dispositivo.
GetTerminalUsageSmsDetails Retorna informações sobre todas as mensagens enviadas ou
recebidas por um dispositivo durante um ciclo de
faturamento específico.
164
GetTerminalUsageVoiceDetails Retorna informações sobre todas as chamadas de voz
recebidas ou feitas por um dispositivo durante um ciclo de
faturamento específico.
Faturas
O Control Center oferece uma única API para acessar os detalhes de alto nível de uma fatura. Para obter mais informações sobre o uso de um dispositivo individual durante um ciclo de faturamento, consulte as APIs de utilização
Chamada de API Descrição
GetInvoice Retorna dados de fatura para uma determinada conta e ciclo de
faturamento. Este dado inclui as informações de Detalhes exibidas na
parte superior da página Faturamento > Faturas > Detalhes da fatura,
mas não as informações exibidas nas guias na parte inferior da
página. Por exemplo, você pode obter:
• Cobrança total por assinaturas
• Cobrança total por utilização de dados e/ou mensagens
SMS além do uso incluído
• Volume de uso total faturável por todos os SIMs faturáveis
• Cobranças por ativação, se aplicáveis
• Outras cobranças como tarifas por serviços de rede. Você também
pode utilizar APIs de Uso para acessar informações de uso de
dispositivos para cada ciclo de cobrança.
Usuários
As APIs de usuário permitem criar novos usuários e verificar se os novos nomes de usuários e senhas estão em conformidade com determinadas regras.
Chamada de API Descrição
CreateUser Cria um usuário do Control Center com as informações fornecidas.
165
IsNewUsernameValid Retorna um valor verdadeiro ou falso dependendo da cadeia fornecida
ser um nome de usuário válido para o Control Center. Um nome de
usuário deve ser único em todas as instâncias do Control Center,
incluindo diferentes operadores.
IsPasswordValid Retorna um valor verdadeiro ou falso dependendo da cadeia fornecida
ser uma senha válida para o Control Center. Os requisitos de senha do
Control Center são definidos no nível do operador.
Chamada de API Descrição
Teste
Uma única API de teste permite que você teste sua conexão com o Control Center durante o desenvolvimento.
Chamada de API Descrição
Eco Chamada de teste simples que retorna um valor enviado por você como
informação.
9.7 Casos de uso de API
Esta seção descreve vários casos de uso ou padrões de design comuns em todos os aplicativos que
acessam o Control Center.
Como analisar o uso de dispositivo
Ao utilizar o conjunto de API, é possível analisar o uso de dispositivo regularmente para determinar se
algum dispositivo está se aproximando ou excedendo seu uso incluído. Em caso afirmativo, é possível
mudar os dispositivos para um plano de tarifas diferente com alocação de uso maior
e taxa menor, em comparação com as taxas de assinatura e de excedente no plano de tarifas original. As
seguintes funções de API oferecem visões ligeiramente diferentes sobre o uso do dispositivo:
• GetTerminalUsage retorna o uso de dados de um dispositivo durante um ciclo de faturamento
específico. O atributo TotalDataVolume informa a quantidade de dados utilizados pelo dispositivo
166
de forma geral. O atributo BillableDataVolume informa a quantidade de dados que estavam
sujeitos a cobranças por excedente.
• GetTerminalUsageDataDetails retorna informações de uso por zona ou país. Também é possível
examinar a duração de cada sessão de dados. GetTerminalUsageSMSDetails e
GetTerminalUsageVoiceDetails fornecerão as mesmas informações para SMS e serviço de voz.
• GetTerminalDetails fornece MonthToDateUsage para o ciclo de faturamento atual. O
atributo OverageLimitReached também informará se o dispositivo começou a incorrer em
cobranças por excedente.
Regras de automação. Para determinados casos de uso, você pode considerar o uso de uma regra de
automação no Control Center (Automação > Regras > Criar novo). Essas regras oferecem uma
variedade de maneiras de monitorar o uso, gerenciar assinaturas e provisionamento de SIMs, sem
necessitar de qualquer programação. Consulte Regras de automação para obter detalhes.
Como sincronizar bancos de dados
Várias empresas mantêm um banco de dados interno, separado do Control Center, com atributos, uso
e informações de mensagens de dispositivos. O conjunto de API oferece a você uma forma mais simples
de sincronizar seus sistemas internos com o Control Center. Aqui está o processo:
Para atributos de dispositivo
1. Uso GetModifiedTerminals para retornar uma lista de dispositivos cujas informações mudaram
desde uma data especificada.
2. Uso GetTerminalDetails para retornar as informações detalhadas apenas para os dispositivos
retornados na etapa 1.
3. Atualize seu banco de dados interno com os dados retornados na etapa 2.
Para mensagens
1. Uso GetModifiedSMS para retornar uma lista de mensagens que foi enviada ou recebida durante
um determinado período de tempo.
2. Uso GetSMSDetails para retornar as informações detalhadas apenas para as mensagens
retornados na etapa 1.
3. Atualize seu banco de dados interno com os dados retornados na etapa 2.
Push APIs
167
O Control Center também mantém um sistema de "push API" que envia uma notificação programática
ao seu aplicativo sempre que um determinado evento ocorre. Po exemplo, você pode desejar saber se
um dispositivo realiza muitas conexões durante um determinado período de tempo.
Para receber uma notificação, você deve criar uma regra de automação no Control Center e, em seguida, configurá-la para enviar uma mensagem de API. Para esse processo funcionar, é necessário configurar um receptor de push, ou servidor, em sua extremidade para ouvir mensagens, interpretar dados e, então, agir de forma apropriada.
Sequência típica de eventos
Aqui está a sequência típica de eventos para push APIs:
Etapa 1: Você define uma regra de automação
Primeiro, você acessa o Assistente de regras no Control Center (Página inicial > Mecanismo de
automação > botão Criar novo) e encontra a regra que monitora a atividade na qual você está
interessado. Por exemplo, talvez você deseje receber uma notificação quando um dispositivo ativado que
estiver usando um plano de tarifas específico não fizer uma conexão por mais de 24 horas. Em seguida,
você instrui o Control Center a enviar notificações por meio da Push API.
Etapa 2: Control Center Enviar push API
Quando todas as condições de sua regra de automação forem atendidas, o Control Center enviará uma
mensagem via Push API ao servidor cujo URL você especificou nas configurações de regra. Se o limite
de tempo esgotar ou seu servidor retornar um código de status diferente de 200, o
Control Center aguardará alguns minutos e reenviará a mensagem. O Control Center desistirá
após 10 tentativas malsucedidas.
Etapa 3: Você verifica a assinatura (opcional)
Todas as notificações do Control Center usam o protocolo HTTPS, porém você pode adicionar outro
nível de segurança à comunicação ao implementar um Segredo compartilhado de Push API. Em seu
perfil de conta (Admin > Perfil de conta > Editar), você pode especificar uma cadeia
que o Control Center criptografará e incluirá na mensagem. Quando receber uma mensagem, você
descriptografará a assinatura e verificará se corresponde ao valor original. Consulte a documentação push
API online para obter instruções detalhadas.
Etapa 4: Você processa os dados
Em seguida, é possível analisar os dados na mensagem e agir de forma apropriada. Em alguns casos, essa
ação pode envolver o uso de APIs de pull para alterar valores no banco de dados do Control Center.
168
Para o exemplo de conectividade, você pode desativar o dispositivo até que um técnico consiga
diagnosticar o problema.
Para obter mais informações
A documentação de API online (Página inicial > Integração de API > Push
API) contém código de amostra para implementar o receptor e descrições detalhadas das notificações e
formatos de assinatura.
Push API/Matriz de regras
As tabelas a seguir mostram quais push APIs a Jasper envia quando você seleciona a opção de ação
Impulsionar uma mensagem de API no assistente de automação (Automação > Regras > Criar novo).
Regras de provisionamento de SIM
Regra Descrição
Alterações do estado do SIM SimStateChange
Alteração de campo personalizado do SIM
SimFieldC
Regras de segurança
Regra Descrição
Sim seguro SecureSimAlert
Alteração de IMEI SimImeiChange
Regras de gerenciamento de assinaturas
Regra Descrição
169
Limite de dados do SIM SimDataLimit
Expiração do SIM SimExpiration
Regras de monitoramento de uso
Regra Descrição
Início da sessão Session
Fim da sessão Session
Muitas conexões (Ciclo até a data) TooManyCtdConnection
Número de conexões de sessão (24 horas)
TooManyDailyConnection TooFewDailyConnection
Sem conexão NoConnection
Uso de dados no ciclo até a data CtdUsage
Uso mensal de dados combinado MonthlyDataUsage
Uso Recente de SMS SmsUsage
Uso mensal de SMS combinado
MonthlySmsUsag
9.8 Perguntas frequentes (APIs)
170
Como crio uma conta de API ?
Siga o processo de desenvolvimento de APIs . Aqui está um resumo das etapas:
• Faça download dos arquivos de esquema WSDL e XML .
• Solicite uma conta de sandbox, se você preferir fazer uma experiência fora do ambiente de
produção.
• Obtenha sua chave de licença de API e o URL correto. • Desenvolva e teste sua solução usando a documentação de referência de API online como guia.
• Migre sua solução para o ambiente de produção (se você estiver
usando o sandbox) ao substituir a chave de licença e o URL.
Quais linguagens são aceitas pela API ?
A API funcionará com qualquer linguagem que ofereça suporte a serviços
Web SOAP.
Qual nome de usuário e senha devo usar?
Você pode usar qualquer conta do Control Center para fazer chamadas
a APIs. No entanto, para fins de auditoria, recomendamos que você use uma conta separada apenas para
APIs. Saiba mais sobre contas de API.
Por que minha API não está funcionando?
Certifique-se de usar o URL correto com o protocolo HTTPS.
Quais dados de fatura posso obter através de APIs?
A API GetInvoice fornece os seguintes dados:
• Cobrança total por assinaturas
• Cobrança total por utilização de dados e/ou mensagens SMS além do uso incluído
• Volume de uso total faturável por todos os SIMs faturáveis • Cobranças por ativação, se aplicáveis
• Outras cobranças como tarifas por serviços de rede
Consulte a documentação de Esquema XML para obter detalhes (Página inicial > API Integração >
Esquema XML > GetInvoice).
Você também pode obter informações de uso de dispositivo para um ciclo de cobrança específico
através das APIs de uso:
• Volume de dados total
• Volume de dados faturável
• Volume de SMS total
171
• Volume de SMS faturável
Como obtenho uma lista de todos os dispositivos via API?
Use GetModifiedTerminals e omita o parâmetro since. Consulte a documentação de Esquema XML
online para obter detalhes (Página inicial > API Integração > Esquema XML > GetModifiedTerminals).
172
Capítulo 10
10. SUPORTE
10.1 Suporte ao produto
A Claro poderá ajudá-lo com quaisquer perguntas relacionadas ao aplicativo Control Center, incluindo
quais serviços e recursos de produto estão disponíveis para você.
Local: Suporte > Suporte do Fornecedor de Serviço
Quando for lançada uma nova versão do Control Center, a Claro também fornecerá informações sobre
novos recursos que possam afetar você. Para que a Claro possa localizar você, é importante assegurar
que os contatos da sua empresa estejam sempre atualizados. A página Contatos de Notificação lista todos
os contatos primários e secundários associados à sua conta.
Local: Suporte > Contatos de Notificação
Alterando o contato principal. Somente a Claro pode alterar seu contato principal.
173
Adicionando/excluindo contatos secundários. Um usuário administrador de conta pode adicionar ou
excluir contatos secundários na página Perfil de Conta, localizada aqui: Admin > Perfil de Conta >
subguia Contatos Secundários > botões Adicionar/Excluir.
10.2 Suporte para desenvolvedores de M2M
Para conhecer recursos para desenvolvedores, visite http://www.m2m.com. Este site é um fórum onde os
desenvolvedores podem fazer perguntas e compartilhar experiências. Você também encontrará informes,
relatórios, vídeos, podcasts e muito mais.
174
Capítulo 11
11. REFERÊNCIA
A seção de referência é um trabalho que contém informações detalhadas para a interface de usuário
para algumas, páginas do produto.
11.1 Automação
Lista de Regras
A página de lista Regras mostra uma lista das regras que estão associadas às contas que você tem
permissão para visualizar.
Local: Automação > Regras
175
Nome do campo Descrição
Criar Novo O link Criar Novo ativa o formulário Criar Nova Regra. Consulte Assistente de
Regras
Editar O link Editar ativa o formulário Editar Regra para a regra selecionada.
Excluir O link Excluir exclui permanentemente a regra selecionada.
Nome da Regra O Nome da Regra é um nome descritivo que deve ajudar os usuários a
entender a finalidade da regra.
Categoria Esse valor identifica a categoria da regra, como
Provisionamento de SIM ou Gerenciamento de Assinaturas.
Acionador Um Acionador de regra identifica uma situação geral que você deseja monitorar,
como uma alteração no Estado do SIM.
Criado pelo
Usuário
O campo Criado pelo Usuário identifica o usuário do
Control Center que criou a regra.
Editado a Última
Vez por
O campo Editado a Última Vez por identifica o usuário do
Control Center que editou a regra mais recentemente.
Criado pela Conta O campo Criado pela Conta identifica a conta do Control Center que criou e
possui a regra. Regras não podem ser compartilhadas entre contas
diferentes.
Definição de Regra O campo Definição de Regra lista o evento específico que acionará a regra.
Por exemplo, no caso de Muitas Conexões, a Definição de Regra especificaria
o número máximo de sessões permitidas dentro do ciclo de faturamento.
Todas as informações inseridas na parte Quando isso acontece... do formulário
Criar Nova Regra aparecerão aqui.
176
Filtros Os Filtros limitam os dispositivos que estão sujeitos à regra. Todas as regras
são filtradas por conta, ou seja, elas somente se aplicam aos dispositivos na
conta que as criou. Além disso, para alguns acionadores de regra, você pode
limitar os dispositivos com base em outros filtros, como plano de tarifas e
estado do SIM. Por exemplo, uma regra cujo valor de Filtro é Conta: Acme,
Plano de
Tarifas: Mensal Combinado - SMS estaria limitada somente as dispositivos
que pertencem à conta Acme e usando o plano de tarifas Mensal Combinado
- SMS.
Ação A Ação especifica o que Control Center fará quando um determinado evento
acionar a regra. O valor de Ação inclui todas as informações inseridas na parte
Faça isso... do formulário Criar Nova Regra. É possível clicar no
valor da ação de uma determinada regra para descobrir quantas vezes o
Control Center executou essa regra.
Data de Criação A Data de Criação indica quando a regra foi criada.
Ativo O valor de Ativo indica se a regra está ativada ou não. Você pode clicar no link
Ativado para alternar entre os estados Ativado e Inativo.
11.2 Assistente de Regras
O formulário do assistente de regras é exibido quando você clica no botão Criar Novo da página de lista
Regra. Para editar uma regra existente, você pode selecioná-la na lista de resumo e clicar no link Editar.
O formulário Editar Regra é essencialmente igual ao formulário Criar Nova Regra, com a diferença de
que não é possível alterar a categoria ou o acionamento da regra.
Local: Automação > Regras > botão Criar Novo
177
Nome do campo Descrição
Selecionar Conta . O campo s e l e c i o n a r Conta indica qual conta possui a regra.
Selecionar Categoria de
Regra
A Categoria da Regra fornece acesso aos acionadores de regras dentro da
categoria. Clique em um nome de categoria para visualizar uma lista dos
acionadores incluídos na categoria.
Selecionar acionador A lista Acionador permite selecionar um acionador para a nova regra. Clique
no nome do acionador para definir
o evento e a ação da regra. Passe o mouse sobre o ícone de informações
para obter uma descrição do acionador.
178
Ver Todos os
Acionadores de Regra
O botão Ver Todos os Acionadores de Regra ativa uma lista completa de
todos os acionadores de regra juntamente com uma descrição de cada um.
Esse botão é exibido somente no formulário Criar Nova Regra, e não no
formulário Editar Regra. Não é possível alterar o acionador para uma regra
existente.
Definir Regra Essa parte do formulário exibe todas as opções de eventos e ações para o
acionador de regra selecionado. As opções disponíveis dependem do
acionador selecionado. Consulte as seções a seguir para obter
mais informações sobre os vários tipos de limite e ação.
Editar Filtros O botão Editar Filtros ativa um pequeno formulário no qual você pode
selecionar valores para os filtros que são apropriados para o acionamento
da regra atual.
Assistente de Regras > Enviar um E-mail
No formulário Criar/Editar Regra, quando você seleciona Enviar um e-mail ou Enviar um e-mail para o cliente final, os seguintes campos são exibidos:
Local: Automação > Regras > botão Criar Novo > Enviar um e-mail/Enviar um e-mail para o cliente
Final
179
Nome do campo Descrição
Mostrar Seleções de
Acionadores de Regra
O botão Mostrar Seleções de Acionadores de Regra leva você de volta à
hierarquia de acionadores de regras e categorias de regras, onde é
possível selecionar um acionador diferente. Esse botão é exibido somente
no formulário Criar Nova Regra, e não no formulário Editar Regra. Não é
possível alterar o acionador para uma regra existente.
Quando isso
acontece…
As informações nessa seção serão diferentes dependendo do
acionador de regra selecionado. Preencha os campos exibidos.
180
Destinatário Quando a regra for executada, o Control Center enviará um e-mail ao(s)
endereço(s) mostrado(s) no campo Destinatário. No caso de vários
destinatários, você deve separar os endereços por vírgulas e garantir que a
contagem de caracteres seja menor que 200. Se optar por enviar um e-mail
para o cliente final, esse campo não aparecerá. O Control Center recupera o
endereço de e-mail para o cliente final associado ao dispositivo do banco de
dados.
Escrever mensagem Essa área de texto extensa contém a mensagem de e- mail que o Control
Center enviará quando a regra for executada. O Control Center não fornece
uma mensagem padrão; você deve compor uma. Esta imagem inclui uma
mensagem somente para dar uma ideia de como é possível personalizar a
mensagem com variáveis. Clique em um botão cinza para inserir a variável
correspondente na localização do cursor atual. Lembre- se de que notificações
por e-mail usam texto sem formatação e não aceitam links dinâmicos.
181
Assistente de Regras > Enviar uma Mensagem (SMS)
No formulário Criar/Editar Regra, quando você opta por Enviar um SMS, os seguintes campos são
exibidos:
Local: Automação > Regras > botão Criar Novo > Enviar um SMS
Nome do campo Descrição
Mostrar Seleções de
Acionadores de Regra
O botão Mostrar Seleções de Acionadores de Regra leva você de volta à
hierarquia de acionadores de regras e categorias de regras, onde é possível
selecionar um acionador diferente. Esse botão é exibido somente no
formulário Criar Nova Regra, e não no formulário Editar Regra. Não é
possível alterar o acionador para uma regra existente.
Quando isso
acontece…
As informações nessa seção serão diferentes dependendo do
acionador de regra selecionado. Preencha os campos exibidos.
182
Escrever mensagem Escrever mensagem Essa área de texto extensa contém a mensagem de texto
que o Control Center enviará ao dispositivo quando a regra for executada. O
Control Center não fornece uma mensagem padrão; você deve compor uma.
Esta imagem inclui uma mensagem somente para dar uma ideia de como é
possível personalizar a mensagem com
Nome do campo Descrição
Para Nesse campo, selecione o nome do novo estado do SIM.
UTC Se você selecionar a ação Alterar o estado do SIM em uma hora
determinada (disponível para um pequeno número de acionadores), será
necessário especificar o horário UTC em que o Control Center fará a
alteração. Essa versão da ação Alterar Estado do SIM não permite ações
de acompanhamento.
Acompanhar com Se quiser especificar uma ação de acompanhamento, marque essa caixa
e preencha os campos adicionais. Não disponível para a ação Alterar o
estado do SIM em uma hora determinada.
183
E receba esta ação de
acompanhamento
O Control Center permite especificar uma segunda ação que ocorrerá
um pouco depois da alteração do estado SIM. Selecione a ação
secundária desejada no menu suspenso. Dependendo da sua escolha,
um segundo campo pode ser exibido. Não disponível para a ação Alterar
o estado do SIM em uma hora determinada.
Neste momento Nesse campo, você pode especificar o cronograma para a ação de
acompanhamento. Dependendo da sua escolha, um segundo campo pode
ser exibido. Não disponível para a ação Alterar o estado do SIM em uma
hora determinada.
Assistente de Regras > Funcionalidades não disponíveis Alterar Plano de Tarifas
Alterar Plano de Comunicação
Obs. No caso de troca de plano, contatar o Gerente de Contas.
Assistente de Regras > Impulsionar uma Mensagem de API
No formulário Criar/Editar Regra, quando você escolhe Impulsionar uma Mensagem de API, os
campos a seguir são exibidos. Consulte Push API/Matriz de regras para ver uma lista de push APIs
associadas a cada regra.
Local: Automação > Regras > botão Criar Novo > Impulsionar uma mensagem de API
184
Nome do campo Descrição
Mostrar Seleções de
Acionadores de Regra
O botão Mostrar Seleções de Acionadores de Regra leva você de volta à
hierarquia de acionadores de regras e categorias de regras, onde é
possível selecionar um acionador diferente. Esse botão é exibido somente
no formulário Criar Nova Regra, e não no formulário
Editar Regra. Não é possível alterar o acionador para uma regra
existente.
Quando isso
acontece…
As informações nessa seção serão diferentes dependendo do
acionador de regra selecionado. Preencha os campos exibidos.
URL Quando a regra for executada, o Control Center enviará uma mensagem
de API para o local especificado no campo URL. Leia mais sobre o sistema
de push API do Control Center clicando no link Integração de API na página
Recursos.
Lista Atividade da Regra
O Control Center cria um registro na tabela Atividade da Regra sempre que uma regra é acionada.
Portanto, você pode ver a mesma regra listada várias vezes. Use a caixa de pesquisa Avançada para filtrar
a lista por atributos, como acionamento de regra, ação ou período.
Local: Automação > Atividade da Regra
185
Nome do campo Descrição
Nome da Regra O Nome da Regra é um nome descritivo que deve ajudar os usuários a
entender a finalidade da regra.
Acionador Um Acionador de Regra identifica uma situação geral que você deseja
monitorar, como uma alteração no Estado do SIM.
Data de acionamento A Data de acionamento permite saber quando o
Control Center executou a regra.
ICCID O ICCID identifica o dispositivo específico que acionou a regra. Esse valor é
nulo para regras que não atuam em um único dispositivo. Por exemplo, a
regra Uso mensal de dados combinados monitora o uso combinado de todos
os dispositivos que usam um plano de tarifas combinado.
Conta de Destino A Conta Alvo identifica a conta em que a regra entrará em vigor.
Definição de Regra O campo Definição de Regra lista o evento específico que acionará a regra.
Por exemplo, no caso de Muitas Conexões, a Definição de Regra especificaria
o número máximo de sessões permitidas dentro do ciclo de faturamento.
Todas as informações inseridas na parte Quando isso acontece... do
formulário Criar Nova Regra aparecerão aqui.
Filtros Os Filtros limitam os dispositivos que estão sujeitos à regra. Todas as regras
são filtradas por conta, ou seja, elas somente se aplicam aos dispositivos na
conta que as criou. Além disso, para alguns acionadores de regra, você pode
limitar os dispositivos com base em outros filtros, como plano de tarifas e
estado do SIM. Por exemplo, uma regra cujo valor de Filtro é Conta: Acme,
Plano de Tarifas: Mensal Compartilhado- SMS estaria limitada somente as
dispositivos que pertencem conta Acme e usando o plano de tarifas Mensal
(comp.)_
Combinado - SMS.
Ação A Ação indica qual ação o Control Center realizará quando a regra for
acionada. As ações incluem Notificação por E-mail, Notificação por SMS,
Alterar Plano de Tarifas, Push API e assim por diante.
186
Ação de
Acompanhamento
Uma Ação de Acompanhamento é uma ação secundária opcional que você
pode definir para alguns tipos de ação. Esse campo lista todas as ações de
acompanhamento.
11.3 Faturamento
Lista de faturas
A página de lista Faturas exibe uma lista de todas as faturas que você tem permissão para visualizar.
Local: Faturamento > Faturas
Campo Descrição do campo
Detalhes O ícone de Detalhes é um botão que ativará a página
Detalhe da Fatura da fatura em questão.
ID da Fatura O ID da Fatura é um identificador exclusivo de uma fatura. O
Control Center gera esse número.
Ciclo de Faturamento Ciclo de Faturamento é um nome de fatura que especifica o mês e o
ano em que ocorreram cobranças. Esse nome se baseia no último dia
do ciclo de faturamento. Por exemplo, o ciclo de faturamento de
janeiro de 2014 pode durar na verdade de 15 de dezembro de 2013 a 14
de janeiro de 2014, ou até mesmo de 2 de dezembro de 2013 a 1° de
janeiro de
2014.
187
Dispositivos O campo Dispositivos lista o número de dispositivos que contribuem para
as cobranças da fatura. Os dispositivos podem estar ativos ou faturáveis
devido a um compromisso.
Cobrança Total Cobrança Total é a soma de todas as cobranças associadas aos planos
de tarifas de uma conta O total também inclui cobranças em nível de
conta, como taxas de configuração, taxas de ativação, taxas mensais
recorrentes para vários serviços e muito mais — menos qualquer
desconto.
Moeda Moeda é a unidade de medida para todas as cobranças de uma conta.
Volume de Dados (MB) O Volume de Dados especifica a quantidade de dados (em MBs) que a
conta usou durante o ciclo de faturamento. Esse número é a soma do
uso de dados total faturável (incluído e em excesso) para todos os
planos de tarifas da conta.
Volume de SMS
incluído (msg)
O Volume de SMS especifica o número de mensagens faturáveis que a
conta usou durante o ciclo de faturamento. Esse número é a soma de
todas as mensagens enviadas e/ou recebidas por todos os dispositivos
que usam os planos de tarifas da conta.
Faturável O sinalizador de u m i t e m Faturável indica se as cobranças da conta
devem ou não ser faturadas. Alguns exemplos de contas não faturáveis
incluem contas de teste econtas de demonstração e contas de kits de
teste.
ID da Conta O ID da Conta é um identificador exclusivo de uma conta. O Control
Center gera esse número.
Nome da Conta Nome da Conta é um nome descritivo para a conta.
ID da Conta do
Operador
O ID da Conta do Operador é um identificador opcional que a Claro cria
para uma conta. Esse valor permite que a Claro cruzem os registros do
Control Center com quaisquer outros sistemas que possam utilizar.
188
Detalhes da Fatura
A página Detalhes da Fatura fornece todas as informações específicas de fatura associadas a uma
determinada fatura. As subguias na parte inferior da página são consideradas formulários separados e
são descritas em outra seção.
Local: Faturamento > Faturas > link Fatura
Campo Descrição do campo
ID da Fatura O ID da Fatura é um identificador exclusivo de uma fatura. O Control
Center gera esse número.
ID da Conta O ID da Conta é um identificador exclusivo de uma conta. O Control
Center gera esse número.
Nome da Conta Nome da Conta é um nome descritivo para a conta.
ID da Conta do
Operador
O ID da Conta do Operador é um identificador opcional que a Claro cria
para uma conta. Esse valor permite que a Claro cruzem os registros do
Control Center com quaisquer outros sistemas que possam utilizar.
189
Data da Fatura A Data da Fatura refere-se à data na qual o Control Center
calculou os dados da fatura. Obs. Não corresponde a data de
vencimento da fatura.
Data de Vencimento A Data de Vencimento é a data em que a conta deve pagar a fatura.
Essa data é sempre 30 dias a contar da Data da Fatura.
Ciclo de Faturamento Ciclo de Faturamento é um nome de fatura que especifica o mês e o
ano em que ocorreram cobranças. Esse nome se baseia no último dia
do ciclo de faturamento. Por exemplo, o ciclo de faturamento de
janeiro de 2014 pode durar na verdade de 15 de dezembro de 2013 a
14 de janeiro de 2014, ou até mesmo de 2 de dezembro de 2013 a 1°
de janeiro de
2014.
Faturável O sinalizador de u m i t e m Faturável indica se as cobranças da conta
devem ou não ser faturadas. Alguns exemplos de contas não
faturáveis incluem contas de teste econtas de demonstração kits de
teste.
Moeda Moeda é a unidade de medida para todas as cobranças de uma
conta.
Dispositivos O campo Dispositivos lista o número de dispositivos que contribuem
para as cobranças da fatura. Os dispositivos podem estar ativos ou
faturáveis devido a um compromisso.
Assinantes Ativos Assinantes Ativados refere-se ao número de dispositivos que tinham
um estado SIM Ativado em algum ponto durante o ciclo de
faturamento e estão contribuindo para esta fatura. Lembre-se de
que esse número pode ser diferente do número total de
dispositivos. O número total de dispositivos pode incluir dispositivos
que são faturáveis, mas que não estão ativos (para cumprirem os
compromissos da conta).
Volume de Dados (MB) O Volume de Dados especifica a quantidade de dados (em MBs) que
a conta usou durante o ciclo de faturamento. Esse número é a
soma do uso de dados total faturável (incluído e em excesso) para
todos os planos de tarifas da conta.
190
Volume de SMS
incluído (msg)
O Volume de SMS especifica o número de mensagens faturáveis
que a conta usou durante o ciclo de faturamento. Esse número é a
soma de todas as mensagens enviadas e/ou recebidas por todos os
dispositivos que usam os planos de tarifas da conta.
Receita do Serviço Receita do Serviço é a soma de todas as cobranças que se qualificam
para um desconto. Consulte a subguia Descontos para obter mais
detalhes.
Desconto (%) Se a conta for elegível para um desconto com base em sua receita ou
no número de assinantes, o campo Desconto exibirá a porcentagem
usada para calcular o desconto. O Control Center aplica esse desconto
no fim de cada ciclo de faturamento. Consulte a subguia Desconto para
obter todos os detalhes.
Cobrança da
Assinatura
A Cobrança da Assinatura é a soma de todas as taxas de assinatura
devidas durante o período de faturamento atual. Você pode visualizar
os detalhes das taxas de assinatura associadas a cada plano de tarifas
nas subguias Assinaturas Pré-pagas e Plano de Tarifas.
Encargos de Dados O campo Encargos de Dados refere-se às cobranças por excesso e
roaming de uso de dados que ultrapassa a alocação de dados para
dispositivos que usam os vários planos de tarifas. Esse número é a soma
das cobranças listadas na caixa Detalhe dos Dados à direita desse campo.
A subguia Detalhe dos Dados na parte inferior da página oferece
informações
adicionais. Lembre-se que o Control Center não calcula cobranças por
excesso para dispositivos individuais usando um plano de tarifas
combinado. Com um plano de tarifas combinado, o Control Center
combina o uso de dados para cada dispositivo no plano e, em seguida,
determina se o uso total excedeu ou não o tamanho do pool. Se o pool
for excedido, o Control Center calculará as cobranças por excesso do
plano de tarifas como um todo, e não para os dispositivos individuais.
191
Preço SMS O campo Preço SMS refere-se às cobranças por excesso aplicáveis ao uso
de mensagens de texto que ultrapassa a alocação de SMS para
dispositivos que usam os vários planos de tarifas. Esse número é a soma
das cobranças por excedente de SMS de cada plano de tarifas. Você pode
obter mais detalhes na subguia Detalhe SMS, localizada na parte inferior
da página.
Custo de Ativação O Custo de Ativação é o número de dispositivos recentemente ativados
ou reativados multiplicado pela taxa de ativação. Se nenhum dispositivo
entrar
nesta categoria durante um ciclo de faturamento, este valor será zero.
Clique na subguia Ativações para obter um detalhamento destas cobranças.
Outro Custo Outro Custo refere-se a cobranças diversificadas da conta. Você pode
obter um detalhamento destas cobranças na subguia Outros Custos.
Desconto Aplicado O campo Desconto Aplicado exibe quanto dinheiro o Control Center
subtrairá do total geral. Consulte a subguia Desconto para obter
detalhes sobre cada desconto.
Cobrança Total Cobrança Total é a soma de todas as cobranças associadas aos planos de
tarifas de uma conta (taxas de assinatura, taxas por excesso e assim por
diante). O total também inclui cobranças em nível de conta, como taxas de
configuração, taxas de ativação e taxas mensais recorrentes para vários
serviços — menos qualquer desconto.
Excesso Padrão Excesso Padrão refere-se às cobranças por excedente de dados. Esse
número é a soma das cobranças por Excesso Padrão de todos os planos de
tarifas.
Roaming Padrão Roaming Padrão refere-se às cobranças por excedente de dados em zonas
designadas como "roaming". Esse número é a soma das cobranças por
Roaming Padrão de todos os planos de tarifas. Consulte as subguias Zonas
de Planos de Tarifas e Detalhe dos Dados na parte inferior da página para
obter mais informações.
192
Faturas > Dispositivos
A subguia Dispositivos mostra todos os dispositivos faturáveis que contribuíram para a fatura. Um
dispositivo faturável pode não estar ativo. Um dispositivo inativo pode ser faturável quando está
cumprindo um compromisso. Cada dispositivo aparece apenas uma vez na lista, mesmo se tiver usado
mais de um plano de tarifas durante o ciclo de faturamento.
Local: Faturamento > Faturas > Detalhes da Fatura > guia Dispositivos
Campo Descrição do campo
ICCID O ICCID é um identificador exclusivo associado a cada cartão SIM.
ID do Dispositivo O ID do Dispositivo é um identificador opcional atribuído a cada
dispositivo pela conta ou pelo cliente.
Cliente Em geral, Cliente é um nome descritivo para a empresa que possui e
opera o dispositivo correspondente. Um campo em branco indica que a
conta propriamente dita possui os dispositivos. No entanto, algumas
contas podem optar por especificar um departamento ou até mesmo
uma pessoa individual nesse campo.
Plano de Tarifas
Mensal
Plano de Tarifas Mensal lista o nome do plano de tarifas mensal
associado ao dispositivo no final do ciclo de faturamento.
193
Plano de Tarifas
Padrão
Um Plano de Tarifas Padrão é o plano de tarifas associado a um
dispositivo no final do ciclo de faturamento. Se você colocar um
dispositivo em um plano de tarifas de evento ou adicional, o
Control Center o retornará automaticamente ao seu plano de tarifas padrão
quando o plano de evento ou adicional expirar. Um plano de tarifas padrão
pode ser mensal ou pré-pago, mas não um plano de evento ou adicional. O
Control Center exibe o plano de tarifas, independentemente de o dispositivo
estar ativo no fim do período da fatura.
Se o dispositivo usar um plano de tarifas mensal, os campos Plano de
Tarifas Mensal e Plano de Tarifas Padrão mostrarão o mesmo nome do
plano de tarifas. Se o dispositivo usar um plano de tarifas pré-pago durante
todo o ciclo de faturamento, o campo Plano de Tarifas Padrão mostrará o
nome do plano de tarifas pré-pago, enquanto o campo Plano de Tarifas
Mensal ficará em branco.
Índice de Rateio
Mensal
O Índice de Rateio Mensal é um número entre zero e um que indica como
o Control Center deve ratear o uso incluído e a taxa de assinatura para o
ciclo de
faturamento atual. Por exemplo, um valor de índice de um indica que a taxa
de assinatura do dispositivo é a taxa normal. No entanto, um valor de índice
de 0,5 indica que a taxa de assinatura é a metade da taxa normal
especificada no plano de tarifas. O rateio se aplica apenas aos dispositivos
que usam planos de tarifas mensais. Se uma taxa de assinatura não for
cobrada do dispositivo durante o ciclo de faturamento, esse campo ficará
em branco.
194
Status do Assinante
Status do Assinante indica por que o dispositivo foi faturado.
Cobrança da
Assinatura
Cobrança da Assinatura é a taxa de assinatura devida durante o período
de faturamento atual. EXCLUIR, NÃO APLICÁVEL
Cobrança de Tarifas
Fixas
Se o dispositivo estiver usando um plano fixo de
tarifas COMPARTILHADO , o campo Cobrança de Tarifas Fixas exibirá a
soma de qualquer cobrança de tarifa (fora a taxa de assinatura) dividida
pelo número de assinantes no pool. Esse valor deve dar uma ideia do
custo por cada dispositivo que esteja participando de um plano de tarifa
fixa. Se o dispositivo não estiver em um plano de tarifa fixa, esse campo
ficará em branco. Talvez você queira ocultar essa coluna se não estiver
usando planos de tarifas fixas combinados.
Ativações de Evento O campo Ativações de Evento refere-se ao número de eventos que
ocorreram para esse dispositivo durante o ciclo de faturamento. Ele
somente será exibido se a conta tiver acesso a planos de evento.
Cobranças de Evento O campo Cobranças de Evento soma o custo das cobranças pré-pagas
para qualquer plano de evento que tenha sido utilizado durante o ciclo
de faturamento.
Volume de Dados (MB) Volume de Dados especifica a quantidade de dados faturáveis (em MBs)
que um determinado dispositivo usou durante o ciclo de faturamento.
195
Volume de SMS
incluído (msg)
Volume de SMS especifica o número de mensagens faturáveis (MT e MO)
que um determinado dispositivo usou durante o ciclo de faturamento. Se
o plano de tarifas do dispositivo rastrear o SMS MO e
MT separadamente, você também verá valores nas colunas Volume
SMS MT e Volume SMS MO.
Funcionalidades não disponíveis: Faturas > Plano de Tarifas
Faturas > Assinaturas Pré-pagas
Faturas> Zonas de Planos de Tarifas
Faturas> Detalhes de Voz
Faturas> Descontos
Faturas> Outros Custos
Faturas > Detalhe dos Dados
A subguia Detalhe dos Dados mostra o uso de dados para cada dispositivo por plano de tarifas Um
dispositivo poderá aparecer várias vezes se tiver usado mais de um plano de tarifas durante o ciclo de
faturamento Para obter os detalhes sobre cada
sessão de dados durante o período de faturamento, clique no número de ID
do SIM e selecione a subguia Dados.
Local: Faturamento > Faturas > Detalhes da Fatura > guia Detalhe dos Dados
196
Campo Descrição do campo
ICCID O ICCID é um identificador exclusivo associado a cada cartão SIM.
ID do Dispositivo O ID do Dispositivo é um identificador opcional atribuído a cada dispositivo
pela conta ou pelo cliente.
Cliente Em geral, Cliente é um nome descritivo para a empresa que possui e
opera o dispositivo correspondente. Um campo em branco indica que a
conta propriamente dita possui os dispositivos. No entanto, algumas
contas podem optar por especificar um departamento ou até mesmo uma
pessoa individual nesse campo.
Plano de tarifas Plano de Tarifas é um nome descritivo para o plano de tarifas.
Zona Zona é um nome descritivo para a zona.
Zona de Roaming Zona de Roaming indica se a zona atual é ou não considerada uma zona de
roaming. Essa classificação determina se as cobranças associadas à zona
são chamadas de excesso ou roaming na fatura.
Dados Incluídos
Limitados
Dados Incluídos Limitados indica se o plano de tarifas expirará quando o
dispositivo atingir a alocação de dados incluídos (Sim) ou se ele
simplesmente entrará em excesso (Não).
197
Modo Incluído Modo Incluído especifica como cada dispositivo pode consumir seu uso
incluído na zona atual:
• Mensalmente — Por SIM. Cada dispositivo recebe uma alocação de
uso para o mês.
• Mensalmente — Combinado. Cada dispositivo contribui com sua
alocação de uso individual para um pool comum que está disponível
a todos os outros dispositivos no plano.
• Por Período. Cada dispositivo recebe uma alocação que pode ser
usada a qualquer momento durante o período do plano de tarifas.
Volume de Dados (MB) Volume de Dados especifica a quantidade de dados faturáveis (tanto
incluídos quanto em excesso) que um determinado dispositivo usou
durante o ciclo de faturamento na zona especificada de um determinado
plano de tarifas.
Encargos de Dados Encargos de Dados refere-se às cobranças por excesso e roaming
aplicáveis ao uso de dados que ultrapassa a alocação de dados para o
dispositivo em cada zona de um plano de tarifas. Lembre-se que o
Control Center não calcula cobranças por excesso para dispositivos
individuais usando um plano de tarifas combinado.
Com um plano de tarifas combinado, o Control Center combina o uso de
dados para cada dispositivo no plano e, em seguida, determina se o uso
total excedeu ou
não o tamanho do pool. Se o pool for excedido, o Control Center
calculará as cobranças por excesso do plano de tarifas como um todo, e
não para os dispositivos individuais. No caso de um plano de tarifas
combinado, esse campo exibe o valor Combinado.
198
Dados Incluídos (MB) O campo Dados Incluídos especifica a quantidade de dados que o
dispositivo pode usar na zona atual durante o ciclo de faturamento. No
caso de um plano de tarifas combinado, esse campo exibe o valor
Combinado. Para um dispositivo que usa um plano de tarifas por
período/individual pré-pago (em que o dispositivo pode consumir o uso
de dados total incluído a qualquer momento durante o período), esse
campo mostrará a quantidade de uso de dados não consumido à qual
esse dispositivo tem direito na zona atual durante o ciclo de
faturamento. Por exemplo, suponha que um plano de tarifas por
período inclua
40MB de dados com um período de 2 meses. O dispositivo pode usar
40 MB de dados a qualquer momento durante o período do plano. Se o
dispositivo usar 10 MB de dados durante o primeiro ciclo de
faturamento, ele terá o direito de usar mais 30 MB durante o segundo
ciclo de faturamento.
Tipo de Plano O Tipo de Plano especifica se um plano de tarifas é individual ou
compartilhado.
Ajuste de
Arredondamento Diário
(MB)
O Ajuste de Arredondamento Diário controla a diferença entre o uso
de dados real (antes do arredondamento) e o uso de dados informado.
Por exemplo, suponha que o plano de tarifas arredonde o uso de dados
para cima até o valor de 1 MB mais próximo diariamente. Se um
dispositivo usar 200 KB de dados todos os dias durante o ciclo de
faturamento (30 dias), o Control Center arredondará esse número para
cima até 1 MB todos os dias. O Ajuste de Arredondamento Diário
mostra o ajuste para um determinado dispositivo por plano de tarifas.
Faturas > Detalhe SMS
A subguia Detalhe SMS mostra o uso de SMS para cada dispositivo por plano de tarifas e por zona. Um
dispositivo poderá aparecer várias vezes se tiver usado mais de um plano de tarifas durante o ciclo de
faturamento ou se um plano de tarifas tiver várias zonas nas quais esse dispositivo usou serviços de SMS.
Para obter os detalhes sobre cada mensagem enviada ou recebida durante o período de faturamento,
clique no número de ID do SIM e selecione a subguia SMS.
199
Local: Faturamento > Faturas > Detalhes da Fatura > guia Detalhe SMS
Campo Descrição do campo
ICCID O ICCID é um identificador exclusivo associado a cada cartão SIM.
ID do Dispositivo O ID do Dispositivo é um identificador opcional atribuído a cada dispositivo
pela conta ou pelo cliente.
Cliente Em geral, Cliente é um nome descritivo para a empresa que possui e
opera o dispositivo correspondente. Um campo em branco indica que a
conta propriamente dita possui os dispositivos. No entanto, algumas
contas podem optar por especificar um departamento ou até mesmo
uma pessoa individual nesse campo.
Plano de tarifas Plano de Tarifas é um nome descritivo para o plano de tarifas.
Zona Zona é um nome descritivo para a zona.
200
Zona de Roaming Zona de Roaming indica se a zona atual é ou não considerada uma zona
de roaming. Essa classificação determina se as cobranças associadas à
zona são chamadas de excesso ou roaming na fatura.
Tipo de Plano O Tipo de Plano especifica se um plano de tarifas é pré-pago ou
mensal, individual ou combinado e de evento ou adicional.
Modo Incluído Modo Incluído especifica como cada dispositivo pode consumir seu uso
incluído na zona atual:
• Mensalmente — Por SIM. Cada dispositivo recebe uma alocação de
uso para o mês.
• Mensalmente — Combinado. Cada dispositivo contribui com sua
alocação de uso individual para um pool comum que está disponível a
todos os outros dispositivos no plano.
• Por Período. Cada dispositivo recebe uma alocação que pode ser usada
a qualquer momento durante o período do plano de tarifas.
Volume de SMS
incluído (msg)
Volume de SMS especifica o número de mensagens faturáveis (tanto
incluídas quanto em excesso) que um determinado dispositivo usou na zona
especificada do plano de tarifas.
Preço SMS Preço SMS refere-se às cobranças por excesso aplicáveis a mensagens de
texto que ultrapassaram a alocação de SMS para o dispositivo na zona
especificada do plano de tarifas.
SMS incluído (msg) SMS Incluído especifica o número de mensagens faturáveis (SMS)
incluídas na taxa de assinatura. Todas as mensagens acima desse valor
estarão sujeitas a cobranças por excesso. Para um por plano de tarifas
por período, esse número representa o saldo disponível para o
dispositivo no início do ciclo de faturamento. Para todos os outros
planos, esse número é a alocação mensal de mensagens para o
dispositivo.
201
Tipo de Mensagem Tipo de Mensagem indica se a mensagem foi enviada pelo dispositivo
(MO, de origem móvel) ou recebida pelo dispositivo (MT, de terminação
móvel). Se o
plano de tarifas combinar mensagens MO e MT, o Tipo de Mensagem será
Combinado.
Faturas > Ativações
A subguia Ativações lista todos os custos de ativação que ocorreram no ciclo de faturamento.
Local: Faturamento > Faturas > Detalhes da Fatura > guia Ativações
Campo Descrição do campo
ICCID O ICCID é um identificador exclusivo associado a cada cartão SIM.
ID do Dispositivo O ID do Dispositivo é um identificador opcional atribuído a cada
dispositivo pela conta ou pelo cliente.
Cliente Em geral, Cliente é um nome descritivo para a empresa que possui e
opera o dispositivo correspondente. Um campo em branco indica que a
conta propriamente dita possui os dispositivos. No entanto, algumas
contas podem optar por especificar um departamento ou até mesmo
uma pessoa individual nesse campo.
Plano de tarifas Plano de Tarifas especifica qual plano de tarifas estava associado ao
dispositivo quando a ativação ocorreu.
Data de Ativação
Inicial
Data de Ativação Inicial é a data em que um dispositivo foi
ativado pela primeira vez.
Custo de Ativação Custo de Ativação é a taxa para ativar o dispositivo correspondente.
202
Moeda Moeda é a unidade de medida para todas as cobranças de uma conta.
Tipo de Ativação Tipo de Ativação é Inicial para dispositivos que estão sendo ativados pela
primeira vez ou Reativação para dispositivos que foram ativados no
passado.
11.4 Lista de Usos
A página de lista Usos mostra o uso do serviço para cada dispositivo por ciclo de faturamento. Esse
relatório fornece informações históricas de alto nível sobre os serviços de dados, SMS, , entre outros,
usados por dispositivos individuais. O Control Center não exibe nenhuma informação financeira aqui
Local: Faturamento > Usos
203
Ciclo de Faturamento Ciclo de Faturamento é um nome de fatura que especifica o mês e
o ano em que ocorreram cobranças. Esse nome se baseia no
último dia do ciclo de faturamento. Por exemplo, o ciclo de
faturamento de janeiro de 2014 pode durar na verdade de 15 de
dezembro de 2013 a 14 de janeiro de 2014, ou até mesmo de 2 de
dezembro de 2013 a 1° de janeiro de
2014.
Volume de Dados (MB) Volume de Dados especifica a quantidade de dados (em MBs)
que um determinado dispositivo usou durante o ciclo de
faturamento.
Volume de SMS (msg) Volume de SMS especifica o número de mensagens que um
determinado dispositivo usou durante o ciclo de faturamento.
Volume de Eventos
(MB)
Volume de Eventos especifica a quantidade de dados (em MBs)
que um determinado dispositivo usou durante o ciclo de
faturamento enquanto ele esteve em qualquer plano de tarifas
de evento.
Eventos Eventos lista o número de planos de tarifas de evento que um
dispositivo usou durante o ciclo de faturamento.
Usos > Dados
A subguia Dados de uso do dispositivo mostra todas as sessões de dados que o dispositivo usou
durante o ciclo de faturamento. Uma sessão de dados é um período em que o dispositivo enviou
ou recebeu dados. O Control Center cria uma sessão de dados sempre que uma conexão de dados
é encerrada pelo dispositivo ou devido à perda de cobertura. O Control Center também cria uma
sessão de dados quando uma conexão de dados se manteve aberta por mais de 24 horas. Em
geral, um dispositivo apresenta várias sessões de dados durante um ciclo de faturamento.
Local: Faturamento > Usos > Detalhes de uso > Dados
204
Nome do campo Descrição do campo
ICCID O ICCID é um identificador exclusivo associado a cada cartão SIM.
ID do Dispositivo O ID do Dispositivo é um identificador opcional atribuído a cada
dispositivo pela conta ou pelo cliente.
Zona Zona é um nome descritivo para a zona.
Horário de Início da
Sessão
Horário de Início da Sessão especifica quando a sessão de dados
começou. O Control Center usa o fuso horário padrão da conta.
Volume de Dados (KB) Volume de Dados especifica a quantidade de dados (em KBs) que
o dispositivo usou durante a sessão de dados.
País Esse campo especifica o país no qual o dispositivo estava
localizado durante a sessão de dados.
Usos > SMS
A subguia de uso SMS mostra todas as mensagens enviadas ou recebidas pelo dispositivo
durante o ciclo de faturamento. O Control Center inclui todas as mensagens,
independentemente de elas serem faturáveis ou não. Nenhuma informação financeira está
incluída.
Local: Faturamento > Usos > Detalhes de Uso do Dispositivo > SMS
205
Nome do campo Descrição do campo
ICCID O ICCID é um identificador exclusivo associado a cada cartão SIM.
ID do Dispositivo O ID do Dispositivo é um identificador opcional atribuído a cada
dispositivo pela conta ou pelo cliente.
Zona Zona é um nome descritivo para a zona.
Data Enviada Data Enviada refere-se à data e à hora em que a mensagem foi
enviada, com base no fuso horário padrão da conta.
Enviar de O campo Enviar de identifica o dispositivo ou computador que
enviou a mensagem. Se o remetente for Control Center, o código
de atalho 5277 aparecerá. Caso contrário, será exibido o MSISDN
do dispositivo de envio, que é equivalente a um número de
telefone.
206
Enviar para O campo Enviar para identifica o destinatário da mensagem. Se
o destinatário for Control Center, o código de atalho 5277 será
exibido. Caso contrário, o MSISDN do dispositivo do destinatário,
equivalente a um número de telefone, será exibido.
País Esse campo especifica o país no qual o dispositivo estava
localizado durante a sessão SMS.
Faturável O sinalizador de Faturável indica se as cobranças da conta devem
ou não ser faturadas. Alguns exemplos de contas não faturáveis
incluem contas de teste, contas de demonstração e contas de kits
de teste.
Plano de tarifas Plano de Tarifas é um nome descritivo para o plano de tarifas.
11.5 Lista de Planos de Tarifas
A página de lista Planos de Tarifas mostra todos os planos de tarifas que você tem permissão
para visualizar (No caso será visualizado o Plano Padrão).
Local: Faturamento > Planos de Tarifas
207
Detalhes do Plano de Tarifas
A página Detalhes do Plano de Tarifas mostra todas as configurações relacionadas a um plano
de tarifas específico. Os campos que aparecem nessa página dependem do tipo de plano e dos
serviços que são tarifados no plano. Todos os campos possíveis estão explicados a seguir.
Local: Faturamento > Planos de Tarifas > Detalhes do Plano de Tarifas
Informações —Tipos de Uso
208
Nome do campo Descrição do campo
Nome da Conta O nome da conta que está usando o plano de tarifas. Se o plano de
tarifas estiver disponível para uso por qualquer conta, esse valor
será Compartilhado.
Tipo de Plano O tipo de plano se refere ao método de pagamento (mensal
versus pré-pago) e o tipo de uso incluído (individual versus
combinado versus evento).
ID do plano O ID do plano identifica um plano de tarifas específico. O Control
Center gera esse número. Como um plano de tarifas pode ter várias
versões, esse valor poderá não ser exclusivo. ID da versão é o único
identificador de plano de tarifas exclusivo.
Nome do plano de
tarifas
Nome descritivo do plano de tarifas.
Termo Termo refere-se ao método de pagamento do plano de tarifas, Pré-
pago ou Mensal.
209
Moeda Moeda é a unidade de medida para todas as cobranças de uma conta.
Dispositivos O número de dispositivos que atualmente estão usando o plano
de tarifas.
Versão do Plano Versão do Plano especifica a versão do plano de tarifas atual. Duas
versões do mesmo plano de tarifas poderão coexistir se houver
dispositivos faturáveis atribuídos a cada uma. Saiba que diferentes
planos de tarifas poderão ter versões com o mesmo número (1,
2, 3 e assim por diante). O campo ID da versão identifica de forma
exclusiva cada versão de plano de tarifas no sistema.
ID da versão Este valor identifica de forma exclusiva uma versão específica de um
plano de tarifas em relação a todas as outras versões de planos de
tarifas no sistema, incluindo diferentes versões do mesmo plano de
tarifas e diferentes versões de outros planos de tarifas. Como um plano
de tarifas pode ter várias versões ativas a qualquer momento, o ID da
versão, não o ID do plano, é o único identificador de planos de tarifas
verdadeiramente exclusivo.
Status O Estado do plano de tarifas pode ser Publicado ou Não publicado. Um
plano publicado foi aprovado pela Claro e está disponível para uso
pelos dispositivos. Um dispositivo não pode usar um plano não
publicado.
Data Efetiva A data em que esta versão do plano de tarifas foi publicada.
Tipos de Uso
Funcionalidade não disponivel
Esta seção lista os serviços sem fio classificados no plano e determina
se o mecanismo de faturamento usará valores personalizados definidos
no plano de tarifas (Gerenciar Tarifação Abaixo de) ou valores padrão do
plano de tarifas padrão da Claro (Usar Tarifação Padrão).
210
11.6 Dispositivos
Dispositivos > Conexões
Mostra uma exibição gráfica do histórico de conexão do SIM, organizada por período de
faturamento.
Local: Dispositivo > Lista de dispositivos > Detalhes do dispositivo > subguia Conexões
Dispositivo > Histórico de conexões
Contém o histórico de conexão do SIM, listado por sessão de dados. O histórico da sessão de dados é
organizado por período de faturamento. Por padrão, o histórico não faturado do SIM é exibido. O
usuário pode visualizar o histórico da sessão de dados referente a outro período de faturamento no
passado selecionando o período de destino no filtro suspenso Ciclo de Faturamento. Registros de
histórico de conexão são exibidos conforme são recebidos pela plataforma Control Center. Em geral, o
Control Center recebe registros de sessão de dados por um destes três motivos:
• Sessão Encerrada – Se o dispositivo finalizar sua sessão de dados, um registro dessa sessão será
recebido.
• Sessão de Execução Longa – Se uma sessão ficar aberta por um período prolongado, um
registro de sessão de dados será recebido a cada 24 horas, começando no horário de início da
sessão inicial.
• Sessão de Alto Volume – Se uma sessão transmitir volumes significativos de tráfego de dados, um
registro de sessão de dados será recebido aproximadamente a cada 500 KB de tráfego transmitido.
(Esse limite de volume é configurável e está sujeito a alterações.)
211
Local: Dispositivo > Lista de dispositivos > Detalhes do dispositivo > subguia Histórico de conexão
Saiba que o plano de tarifas exibido na lista de histórico é o plano de tarifas que estava ativo no
momento em que a sessão ocorreu. Se o plano de tarifas do dispositivo for alterado antes do fim dos
ciclos de faturamento, o mecanismo de tarifação recalculará quaisquer cobranças de uso com base no
plano de tarifas em vigor no fim do ciclo de faturamento.
Dispositivo > SMS > SMS Live
A subguia SMS > SMS Live mostra uma listagem de todas as mensagens via SMS enviadas ou recebidas pelo
SIM de destino, bem como seus respectivo estado (recebidas ou com falha).
Local: Dispositivo > Lista de dispositivos > Detalhes do dispositivo > subguia SMS > subguia SMS Live
Observação: Nem todos os usuários verão a subguia SMS na página de detalhes devido às
configurações de funções de usuário e conta.
Os estados típicos de mensagens na subguia SMS Live são:
212
• Pendente — Indica que o Control Center ainda não recebeu a confirmação de que a
mensagem está em uma fila de entrega.
• Entregue — Indica que uma mensagem do Control Center para o dispositivo (ou seja, uma
mensagem de terminação móvel, ou MT) foi entregue com êxito para esse dispositivo.
• Recebido — Indica que uma mensagem do dispositivo para o
Control Center (ou seja, uma mensagem de origem móvel, ou MO) foi recebida com êxito
pelo Control Center.
• Cancelado — Indica que a entrega da mensagem foi cancelada antes que o Control Center
recebesse uma confirmação de que essa mensagem chegou em uma fila de entrega.
Depois que o Control Center receber a confirmação de que uma mensagem
Pendente chegou a uma fila de entrega nos servidores de SMS do
Control Center, essa mensagem também aparecerá na subguia Histórico de
Mensagens com o estado apropriado indicando se ela foi entregue. Há também vários
botões disponíveis na subguia SMS Live:
• Enviar SMS — Inicia uma caixa de diálogo pop-up para permitir que o usuário envie uma
mensagem via SMS ao SIM diretamente do Control Center.
• Cancelar SMS — Quando uma mensagem via SMS pendente é selecionada, o botão
Cancelar SMS cancela a solicitação de envio da mensagem por meio da infraestrutura de
SMS do Control Center.
• Reenviar SMS — Quando uma mensagem via SMS cancelada é selecionada, o
botão Reenviar SMS reenvia a mensagem.
Observação: Pode haver um atraso no tempo necessário para uma mensagem via SMS
aparecer na guia Histórico de Mensagens quando ela é enviada do Control Center. Esse atraso
ocorre devido ao processamento envolvido na exibição dos registros de histórico na interface de
usuário do Control Center. Ele não afeta o tempo de entrega real da mensagem para o SIM.
213
Dispositivo > SMS > Histórico de Mensagens
A guia Histórico de Mensagens mostra uma lista de mensagens SMS recebidas ou enviadas pelo SIM
de destino em um ciclo de faturamento específico.
Local: Dispositivo > Lista de dispositivos > Detalhes do dispositivo > subguia SMS > subguia Histórico de mensagens
Dispositivo > SMS > Mensagens Não Entregues
A terceira guia na subguia SMS, Mensagens Não Entregues, mostra um histórico de mensagens via
SMS que não puderam ser entregues.
Local: Dispositivo > Lista de dispositivos > Detalhes do dispositivo > subguia SMS > subguia Mensagens não entregues
214
Dispositivo > Cliente final
Mostra informações básicas de contato sobre a pessoa ou organização que possui o dispositivo, para
auxiliar no suporte ao dispositivo.
Local: Dispositivo > Lista de dispositivos > Detalhes do dispositivo >subguia Cliente final
215
Dispositivo > Alterações Programadas
Mostra todas as edições iminentes nos atributos do dispositivo que foram programadas para o
dispositivo.
Local: Dispositivo > Lista de dispositivos > Detalhes do Dispositivo > subguia Alterações Programadas
Observação: Ao editar um dispositivo, o usuário pode especificar a data atual ou uma data futura como
a Data Efetiva da alteração. Se a data atual for especificada, a alteração ocorrerá imediatamente.
Dispositivo > Rastreamento de Auditoria
Mostra um histórico de todas as alterações feitas nas informações detalhadas do dispositivo,
incluindo:
• O campo que foi alterado
• Valor anterior do campo
• Novo valor do campo
• Data e hora da alteração
• Nome do usuário do Control Center conectado ou que está fazendo a alteração via API (pode mostrar
o nome de um processo em segundo plano se a alteração foi automatizada).
• Qualquer usuário autorizado que realizou a edição em nome de outro usuário
• Status da modificação
Local: Dispositivo > Lista de dispositivos > Detalhes do dispositivo > subguia Rastreamento de auditoria
216
Dispositivo > Tarifação
Mostra as configurações atuais que controlam a tarifação do dispositivo. Essas configurações incluem o
plano de tarifas atualmente atribuído ao dispositivo, bem como informações sobre o período de
tarifação atual e o comportamento de renovação da tarifação para o dispositivo.
Local: Dispositivo > Lista de dispositivos > Detalhes do dispositivo > subguia Tarifação
217
12. GLOSSÁRIO assinante
Um termo de faturamento que identifica um dispositivo que utiliza um plano de tarifas. Em geral, por
questões de clareza e coerência, este documento usa o termo dispositivo em vez de assinante. No
entanto, há lugares na interface do usuário do Control Center em que o termo assinante é usado.
Nessas situações, o documento usa o mesmo termo. assinante ativo
Um dispositivo faturável cujo estado SIM era Ativado durante todo ou parte do ciclo de faturamento. assinante faturável
Um dispositivo do qual que será cobrada uma taxa de assinatura, independentemente do estado SIM.
Alguns assinantes são faturáveis, mas não são ativos. Essa situação pode ocorrer quando a linha está
em estado de suspensão perda/roubo. ciclo de faturamento
Um período de tempo durante o qual o Control Center controla o uso e as cobranças de uma única
fatura de acordo com o ciclo negociado.
cliente
Uma organização com uma relação subordinada direta com uma conta principal. compromisso Período máximo em que não ocorrerá faturamento (até 30 dias da ativação da linha, desde que não ultrapasse o tráfego de 20 Kb ou envio de 2 SMS)
Config de acesso de rede
Um termo antigo do Control Center para um plano de comunicação. Nós continuamos a usar o termo
porque várias APIs usam o termo em seus nomes de função.
218
conta
A empresa com a qual um provedor de serviço mantém uma relação direta. Geralmente, as empresas
chamadas de "clientes diretos" dos provedores de serviço são representadas como contas na
terminologia do Control Center. Contas do Control Center têm dispositivos associados (ou seja,
dispositivos que contêm SIMs ativados para o Control Center), bem como usuários associados do Control
Center. Consulte as definições de "Dispositivo" e "Usuário" para obter informações relacionadas. Contexto de PDP
Um Contexto de PDP (Packet Data Protocol) é uma estrutura de dados presente no SGSN e GGSN que
contém informações de sessão do dispositivo quando ele está em uma sessão ativa. Quando um
dispositivo desejar usar a rede de dados, primeiramente, ele deverá se conectar e depois ativar um
Contexto de PDP. dispositivo
Um componente de hardware que contém um SIM que utiliza serviços sem fio. Cada dispositivo está
associado a uma única conta e é gerenciado por meio da plataforma. Os termos dispositivo, terminal e
SIM serão frequentemente usados de forma intercambiável. distribuição de uso
Define a quantidade de dados emensagens na taxa de assinatura do plano de tarifas. Geralmente, a
alocação de uso é chamada "uso incluído", que se refere a franquia do plano. excesso
Refere-se à utilização que vai muito além do uso incluído. Quando um dispositivo excede sua
distribuição de uso, o Control Center cobra uma taxa por excesso com base na tarifa definida no plano
de tarifas (custo do excedente)
fatura
Contém todas as informações de faturamento para uma conta durante um ciclo de faturamento
específico. Essas informações incluem taxas de assinatura, taxas por excesso e outras cobranças,
juntamente com informações de uso para todos os dispositivos que contribuem para essas cobranças. A
fatura será gerada pela Claro.
219
função
Cada usuário tem uma função associada que define os privilégios do usuário para ver e trabalhar com
os dados e as funcionalidades no Control Center. Por exemplo, para visualizar as informações do
planos de tarifas, você precisará da função AccountFinance. GSSN
Um GGSN (Nó de Suporte para GPRS de Gateway) forma o gateway entre a arquitetura de dados
sem fio e a Internet. HLR
Um HLR (Home Location Register, Registrador de localização inicial) autentica qualquer dispositivo que
esteja tentando se conectar a um MSC ou SGSN. Ele confirma se um dispositivo tem ou não permissão
em sua rede, quais serviços ele pode acessar, quais APNs ele pode usar e se existem restrições de
roaming. ICCID
Identificador exclusivo primário para um dispositivo no Control Center. Em geral, o ICCID está impresso
no próprio cartão SIM. Ele é semelhante a um número de série e não pode ser alterado. interface de programação de aplicativo (API)
Permite que você gerencie suas informações no Control Center por meio de um aplicativo externo, e não
pela interface da web. Interface de usuário
Uma interface de usuário, frequentemente abreviada como "UI", é o conjunto de controles utilizados
pelo usuário final para interagir com um aplicativo de software. No Control Center, esses controles
incluem guias, menus, caixas de diálogo, etc.
limite de uso
Como um freio de emergência que garante que um dispositivo não use uma quantidade excessiva de
dados durante um ciclo de faturamento. Quando o dispositivo atingir o limite, por padrão, o Control
Center interromperá o acesso aos dados.
220
mecanismo de classificação
Inclui a interface de usuário e a lógica que permitem à Claro definir preços de serviços para suas
contas diretas. Preços flexíveis são definidos por plano de tarifas. MSC
Um MSC (Mobile Switching Center, Centro de comutação móvel) faz parte da rede GSM original,
fornecendo serviços móveis de voz e SMS. Vários MSCs são necessários para dar cobertura a um país. MSISDN
Um número de telefone associado a um dispositivo. Durante um período de tempo, você pode usar o
mesmo número de telefone para vários dispositivos (por exemplo, se aposentar o aparelho original e
substituir por um modelo mais novo). Consequentemente, o Control Center não
usa o MSISDN para identificar exclusivamente um dispositivo. pedidos triplos
Quando um dispositivo tenta se conectar a um MSC, esse MSC entrará em contato com o HLR da rede
e iniciará um pedido triplo — um pedido de autorização do dispositivo para se conectar à rede. O HLR
informará ao MSC se o dispositivo tem permissão na rede, quais APNs tem permissão de usar, quais
serviços pode acessar e se tem restrições de roaming. Com base nessas informações, o dispositivo pode
se conectar à rede por esse MSC três vezes antes de o MSC precisar se conectar ao HLR para nova
verificação
plano de comunicação
Define as configurações de comunicação que regem as permissões de rede para um dispositivo. Cada
dispositivo possui exatamente um plano de comunicação atribuído a ele. Especificamente, um plano de
comunicação define: serviços de rede disponíveis (por exemplo, dados de GPRS, SMS, voz), restrições de
roaming (ou seja, quais redes são permitidas/proibidas) e APNs (Access Point Names, Nomes de pontos
de acesso). plano de tarifas compartilhado
Um plano de tarifas que possui uma distribuição de uso compartilhada por todos os dispositivos no
plano. Em um grupo fixo, a Claro especifica o tamanho do grupo independente do número de
dispositivos que o utilizam. Em uma combinação flexível, cada dispositivo contribui com o seu uso na
combinação para compartilhamento com outros dispositivos. Portanto, o tamanho da combinação está
diretamente relacionado ao número de dispositivos que a utilizam.
plano e tarifas
221
Um acordo (plano contratado) determina quanto custará para um dispositivo acessar serviços sem fio.
Um plano de tarifas define como cada dispositivo será cobrado por taxas de assinatura e uso da rede. plano mensal
Um período de assinatura de um mês que é renovado automaticamente todos os meses. A conta paga
pelo plano no final de cada mês. O plano pode ser individual ou compartilhado provedor de serviço
Nos termos do Control Center, uma Operadora de rede móvel que possui e gerencia contas diretas
por meio do Control Center. Essa relação direta com contas inclui gerenciamento, provisionamento,
suporte e faturamento de dispositivos. Consulte também conta. push API
Uma interface de programação de aplicativo que permite ao Control Center enviar alertas
programáticos a um aplicativo externo. Para usar esses alertas, a conta ou cliente deve configurar um
servidor local para receber e processar os dados enviados.
rateio da taxa de assinatura
O Control Center rateia a taxa de assinatura e o uso incluído apenas para planos mensais. Um
dispositivo que começar um plano de tarifas no meio do mês pagará a metade da taxa de assinatura e
receberá metade da alocação de uso para esse mês. O rateio está disponível para
o primeiro mês de um dispositivo no plano, mas não para o último mês. Se refere a cobrança proporcional (pró-rata)
rateio do uso
O Control Center rateia o uso de um plano de tarifas somente quando você rateia a taxa de assinatura
desse plano. Consulte Rateio da taxa de assinatura. serviço
Um de vários tipos de serviço sem fio: dados, mensagens (SMS), e outros. servidor de aplicativos
Um servidor de clientes que executa os aplicativos que processam os dados oriundos de dispositivos
remotos. sessão
Um contexto de dados único estabelecido entre um dispositivo e os servidores de data center para
a conta que possui o dispositivo.
222
SGSN
Um SGSN (Nó de Suporte GPRS de Atendimento) é uma extensão da rede GSM original para fornecer
serviços de dados móveis. Conexões de dados entre um dispositivo e a Internet/VPN são estabelecidas
por meio de SGSN. Em comparação a MSCs, uma quantidade muito menor de SGSNs é necessária para
dar cobertura à área geográfica de um país. SIM
Um cartão físico em um dispositivo que permite que ele se comunique sem fio através de conectividade
GSM. Algumas telas podem fazer referência a um dispositivo usando um identificador exclusivo
denominado ICCID. Cada dispositivo possui um estado que descreve sua preparação para uso (por
exemplo, Teste, Teste Pronto, Ativado e Removido). A não ser que haja motivos específicos para fazer
uma distinção entre um cartão de dispositivo e um dispositivo, este documento usará o termo
dispositivo. Os termos dispositivo, terminal e SIM são usados de forma intercambiável. SMPP
Um Servidor SMPP também é um servidor de cliente. Ele envia e recebe mensagens SMS para e de
dispositivos remotos por meio do protocolo SMPP (Mensagens Curtas entre Pares).
SMSC
Um Centro de Serviços de Mensagens Curtas (SMSC) retransmite mensagens SMS de e para os
dispositivos remotos. SS7
O SS7 (Sistema de Sinalização n° 7) é um protocolo de sinalização de telefonia de padrão internacional.
Diferentes componentes da rede sem fio se comunicam uns com os outros via SS7. terminal
Outra palavra para um dispositivo ou SIM com acesso a serviços sem fio. uso fora do horário de pico
Refere-se a qualquer serviço utilizado por um dispositivo fora do horário padrão. Em um plano de
tarifas, a Claro pode definir o uso incluído e as taxas por excedente para o horário fora de pico ao
utilizar zonas fora de pico.> se refere a horário normal e reduzido (se aplica a planos Telemetria?)
223
uso incluído
Define a quantidade de dados emensagens incluídos na taxa de assinatura do plano de tarifas. O uso
incluído também é chamado de alocação de uso. > se refere a franquia usuário
Um usuário individual da plataforma Jasper. Cada usuário tem credenciais de ID de usuário e senha
que concedem acesso ao Control Center. VPN
Uma Rede privada virtual permite enviar e receber dados com segurança em redes
compartilhadas ou públicas.
zona
Geralmente uma área geográfica na qual você pode definir diferentes níveis de uso e cobranças por
excesso. O Control Center também oferece suporte a zonas de APN (Access Point Name, Nome do ponto
de acesso) e de fluxo de dados, que permitem tarifar um dispositivo de acordo com o tipo de conteúdo
que ele utiliza. Você também pode tarifar o uso fora do pico com o uso de zonas.
224
225