Comment récupérer la prochaine meilleure expérience ZIA dans Zoho CRM

La fonctionnalité Next Best Experience (NBX) de Zia dans Zoho CRM propose des recommandations d'actions contextuelles et pilotées par l'IA pour un enregistrement donné — et vous pouvez récupérer ces suggestions de manière programmatique via un endpoint API dédié.

Pourquoi c'est important

Les équipes commerciales gérant de larges pipelines ont besoin de conseils intelligents et opportuns sur l'action à entreprendre pour chaque opportunité ou prospect. Plutôt que de faire remonter manuellement les suggestions NBX depuis l'interface CRM, les développeurs et les intégrateurs peuvent appeler directement l'endpoint NBX pour intégrer ces recommandations dans des tableaux de bord externes, des workflows d'automatisation ou des applications personnalisées. Cela est particulièrement utile lorsque vous souhaitez déclencher une logique de vente guidée en dehors de l'interface standard de Zoho CRM.

Étape par étape

Étape 1. Comprendre ce que retourne l'endpoint.

L'API Zia NBX récupère la recommandation de prochaine meilleure expérience pour un enregistrement CRM spécifique. Zia analyse chaque point de contact pertinent — interactions, signaux et transactions — pour produire des suggestions contextuelles et exploitables qui vous aident à nourrir vos prospects, fidéliser vos clients et optimiser votre pipeline. ^[2]

Étape 2. Identifier les deux paramètres de chemin requis.

L'endpoint nécessite exactement deux paramètres : m (le nom du module, par ex. Leads, Contacts, Deals) et rid (l'identifiant unique de l'enregistrement dans ce module). Les deux sont des segments positionnels dans le chemin de l'URL. ^[5]

Étape 3. Construire la requête HTTP.

Émettez une requête HTTP GET vers le modèle de chemin suivant :

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

Remplacez {m} par le nom API du module cible et {rid} par l'identifiant de l'enregistrement. Par exemple, pour récupérer les données NBX d'un enregistrement Deal, votre chemin ressemblerait à :

GET /Deals/4876XXXXXXXXX/zia/nbe

^[5]

Étape 4. Appeler l'opération via le helper SDK (le cas échéant).

Si vous utilisez le client Python de Zoho CRM ou une couche d'intégration basée sur zpilot, l'opération est exposée sous le nom getzianextbestexperience. Passez le nom du module comme premier argument (m) et l'identifiant de l'enregistrement comme second (rid) : [^1, ^5]

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

La méthode déclenche en interne la requête GET /{m}/{rid}/zia/nbe et retourne la réponse analysée. ^[5]

Étape 5. Interpréter la réponse en contexte.

Le payload NBX contiendra les actions recommandées par Zia pour cet enregistrement. Ces suggestions sont fondées sur l'historique complet des points de contact de l'enregistrement ; ainsi, plus les données de votre CRM sont riches (e-mails, appels, transactions, signaux), plus la recommandation sera précise. ^[2]

Étape 6. Afficher optionnellement le NBX via des boutons personnalisés dans l'interface.

Si vous préférez une approche sans code, Zoho CRM vous permet également d'associer des invites à des boutons personnalisés. Lorsqu'un utilisateur clique sur le bouton d'un enregistrement, Zia exécute l'invite associée et retourne un résultat contextuel à cet enregistrement CRM spécifique — vous offrant ainsi une version intégrée à l'interface de l'expérience NBX sans écrire d'appels API. ^[2]

Erreurs courantes

• Nom API de module incorrect : Le paramètre m doit correspondre exactement au nom API du module (par ex. Leads et non Lead, Deals et non Deal). Une discordance entraînera l'échec de la requête. ^[5]
• Identifiant d'enregistrement invalide ou inaccessible : Si rid ne correspond pas à un enregistrement auquel l'utilisateur authentifié peut accéder, l'API retournera une erreur. Vérifiez toujours que l'enregistrement existe et que votre token OAuth dispose du scope CRM approprié. ^[5]
• Données insuffisantes pour les recommandations : La qualité du NBX dépend du volume et de la variété des points de contact enregistrés pour l'enregistrement. Les enregistrements avec peu d'activité peuvent retourner des suggestions limitées ou inexistantes. S'assurer que les interactions, signaux et transactions sont systématiquement capturés améliorera la qualité des résultats. ^[2]

Points à vérifier

• Confirmez que la valeur de m correspond exactement au nom API du module cible et que rid est un identifiant d'enregistrement valide et accessible avant d'effectuer l'appel. ^[5]
• Vérifiez que votre token OAuth Zoho CRM dispose des autorisations Zia/IA nécessaires, car le NBX est une fonctionnalité alimentée par l'IA qui peut nécessiter l'activation de scopes spécifiques. ^[1]
• Après avoir reçu la réponse, comparez l'action suggérée avec l'étape actuelle de l'enregistrement dans le pipeline pour vous assurer que la recommandation est cohérente avec votre logique de vente guidée attendue. ^[2]

---

*Beam Help est une ressource d'assistance experte indépendante pour les produits Zoho et ne constitue pas le support officiel de Zoho. Validez toujours le comportement de l'API par rapport à votre édition et votre plan Zoho CRM spécifiques, car la disponibilité des fonctionnalités peut varier.*