I modelli email di Zoho CRM non vengono caricati o le email non vengono inviate quando richiamati dall'API se il modello è mancante, malformato o il contesto di chiamata non dispone degli scope o dei dati di campo corretti. Questo errore appare solitamente come un payload del modello vuoto, HTTP 200 senza contenuto o errori API che fanno riferimento a input o permessi non validi.
Cosa significa — spiegazione concreta legata alla superficie API di Zoho [2][3][6]
La funzionalità Modelli Email del CRM memorizza modelli HTML o drag-and-drop a cui l'interfaccia utente e l'API del CRM fanno riferimento quando inviano messaggi. Quando una chiamata API per inviare o recuperare un modello restituisce un corpo vuoto, un errore o non riesce ad allegare il modello, sta accadendo una di queste cose: il record del modello non viene trovato o pubblicato, l'HTML del modello contiene elementi non supportati o campi di unione, oppure il chiamante non presenta gli scope OAuth corretti o gli input a livello di record richiesti dall'API di invio o dalla funzione sendmail di Deluge [2][3][6].
Cause comuni
- Il modello è ancora una bozza, non pubblicato o archiviato in una cartella/organizzazione diversa da quella a cui l'API caller può accedere [2][3].
- Il modello utilizza campi di unione o componenti che fanno riferimento a campi CRM mancanti o HTML non supportato, quindi l'API restituisce contenuto vuoto o rimuove il corpo [2][3].
- Il token OAuth manca degli scope CRM corretti (invio email / accesso ai modelli) o il token appartiene a un utente senza permesso di visualizzare quel modello [6][5].
- Gli input Deluge o Flow passano tipi errati o omettono campi richiesti (ad esempio, campi booleani/contatto), causando il fallimento della chiamata di invio anche se il recupero del modello appare normale [4][6].
- Disallineamento del servizio o dell'endpoint regionale: chiamare l'endpoint del datacenter Zoho errato può restituire 200 con dettagli vuoti per oggetti archiviati in un'altra regione [1].
Come risolvere
- Conferma che il modello sia pubblicato e visibile: apri CRM > Setup > Modelli > Modelli Email e verifica che il modello sia pubblicato e nella cartella prevista [2][3].
- Testa il recupero del modello con l'endpoint API e il token corretti: chiama GET https://www.zohoapis.com/crm/v2/settings/templates o l'endpoint del modello specifico del modulo per la tua regione e conferma che il JSON includa il corpo del modello. Se hai un account regionale, chiama il dominio corrispondente (zoho.eu, zoho.in) [1].
- Valida i campi di unione e l'HTML: rimuovi o sostituisci i tag non supportati e assicurati che ogni campo di unione corrisponda a un nome di campo CRM esistente; quindi salva e pubblica nuovamente il modello [2][3].
- Controlla gli scope OAuth e i permessi utente: assicurati che il token OAuth abbia gli scope ZohoCRM.modules.* e di invio email richiesti dal tuo codice o dalla funzione Deluge e che l'utente del token possa visualizzare/inviare quel modello [6][5]. Ri-autorizza se gli scope mancano.
- Verifica i tipi di dati e gli input richiesti nella tua chiamata: per sendmail Deluge o gli endpoint di invio API, passa gli ID record e i campi richiesti nei tipi previsti (booleani come true/false, non "1" o stringa vuota) e gestisci i null prima di chiamare [4][6].
- Riprova dall'endpoint regionale corretto se la tua organizzazione si trova al di fuori del datacenter globale; conferma che l'ID organizzazione e il dominio corrispondano al tuo token. Se vedi HTTP 200 ma campi vuoti, è probabile un disallineamento regionale [1].
Quando escalare
Escala al Supporto Zoho se confermi che il modello è pubblicato, il tuo token ha gli scope corretti e l'endpoint regionale è corretto, ma l'API restituisce ancora contenuto vuoto o errori del server; includi le intestazioni della richiesta/risposta API, l'ID del modello e l'ID dell'account utente in modo che il Supporto possa tracciare la richiesta.