Come recuperare la configurazione di invio email in Zoho

Recuperare la configurazione di invio email in Zoho CRM è semplice tramite un singolo endpoint API delle impostazioni che restituisce la configurazione della posta in uscita per la tua organizzazione.

Perché è importante

Quando hai bisogno di verificare, risolvere problemi o ispezionare programmaticamente come sono configurate le email in uscita in Zoho CRM, hai bisogno di un modo affidabile per estrarre quei dati senza navigare attraverso più schermate dell'interfaccia utente. Questo è particolarmente utile per i consulenti che effettuano l'onboarding di un nuovo cliente, per gli sviluppatori che creano integrazioni, o per gli amministratori che verificano che l'identità di invio corretta sia configurata. Comprendere la chiamata API ti consente inoltre di automatizzare i controlli della configurazione come parte di un flusso di lavoro di verifica dello stato più ampio.

Procedura passo dopo passo

Passaggio 1. Assicurati che la tua connessione a Zoho CRM sia autenticata e che il tuo token di accesso sia valido. Il flusso OAuth richiede una sessione connessa prima che qualsiasi endpoint delle impostazioni possa essere raggiunto — se la connessione è assente o scaduta, l'API rifiuterà la richiesta. ^[3]

Passaggio 2. Verifica che i tuoi scope OAuth includano le autorizzazioni necessarie a livello di organizzazione CRM. Il set di scope utilizzato per Zoho CRM deve coprire ZohoCRM.org.ALL (o almeno l'accesso in lettura alle impostazioni dell'organizzazione) affinché gli endpoint delle impostazioni siano accessibili al tuo token. ^[7]

Passaggio 3. Invia una richiesta GET all'endpoint /settings/sendmailconfig. Questa è l'operazione dedicata — denominata getsendmail_config — nella categoria delle impostazioni Mail & Social dell'API di Zoho CRM. ^[5]

GET /settings/send_mail_config

In Python, utilizzando il wrapper client CRM, la chiamata si presenta così: ^[5]

def get_send_mail_config(self):
    return self.c.request("GET", "/settings/send_mail_config")

Passaggio 4. Analizza l'oggetto di risposta restituito dall'endpoint. Il risultato conterrà le impostazioni della posta in uscita della tua organizzazione. Archivia o registra questi dati secondo le necessità per la tua verifica o logica di integrazione. ^[5]

Passaggio 5. Se stai lavorando in un ambiente multi-app (CRM + Desk), assicurati di puntare specificamente al client API CRM — non al client Desk — poiché /settings/sendmailconfig è un endpoint con scope CRM. Il parametro app_type nel livello di connessione controlla quale client API viene istanziato. ^[1]

---

> Nota: Beam Help è un servizio di supporto esperto indipendente per Zoho — non siamo il supporto ufficiale di Zoho. Per problemi di fatturazione o a livello di account, contatta direttamente Zoho.

---

Errori comuni

• Nessuna connessione attiva. Se il record zoho_connections per l'utente corrente è assente o il token è scaduto, il livello API restituirà un errore come *"Zoho is not connected for this app. Please reconnect."* Verifica sempre lo stato della connessione prima di chiamare gli endpoint delle impostazioni. ^[1]
• Data center errato. Il token OAuth e il dominio API sono legati al data center (com, eu, in, ecc.) registrato al momento dello scambio del token. Inviare una richiesta al dominio regionale errato comporterà un errore di autenticazione. Controlla il valore api_domain restituito durante lo scambio del codice OAuth. ^[3]
• Scope insufficienti. Se ZohoCRM.org.ALL non è stato incluso al momento della concessione del consenso OAuth, l'endpoint delle impostazioni restituirà un errore di autorizzazioni. Potrebbe essere necessario revocare il token esistente e ri-autorizzare con l'elenco di scope corretto. ^[7]

Cosa verificare

• Validità del token: Conferma che il token di accesso non sia scaduto e che sia disponibile un token di aggiornamento valido per ottenerne uno nuovo se necessario. ^[3]
• Copertura degli scope: Verifica che ZohoCRM.org.ALL sia presente negli scope concessi durante l'autorizzazione OAuth. ^[7]
• Client API corretto: Assicurati che la richiesta venga instradata attraverso il client API CRM (non Desk) e che app_type sia impostato su "crm" nella configurazione della connessione. ^[1]