Comment récupérer les informations de l'organisation dans Zoho CRM

La récupération des informations de votre organisation dans Zoho CRM peut être effectuée soit par la zone Paramètres de l'entreprise intégrée dans l'interface utilisateur, soit par programmation via le point de terminaison OAuth de Zoho Accounts — les deux approches exposent les identifiants clés de l'organisation et les détails de configuration.

Pourquoi c'est important

Savoir où trouver et comment récupérer les informations de l'organisation est essentiel lorsque vous configurez des intégrations, auditez votre configuration CRM ou créez des applications personnalisées qui doivent identifier l'organisation Zoho CRM à laquelle elles sont connectées. Les administrateurs ont régulièrement besoin de ces détails pour configurer les exercices fiscaux, les heures de travail, les paramètres de devise et les préférences de hiérarchie. Les développeurs créant des applications connectées via OAuth doivent résoudre de manière fiable l'ID d'organisation et le nom de l'organisation avant d'effectuer les appels API en aval.

Étape par étape

Option A — Utiliser l'interface utilisateur de Zoho CRM (Administrateur)

Étape 1. Connectez-vous à Zoho CRM avec un compte disposant du profil Administrateur. Seuls les administrateurs sont recommandés pour afficher et personnaliser les détails spécifiques à l'entreprise qui différencient une organisation d'une autre. ^[6]

Étape 2. Accédez à Configuration (l'icône d'engrenage dans le coin supérieur droit), puis localisez la section Paramètres de l'entreprise. Cette zone contient les détails spécifiques à l'organisation, notamment la configuration de l'exercice fiscal, les heures de travail, les préférences de hiérarchie et les options multi-devises. ^[6]

Étape 3. Ouvrez Gérer les paramètres de l'entreprise pour examiner ou modifier le profil principal de votre organisation — des éléments comme le nom de l'entreprise, l'adresse et le fuseau horaire. Ces champs sont ce que Zoho CRM utilise pour distinguer votre organisation des autres sur la plateforme. ^[6]

Étape 4. Tout en restant dans Paramètres de l'entreprise, explorez les sous-sections selon vos besoins :

• Configurer l'exercice fiscal — définit la période de 12 mois que votre organisation utilise pour la planification et le suivi des ventes. ^[6]
• Gérer les heures de travail — définit les heures de travail en fonction de la localisation de votre entreprise, important si vous avez des bureaux dans plusieurs pays. ^[6]
• Gérer la préférence de hiérarchie — contrôle la façon dont l'accès aux données est structuré entre les utilisateurs par désignation. ^[6]
• Gérer plusieurs devises — pertinent si votre organisation traite des transactions internationales. ^[6]

---

Option B — Récupérer les informations de l'organisation par programmation via OAuth

Étape 1. Complétez le flux OAuth 2.0 pour votre intégration Zoho CRM afin d'obtenir un jeton d'accès valide. Sans jeton, le point de terminaison des informations utilisateur/organisation rejettera la demande. ^[4]

Étape 2. Effectuez une demande GET au point de terminaison des informations utilisateur de Zoho Accounts :

GET https://accounts.zoho.<DC>/oauth/user/info
Authorization: Bearer <access_token>

Remplacez <DC> par le suffixe de votre centre de données (par exemple, com, eu, in, com.au). La réponse contient les détails de l'utilisateur et de l'organisation. ^[4]

Étape 3. Analysez la réponse JSON pour extraire les champs dont vous avez besoin. Les champs clés à rechercher incluent :

• ZUID — l'ID utilisateur Zoho. ^[4]
• Email — l'adresse e-mail de l'utilisateur authentifié. ^[4]
• ID d'organisation — les noms de champs varient selon le centre de données ; vérifiez orgid, organizationid ou ZGID dans cet ordre. Pour les organisations à utilisateur unique, revenir à ZUID est une approche raisonnable. ^[4]
• Nom de l'organisation — de même, essayez companyname, organizationname ou Company_Name en séquence. Si aucun n'est présent, la partie domaine de l'adresse e-mail peut servir d'étiquette de secours. ^[4]

Étape 4. Stockez le crmorgid résolu de manière sécurisée (par exemple, dans une table zoho_connections indexée par ID de connexion) afin que les appels API ultérieurs puissent référencer l'organisation correcte sans avoir à récupérer à nouveau. ^[5]

---

Pièges courants

• Les noms de champs diffèrent selon le centre de données. Les champs d'ID d'organisation et de nom d'organisation renvoyés par https://accounts.zoho.<DC>/oauth/user/info ne sont pas cohérents dans tous les centres de données Zoho. Implémentez toujours une chaîne de secours plutôt que de supposer qu'un seul nom de champ sera présent. ^[4]
• Les organisations à utilisateur unique peuvent ne pas renvoyer un ID d'organisation distinct. Dans ce cas limite, utiliser le ZUID comme identifiant d'organisation proxy est une solution de contournement acceptée, mais sachez qu'il s'agit d'un identifiant au niveau de l'utilisateur — et non au niveau de l'organisation. ^[4]
• Les paramètres de l'entreprise sont réservés aux administrateurs. Si un non-administrateur accède à Configuration, il peut ne pas voir le menu Paramètres de l'entreprise complet. Assurez-vous que le profil correct est attribué avant de dépanner les éléments de menu manquants. ^[6]
• Les champs de compte synchronisés sont limités. Si vous extrayez des données d'organisation/compte dans une intégration Zoho Desk–CRM, seul un ensemble défini de champs (Téléphone, E-mail, Fax, Site Web, Secteur d'activité, Chiffre d'affaires annuel, champs d'adresse et Description) sera mappé. Les champs en dehors de cette liste ne seront pas synchronisés automatiquement. ^[2]

Ce qu'il faut vérifier

• Confirmez que le suffixe de votre centre de données est correct dans l'URL du point de terminaison OAuth — une non-correspondance renverra une erreur d'authentification plutôt que des données d'organisation. ^[4]
• Vérifiez que l'accès administrateur est actif pour le compte que vous utilisez pour parcourir Paramètres de l'entreprise dans l'interface utilisateur de Zoho CRM. ^[6]
• Vérifiez le crmorgid stocké par rapport à la valeur renvoyée par le point de terminaison des informations utilisateur après toute réauthentification pour vous assurer que l'enregistrement de connexion reste exact. ^[5]

---

*Beam Help est une ressource d'assistance expert indépendante pour les produits Zoho et n'est pas le support officiel de Zoho. Pour les problèmes de compte au niveau de la plateforme, contactez Zoho directement via leur portail d'assistance.*