Questo errore si verifica quando Make (precedentemente Integromat) non riesce a completare l'handshake OAuth o le chiamate API verso Zoho CRM—tipicamente si riscontrano risposte OAUTHSCOPEMISMATCH, 401/403, o fallimenti intermittenti di "token non valido" durante la creazione o l'esecuzione di scenari.
Cosa significa — spiegazione concreta legata alla superficie API di Zoho
Make sta richiedendo scope OAuth, o sta tentando chiamate API, che non corrispondono alla configurazione OAuth di Zoho CRM o alle autorizzazioni dell'utente connesso. L'API di Zoho applica gruppi di scope e permessi di estensione a livello di amministratore; se gli scope sono mancanti, scaduti, o se l'utente Zoho autorizzato non dispone dell'accesso amministrativo/di estensione richiesto, l'emissione del token o le chiamate API falliscono [1][2]. Incidenti transitori del servizio Zoho o il raggiungimento di quote/limiti possono produrre errori simili a quelli di autenticazione quando le richieste vengono rifiutate a metà flusso [6][7].
Cause comuni
- Scope OAuth errati o incompleti richiesti in Make—gruppi di scope come ZohoCRM.modules.ALL devono corrispondere esattamente a quanto si aspetta l'app [2].
- L'utente Zoho che ha autorizzato la connessione non dispone dei privilegi amministrativi/di estensione richiesti per concedere integrazioni di marketplace o determinati scope dell'API CRM [1].
- Token di accesso o di refresh scaduto, revocato, o non memorizzato correttamente dalla connessione Make, causando ripetuti 401/403 [1].
- Incidenti del servizio Zoho o limiti di rate/quota che bloccano le richieste; gli errori appaiono come fallimenti di autenticazione quando le chiamate vengono limitate o vanno in timeout [6][7].
Come risolverlo
- Ri-autorizzare da Make utilizzando un account amministratore: In Make, elimina la connessione Zoho CRM esistente e creane una nuova accedendo come amministratore di Zoho CRM (Profilo > Setup > Marketplace/Estensioni se hai bisogno di verificare i privilegi di estensione) [1].
- Richiedere scope espliciti: Nella configurazione OAuth di Make, includi gli scope CRM esatti di cui il tuo scenario ha bisogno (ad esempio ZohoCRM.modules.ALL). Evita di combinare gruppi di scope errati che attivano OAUTHSCOPEMISMATCH [2].
- Confermare il ciclo di vita del token: Assicurati che Make riceva e memorizzi sia i token di accesso che quelli di refresh. Se noti scadenze frequenti, forza una nuova concessione OAuth e verifica che le impostazioni del connettore di Make mostrino una connessione attiva.
- Controllare i permessi utente in CRM: Verifica che il profilo dell'utente autorizzante disponga dell'accesso alle estensioni e alle API (Setup > Utenti e Controllo > Controllo Sicurezza / Profili) e che i permessi a livello di modulo coprano le operazioni eseguite da Make [1].
- Escludere incidenti di servizio e limiti: Controlla lo stato di Zoho e l'utilizzo/quota API della tua organizzazione. Se raggiungi i limiti per minuto o giornalieri, regola la cadenza degli scenari o richiedi limiti più alti tramite il supporto Zoho [6][7].
Quando escalare
Escala al supporto Zoho quando la riautorizzazione, gli scope corretti e i controlli dei permessi amministrativi non risolvono l'errore, o quando è necessario un intervento confermato sul lato Zoho o un aggiustamento della quota; includi i log che mostrano il codice di errore esatto, il timestamp e gli scope OAuth utilizzati.
[1]: CRM | Troubleshooting | Knowledge Base
[2]: User permissions for translation (scope-related example)
[6]: Impact/Best Practices when "US Zoho Services Availability - Incident, Zoho Deluge is down"
[7]: Exceed Limit Execution