Come recuperare la prossima migliore esperienza ZIA in Zoho CRM

La funzionalità Next Best Experience (NBX) di Zia in Zoho CRM fornisce raccomandazioni di azioni contestuali e basate sull'IA per un determinato record — ed è possibile recuperare questi suggerimenti in modo programmatico tramite un endpoint API dedicato.

Perché è importante

I team di vendita che gestiscono pipeline di grandi dimensioni hanno bisogno di indicazioni tempestive e intelligenti su quale azione intraprendere per ogni opportunità o lead. Invece di visualizzare manualmente i suggerimenti NBX nell'interfaccia CRM, sviluppatori e integratori possono chiamare direttamente l'endpoint NBX per incorporare quelle raccomandazioni in dashboard esterni, flussi di lavoro automatizzati o applicazioni personalizzate. Questo è particolarmente utile quando si desidera attivare la logica di guided selling al di fuori dell'interfaccia standard di Zoho CRM.

Procedura passo dopo passo

Passaggio 1. Comprendi cosa restituisce l'endpoint.

L'API Zia NBX recupera la raccomandazione della prossima migliore esperienza per un record CRM specifico. Zia analizza ogni punto di contatto rilevante — interazioni, segnali e transazioni — per produrre suggerimenti contestuali e pratici che aiutano a coltivare i lead, fidelizzare i clienti e ottimizzare la pipeline. ^[2]

Passaggio 2. Identifica i due parametri di percorso obbligatori.

L'endpoint richiede esattamente due parametri: m (il nome del modulo, ad es. Leads, Contacts, Deals) e rid (l'ID univoco del record all'interno di quel modulo). Entrambi sono segmenti posizionali nel percorso URL. ^[5]

Passaggio 3. Costruisci la richiesta HTTP.

Invia una richiesta HTTP GET al seguente schema di percorso:

GET /{m}/{rid}/zia/nbe

Sostituisci {m} con il nome API del modulo di destinazione e {rid} con l'ID del record. Ad esempio, per recuperare i dati NBX per un record Deal, il percorso sarà simile a:

GET /Deals/4876XXXXXXXXX/zia/nbe

^[5]

Passaggio 4. Chiama l'operazione utilizzando l'helper SDK (se applicabile).

Se stai utilizzando il client Python di Zoho CRM o un livello di integrazione basato su zpilot, l'operazione è esposta come getzianextbestexperience. Passa il nome del modulo come primo argomento (m) e l'ID del record come secondo (rid): [^1, ^5]

result = client.get_zia_next_best_experience(m="Deals", rid="4876XXXXXXXXX")

Il metodo esegue internamente la richiesta GET /{m}/{rid}/zia/nbe e restituisce la risposta elaborata. ^[5]

Passaggio 5. Interpreta la risposta nel contesto.

Il payload NBX conterrà le azioni consigliate da Zia per quel record. Questi suggerimenti si basano sull'intera cronologia dei punti di contatto del record, quindi più ricchi sono i dati nel CRM (email, chiamate, transazioni, segnali), più precisa sarà la raccomandazione. ^[2]

Passaggio 6. Facoltativamente, visualizza NBX tramite pulsanti personalizzati nell'interfaccia.

Se preferisci un approccio senza codice, Zoho CRM consente anche di associare prompt a pulsanti personalizzati. Quando un utente fa clic sul pulsante su un record, Zia esegue il prompt associato e restituisce un output contestuale a quel specifico record CRM — offrendo di fatto una versione in-UI dell'esperienza NBX senza scrivere chiamate API. ^[2]

Errori comuni

• Nome API del modulo errato: Il parametro m deve corrispondere esattamente al nome API del modulo (ad es. Leads e non Lead, Deals e non Deal). Una mancata corrispondenza causerà il fallimento della richiesta. ^[5]
• ID record non valido o inaccessibile: Se rid non corrisponde a un record accessibile dall'utente autenticato, l'API restituirà un errore. Verifica sempre che il record esista e che il tuo token OAuth disponga dello scope CRM appropriato. ^[5]
• Dati insufficienti per le raccomandazioni: La qualità di NBX dipende dal volume e dalla varietà dei punti di contatto registrati per il record. I record con scarsa attività potrebbero restituire suggerimenti limitati o assenti. Assicurarsi che interazioni, segnali e transazioni vengano acquisiti in modo coerente migliorerà la qualità dell'output. ^[2]

Cosa verificare

• Conferma che il valore di m corrisponda esattamente al nome API del modulo di destinazione e che rid sia un identificatore di record valido e accessibile prima di effettuare la chiamata. ^[5]
• Verifica che il tuo token OAuth di Zoho CRM disponga delle autorizzazioni Zia/IA necessarie, poiché NBX è una funzionalità basata sull'IA che potrebbe richiedere l'abilitazione di scope specifici. ^[1]
• Dopo aver ricevuto la risposta, confronta l'azione suggerita con la fase attuale del record nella pipeline per assicurarti che la raccomandazione sia allineata con la logica di guided selling prevista. ^[2]

---

*Beam Help è una risorsa di supporto esperto indipendente per i prodotti Zoho e non rappresenta il supporto ufficiale di Zoho. Verifica sempre il comportamento delle API in base alla tua specifica edizione e al tuo piano di Zoho CRM, poiché la disponibilità delle funzionalità può variare.*