Cómo funciona RegionTime

Qué hace el widget

RegionTime toma el número de la tarjeta y responde a una pregunta: qué hora es donde está esa persona y si está en horario de trabajo. La respuesta aparece encima del número, en un bloque propio de la tarjeta y al crear una tarea.

El cálculo ocurre en el navegador. Las tablas de numeración y de zonas horarias viajan dentro del widget, así que la hora aparece junto con la tarjeta en vez de esperar al servidor. Al servidor solo se pide la configuración, el plan y los campos del CRM.

Cómo un número se convierte en zona horaria

El widget lee el número por prefijo, no por país entero.

• Los países con varias zonas — EE. UU., Brasil, Australia, México, Rusia, Kazajistán — se resuelven por la región del número. Una media del país estaría equivocada en la mayor parte del mapa.
• Los datos son el plan de numeración del conjunto abierto libphonenumber de Google más la base de zonas horarias IANA. Rusia usa además el registro de Rossvyaz, donde los prefijos DEF y ABC están asignados a sujetos federales y estos a zonas.
• Cuando el prefijo no dice nada. Los móviles de muchos países no llevan región alguna. El widget muestra entonces el país y marca la respuesta como aproximada — en cursiva y con borde punteado. Eso es precisión honesta, no un fallo.

Horario de verano

El widget guarda nombres de zonas — America/Mexico_City, Europe/Madrid — y no un desfase ya calculado en horas. El desfase se calcula para la fecha concreta, cada vez.

La diferencia se nota justo donde suele pasarse por alto: una tarea creada en octubre para noviembre se calcula con la hora de noviembre, no con la de hoy. Media Europa y media América se mueven una hora a finales de octubre, y el widget lo sabe.

Junto a la hora puede aparecer un copo de nieve. Significa que esa zona sí cambia de hora y ahora está en horario estándar. Donde no hay cambio — la mayor parte del mundo — el copo no aparece nunca.

Cómo se decide laboral y no laboral

No es solo «si la hora cae dentro de la franja». El widget distingue cuatro estados y colorea la hora en consecuencia.

• Horario laboral — verde. Dentro de la franja, ni fin de semana ni festivo.
• La jornada termina — ámbar. Los últimos 30 minutos: aún se puede llamar, pero no para algo largo.
• Fuera de horario — coral, con una luna.
• Fin de semana o festivo — coral también, con otro icono, para que el motivo se vea.

La franja es 10:00–19:00 por defecto y se cambia en los ajustes. Se aplica a la hora local del cliente, no a la suya.

Festivos y fines de semana

Fines de semana

Sábado y domingo no es una regla universal. En Arabia Saudí, los Emiratos e Israel el fin de semana cae en otros días, y el widget lo toma de los datos del país en vez de por costumbre.

Festivos

El calendario se arma con reglas, no con una lista de fechas de un año: fechas fijas, la Pascua y la Pascua ortodoxa con sus derivadas móviles, construcciones del tipo «el tercer lunes de enero». Así la tabla no caduca en Nochevieja.

La corrección manual y por qué manda

Un número no siempre coincide con un lugar: la gente se muda, se lleva la SIM, mantiene un número dado de alta en otra región.

La corrección queda marcada como manual y sobrevive a la redetección: si el número cambia o la tarjeta se abre de nuevo, el cálculo automático no la sobrescribe. Al revés — un algoritmo borrando la decisión de una persona — significaría que el error no se puede arreglar nunca.

Campos en la tarjeta del CRM

El widget crea su propio grupo de campos — «Región» — y mete ahí solo lo suyo:

• RTZ_TIMEZONE — la zona horaria en formato IANA;
• RTZ_REGION — la región o la ciudad;
• RTZ_COUNTRY — el país;
• RTZ_WORKING — working u off (PRO).

Dónde crearlos — lead, contacto, compañía — se elige por separado, y pueden no crearse en absoluto. Sus campos, estados, etiquetas y notas no se tocan.

El campo para bots y cómo se mantiene al día

«Horario laboral del cliente» es lo único que hay que recalcular de forma continua, y lo único por lo que se cobra.

El servidor no barre la base con un temporizador. Para cada registro calcula el momento en que la respuesta cambia — cuando empieza o termina la jornada del cliente — y solo despierta para él. Los registros cuyo momento llegó se actualizan por lotes: el CRM acepta hasta 250 entidades por petición.

De ahí sale la aritmética que lo hace posible. Cada cliente cambia dos veces al día. Una base de 100 000 contactos son unas 33 peticiones por lote a la hora frente a un límite de 7 peticiones por segundo. Barrer toda la base cada hora — que es como suena a primera vista — no lo sería.

Dónde dibuja el widget

• Encima del número — la hora, la región y el color del estado. Sin borde ni fondo: el campo de la tarjeta ya va enmarcado, y una caja dentro se leería como un botón.
• Un bloque en la columna derecha — dos esferas, el día en una franja y un conversor: arrastre la esfera del cliente para ver qué hora es para usted.
• En el planificador — la hora del cliente para el momento elegido, antes de guardar la tarea.

El widget vigila el redibujado de la tarjeta y devuelve sus elementos a su sitio cuando el CRM rehace la maquetación.

Qué hace el widget con los datos

• La zona se resuelve en el navegador. El número no se envía a ninguna parte para eso.
• En el servidor quedan el identificador de la cuenta, los ajustes, la correspondencia entre entidad y zona, y los dígitos del número — necesarios para recalcular el campo de horario laboral sin llamar al CRM.
• Los tokens de acceso se guardan cifrados y se renuevan una hora antes de caducar. Si se revoca el acceso, el widget lo dice en el centro de notificaciones en vez de callarse.
• Las zonas horarias de los empleados no se recogen por defecto: una zona horaria es un dato aproximado de localización de una persona, y recogerlo debe ser una decisión consciente.

Planes y requisitos

Qué incluye el plan gratuito

Todo lo que lee una persona: hora y región encima del número, el bloque con esferas y conversor, la indicación en el planificador, los campos de zona, región y país, el horario de verano, los fines de semana y los festivos, la corrección manual. Para siempre y sin límite de gestores.

Qué añade PRO

El campo «Horario laboral del cliente», que el servidor mantiene al día, y cinco estilos de reloj. $15 al mes por toda la cuenta, sea cual sea la plantilla.

Qué necesita el CRM

Nada especial para lo que se dibuja en pantalla: funciona en cualquier plan. El campo de horario laboral se actualiza por webhooks, que no están en todos los planes de Kommo. Si el suyo no los tiene, el resto sigue funcionando.

Instalación