✅ Opción A: Pregunta directamente a Zoho (Hazlo hoy mismo)

Abra un ticket de soporte con el soporte de SalesIQ, a través de la ayuda integrada en el producto o la comunidad de Zoho SalesIQ , y formule estas tres preguntas:

1. ¿Existe algún punto final de API o ámbito de OAuth compatible para el estado histórico de disponibilidad del operador?
2. De no ser así, ¿existe alguna solicitud de función o elemento en la hoja de ruta para esto?
3. ¿El informe de disponibilidad del operador se puede exportar o programar en su plan actual?

Solo Zoho puede confirmar si el punto final de la interfaz de usuario interna es intencionalmente privado o si existe una ruta compatible que aún no está documentada. La visibilidad en la comunidad también es importante. Las solicitudes de nuevas funciones con más votos influyen en la hoja de ruta.

✅ Opción B: Consultar el punto final de estado actual y crear un historial propio (la solución alternativa más robusta)

Dado que no existe un punto final histórico, capture instantáneas del estado actual periódicamente y cree el historial usted mismo. Esta es la solución programática más fiable disponible en la actualidad.

Pasos de configuración:

1. Cree un cliente propio en https://api-console.zoho.eu con el ámbito SalesIQ.operators.READ
2. Genera un código de concesión, cámbialo por un token de actualización y guárdalo de forma segura. Nunca lo incluyas en el código fuente.
3. De forma programada (cada 1-5 minutos), actualice el token de acceso y llame a:

 GET https://salesiq.zoho.eu/api/v2/{screen_name}/operators
 Authorization: Zoho-oauthtoken {access_token}

4. Escribe las filas (operator_id, status, observed_at) en una base de datos. Registra solo los cambios, además de una señal de actividad periódica.
5. Calcular duraciones: para cada par consecutivo de registros por operador, duration = next.observed_at − current.observed_at

Qué manipular con cuidado:

• No se admiten datos retroactivos. El historial comienza cuando se inicia el sondeo. No hay forma de recuperar datos anteriores.
• Interrupciones en la recopilación de datos. Si el sistema de recopilación de datos deja de funcionar, marque ese período como "unknown" en lugar de asumir que el último estado conocido se mantuvo. Esto es importante para obtener informes precisos.
• Límite de precisión. Con un intervalo de sondeo de 5 minutos, es posible que no se detecten los cambios de estado que ocurran en menos de 5 minutos. Si la precisión es importante, utilice un intervalo más corto.
• Límites de velocidad. Implementar retroceso exponencial en las respuestas 429 .

Opciones de programación: una tarea programada (cron job), una función en la nube (AWS Lambda, Google Cloud Functions) o, si desea permanecer completamente dentro del ecosistema de Zoho, una función programada de Zoho Flow que utilice una conexión OAuth administrada, la cual se encarga de la actualización del token por usted.

Si sueles crear integraciones personalizadas de Zoho, considera Zoho Creator como una plataforma de bajo código para alojar funciones programadas de Deluge que llaman a la API de SalesIQ, sin necesidad de infraestructura externa.

✅ Opción C: Consulta los informes integrados (la solución más rápida si cubre tus necesidades)

Antes de crear cualquier función personalizada, compruebe qué ofrece ya el módulo de informes de SalesIQ.

El módulo Informes 2.0 incluye informes del operador que abarcan la disponibilidad, el rendimiento y el volumen de chat. Detalles clave:

• Requisito del plan: Reports 2.0 solo está disponible en los planes Professional y Enterprise .
• Granularidad diaria: Para una fecha seleccionada, el informe muestra los cambios de estado en función de las horas. Para rangos de fechas superiores a un día, el informe utiliza agregados basados en inicios de sesión en lugar de cronogramas detallados de cambios de estado.
• Opciones de exportación: Compruebe si su plan admite la exportación a CSV/PDF o el envío programado por correo electrónico. De ser así, puede automatizar la recepción del archivo exportado mediante una regla de buzón y un analizador.

Si los datos agregados cumplen con el requisito de "tiempo dedicado por estado", esta es la opción más rápida. Si necesita marcas de tiempo sin procesar, utilice la opción B.

✅ Opción D: Integraciones nativas de Zoho (Ruta de bajo código)

Varias opciones nativas de Zoho pueden reducir los costos de ingeniería:

Conector Zoho Analytics SalesIQ
Compruebe si los datos de disponibilidad del operador se encuentran entre los módulos sincronizados en el conector Zoho Analytics SalesIQ. Analytics puede programar sincronizaciones y exponer datos a través de su propia API documentada. Si el conector incluye datos de disponibilidad, podría reemplazar el sondeo personalizado.

Zoho Flow con conexión administrada
Zoho Flow permite ejecutar flujos de trabajo programados que llaman a SalesIQ mediante una conexión OAuth administrada, de modo que Zoho gestiona automáticamente la actualización de tokens. Esta es una forma sencilla de implementar el método de sondeo de la Opción B sin tener que gestionar los tokens manualmente. Compruebe si SalesIQ expone un activador de cambio de estado del operador en Flow. Si lo hace, la captura basada en eventos es más precisa que el sondeo.

Combinación de Zoho Flow y Zoho Creator
Para los equipos que ya utilizan Zoho Creator, pueden combinar los activadores de Flow con la base de datos de Creator para almacenar instantáneas de estado en una plataforma totalmente nativa de Zoho. Consulte nuestra guía sobre la integración de Zoho SalesIQ con Zoho Creator mediante Zoho Flow para obtener una explicación práctica.

⚠️ Opción E: Inferir actividad a partir de conversaciones (solo aproximación)

Puedes usar la API de Conversaciones ( SalesIQ.conversations.READ ) para inferir cuándo los operadores estuvieron activos. Sin embargo, muestra cuándo estaban gestionando chats , no cuándo estaban Disponibles, Ocupados o Desconectados. Un operador puede estar Disponible sin conversaciones activas o Ocupado sin chatear activamente.

Este método no es adecuado cuando se requiere precisión en la duración del estado. Úselo solo como una aproximación cuando no haya otra opción disponible.

Opción F: Reproducir el punto final del navegador (último recurso: evitar)

La automatización del navegador sin interfaz gráfica o la reproducción de las cookies de sesión contra el punto final de la interfaz de usuario interna es técnicamente posible, pero conlleva riesgos graves:

• Condiciones del servicio: Es probable que esto infrinja las condiciones de servicio de Zoho sobre el uso de API no compatibles. Revise las condiciones de servicio antes de intentarlo.
• Fragilidad: Las sesiones caducan, la autenticación multifactor puede interrumpir la automatización y los puntos finales internos pueden cambiar sin previo aviso.
• Seguridad: Esto requiere el almacenamiento de las credenciales de usuario, lo cual supone un importante problema de seguridad.

Si cree que esta es su única opción, utilice una cuenta de servicio dedicada, obtenga la aprobación por escrito de Zoho y aíslela completamente de los sistemas de producción. Considérela una medida temporal mientras evalúa la Opción A.