Come recuperare i connettori in Zoho CRM

Recuperare i connettori in Zoho CRM significa accedere ai collegamenti di autenticazione che permettono al tuo account CRM di comunicare con servizi di terze parti — e capire come referenziarli correttamente all'interno delle tue funzioni Deluge.

Perché è importante

I connettori (chiamati anche Connessioni) fungono da ponte di autenticazione tra Zoho CRM e le applicazioni esterne. Quando crei una funzione che chiama un servizio esterno, devi conoscere il nome del collegamento del connettore e il suo stato attuale prima di poterlo invocare in modo affidabile. ^[8] Che tu stia recuperando dati di campagna da MailChimp o interrogando un'API REST esterna, il connettore deve essere configurato e recuperabile prima che qualsiasi codice di integrazione funzioni. ^[1]

> Nota: Beam Help è un servizio di supporto esperto indipendente per Zoho — non siamo il supporto ufficiale Zoho.

---

Procedura passo dopo passo

Passaggio 1. Accedi al tuo account Zoho CRM e vai su Impostazioni. Da lì, individua la sezione Developer Space (o Developer Hub) nel menu a sinistra. È qui che risiede tutta la configurazione di connettori e funzioni. ^[1]

Passaggio 2. All'interno dell'area sviluppatori, seleziona Connessioni (a volte etichettata come Connettori a seconda della versione del CRM). Questa sezione elenca ogni collegamento di autenticazione già creato dalla tua organizzazione, insieme al suo stato attuale. ^[8]

Passaggio 3. Nell'elenco delle Connessioni, individua il connettore che desideri recuperare. Ogni voce mostra tre informazioni chiave: il Nome del collegamento, il Nome del servizio (l'applicazione di terze parti verso cui si autentica) e lo Stato della connessione (attiva o inattiva). ^[1]

Passaggio 4. Fai clic su un connettore specifico per aprire la sua vista di dettaglio. Qui troverai il frammento di codice generato automaticamente che mostra esattamente come referenziare questo connettore all'interno di una funzione Deluge. Il campo Connection in quel frammento corrisponde direttamente al nome del collegamento che hai visto nell'elenco. ^[1]

Passaggio 5. Copia il nome del collegamento dalla vista di dettaglio. Questa stringa è ciò che passerai come parametro connection ogni volta che utilizzi un'attività Invoke URL in una funzione Deluge per chiamare il servizio di terze parti. ^[1]

Passaggio 6. Se hai bisogno che il connettore venga utilizzato come sorgente per la funzionalità Query, vai su Impostazioni → Developer Space → Query, quindi aggiungi una nuova sorgente REST API. In quel modulo puoi specificare l'URL base, i parametri predefiniti, le intestazioni e — aspetto fondamentale — selezionare la connessione (connettore) esistente da un menu a tendina per autenticare la query. ^[7]

Passaggio 7. Per verificare che il connettore funzioni correttamente dall'inizio alla fine, referenzialo all'interno di una funzione di test utilizzando l'attività Invoke URL. L'editor di funzioni mostrerà il nome del collegamento della connessione nel contesto, e potrai eseguire una chiamata di test per confermare che il servizio di terze parti risponda come previsto. ^[1]

---

Errori comuni

• Maiuscole/minuscole errate nel nome del collegamento: Il nome del collegamento è sensibile alle maiuscole quando viene referenziato nel codice Deluge. Copialo esattamente come mostrato nella pagina di dettaglio del connettore — non riscriverlo manualmente. ^[1]

• Stato inattivo: Se lo stato del connettore risulta inattivo o scaduto, il token di autenticazione potrebbe essere scaduto. Dovrai ri-autorizzare la connessione prima che qualsiasi funzione che la referenzia abbia successo. ^[8]

• Domini attendibili mancanti per le sorgenti database: Se stai utilizzando la funzionalità Query con un connettore REST API e l'host non è in formato indirizzo IP, devi aggiungerlo ai Domini Attendibili nelle impostazioni del CRM e inserire nella whitelist gli IP di Zoho CRM sul lato del server relay. Saltare questo passaggio causerà timeout di connessione anche quando il connettore stesso appare attivo. ^[7]

• Scope del connettore vs. scope della funzione: Le connessioni possono essere invocate da funzioni e widget, ma al connettore devono essere stati concessi gli scope OAuth corretti per il servizio di terze parti al momento della creazione. Recuperare un connettore configurato con scope insufficienti comporterà errori di autorizzazione in fase di esecuzione, non nella fase di recupero. ^[8]

---

Cosa verificare

• Il nome del collegamento è esatto: Conferma che il nome del collegamento copiato dalla vista di dettaglio del connettore corrisponda carattere per carattere a quello presente nel parametro connection della tua funzione Deluge. ^[1]
• Lo stato è attivo: Nell'elenco delle Connessioni, verifica che la colonna dello stato del connettore mostri uno stato attivo/connesso prima di distribuire qualsiasi funzione che dipende da esso. ^[1]
• La sorgente è configurata per le Query (se applicabile): Se stai utilizzando il connettore come sorgente REST API all'interno della funzionalità Query, conferma che l'URL base, le intestazioni e il riferimento alla connessione siano tutti compilati correttamente nella configurazione della sorgente. ^[7]