L'appel de fonction Sigma du widget Zoho Desk se bloque indéfiniment

Un widget Zoho Desk qui appelle Sigma (une fonction côté serveur ou une API externe) et ne revient jamais est un blocage : le client reste en attente, l'interface utilisateur se fige et aucune erreur n'apparaît. Cela signifie généralement que l'appel de fonction n'aboutit jamais ou que le chemin réseau est bloqué.

Ce que cela signifie — explication concrète liée à la surface de l'API Zoho

Lorsqu'un widget Desk invoque une fonction Sigma ou une API externe à partir d'un widget ou d'une fonction Deluge/Serveur, la requête n'atteint pas le service cible ou la cible ne répond jamais. Les widgets appellent des services hébergés par Zoho ou vos points de terminaison ; si la couche d'exécution de Zoho (Deluge/Sigma) est en panne ou si l'appel sortant est bloqué, l'appel semblera se bloquer sans événement de complétion pour l'interface utilisateur du navigateur ^[7] et les widgets peuvent rester non réactifs ^[1][4]. Si votre widget appelle votre propre API, des entrées manquantes dans la liste d'autorisation IP pour les IP sortantes de Zoho entraîneront le rejet des requêtes avant qu'elles n'atteignent votre serveur ^[3].

Causes courantes

• Votre API externe ou votre point de terminaison webhook est inaccessible depuis Zoho en raison d'un pare-feu ou d'un filtrage IP (IP Zoho manquantes) ^[3].
• La couche d'exécution de Zoho (services Deluge/Sigma) connaît un incident ou une panne ; les appels de fonction sont mis en file d'attente ou n'aboutissent jamais ^[7].
• Le code du widget effectue une requête synchrone/bloquante ou ne gère jamais les délais d'attente et les rejets de promesses, de sorte que l'interface utilisateur reste en attente ^[1][4].
• Une logique côté serveur de longue durée ou une boucle infinie dans le script Sigma/Deluge empêche le retour d'une réponse ^[7].

Comment le résoudre

1. Reproduire avec les outils de développement : ouvrez la console du navigateur et l'onglet Réseau, déclenchez l'appel du widget et notez le statut de la requête, le temps de réponse et les éventuelles erreurs de console. Cela montre si l'appel quitte le navigateur ou échoue plus tôt.
2. Confirmer l'accessibilité du point de terminaison depuis Zoho : si vous appelez votre propre serveur, autorisez les IP Zoho ou supprimez temporairement la restriction IP. Demandez la liste actuelle des IP sortantes de Zoho pour les appels Sigma/Deluge et ajoutez-les à votre liste d'autorisation de pare-feu ^[3].
3. Ajouter des délais d'attente côté client et une gestion des erreurs : assurez-vous que fetch/XHR utilise un délai d'attente, gérez les rejets de promesses et affichez une erreur claire après 10 à 15 secondes au lieu de bloquer l'interface utilisateur ^[1][4].
4. Vérifier la santé du service et les journaux : inspectez les journaux d'exécution Sigma/Deluge et vos journaux serveur pour l'horodatage de la requête. Si les journaux Zoho montrent que l'appel a commencé mais ne s'est pas terminé, recherchez des boucles infinies ou des opérations bloquantes dans le script ^[7].
5. Exécuter un simple contrôle de santé : remplacez l'appel du widget par un point de terminaison minimal qui renvoie rapidement 200. Si cela réussit, le problème se situe dans la logique de votre fonction ; si cela échoue, il s'agit d'un problème réseau ou côté Zoho.
6. Implémenter des nouvelles tentatives avec backoff exponentiel et idempotence pour les opérations qui pourraient être interrompues par des échecs transitoires. Cela évite les blocages permanents lorsqu'un seul appel échoue.

Quand escalader

Si les journaux montrent que Zoho Deluge/Sigma a accepté l'appel mais ne l'a jamais terminé et que vous ne parvenez pas à identifier un chemin de code provoquant le blocage, ou si plusieurs clients constatent le même comportement et qu'un contrôle de santé échoue, ouvrez un ticket de support Zoho avec les horodatages des requêtes/réponses, les ID d'exécution et les étapes de reproduction. Le support Zoho peut vérifier les traces d'exécution internes et les incidents de service ^[7].

^[1]: Rapports communautaires de blocages d'applications et d'interfaces utilisateur non réactives.

^[3]: Demande communautaire de la liste des IP sortantes de Zoho utilisées par les Widgets et Deluge.

^[4]: Rapport communautaire d'une opération de sauvegarde bloquée.

^[7]: Discussion communautaire sur la disponibilité du service Deluge et ce qui échoue lorsqu'il est en panne.