Table of Contents

Connecteur Zoho CRM

Créer un enregistrement dans un module de Zoho CRM à chaque dépôt.

Important

Exemple à adapter. Dans cette version, le connecteur n'envoie aucune donnée du manifeste : il crée un enregistrement qui ne contient qu'une description et l'identifiant de la requête. Utilisez-le comme point de départ, de préférence en reprenant sa logique dans un gestionnaire.
Identifiant zoho-crm
Adresse https://<serveur>/api/webhook/zoho-crm

Réglages

Section Connector:zoho-crm d'appsettings.json :

Clé Défaut Effet
Domain https://www.zohoapis.com Domaine de l'API de Zoho CRM.
TargetModule Leads Module dans lequel créer l'enregistrement.
AccountsDomain https://accounts.zoho.com Domaine des comptes Zoho, pour obtenir le jeton.
FieldMappings aucun Liste ChampZoho:Chemin,.... Dans cette version, chaque champ reçoit le texte Mapped from: {chemin}, et non la valeur du manifeste.

Utilisez les domaines du centre de données de votre compte Zoho.

Secrets

Sous Connectors.zoho-crm.Secrets : ClientId, ClientSecret et RefreshToken, d'un client créé dans la console d'API de Zoho, avec un jeton qui permet de créer des enregistrements dans le module cible.

Ce qu'il fait

  1. Il obtient un jeton d'accès à partir du jeton de rafraîchissement, auprès de {AccountsDomain}/oauth/v2/token.
  2. Il envoie POST {Domain}/crm/v3/{TargetModule}, avec l'en-tête Authorization: Zoho-oauthtoken <jeton> et le corps {"data": [<enregistrement>]}.
  3. L'enregistrement contient :
    • Description : Synchronized from SESAR at <date>, en heure UTC ;
    • SESAR_Request_Id : l'identifiant de la requête, qui doit exister comme champ personnalisé dans le module ;
    • les champs de FieldMappings.
  4. En cas de succès, l'identifiant Zoho de l'enregistrement est renvoyé dans ExternalReferenceId.

Le module cible peut exiger d'autres champs, par exemple un nom pour les pistes : sans eux, Zoho refuse la création.

Tester

POST /api/connectors/zoho-crm/test vérifie seulement qu'un jeton d'accès peut être obtenu, sans appeler le CRM.

L'adapter

Dans votre gestionnaire, utilisez OAuth2RefreshTokenHelper.ForZoho, puis construisez l'enregistrement à partir du manifeste : objet (GetSubject), destinataires (GetRecipientEmails), nombre de fichiers (GetFileCount). Voir Authentification vers vos systèmes.

En cas d'échec, la réponse du connecteur contient la réponse brute de Zoho : elle n'est lue que par SESAR, mais ne la journalisez pas telle quelle.