Questo errore si verifica quando la chiamata API di Zoho CRM/prodotti Zoho correlati che dovrebbe restituire i fallimenti delle funzioni personalizzate restituisce invece HTTP 204 (No Content) o un corpo 200 vuoto, mentre l'interfaccia utente web di Zoho mostra ancora funzioni fallite. L'API attualmente non dispone di un endpoint "function-failures" documentato, quindi il client vede "nessun fallimento" anche se la vista Fallimenti nel prodotto elenca errori reali.[1]
Cosa significa — spiegazione concreta legata all'API di Zoho
L'API pubblica del prodotto non espone lo stesso report dei fallimenti delle funzioni utilizzato dall'interfaccia utente; i chiamanti degli endpoint tentati raggiungono un percorso non documentato o un endpoint che restituisce intenzionalmente 204/200 vuoto quando non esiste un feed di fallimenti a livello API. Questa discrepanza produce una risposta API vuota anche quando l'interfaccia utente ha voci per fallimenti di funzioni personalizzate o errori di script di workflow.[1]
Cause comuni
- Hai chiamato un endpoint non documentato o non supportato (non esiste un'API ufficiale per i fallimenti delle funzioni nel riferimento).[ ^1]
- Hai interrogato l'endpoint del prodotto o del data center (DC) errato e hai raggiunto un percorso che restituisce 204 per richieste cross-DC o non corrispondenti.[1]
- Il tuo token di accesso o scope non dispone dei diritti per visualizzare l'automazione o le funzioni, causando la soppressione dei risultati da parte dell'API.[1]
- Hai tentato di riutilizzare un percorso webhook-failures; i webhook-failures sono documentati ma non segnalano i fallimenti delle funzioni personalizzate.[1]
Come risolvere
- Conferma il riferimento API: controlla la documentazione API ufficiale di Zoho per il tuo prodotto e DC per verificare se è disponibile un endpoint per i fallimenti delle funzioni. Se nessun endpoint è documentato, pianifica di utilizzare invece l'interfaccia utente o i log dell'applicazione.[1]
- Utilizza la vista Fallimenti dell'interfaccia utente per una triage immediata: apri Zoho CRM (o il prodotto che esegue le funzioni) > Impostazioni > Automazione > Funzioni/Fallimenti per visualizzare e rieseguire le funzioni fallite. Copia i timestamp e i nomi delle funzioni per la registrazione.[1]
- Se devi automatizzare: strumenta le tue funzioni per registrare i fallimenti in un archivio ricercabile (Zoho Analytics, un webhook personalizzato o un servizio di logging esterno) quando catturano eccezioni. Ciò ti fornisce uno stream di fallimenti accessibile tramite API indipendente dal visualizzatore di fallimenti interno del prodotto.
- Verifica gli scope OAuth e il DC: conferma che il client OAuth utilizzi gli scope che consentono la lettura dei metadati di automazione/funzioni e che l'URL di base dell'API corrisponda al DC dell'organizzazione. Riprova dopo aver corretto gli scope o l'URL di base.[1]
- Raccogli prove e riproduci: acquisisci la richiesta/risposta API (header, URL, corpo, stato HTTP), la riga di fallimento dell'interfaccia utente (nome funzione, ora, messaggio di errore) e il DC dell'account. Prepara questi elementi prima di contattare il supporto Zoho.[1]
Quando escalare
Apri un ticket di supporto Zoho quando puoi riprodurre la discrepanza con i log delle richieste e lo screenshot dell'interfaccia utente; includi timestamp, dump di richieste/risposte e l'account/DC interessato. Escala se ciò blocca il recupero dell'automazione o se hai bisogno di un'API ufficiale per il monitoraggio dei fallimenti oltre i controlli manuali dell'interfaccia utente.