Come recuperare un'azione personalizzata in Zoho CRM

Recuperare un'azione personalizzata in Zoho CRM ti consente di ispezionare, riutilizzare o risolvere i problemi delle azioni automatizzate — come aggiornamenti di campi, notifiche email, webhook e funzioni — che guidano i tuoi flussi di lavoro di vendita e marketing. Qui su Beam Help (supporto esperto indipendente per Zoho, non supporto ufficiale Zoho), ti guidiamo esattamente su come individuare e revisionare queste azioni.

Perché è importante

Le azioni personalizzate in Zoho CRM sono i mattoni fondamentali dell'automazione: si attivano quando vengono innescate regole di workflow, blueprint o processi di approvazione. Se un'azione si comporta in modo anomalo, è duplicata o deve essere riutilizzata in una nuova regola, devi prima sapere come recuperarla e ispezionarla. Capire dove risiedono queste azioni è utile anche quando vuoi associare una funzione o un webhook esistente a un nuovo workflow invece di ricrearlo da zero. ^[8]

Procedura passo dopo passo

Passaggio 1. Accedi al tuo account Zoho CRM e vai su Impostazioni (l'icona a forma di ingranaggio nell'angolo in alto a destra). Questo è il centro di controllo per tutte le configurazioni di personalizzazione e automazione. ^[8]

Passaggio 2. All'interno delle Impostazioni, vai su Automazione e seleziona Azioni. Questa sezione elenca ogni azione configurata nel tuo CRM — inclusi task di workflow, aggiornamenti di campi, notifiche email, webhook e funzioni associate. ^[8]

Passaggio 3. Nella pagina Azioni vedrai il catalogo completo delle azioni salvate, raggruppate per tipo. Sfoglia l'elenco o usa la barra di ricerca per individuare l'azione personalizzata specifica di cui hai bisogno. L'elenco mostra il nome dell'azione, il tipo e il modulo a cui appartiene, rendendo semplice identificare la voce corretta. ^[8]

Passaggio 4. Fai clic sul nome dell'azione che vuoi recuperare. Si apre la visualizzazione dettagliata dove puoi ispezionare ogni impostazione — ad esempio, i campi che vengono aggiornati, lo script della funzione allegato o l'endpoint webhook configurato. ^[8]

Passaggio 5. Se l'azione personalizzata coinvolge una funzione (uno script Deluge), la visualizzazione dettagliata mostrerà il blocco di codice e i riferimenti alle connessioni utilizzati per richiamare servizi esterni. Le connessioni sono identificate da un Link name, e il blocco di codice stesso mostra il metodo HTTP (GET, POST, PUT o DELETE) e gli eventuali parametri dinamici che la funzione passa in fase di esecuzione. ^[7]

Passaggio 6. Per riutilizzare l'azione in un'altra regola di workflow, torna all'editor della regola di workflow, scorri fino alla sezione Azioni e scegli Associa. Il menu a tendina mostrerà tutte le azioni precedentemente create del tipo pertinente, così puoi collegare l'azione recuperata senza doverla ricostruire. ^[8]

Passaggio 7. Se l'azione che stai cercando è collegata a un connettore (un'integrazione con un servizio di terze parti), vai su Impostazioni → Spazio sviluppatore → Connessioni. Qui puoi visualizzare il Link name, il nome del servizio e lo stato attuale di ogni connessione, insieme allo snippet di codice pronto all'uso per richiamarla all'interno di una funzione. ^[7]

Errori comuni

• L'azione non appare nell'elenco. Le azioni sono specifiche per modulo in alcuni contesti. Se non riesci a trovare un'azione, verifica di stare cercando nell'ambito del modulo corretto — un'azione creata per i Lead non apparirà automaticamente quando si modifica un workflow per i Contatti. ^[8]
• Lo stato della connessione è inattivo. Quando recuperi un'azione basata su funzione, verifica sempre che la connessione associata mostri uno stato Attivo in Impostazioni → Connessioni. Una connessione inattiva causerà il fallimento silenzioso della funzione in fase di esecuzione. ^[7]
• I parametri dinamici restituiscono valori vuoti. Se l'azione recuperata utilizza parametri per estrarre dati specifici del record (come il nome o l'email di un lead), verifica che le mappature dei parametri facciano ancora riferimento a nomi API di campo validi. I nomi API dei campi possono cambiare se un campo viene eliminato e ricreato. ^[7]
• Richiamare una funzione standalone da un'altra funzione. Se la tua azione personalizzata chiama una funzione standalone tramite URL (usando invokeurl), verifica che il percorso dell'endpoint e il tipo di autenticazione siano ancora corretti — ad esempio, le chiamate basate su OAuth richiedono una connessione valida e non scaduta. ^[2]

Cosa verificare

• L'azione è ancora collegata ad almeno una regola attiva. Apri la visualizzazione dettagliata dell'azione e verifica che sia associata a una regola di workflow o a un blueprint attivo; le azioni orfane possono essere facili da trascurare durante i controlli. ^[8]
• Le credenziali della connessione sono valide. Se l'azione integra un servizio di terze parti, verifica che la connessione in Impostazioni → Connessioni mostri il Link name corretto e uno stato Attivo prima di affidarti all'azione in produzione. ^[7]
• I parametri della funzione corrispondono ai nomi dei campi attuali. Dopo aver recuperato un'azione basata su funzione, confronta i riferimenti ai parametri dinamici con l'elenco dei campi corrente nel modulo pertinente per evitare errori in fase di esecuzione. ^[7]