Como funciona o RegionTime

O que o widget faz

RegionTime pega o número do cartão e responde a uma pergunta: que horas são onde essa pessoa está e se ela está em expediente. A resposta aparece acima do número, num bloco próprio do cartão e ao criar uma tarefa.

O cálculo roda no navegador. As tabelas de numeração e de fusos viajam dentro do widget, então o horário aparece junto com o cartão em vez de esperar o servidor. Ao servidor só se pedem as configurações, o plano e os campos do CRM.

Como um número vira fuso horário

O widget lê o número pelo prefixo, não pelo país inteiro.

• Países com vários fusos — Brasil, EUA, Austrália, México, Rússia, Cazaquistão — são resolvidos pela região do número. Uma média do país estaria errada na maior parte do mapa.
• Os dados são o plano de numeração do conjunto aberto libphonenumber do Google mais a base de fusos IANA. A Rússia usa ainda o registro da Rossvyaz, onde os prefixos DEF e ABC são ligados a sujeitos federais e estes a fusos.
• Quando o prefixo não diz nada. Celulares de muitos países não carregam região alguma. O widget então mostra o país e marca a resposta como aproximada — em itálico e com borda tracejada. Isso é precisão honesta, não uma falha.

Horário de verão

O widget guarda nomes de fusos — America/Sao_Paulo, Europe/Lisbon — e não um deslocamento pronto em horas. O deslocamento é calculado para a data em questão, toda vez.

A diferença aparece justamente onde costuma passar batido: uma tarefa criada em outubro para novembro é calculada com o horário de novembro, não com o de hoje. Metade da Europa e das Américas anda uma hora no fim de outubro, e o widget sabe disso.

Ao lado do horário pode aparecer um floco de neve. Ele significa que aquele fuso muda de horário e agora está no horário padrão. Onde não há mudança — a maior parte do mundo — o floco nunca aparece.

Como se decide expediente e fora de expediente

Não é só «a hora cai dentro da faixa». O widget distingue quatro estados e colore o horário conforme.

• Expediente — verde. Dentro da faixa, sem ser fim de semana nem feriado.
• O dia está acabando — âmbar. Os últimos 30 minutos: dá para ligar, mas não para algo longo.
• Fora de expediente — coral, com uma lua.
• Fim de semana ou feriado — coral também, com outro ícone, para o motivo ficar visível.

A faixa é 10:00–19:00 por padrão e muda nas configurações. Ela vale para o horário local do cliente, não para o seu.

Feriados e fins de semana

Fins de semana

Sábado e domingo não é regra universal. Na Arábia Saudita, nos Emirados e em Israel o fim de semana cai em outros dias, e o widget tira isso dos dados do país em vez do hábito.

Feriados

O calendário é montado por regras, não por uma lista de datas de um ano: datas fixas, a Páscoa e a Páscoa ortodoxa com suas derivadas móveis, construções do tipo «a terceira segunda-feira de janeiro». Assim a tabela não vence na virada do ano.

A correção manual e por que ela prevalece

Um número nem sempre bate com o lugar: as pessoas se mudam, levam o chip junto, mantêm um número registrado em outra região.

A correção fica marcada como manual e sobrevive à redetecção: se o número muda ou o cartão é aberto de novo, o cálculo automático não a sobrescreve. O contrário — um algoritmo apagando a decisão de uma pessoa — significaria que o erro nunca poderia ser corrigido.

Campos no cartão do CRM

O widget cria um grupo de campos próprio — «Região» — e coloca ali só o que é dele:

• RTZ_TIMEZONE — o fuso horário no formato IANA;
• RTZ_REGION — a região ou a cidade;
• RTZ_COUNTRY — o país;
• RTZ_WORKING — working ou off (PRO).

Onde criá-los — lead, contato, empresa — é escolhido separadamente, e eles podem não ser criados. Seus campos, status, tags e notas não são tocados.

O campo para bots e como ele se mantém atualizado

«Horário de trabalho do cliente» é a única coisa que precisa ser recalculada continuamente, e a única pela qual se cobra.

O servidor não varre a base por temporizador. Para cada registro ele calcula o momento em que a resposta muda — quando o expediente do cliente começa ou termina — e só acorda para ele. Registros cujo momento chegou são atualizados em lotes: o CRM aceita até 250 entidades por requisição.

Daí sai a aritmética que torna isso possível. Cada cliente vira duas vezes por dia. Uma base de 100 000 contatos dá cerca de 33 requisições em lote por hora contra um limite de 7 por segundo. Varrer a base inteira toda hora — que é como soa à primeira vista — não daria.

Onde o widget desenha

• Acima do número — o horário, a região e a cor do estado. Sem borda e sem fundo: o campo do cartão já é emoldurado, e uma caixa dentro se leria como um botão.
• Um bloco na coluna da direita — dois mostradores, o dia em faixa e um conversor: arraste o mostrador do cliente para ver que horas aquilo é para você.
• No planejador — o horário do cliente para o momento escolhido, antes de salvar a tarefa.

O widget observa o cartão sendo redesenhado e devolve seus elementos ao lugar quando o CRM refaz a marcação.

O que o widget faz com os dados

• O fuso é resolvido no navegador. O número não é enviado a lugar nenhum para isso.
• No servidor ficam o identificador da conta, as configurações, a correspondência entre entidade e fuso, e os dígitos do número — necessários para recalcular o campo de expediente sem chamar o CRM.
• Os tokens de acesso são guardados criptografados e renovados uma hora antes de expirar. Se o acesso for revogado, o widget avisa na central de notificações em vez de silenciar.
• Os fusos dos funcionários não são coletados por padrão: um fuso horário é um dado aproximado de localização de uma pessoa, e coletá-lo deve ser uma escolha consciente.

Planos e requisitos

O que o plano gratuito inclui

Tudo o que uma pessoa lê: horário e região acima do número, o bloco com mostradores e conversor, a dica no planejador, os campos de fuso, região e país, o horário de verão, os fins de semana e os feriados, a correção manual. Para sempre e sem limite de gestores.

O que o PRO acrescenta

O campo «Horário de trabalho do cliente», que o servidor mantém atualizado, e cinco estilos de relógio. $15 por mês pela conta inteira, qualquer que seja o time.

O que o CRM precisa ter

Nada de especial para o que é desenhado na tela: funciona em qualquer plano. O campo de expediente é atualizado por webhooks, que não estão em todos os planos do Kommo. Se o seu não tiver, o resto continua funcionando.

Instalação