La llamada a la función Sigma del widget de Zoho Desk se cuelga indefinidamente

Un widget de Zoho Desk que llama a Sigma (una función del lado del servidor o una API externa) y nunca regresa es un bloqueo: el cliente permanece esperando, la interfaz de usuario se congela y no aparece ningún error. Esto generalmente significa que la llamada a la función nunca se completa o la ruta de red está bloqueada.

Qué significa — explicación concreta ligada a la superficie de la API de Zoho

Cuando un widget de Desk invoca una función Sigma o una API externa desde un widget o una función Deluge/Server, la solicitud o no llega al servicio de destino o el destino nunca responde. Los widgets llaman a servicios alojados por Zoho o a sus puntos finales; si la capa de ejecución de Zoho (Deluge/Sigma) está caída o la llamada saliente está bloqueada, la llamada parecerá colgarse sin un evento de finalización para la interfaz de usuario del navegador ^[7] y los widgets pueden permanecer sin respuesta ^[1][4]. Si su widget llama a su propia API, las entradas faltantes en la lista de permitidos para las IP salientes de Zoho harán que las solicitudes se descarten antes de que lleguen a su servidor ^[3].

Causas comunes

• Su API externa o punto final de webhook no es accesible desde Zoho debido a un firewall o filtrado de IP (faltan las IP de Zoho) ^[3].
• La capa de ejecución de Zoho (servicios Deluge/Sigma) está experimentando un incidente o interrupción; las llamadas a funciones se ponen en cola o nunca se completan ^[7].
• El código del widget realiza una solicitud síncrona/bloqueante o nunca maneja tiempos de espera y rechazos de promesas, por lo que la interfaz de usuario permanece esperando ^[1][4].
• La lógica del lado del servidor de larga ejecución o un bucle infinito en el script Sigma/Deluge provoca que no se devuelva ninguna respuesta ^[7].

Cómo solucionarlo

1. Reproduzca con herramientas de desarrollador: abra la Consola del navegador y la pestaña Red, active la llamada del widget y anote el estado de la solicitud, el tiempo de respuesta y cualquier error de consola. Esto muestra si la llamada sale del navegador o falla antes.
2. Confirme la accesibilidad del punto final desde Zoho: si llama a su propio servidor, permita las IP de Zoho o elimine temporalmente la restricción de IP. Solicite la lista actual de IP salientes de Zoho para llamadas Sigma/Deluge y agréguelas a la lista de permitidos de su firewall ^[3].
3. Agregue tiempos de espera y manejo de errores del lado del cliente: asegúrese de que fetch/XHR use un tiempo de espera, maneje los rechazos de promesas y muestre un error claro después de 10-15 segundos en lugar de colgar la interfaz de usuario ^[1][4].
4. Verifique el estado del servicio y los registros: inspeccione los registros de ejecución de Sigma/Deluge y los registros de su servidor para ver la marca de tiempo de la solicitud. Si los registros de Zoho muestran que la llamada comenzó pero no terminó, busque bucles infinitos u operaciones de bloqueo en el script ^[7].
5. Ejecute una verificación de estado simple: reemplace la llamada del widget con un punto final mínimo que devuelva 200 rápidamente. Si eso tiene éxito, el problema está en la lógica de su función; si falla, es de red o del lado de Zoho.
6. Implemente reintentos con retroceso exponencial e idempotencia para operaciones que puedan interrumpirse por fallas transitorias. Esto evita bloqueos permanentes cuando una sola llamada falla.

Cuándo escalar

Si los registros muestran que Zoho Deluge/Sigma aceptó la llamada pero nunca se completó y no puede identificar una ruta de código que cause el bloqueo, o si varios clientes ven el mismo comportamiento y una verificación de estado falla, abra un ticket de soporte de Zoho con las marcas de tiempo de solicitud/respuesta, IDs de ejecución y pasos de reproducción. El soporte de Zoho puede verificar rastreos de ejecución internos e incidentes de servicio ^[7].

^[1]: Informes de la comunidad sobre bloqueos de aplicaciones e interfaz de usuario no receptiva.

^[3]: Solicitud de la comunidad de la lista de IP salientes de Zoho utilizada por Widgets y Deluge.

^[4]: Informe de la comunidad de una operación de guardado que se cuelga.

^[7]: Discusión de la comunidad sobre la disponibilidad del servicio Deluge y qué falla cuando está caído.