Connecter Zoho CRM à votre logiciel métier

Quelles API Zoho CRM pour quel usage ?

La page API de Zoho CRM présente quatre familles d'API, dont la documentation renvoie à la version 8 en octobre 2026 :

Zoho publie aussi des SDK officiels pour Java, Python, Node.js, PHP et C#, et un tableau de bord d'usage de l'API qui montre les plus gros consommateurs et la moyenne quotidienne. Ce tableau de bord devient l'outil de suivi principal une fois l'intégration en service.

Compte hébergé en Europe : quels domaines appeler ?

Zoho CRM fonctionne sur plusieurs centres de données, chacun avec son domaine : accounts.zoho.com pour les États-Unis, accounts.zoho.eu pour l'Europe, et des domaines propres à l'Inde, l'Australie, le Japon, la Chine et le Canada. Pour un compte européen, les appels partent vers www.zohoapis.eu.

La documentation « Multi DC » décrit le mécanisme : pour un compte européen, la demande d'autorisation part de accounts.zoho.com, Zoho redirige vers le domaine du compte, et la réponse contient un paramètre location qui désigne ce domaine, à enregistrer et à utiliser pour tous les appels. Un service qui fonctionne sur un compte de démonstration américain peut ainsi échouer sur le compte européen du client.

Pour la conformité, on vérifie d'abord le centre de données du compte, puis on héberge le service d'intégration dans l'Union européenne. Les obligations à respecter sont rappelées dans notre guide RGPD et logiciel métier.

OAuth 2.0 chez Zoho : un jeton d'une heure, un jeton durable

L'API Zoho CRM s'authentifie en OAuth 2.0. Le jeton d'accès, envoyé dans l'en-tête Authorization sous la forme « Zoho-oauthtoken », vaut une heure et ne sert qu'aux opérations couvertes par ses scopes, par exemple ZohoCRM.notifications.ALL pour gérer les notifications. Le jeton de rafraîchissement, lui, n'expire pas tant que l'utilisateur ne le révoque pas.

• Renouvellement : le service d'intégration obtient un nouveau jeton d'accès toutes les heures, sans intervention humaine, et transforme un échec de renouvellement (jeton révoqué, utilisateur désactivé) en alerte lisible.
• Confidentialité : Zoho demande de ne jamais exposer un jeton dans du code côté navigateur, un forum ou un dépôt public. Le jeton de rafraîchissement, durable, se range dans un coffre de secrets côté serveur.

Crédits d'API et appels simultanés : dimensionner la synchronisation

Zoho CRM ne plafonne pas l'API par minute, mais par crédits sur 24 heures glissantes et par nombre d'appels simultanés. Chaque appel coûte au moins un crédit, certains bien davantage :

Le nombre d'appels simultanés, par utilisateur et par application, va de 5 en édition Free à 25 en Ultimate (10 en Standard, 15 en Professional, 20 en Enterprise), avec une sous-limite fixe de 10 pour les opérations lourdes comme la conversion de prospects ou l'écriture de plus de 10 enregistrements.

Le total de crédits dépend de l'édition et du nombre de licences, dans la limite d'un plafond par édition ; l'édition Free est fixée à 5 000 crédits. En octobre 2026, la page développeur et la liste des fonctionnalités de Zoho n'affichent pas les mêmes formules pour les éditions payantes : pour Enterprise, la première indique 15 000 crédits plus 1 000 par licence, plafonnés à 1 000 000, la seconde 50 000 crédits plus 1 000 par licence, plafonnés à 5 000 000. Le tableau de bord d'usage de l'API du compte reste la référence à suivre. Une règle tient dans tous les cas : écrire 100 enregistrements en un appel coûte 10 crédits, contre 100 en appels unitaires.

Être prévenu d'un changement : notification ou webhook de workflow ?

La Notification API active un canal par un appel POST sur actions/watch : on y indique les événements suivis (par exemple Deals.create, Deals.edit, Deals.delete ou Deals.all), l'adresse de réception et un jeton de vérification de 50 caractères au plus. La notification reçue contient le module, l'opération, les identifiants concernés et, sur option, les champs modifiés avec leurs valeurs. Une condition permet de ne suivre que certains champs, jusqu'à 10, comme le passage d'une affaire à l'étape suivante.

Le point à ne pas manquer : un canal expire, au bout d'une semaine au maximum, et d'une heure si la durée n'est pas précisée. Sans tâche de renouvellement, le service cesse d'être prévenu sans le moindre message d'erreur. On programme donc un renouvellement quotidien et un contrôle que des notifications arrivent bien.

Autre voie, sans code : le webhook déclenché comme action d'une règle de workflow. La liste des fonctionnalités de Zoho en plafonne le volume quotidien, la valeur la plus basse s'appliquant :

Du prospect converti à la marge par affaire : cinq flux Zoho CRM

1. Prospect converti, compte client ouvert. Dans un négoce de matériaux, le commercial convertit un prospect ; la notification de création du compte déclenche l'ouverture du compte client dans l'ERP, avec ses conditions de paiement.
2. Affaire à l'étape « commande », production lancée. Une condition de notification sur le champ d'étape prévient le logiciel de production, qui crée l'ordre de fabrication.
3. Stocks visibles par les commerciaux. Chaque soir, les disponibilités calculées par l'ERP sont écrites par paquets de 100 dans un module personnalisé de Zoho CRM.
4. Historique chargé une fois. Avant le démarrage, clients et affaires des années passées passent par la Bulk API, en arrière-plan, plutôt que par des milliers d'appels unitaires.
5. Marge réelle par affaire. Une requête COQL extrait les affaires gagnées du mois pour un tableau de bord qui les croise avec la marge tirée de la comptabilité, sur le modèle de notre tableau de bord de pilotage.

Chacun de ces flux supprime une ressaisie ; la logique est détaillée dans notre page pour éliminer les doubles saisies.

Sandbox, fonctions Deluge ou service externe ?

Pour tester, Zoho CRM propose des sandboxes : des environnements séparés de la production, dans lesquels l'administrateur importe tout ou partie de la configuration, avec des données d'exemple ou une copie des données réelles. La liste des fonctionnalités les réserve aux éditions Enterprise (3 sandboxes de configuration et 2 de configuration et données) et Ultimate (7 et 3). En Standard ou Professional, on travaille sur un compte de test séparé ou sur la Developer Edition que Zoho met à disposition des développeurs.

Avant de développer à l'extérieur, regardez ce que Zoho fait en interne : les fonctions Deluge, écrites et exécutées dans Zoho CRM, peuvent suffire pour un flux simple qui reste dans l'écosystème Zoho. La liste des fonctionnalités leur attribue des crédits propres, distincts des crédits d'API, et ne les ouvre en Standard et Professional que par des extensions. Un service externe se justifie quand la logique appartient à votre logiciel métier, quand plusieurs outils partagent les mêmes règles, ou quand vous voulez garder la main sur le code.

YMHB Web écrit alors un service d'intégration hébergé à votre nom, dont le code vous appartient au paiement intégral : jetons OAuth dans un coffre, renouvellement des canaux surveillé, écritures groupées pour économiser les crédits, journal des échanges et alertes. Le déroulé suit notre démarche d'API et intégrations : cartographie des flux, tests en sandbox, mise en service flux par flux. Pour changer de CRM, voir les alternatives à Zoho CRM.