Un errore di connessione F7003 ("OAuth non valido") indica che Zoho CRM non è riuscito ad autorizzare le chiamate a WorkDrive perché l'handshake OAuth o il token non è valido o mancante. Il CRM non può allegare un token di accesso valido alla richiesta WorkDrive.
Cosa significa
Zoho CRM ha tentato una richiesta OAuth 2.0 per WorkDrive, ma la fase di autorizzazione non ha restituito un token utilizzabile o il token non ha potuto essere applicato alla chiamata API. Questo si verifica quando la connessione risulta "Connessa" nel CRM ma le chiamate API restituiscono errori di autenticazione, o quando il reindirizzamento/metadati OAuth non corrispondono alle impostazioni del client registrato [1][3][5].
Cause comuni
- Il token di accesso memorizzato è scaduto o il refresh è fallito, quindi le chiamate vengono inviate senza credenziali valide [1][6].
- Le impostazioni del client OAuth (URI di reindirizzamento, stato o URL di richiesta) non corrispondono alla registrazione dell'app, causando il rifiuto dello scambio di token da parte del provider [3][5].
- La connessione in Developer Hub è stata creata con scope o ID/segreto client errati, quindi i token mancano degli scope WorkDrive richiesti [1][6].
- Un glitch nella gestione delle richieste lato Zoho o uno stato/URL OAuth malformato (caratteri speciali o delimitatori pipe) interrompe il flusso e genera un errore "Invalid request url" o simile [5][7].
Come risolvere
- Riconnetti la connessione WorkDrive in Zoho CRM: vai su Setup → Developer Space → Connections, apri la connessione WorkDrive e fai clic su Riconnetti. Conferma il consenso OAuth e consenti gli scope richiesti [1].
- Verifica le credenziali dell'app e gli URI di reindirizzamento: nella Zoho API Console (o provider OAuth esterno) conferma che l'ID client, il segreto client e l'URI di reindirizzamento esatto corrispondano alle impostazioni della connessione CRM. Correggi eventuali discrepanze e ricrea la connessione se modifichi i valori [3][5].
- Controlla gli scope e i permessi: assicurati che la connessione richieda gli scope WorkDrive necessari per le azioni che esegui. Se hai utilizzato scope personalizzati, aggiornali e riconnetti in modo che il token includa tali scope [6].
- Cancella i token memorizzati nella cache: se la riconnessione non ha aiutato, elimina la connessione e creane una nuova per forzare un flusso di autenticazione completo e nuovi token di accesso + refresh. Testa una chiamata API subito dopo la riconnessione.
- Ispeziona i dettagli dell'errore e i log: acquisisci la risposta completa dell'errore API e i log del CRM (Developer Space → Connections → View Logs) per individuare errori come “CREDENTIALSMISSING”, “invalidscope”, o errori relativi all'URL/stato. Se controlli l'applicazione client, evita caratteri speciali nello stato e problemi di codifica URL che hanno causato errori in passato [1][5][7].
Quando escalare
Apri un ticket di supporto Zoho quando le nuove connessioni e le impostazioni client corrette falliscono ancora, o quando i log mostrano errori lato provider come URLRULENOT_CONFIGURED o comportamento OAuth non standard. Includi i log della connessione, il payload esatto dell'errore, i valori di reindirizzamento OAuth e i timestamp in modo che il supporto possa tracciare lo scambio OAuth [3][5].
[1]: 401 Unauthenticated Error – Zoho CRM to Google Sheets Integration.
[3]: TeamInbox EU: Microsoft 365 not connecting (Invalid URL / URLRULENOT_CONFIGURED).
[5]: Bug: OAuth 2.0 State Parameter fails with Pipe Delimiters (RFC 6749 Non-Compliance).
[6]: Migrating to Oauth 2.0 (Zoho developer docs).
[7]: ChatGPT Plugin / MCP Server auth error (Invalid request url per oauth metadata).