Errore del connettore CData Looker Studio con Zoho CRM

Questo errore viene visualizzato quando il connettore CData Looker Studio non riesce a completare una chiamata autenticata o autorizzata in Zoho CRM. Looker Studio mostra un errore a livello di connettore anziché un errore dell'applicazione. Il connettore non è in grado di leggere i dati CRM previsti, pertanto i dashboard smettono di popolarsi.

Cosa significa

Il connettore CData non è riuscito a completare una richiesta autenticata tramite OAuth all'API di Zoho CRM o il connettore non dispone dell'accesso ai moduli CRM necessari per eseguire query. L'errore si verifica tra il connettore e gli endpoint CRM di Zoho, piuttosto che all'interno di Looker Studio stesso ^[1][4]. Molti errori di integrazione di questo tipo risalgono a problemi di autenticazione, permessi o configurazione dell'integrazione all'interno dell'account CRM ^[6].

Cause comuni

• Token OAuth scaduto o revocato per il connettore CData: il connettore perde la sua sessione autorizzata e le richieste falliscono ^[1][4].
• Il connettore non dispone dei permessi CRM richiesti o un amministratore non ha approvato l'integrazione marketplace/estensione: le app e i connettori marketplace devono essere installati/approvati da un amministratore ^[6].
• La configurazione o le credenziali del connettore puntano all'account CRM errato o utilizzano credenziali client errate (impostazioni del connettore non corrette) ^[1].
• Versione obsoleta del connettore CData o un bug transitorio del servizio CData che impedisce le chiamate API corrette ^[1].

Come risolverlo

1. Ri-autenticare il connettore: aprire il connettore CData in Looker Studio, rimuovere la connessione Zoho CRM esistente, quindi ri-autorizzare utilizzando l'account Zoho corretto. Verificare che la schermata di consenso OAuth si completi senza errori ^[1][4].
2. Confermare che un amministratore abbia installato/approvato l'integrazione: in Zoho CRM, accedere come amministratore e andare su Setup > Marketplace (App Installate) per confermare che il connettore/estensione sia installato e consentito per gli utenti che ne hanno bisogno ^[6].
3. Verificare che le credenziali e l'account del connettore corrispondano: controllare le impostazioni del connettore CData per l'account/email Zoho utilizzati e confermare che lo stesso account CRM venga utilizzato durante il test delle chiamate API (evitare di utilizzare un utente diverso o un'organizzazione demo) ^[1].
4. Eseguire un controllo API diretto: utilizzare Postman o la console API di Zoho per effettuare una semplice query API CRM o COQL (ad esempio, un select di base) con lo stesso token OAuth per confermare che l'API CRM risponda e che gli ambiti del token includano l'accesso in lettura ai moduli di destinazione ^[6].
5. Aggiornare il connettore e raccogliere i log: assicurarsi che il connettore CData sia sull'ultima build, acquisire i log del connettore o i dettagli dell'errore del connettore di Looker Studio, quindi riprovare. Se l'errore persiste, condividere i log con il supporto CData includendo il testo esatto dell'errore e un timestamp ^[1].

Quando escalare

Se la ri-autenticazione, l'approvazione dell'amministratore e i controlli delle credenziali non ripristinano la connettività, escalare prima al supporto CData con i log del connettore e i passaggi già eseguiti. Se CData determina che il connettore ha emesso chiamate CRM valide ma Zoho le ha rifiutate, aprire un ticket con il supporto Zoho includendo gli stessi log e un esempio di richiesta/risposta API fallita ^[1][7].