Questo errore si verifica quando gli endpoint della pipeline del modulo Deal restituiscono 204 No Content o un oggetto pipeline null, anche se il CRM mostra la pipeline predefinita (Standard) nell'interfaccia utente. L'API inizia a restituire dati sulla pipeline solo dopo che è stata creata almeno una pipeline personalizzata, il che interrompe le integrazioni che si aspettano un record di pipeline per ogni account [1].
Cosa significa
Quando chiami gli endpoint della pipeline di Zoho CRM per i Deal e ricevi 204 No Content o una pipeline null, l'API non espone la pipeline Standard integrata se non esistono pipeline personalizzate nell'account. La pagina Gestisci Pipeline in Impostazioni CRM potrebbe non mostrare pipeline configurate, eppure la pipeline Standard esiste ancora nell'interfaccia utente; la risposta dell'API la omette finché non viene aggiunta una pipeline personalizzata [1].
Cause comuni
- Un comportamento/bug della piattaforma in cui l'API omette la pipeline Standard predefinita a meno che non esista una pipeline personalizzata [1].
- L'account non ha realmente pipeline personalizzate configurate, il che attiva la risposta 204 mentre l'interfaccia utente mostra ancora la pipeline Standard implicita [1].
- L'ambito delle impostazioni della pipeline mancante nel token API può impedire la restituzione dei dati della pipeline: verifica che i tuoi ambiti OAuth includano l'ambito delle impostazioni della pipeline, se utilizzato [2].
- Il codice di integrazione tratta 204 come un errore grave invece che come uno stato che significa "solo pipeline predefinita presente", quindi fallisce a valle [1].
Come risolvere
- Aggiungi una pipeline personalizzata nell'account come soluzione temporanea: apri Impostazioni CRM > Configura > Gestisci Pipeline (Pipeline) e crea una qualsiasi pipeline personalizzata. L'API restituirà quindi la pipeline Standard più la nuova pipeline personalizzata, ripristinando i dati attesi per le integrazioni [1].
- Aggiorna la tua integrazione per gestire 204 No Content in modo grazioso: quando l'endpoint della pipeline restituisce 204, torna a considerare l'account come se utilizzasse la pipeline Standard (usa i valori del campo Fase dei Deal e la tua mappatura predefinita nota). Ciò evita di bloccare l'elaborazione quando non viene restituito alcun oggetto pipeline [1].
- Se hai bisogno degli ID pipeline programmaticamente, crea una pipeline personalizzata minima tramite API o interfaccia utente per forzare l'API a restituire oggetti pipeline; acquisisci gli ID pipeline restituiti per un uso futuro [1].
- Se non puoi creare pipeline personalizzate negli account client, aggiungi un rilevamento robusto: in caso di 204 dagli endpoint delle pipeline, interroga i record Deal per i valori di fase per ricostruire gli elenchi di pipeline/fase attesi e procedi senza ID pipeline. Implementa tentativi e registra l'occorrenza di 204 per analisi successive [1].
- Raccogli i log e apri un ticket di supporto se necessiti di una correzione permanente della piattaforma: includi coppie di richieste/risposte API, timestamp, ID organizzazione e una sequenza riproducibile (nessuna pipeline personalizzata -> 204; aggiungi una pipeline personalizzata -> compaiono gli oggetti pipeline) in modo che il supporto possa escalare il comportamento backend [1].
Quando escalare
Escala al Supporto Zoho quando la tua integrazione non può operare senza ID pipeline e la creazione di una pipeline personalizzata non è un'opzione, o quando il comportamento 204 si verifica in modo incoerente tra gli account nonostante configurazioni identiche — includi i log API e l'ID organizzazione per una risoluzione più rapida [1].
[1]: https://help.zoho.com/portal/en/community/topic/zoho-crm-deal-api-returning-null-pipeline-in-case-of-default-pipeline
[2]: https://help.zoho.com/portal/en/kb/crm/troubleshooting/articles/troubleshooting-pipelines