Un widget Zoho Desk che chiama Sigma (una funzione lato server o un'API esterna) e non restituisce mai nulla è un blocco: il client rimane in attesa, l'interfaccia utente si blocca e non viene visualizzato alcun errore. Ciò significa solitamente che la chiamata alla funzione non viene mai completata o che il percorso di rete è bloccato.
Cosa significa — spiegazione concreta legata alla superficie dell'API Zoho
Quando un widget Desk invoca una funzione Sigma o un'API esterna da un widget o da una funzione Deluge/Server, la richiesta o non raggiunge il servizio di destinazione o la destinazione non risponde mai. I widget chiamano servizi ospitati da Zoho o i tuoi endpoint; se il livello di esecuzione di Zoho (Deluge/Sigma) è inattivo o la chiamata in uscita è bloccata, la chiamata sembrerà bloccarsi senza un evento di completamento per l'interfaccia utente del browser [7] e i widget possono rimanere non reattivi [1][4]. Se il tuo widget chiama la tua API, voci mancanti nella lista consentiti per gli IP in uscita di Zoho causeranno il dropping delle richieste prima che raggiungano il tuo server [3].
Cause comuni
- La tua API esterna o l'endpoint webhook non è raggiungibile da Zoho a causa di firewall o filtraggio IP (IP Zoho mancanti) [3].
- Il livello di esecuzione di Zoho (servizi Deluge/Sigma) sta riscontrando un incidente o un'interruzione; le chiamate alle funzioni vengono messe in coda o non vengono mai completate [7].
- Il codice del widget esegue una richiesta sincrona/bloccante o non gestisce mai i timeout e i rifiuti delle promise, quindi l'interfaccia utente rimane in attesa [1][4].
- Logica lato server di lunga esecuzione o un ciclo infinito nello script Sigma/Deluge causa la mancata restituzione di una risposta [7].
Come risolverlo
- Riproduci con gli strumenti per sviluppatori: apri la Console del browser e la scheda Rete, attiva la chiamata al widget e annota lo stato della richiesta, il tempo di risposta e gli eventuali errori della console. Questo mostra se la chiamata lascia il browser o fallisce prima.
- Conferma la raggiungibilità dell'endpoint da Zoho: se chiami il tuo server, consenti gli IP Zoho o rimuovi temporaneamente la restrizione IP. Richiedi l'elenco corrente degli IP in uscita di Zoho per le chiamate Sigma/Deluge e aggiungili alla tua lista consentiti del firewall [3].
- Aggiungi timeout lato client e gestione degli errori: assicurati che fetch/XHR utilizzi un timeout, gestisci i rifiuti delle promise e mostra un errore chiaro dopo 10-15 secondi anziché bloccare l'interfaccia utente [1][4].
- Controlla lo stato del servizio e i log: ispeziona i log di esecuzione Sigma/Deluge e i log del tuo server per l'ora della richiesta. Se i log di Zoho mostrano che la chiamata è iniziata ma non è stata completata, cerca cicli infiniti o operazioni bloccanti nello script [7].
- Esegui un semplice controllo di integrità: sostituisci la chiamata al widget con un endpoint minimo che restituisca 200 rapidamente. Se questo ha successo, il problema è nella logica della tua funzione; se fallisce, è di rete o lato Zoho.
- Implementa tentativi con backoff esponenziale e idempotenza per operazioni che potrebbero essere interrotte da errori transitori. Questo previene blocchi permanenti quando una singola chiamata fallisce.
Quando escalare
Se i log mostrano che Zoho Deluge/Sigma ha accettato la chiamata ma non l'ha mai completata e non riesci a identificare un percorso di codice che causa il blocco, o se più clienti riscontrano lo stesso comportamento e un controllo di integrità fallisce, apri un ticket di supporto Zoho con timestamp di richiesta/risposta, ID di esecuzione e passaggi per la riproduzione. Il supporto Zoho può controllare le tracce di esecuzione interne e gli incidenti del servizio [7].
[1]: Segnalazioni della community di blocchi dell'app e UI non reattiva.
[3]: Richiesta della community per l'elenco degli IP in uscita di Zoho utilizzati da Widget e Deluge.
[4]: Segnalazione della community di un'operazione di salvataggio bloccata.
[7]: Discussione della community sulla disponibilità del servizio Deluge e su cosa fallisce quando è inattivo.