Développement Zoho

Développement Zoho : Deluge, API, Creator ou Catalyst, quand utiliser quoi ?

Deluge, Client Script, widgets, API REST, Creator ou Catalyst : le guide pour choisir le bon outil de développement Zoho, avec les limites de chacun.

31 octobre 2026

L'essentiel

Pour développer sur Zoho, il n'y a pas un outil mais six : les fonctions Deluge, les Client Scripts, les widgets, les API REST, Zoho Creator et Zoho Catalyst. Le bon choix dépend de trois choses : où le code doit agir, combien de temps il tourne et qui le déclenche.

La règle de base : Deluge pour automatiser à l'intérieur de Zoho, JavaScript dans le navigateur pour l'interface, l'API pour les logiciels externes, Creator pour une application métier, Catalyst dès que les limites de Deluge sont atteintes.

En bref

Deluge suffit tant que le traitement tient en 10 secondes (bouton), 30 secondes (workflow) ou 15 minutes (fonction planifiée).
Client Script et widgets demandent l'édition Professional au minimum ; les fonctions Deluge directes, l'édition Enterprise.
L'API REST s'impose dès qu'un autre logiciel lit ou écrit dans Zoho, avec un budget de crédits à surveiller.
Creator sert à construire une application complète, pas à ajouter un champ calculé au CRM.
Catalyst prend les traitements longs, les lots et l'IA, en Node.js, Python ou Java.

Quel outil pour quel besoin ?

Zoho offre six façons d'ajouter du code à vos applications. Elles ne se font pas concurrence : chacune répond à une question précise. Suivez le schéma dans l'ordre ; le premier « oui » vous donne l'outil.

Quatre questions suffisent pour choisir l’outil Zoho — Choisir l’outil de développement Zoho · 4 questions, 5 outils

Un projet réel en combine souvent plusieurs : un widget affiche des données, une fonction Deluge les met à jour, et Catalyst prend le relais quand le traitement devient lourd.

Outil	Où s'exécute le code	Langage	Usage type	Limite à connaître
Fonction Deluge	Serveurs Zoho	Deluge	Automatiser dans une application Zoho	10 s, 30 s ou 15 min selon le déclencheur
Client Script	Navigateur de l'utilisateur	JavaScript	Contrôler la saisie, guider l'utilisateur	10 s par exécution
Widget	Navigateur, dans le CRM	JavaScript, avec le JS SDK	Écran sur mesure, données externes	200 widgets en Enterprise et Ultimate
API REST	Votre serveur ou un service tiers	Tous	Synchroniser un autre logiciel	Crédits d'API sur 24 heures glissantes
Zoho Creator	Serveurs Zoho	Deluge	Application métier complète	Une seule application en offre Standard
Zoho Catalyst	Serveurs Zoho, sans serveur à gérer	Node.js, Python, Java	Traitements longs, lots, IA	30 s en HTTP, 15 min par job

Deluge : automatiser à l'intérieur de Zoho

Deluge est le langage de script de Zoho. On le retrouve dans le CRM, Creator, Books, Desk ou Flow. Dans Zoho CRM, une fonction Deluge peut partir d'une règle de workflow, d'un bouton, d'un processus guidé (blueprint), d'une planification, d'une liste associée ou d'un appel d'API.

Sa force est sa proximité avec les données : une ligne suffit pour lire ou modifier un enregistrement, sans authentification à gérer.

// Fonction appelée par un workflow sur les affaires. Argument : idAffaire
affaire = zoho.crm.getRecordById("Deals",idAffaire);
montant = ifnull(affaire.get("Amount"),0);
maj = Map();
maj.put("Priorite",if(montant >= 50000,"Haute","Normale"));
zoho.crm.updateRecord("Deals",idAffaire,maj);

Ses limites sont fixes, et c'est là que les projets dérapent (Zoho CRM) :

Limite	Valeur
Durée d'exécution	10 s (bouton, validation, liste associée, API), 30 s (workflow, blueprint, approbation), 15 min (planification)
Lignes exécutées par appel	200 000, boucles comprises
Valeur renvoyée	10 Mo
Appels sortants (invokeurl)	5 000 000 par jour pour l'organisation
Crédits de fonctions, Enterprise	20 000 plus 500 par licence, sur 24 h glissantes

Trois points à connaître avant de s'y lancer :

Les fonctions directes sont réservées à l'édition Enterprise et au-delà. En Standard et Professional, elles passent par des extensions.
Chaque appel zoho.crm.* consomme des crédits d'API, comme un appel externe. Le code ci-dessus en consomme deux à chaque exécution. Voir notre guide des limites de l'API Zoho CRM.
Les lectures en masse passent par COQL, qui ramène jusqu'à 2 000 lignes par appel, plutôt que par une boucle de lectures unitaires. Voir notre guide COQL.

Quand une fonction dépasse ses limites, les parades sont décrites dans notre guide sur Deluge et Catalyst.

Personnaliser l'interface : Client Script et widgets

Deluge s'exécute sur les serveurs de Zoho. Pour agir sur ce que voit l'utilisateur, il faut du JavaScript dans le navigateur. Zoho CRM propose deux outils, disponibles à partir de l'édition Professional.

Client Script : réagir à la saisie. Un Client Script s'exécute dans le navigateur quand l'utilisateur enregistre une fiche, modifie un champ ou lance une commande par raccourci clavier. Il fonctionne sur les pages de création, de modification, de liste et de détail, y compris les pages Canvas et les portails (Zoho CRM). Chaque exécution dispose de 10 secondes, et un script est à créer pour chaque mise en page du module.

// Client Script, module Affaires, page de création, événement à l'enregistrement
const montant = ZDK.Page.getField('Amount').getValue();
const remise = ZDK.Page.getField('Remise').getValue();
if (remise > 15 && montant < 10000) {
  ZDK.Client.showAlert('Une remise de plus de 15 % demande un montant d\'au moins 10 000 €.');
  return false; // l'enregistrement est annulé
}

Attention : les appels au CRM faits depuis un Client Script consomment eux aussi des crédits d'API.

Widgets : construire un écran. Un widget est un composant d'interface en JavaScript, développé avec le JS SDK de Zoho, que l'on place dans un onglet, un bouton, une liste associée, les paramètres, un tableau de bord, un assistant ou un blueprint (Zoho CRM). C'est l'outil pour afficher des données d'un autre système dans une fiche, ou pour proposer un écran que les mises en page standard ne permettent pas. Une organisation peut en créer jusqu'à 200 en édition Enterprise ou Ultimate.

La règle de partage est simple : le Client Script modifie le comportement des pages existantes, le widget ajoute une page ou un bloc qui n'existait pas.

Les API REST : quand un autre logiciel pilote Zoho

Dès qu'un système externe doit lire ou écrire dans Zoho, c'est l'API REST qui s'impose : site web, ERP, outil métier, application mobile, plateforme de facturation. Le code tourne chez vous, dans le langage de votre choix.

Cinq règles évitent la plupart des pannes :

Respecter le centre de données. Zoho héberge ses clients sur plusieurs centres, dont un en Europe. Utilisez l'adresse d'authentification de votre centre et l'adresse d'API renvoyée avec le jeton, au lieu d'adresses écrites en dur dans le code.
Gérer les jetons. Un jeton d'accès vit une heure ; le jeton de rafraîchissement, lui, se conserve comme un mot de passe.
Budgéter les crédits. Zoho CRM accorde 50 000 crédits par 24 heures glissantes, plus un bonus par licence selon l'édition. Une écriture compte pour 1 crédit par tranche de 10 enregistrements, une conversion de prospect pour 5, une écriture en masse pour 500.
Grouper. Jusqu'à 100 enregistrements par écriture, jusqu'à 2 000 lignes par requête COQL, et l'API en masse pour les gros volumes.
Préférer les notifications au sondage. Plutôt que d'interroger le CRM toutes les minutes, abonnez-vous aux notifications, sans oublier de les renouveler chaque semaine.

Deux de nos guides détaillent ces points : les limites de l'API Zoho CRM (API Zoho CRM : crédits, limites et quotas (v8)) et l'expiration des webhooks (Webhooks Zoho CRM : pourquoi ils s'arrêtent après 7 jours).

Zoho Creator : une application métier sur mesure

Creator est la plateforme low-code de Zoho. On y construit une application complète : ses tables, ses formulaires, ses rapports, ses droits d'accès et sa logique, écrite en Deluge.

Quand l'utiliser. Pour un processus qui ne rentre pas dans le modèle du CRM : suivi d'interventions, gestion de dossiers, planification, contrôle qualité, portail pour vos clients ou vos partenaires.

Quand l'éviter. Pour ajouter un calcul ou un écran au CRM, un Client Script ou un widget suffit. Pour remplacer un logiciel du marché qui fait déjà bien le travail, Creator coûte souvent plus cher à maintenir qu'il ne rapporte.

Les offres. Creator se facture par utilisateur, en trois offres. L'offre Standard ne permet qu'une seule application ; Professional et Enterprise n'ont pas de limite d'applications (Zoho Creator). Les autres écarts portent notamment sur :

Limite	Standard	Professional	Enterprise
Applications	1	Illimitées	Illimitées
Sources de données	5	15	30
Connecteurs personnalisés	5	10	20

Les portails pour utilisateurs externes sont une option, de 250 à 100 000 utilisateurs de portail.

Deux pièges. L'intégration native entre Creator et Zoho CRM n'existe pas en CRM Standard. Et une application Creator qui émet des factures ne passe par aucune plateforme agréée : voir notre guide sur les factures émises depuis Zoho CRM ou Creator.

Notre article Zoho Creator : quand l'utiliser, quand l'éviter détaille les coûts et les alternatives.

Zoho Catalyst : le code qui dépasse les limites

Catalyst est la plateforme serverless de Zoho. On y déploie des fonctions en Node.js, Python ou Java, sans serveur à administrer (Catalyst). C'est là que va tout ce qui ne tient pas dans Deluge : traitements longs, lots de milliers d'enregistrements, bibliothèques spécialisées, appels à des modèles d'IA.

Les briques les plus utiles pour un projet Zoho :

Les fonctions HTTP (Advanced I/O), qui reçoivent les appels du CRM ou d'un site, avec 30 secondes au plus pour répondre ;
les fonctions Job, lancées depuis une file d'attente, qui disposent de 15 minutes et de nouvelles tentatives automatiques ;
les fonctions Cron, pour les traitements à heure fixe ;
le stockage : base de données, cache et stockage de fichiers ;
AppSail, pour héberger une application complète quand une fonction ne suffit plus.

Catalyst propose un centre de données en Europe, un palier gratuit renouvelé chaque mois et une facturation à l'usage. Les fonctions de type Integration n'y sont toutefois pas disponibles sur le centre européen.

La version 3.0, lancée le 2 septembre 2026, ajoute des compétences pour les assistants de code comme Claude Code et Codex, ainsi que le support du protocole MCP (CXOToday).

L'exemple complet d'un traitement confié par le CRM à Catalyst, avec le code, se trouve dans notre guide sur Deluge et Catalyst. Le guide Catalyst présente la plateforme en détail.

Ce que chaque édition de Zoho CRM autorise

L'édition de votre CRM décide de ce que vous pouvez développer. C'est souvent la première question à poser avant un devis.

Fonction	Standard	Professional	Enterprise et Zoho One	Ultimate
Webhooks	Non	Oui	Oui	Oui
Connexions vers d'autres services	Non	Oui	Oui	Oui
Blueprint	Non	Oui	Oui	Oui
Client Script	Non	Oui	Oui	Oui
Widgets	Non	Oui	Oui, 200 au plus	Oui, 200 au plus
Fonctions Deluge directes	Par extension	Par extension	Oui	Oui
Bac à sable	Non	Non	Oui	Oui
Crédits d'API par 24 h	50 000 + 250 par licence, plafond 100 000	50 000 + 500 par licence, plafond 3 millions	50 000 + 1 000 par licence, plafond 5 millions	50 000 + 2 000 par licence, sans plafond

Sources : documentation Zoho sur les Client Scripts, les widgets, les limites de l'API et les fonctionnalités perdues lors d'un passage en édition Standard (Zoho CRM).

En pratique, une PME en Standard qui veut automatiser sérieusement doit passer en Professional pour les webhooks, les connexions et les scripts, ou en Enterprise pour les fonctions et le bac à sable. Notre comparatif des éditions Zoho CRM détaille ces écarts.

Les bonnes pratiques communes à tous les outils

Quel que soit l'outil, les mêmes règles séparent un développement fiable d'une accumulation de scripts fragiles.

Développer dans un bac à sable, disponible à partir de l'édition Enterprise, puis déployer en production. Sans bac à sable, testez sur des fiches de test, jamais sur celles de vos clients.
Utiliser les connexions plutôt que des jetons écrits dans le code. Une connexion Zoho conserve l'authentification et se révoque en un clic.
Sortir les paramètres du code : identifiants d'organisation, seuils, adresses, rangés dans des variables de l'organisation.
Gérer les erreurs. Deluge intercepte les erreurs avec try et catch : journalisez-les, et prévenez quelqu'un quand un traitement important échoue.
Versionner le code. Le code Deluge vit dans l'interface de Zoho : gardez une copie de chaque fonction dans un dépôt Git, avec la date et l'auteur de chaque modification.
Tester avec un volume réaliste. Une fonction qui passe sur trois fiches peut échouer sur trois cents.
Tenir un inventaire. Workflows, fonctions, webhooks, scripts : une liste à jour de ce que fait chaque élément et de qui en est responsable.

Ces sept points forment l'ossature de notre checklist d'audit Zoho CRM.

Faire le point sur vos développements Zoho

Avant de lancer un nouveau développement, mieux vaut savoir ce qui tourne déjà : les fonctions qui frôlent leurs limites, les webhooks qui expirent, les crédits d'API consommés par des boucles inutiles.

Audit technique Zoho, par SquadNovia

Nous passons en revue vos fonctions Deluge, vos intégrations, vos webhooks, vos scripts et votre consommation d'API, puis nous vous remettons un plan d'action classé par priorité, avec pour chaque point l'outil le plus adapté. Au forfait, sur devis.

Demander l'audit · Développer avec une banque d'heures

Questions fréquentes

Quel langage apprendre pour développer sur Zoho ?

Deluge d'abord : c'est le langage de toutes les applications Zoho. Ensuite JavaScript pour les Client Scripts et les widgets, puis Node.js ou Python pour Catalyst et les intégrations par API.

Peut-on développer sur Zoho CRM édition Standard ?

Très peu. L'édition Standard n'a ni webhooks, ni connexions, ni Client Script, ni widgets. L'API REST reste disponible, avec 50 000 crédits par jour plus 250 par licence.

Creator ou Catalyst : lequel choisir ?

Creator pour une application avec des écrans, des formulaires et des utilisateurs. Catalyst pour du code sans interface, ou presque : traitements longs, intégrations lourdes, IA.

Les appels faits dans une fonction Deluge consomment-ils des crédits d'API ?

Oui. Chaque appel zoho.crm.* compte comme un appel d'API, en plus des crédits de fonctions.

Un Client Script peut-il remplacer un workflow ?

Non. Un Client Script ne s'exécute que dans le navigateur, quand un utilisateur agit sur une page. Une fiche créée par l'API ou par un import ne le déclenche pas : les règles qui doivent toujours s'appliquer vont dans un workflow ou une fonction.

Comment vérifier le niveau d'un développeur Zoho ?

Zoho propose des certifications Deluge et Creator. Demandez aussi des exemples de code commenté et la façon dont le développeur gère les erreurs et les crédits d'API.

Sources

Pages consultées les 20 et 21 octobre 2026.