Clientes, Contatos, Locais e Serviços

Temos um modelo simples de um Cliente que pode ter vários Contatos e vários Locais, Serviços, etc.

Um Cliente é uma empresa ou indivíduo que tem um relacionamento conosco, para quem enviamos uma fatura / conta.

Um Contato é uma pessoa que trabalha com o cliente, para um indivíduo, provavelmente é o mesmo que o próprio cliente, uma única pessoa, mas podemos ter membros da família ou outros contatos, e cada contato tem um tipo, por exemplo, um contato de cobrança, um contato técnico, etc., que influencia como lidamos com o contato.

Um Local é um local físico onde entregamos serviços, pode ser uma casa, escritório ou outro local. Isso nos permite ter vários locais para um único cliente, por exemplo, um cliente com vários escritórios, e saber quais serviços estão associados a qual local.

Um Serviço é algo pelo qual cobramos um cliente, pode ser um serviço de internet residencial, serviço móvel ou até mesmo serviços abstratos como locação de um sub-rede ou fornecimento de eletricidade medida para um rack. Cada serviço está vinculado a um cliente e a um local, e pode ter várias cobranças associadas a ele.

Os clientes também têm um Registro de Atividades, que é um registro de todas as alterações feitas, Tags, Atributos para armazenar metadados personalizados, Itens de Inventário e informações financeiras como Transações, Faturas & Métodos de Pagamento.

Uma vez que criamos um cliente, podemos então adicionar um serviço a esse cliente, que é a coisa pela qual cobramos.

Para informações sobre como criar um cliente, veja Criar um Cliente.

Lista de Clientes

A lista de clientes fornece uma tabela pesquisável e filtrável de todos os clientes no sistema.

{.align-center width="800px"}

Recursos:

• Pesquisa - Filtrar clientes por nome ou ID
• Ações em Lote - Selecionar vários clientes para operações em lote
• Paginação - Navegar por grandes listas de clientes
• Ações Rápidas - Visualizar ou excluir clientes diretamente da lista

Cliente - Detalhe

O objeto cliente em si não contém muitas informações, é apenas um nome e uma referência aos contatos e locais.

Sua implantação específica pode incluir campos adicionais ou personalizações, mas o objeto cliente básico é muito simples.

Na página de visão geral também há um gráfico mostrando a Receita Média Por Usuário (ARPU) para o cliente, que é a receita total dividida pelo número de serviços, e uma comparação de como este cliente se compara à média de ARPU para todos os clientes no sistema.

As opções de Status do Cliente são adaptadas com base nas necessidades específicas de seu negócio, mas geralmente incluem opções como Ativo, Inativo, Pendente, etc., com diferentes regras em cada uma que controlam o comportamento do cliente no sistema nesse estado.

Excluir um cliente só pode ser feito se o cliente não tiver serviços ativos, faturas não pagas ou transações não faturadas. Se o cliente tiver algum desses, você precisará encerrar os serviços ativos e garantir que os pagamentos sejam feitos antes de poder excluir o cliente, o que, por sua vez, arquivará o cliente e todos os dados associados, que podem ser restaurados posteriormente, se necessário.

Local - Detalhe

Os locais são locais físicos onde os serviços são entregues e podem ter vários serviços associados a eles.

Eles são predominantemente usados para clientes empresariais, onde um único cliente pode ter vários locais, por exemplo, um cliente com vários escritórios.

Ter vários locais nos permite rastrear quais serviços estão associados a qual local, por exemplo, se um cliente solicita um novo serviço para um novo escritório, precisamos garantir que entregamos o serviço correto ao local correto. Isso nos permite rastrear serviços por local e faturá-los separadamente, se necessário.

Integração com Google Maps e Geocodificação

Cada local está integrado com Google Maps para garantir dados de endereço precisos e geolocalização. A interface do usuário geocodifica automaticamente os endereços e gera dados de localização.

Como Funciona a Geocodificação de Endereço:

Ao adicionar ou editar um local, a interface fornece dois métodos para definir a localização:

1. Pesquisa de Endereço (Recomendado)
   • Use a barra de pesquisa na parte superior do formulário
   • Digite um endereço e o Google Maps Autocomplete sugere correspondências
   • Selecione o endereço correto no dropdown
   • O sistema preenche automaticamente:
     • Nome do Local - Nome do lugar do Google Maps
     • Linha de Endereço 1 - Número e nome da rua
     • Linha de Endereço 2 - Subprédio (número da unidade/sala)
     • Cidade - Localidade
     • Estado/Região - Área administrativa
     • Código Postal - Código postal
     • País - Nome do país
     • Latitude & Longitude - Coordenadas precisas
     • Código Plus - Código de Localização Aberta de 11 caracteres (por exemplo, 8C3MFJV8+2F)
     • Google Maps Place ID - Identificador único do lugar
2. Marcador de Mapa Arrastável (Manual)
   • Arraste o pino no mapa para o local exato
   • O sistema realiza geocodificação reversa para obter o endereço a partir das coordenadas
   • Os mesmos campos são preenchidos automaticamente com base na localização do pino
   • Útil para áreas rurais ou quando o endereço é impreciso

Geração de Código Plus:

Os Códigos Plus são gerados automaticamente a partir de latitude/longitude usando a biblioteca Open Location Code. Um Código Plus é um código curto (11 caracteres) que representa uma localização precisa em qualquer lugar do mundo.

Exemplo:

Campos preenchidos automaticamente: ✓ Nome do Local: "123 Main Street" ✓ Linha de Endereço 1: "123 Main Street" ✓ Cidade: "Londres" ✓ Estado: "Grande Londres" ✓ País: "Reino Unido" ✓ Código Postal: "SW1A 1AA" ✓ Latitude: 51.5074 ✓ Longitude: -0.1278 ✓ Código Plus: "9C3XGPHC+3Q" ✓ Google Place ID: "ChIJdd4hrwug2EcRmSrV3Vo6llI"

Requisitos de Validação:

Antes de salvar um local, o sistema valida:

• Latitude & Longitude devem ser definidos (seja via pesquisa ou arrastando o marcador)
• País deve ser preenchido (padrão para REACT_APP_DEFAULT_COUNTRY se não definido)
• Código Plus deve ter 12 caracteres (11 + 1 para preenchimento)

Se a validação falhar, você verá um erro:

Feedback Visual:

A interface mostra feedback em tempo real:

ou

Como os Dados de Localização são Usados

Os dados de localização geocodificados (latitude, longitude, Código Plus) são usados em todo o OmniCRM para:

1. Entrega e Instalação de Serviços

• Técnicos de Campo - Acessar Código Plus para navegar até o local exato do local
• Agendamento de Instalação - Atribuir técnicos com base na proximidade geográfica
• Implantação de Equipamentos - Garantir que o equipamento correto seja entregue ao local correto

2. Notificações de Falhas

• Alertas Geofenced - Se houver falha de rede em uma área específica, consultar locais por raio de lat/long
• Comunicações Direcionadas - Enviar notificações de falha apenas para clientes afetados via Mailjet
• Páginas de Status - Exibir mapa de falhas com locais afetados

Exemplo:

Consulta: SELECT * FROM Customer_Site

: WHERE distance(latitude, longitude, 51.5074, -0.1278) < 5

Resultado: 47 locais afetados Ação: Enviar notificação de falha para 47 clientes

3. Relatórios e Análises

• Receita Geográfica - Receita por cidade, estado, região
• Mapas de Densidade de Serviços - Mapa de calor das localizações de serviços
• Planejamento de Expansão - Identificar áreas carentes

4. Clientes Empresariais com Múltiplos Locais

• Gerenciamento de Locais - Rastrear quais serviços em quais locais
• Faturamento Separado - Faturar por local, se necessário
• Atribuição de Serviços - Vincular serviços a locais específicos durante a provisão

Locais Rurais e Remotos

Para clientes em áreas rurais onde endereços de rua podem não existir ou ser imprecisos:

1. Usar Arraste no Mapa
   • Aproxime-se da área aproximada
   • Arraste o pino para a propriedade/edifício exato
   • O sistema gera Código Plus para essa localização precisa
2. Compartilhamento de Código Plus
   • Compartilhe o Código Plus com o cliente (por exemplo, 8C3MFJV8+2F)
   • O cliente pode inserir isso no Google Maps para ver a localização exata
   • Técnicos de campo usam o Código Plus para navegação
3. Notas de Endereço
   • Use o campo "Nota de Endereço" para direções adicionais
   • Exemplo: "Vire à esquerda no celeiro vermelho, 500m após a grade de gado"
   • Notas visíveis para as equipes de instalação

::: tip ::: title Dica :::

Você pode arrastar o pino no mapa para a localização correta se o endereço não for preciso. O sistema fará a geocodificação reversa da localização e preencherá automaticamente todos os campos de endereço. :::

Contato - Detalhe

Os Contatos são pessoas associadas ao cliente. Eles podem ser contatos de cobrança, contatos técnicos ou outros tipos, e cada contato tem um tipo que influencia como lidamos com o contato.

Podemos ter vários contatos para um único cliente, por exemplo, um cliente com vários contatos de cobrança, ou um cliente com vários contatos técnicos.

Um bom exemplo seria uma empresa com um provedor de serviços gerenciados, que lida com o lado técnico das coisas, e um contato de cobrança separado que cuida do lado financeiro, ou uma família onde cada membro tem seu próprio contato, mas nem todos estão autorizados a fazer alterações.

Da mesma forma, podemos querer enviar notificações de falha apenas para o contato técnico, ou enviar faturas apenas para o contato de cobrança, e o tipo de contato nos permite controlar isso.

A lógica exata de como os tipos de contato são usados depende do seu negócio, mas a ideia básica é que cada contato tem um tipo que influencia como lidamos com eles, e que cada pessoa que está associada ao cliente é um contato.

Os contatos são sincronizados com a Mailjet integração, permitindo-nos enviar campanhas de e-mail direcionadas com base no tipo de contato, localização, gastos mensais ou serviços adquiridos, e gerenciar todos os modelos de e-mail usados para comunicações transacionais.