Come recuperare le funzioni in Zoho

Recuperare le funzioni in Zoho CRM ti permette di individuare, esaminare e riutilizzare la logica personalizzata già distribuita nella tua organizzazione — risparmiando tempo ed evitando codice duplicato nelle automazioni.

Perché è importante

Quando il tuo team crea automazioni, workflow o integrazioni, le funzioni personalizzate si accumulano rapidamente. Poter recuperare e ispezionare quelle funzioni significa che puoi verificare la logica prima di attivarla, richiamare una funzione dall'interno di un'altra e passare i parametri corretti senza dover fare supposizioni. Questo è particolarmente rilevante quando si collega Zoho CRM a servizi esterni o ad altri prodotti Zoho. In qualità di supporto esperto indipendente (non supporto ufficiale Zoho), Beam Help ti guida attraverso i passaggi chiave qui di seguito.

Procedura passo dopo passo

Passaggio 1. Vai all'area delle impostazioni Funzioni all'interno della tua applicazione Zoho. Per Zoho CRM, vai su Configurazione → Spazio sviluppatore → Funzioni. Qui vengono elencate tutte le funzioni personalizzate disponibili nel tuo account, incluse quelle standalone che possono essere richiamate esternamente. ^[1]

Passaggio 2. Identifica la funzione che desideri recuperare. Ogni funzione ha un nome univoco (ad esempio, createcontact1) che fa parte del suo endpoint di esecuzione. Prendi nota di questo nome — ti servirà per richiamare o ispezionare la funzione in modo programmatico. ^[1]

Passaggio 3. Per recuperare o richiamare una funzione dall'interno di un'altra funzione, utilizza il task Deluge invokeurl. Costruisci la richiesta puntando all'endpoint di esecuzione della funzione. Per Zoho FSM il pattern è il seguente:

rest = invokeurl
[
  url: "https://fsm.zoho.com/fsm/v1/functions/<function_name>/actions/execute?auth_type=oauth"
  type: GET
  parameters: {"Last_Name":"Robins","Email":"lucy.robins@zylker.com"}
  headers: Map()
  connection: "fsm"
];
return rest;

Adatta l'URL di base e il nome della connessione al tuo ambiente Zoho CRM. ^[1]

Passaggio 4. Autentica correttamente la richiesta. Le chiamate a funzioni standalone richiedono OAuth. Avrai bisogno di un Access Token valido ottenuto da https://accounts.zoho.com/oauth/v2/token, e lo scope deve includere l'autorizzazione appropriata per le funzioni (ad esempio, ZohoFSM.settings.functions.CREATE in FSM — verifica lo scope CRM equivalente nella tua console sviluppatore). ^[5]

Passaggio 5. Esamina il payload della risposta. Quando la funzione viene eseguita correttamente, i messaggi di log info emessi dalla funzione vengono restituiti sotto la chiave userMessage, mentre il valore di ritorno effettivo della funzione appare sotto la chiave output. Usa queste chiavi per verificare che la funzione sia stata eseguita come previsto e per estrarre i dati necessari. ^[5]

Passaggio 6. Se hai bisogno di richiamare la funzione da un'automazione workflow anziché da un'altra funzione, puoi collegarla tramite un'azione workflow Funzione personalizzata. All'interno dell'editor Deluge per quell'azione, utilizza lo stesso pattern invokeurl descritto sopra, fornendo l'URL corretto, il metodo HTTP (GET o POST), i parametri e il nome della connessione. ^[7]

Passaggio 7. Per gestire la funzione dopo il recupero — ad esempio per modificarne la logica, clonarla per un nuovo caso d'uso o rimuovere una versione obsoleta — torna all'elenco Funzioni in Configurazione e utilizza il menu delle azioni inline accanto al nome della funzione. Le opzioni disponibili includono Modifica, Elimina e Clona. ^[1]

Errori comuni

• Metodo HTTP errato per il tipo di input. I parametri possono essere passati tramite GET (aggiunti alla query string) o POST (nel corpo della richiesta). Confonderli causa la ricezione di input vuoti da parte della funzione. Assicurati sempre che il metodo corrisponda a come la tua funzione legge APIRequest. ^[5]
• Scope OAuth mancante o errato. Se l'access token è stato generato senza lo scope delle funzioni richiesto, la chiamata API verrà rifiutata. Rigenera il token con lo scope corretto prima di riprovare. ^[5]
• Richiamare una funzione che non è standalone. Solo le funzioni esplicitamente pubblicate come standalone possono essere chiamate tramite il pattern URL esterno. Le funzioni solo per workflow non sono raggiungibili in questo modo. ^[1]
• Input di ricerca multipli nelle azioni di recupero. Quando si recuperano record come parte della logica di una funzione, fornire troppi input di campo univoci può produrre un comportamento di corrispondenza AND/OR inatteso. Utilizza il numero minimo di campi univoci necessari per identificare un record. ^[8]

Cosa verificare

• Conferma che il nome della funzione nell'URL corrisponda esattamente al nome mostrato nell'elenco Funzioni — una singola differenza di carattere restituirà un errore 404. ^[1]
• Verifica che la chiave output nella risposta contenga il valore di ritorno atteso prima di costruire la logica a valle che dipende da esso. ^[5]
• Assicurati che la connessione OAuth referenziata nel parametro connection di invokeurl sia attiva e non sia scaduta o revocata. ^[7]