Zoho est multirégional — votre compte réside dans un centre de données précis, et le flux OAuth doit passer par les serveurs d’authentification de la région correspondante. Anexus vous demande lequel avant la redirection.
Avant de commencer
- Un compte Zoho CRM sur un forfait qui expose l’API (le forfait gratuit est inclus).
- Sachez dans quel centre de données se trouve votre compte Zoho (vous pouvez le voir dans l’URL de votre tableau de bord Zoho).
Référence rapide des centres de données
| Votre URL Zoho se termine par… | Choisir ce CD |
|---|---|
.zoho.com | US |
.zoho.eu | EU |
.zoho.in | IN |
.zoho.com.au | AU |
.zoho.jp | JP |
.zohocloud.ca | CA |
Étape 1 — Choisir votre CD et cliquer sur Connecter
Dans Anexus, Paramètres → Intégrations CRM → Zoho CRM.
Dans le petit menu déroulant à côté du bouton Connecter, sélectionnez votre centre de données (US, EU, IN, AU, JP ou CA).
Cliquez sur Se connecter avec Zoho CRM. Vous êtes redirigé vers la page de connexion Zoho de la région choisie.
Étape 2 — Se connecter et autoriser
Connectez-vous avec vos identifiants Zoho.
Zoho affiche un écran de consentement. Anexus demande :
- ZohoCRM.modules.contacts.ALL — lecture et écriture des fiches Contact
- ZohoCRM.users.READ — lecture de votre fiche utilisateur (utilisée pour afficher le nom de votre compte)
Cliquez sur Accepter.
Zoho vous redirige vers Anexus. La carte Zoho bascule à l’état vert « Connecté ».
Ce qui se synchronise vers Zoho CRM
Chaque contact saisi devient (ou met à jour) un Contact Zoho. Nous utilisons le point de terminaison upsert de Zoho — la même personne qui soumet votre formulaire deux fois met à jour le Contact existant, sans jamais créer de doublon.
Champs synchronisés :
- Prénom, Nom (le Nom est défini par défaut sur « Unknown » s’il est absent — exigé par Zoho)
- Courriel
- Téléphone
- Fonction
- Nom du compte (depuis le champ entreprise)
Utilisez Synchroniser les contacts antérieurs sur la carte Zoho pour récupérer tout ce qui a été saisi avant la connexion.
En cas de problème
« Invalid Client » sur l’écran de consentement
Vous avez choisi le mauvais centre de données. L’application Anexus est enregistrée séparément dans chaque région Zoho — si vous sélectionnez US mais que votre compte est en EU, le serveur Zoho US ne trouve pas d’application correspondante. Déconnectez-vous, choisissez le bon CD, puis réessayez.
« Session Zoho invalide » au test
Le jeton d’accès a expiré et le rafraîchissement a échoué. C’est rare — déconnectez-vous et reconnectez-vous.
Champs manquants pour les contacts dans Zoho
Les organisations Zoho ajoutent parfois des champs personnalisés obligatoires. Notre upsert n’envoie que les champs standard ; si votre organisation exige des champs personnalisés, le contact est tout de même enregistré, mais avec des valeurs personnalisées vides. Votre administrateur peut marquer ces champs personnalisés comme non obligatoires, ou vous pouvez les remplir manuellement.
Comment se déconnecter
Cliquez sur Déconnecter dans Anexus. Pour aussi révoquer du côté de Zoho : connectez-vous à Zoho, cliquez sur votre profil, Mon compte → Jetons d’authentification actifs, trouvez Anexus Connect et cliquez sur Révoquer.