(Bêta) Créer une Zoho CRM connexion de base à l’aide de Flow Service API

REMARQUE

Le Zoho CRM source est en version bêta. Voir la section Présentation des sources pour plus d’informations sur l’utilisation de connecteurs étiquetés bêta.

Une connexion de base représente la connexion authentifiée entre une source et Adobe Experience Platform.

Ce tutoriel vous explique les étapes à suivre pour créer une connexion de base pour Zoho CRM à l’aide de la Flow Service API.

Prise en main

Ce guide nécessite une compréhension professionnelle des composants suivants d'Adobe Experience Platform :

  • Sources: Experience Platform permet l’assimilation de données à partir de diverses sources tout en vous permettant de structurer, étiqueter et améliorer les données entrantes à l’aide de Platform services.
  • Environnements de test : Experience Platform fournit des environnements de test virtuels qui divisent une instance Platform unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience numérique.

Les sections suivantes fournissent des informations supplémentaires que vous devez connaître pour vous connecter à Zoho CRM à l’aide de la Flow Service API.

Collecte des informations d’identification requises

Pour Flow Service pour se connecter à Zoho CRM, vous devez fournir des valeurs pour les propriétés de connexion suivantes :

Informations d'identification Description
endpoint Le point de terminaison de Zoho CRM le serveur auquel vous faites votre demande.
accountsUrl L’URL du compte est utilisée pour générer vos jetons d’accès et d’actualisation. L’URL doit être spécifique au domaine.
clientId L’ID client correspondant à votre Zoho CRM compte utilisateur.
clientSecret Le secret client qui correspond à votre Zoho CRM compte utilisateur.
accessToken Le jeton d’accès autorise votre accès sécurisé et temporaire à votre Zoho CRM compte.
refreshToken Un jeton d’actualisation est un jeton utilisé pour générer un nouveau jeton d’accès, une fois que votre jeton d’accès a expiré.
connectionSpec.id La spécification de connexion renvoie les propriétés de connecteur d’une source, y compris les spécifications d’authentification liées à la création des connexions de base et source. ID de spécification de connexion pour Zoho CRM est : 929e4450-0237-4ed2-9404-b7e1e0a00309.

Pour plus d’informations sur ces informations d’identification, consultez la documentation sur Zoho CRM authentification.

Utilisation des API de plate-forme

Pour plus d’informations sur la manière d’effectuer des appels vers les API de plate-forme, consultez le guide sur prise en main des API de plate-forme.

Création d’une connexion de base

Une connexion de base conserve les informations entre votre source et la plate-forme, y compris les informations d'identification de votre source, l'état actuel de la connexion et votre ID de connexion de base unique. L’ID de connexion de base vous permet d’explorer et de parcourir les fichiers à partir de votre source et d’identifier les éléments spécifiques que vous souhaitez assimiler, y compris des informations concernant leurs types et formats de données.

Pour créer un ID de connexion de base, effectuez une demande de POST à l’adresse /connections point de terminaison lors de la fourniture de votre Zoho CRM les informations d'identification d'authentification dans le cadre des paramètres de demande.

Format d’API

POST /connections

Requête

CONSEIL

Votre domaine d’URL de compte doit correspondre à l’emplacement de votre domaine approprié. Voici les différents domaines et leurs URL de compte correspondantes :

  • États-Unis : https://accounts.zoho.com
  • Australie : https://accounts.zoho.com.au
  • Europe : https://accounts.zoho.eu
  • Inde : https://accounts.zoho.in
  • Chine : https://accounts.zoho.com.cn

La demande suivante crée une connexion de base pour Zoho CRM:

curl -X POST \
    'https://platform.adobe.io/data/foundation/flowservice/connections' \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {IMS_ORG}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}' \
    -H 'Content-Type: application/json'
    -d '{
        "name": "Zoho CRM base connection",
        "description": "Base Connection for Zoho CRM",
        "auth": {
            "specName": "Basic Authentication",
            "params": {
                "endpoint": "{ENDPOINT}",
                "accountsUrl": "{ACCOUNTS_URL}",
                "clientId": "{CLIENT_ID}",
                "clientSecret": "{CLIENT_SECRET}",
                "accessToken": "{ACCESS_TOKEN}",
                "refreshToken": "{REFRESH_TOKEN}"
            }
        },
        "connectionSpec": {
            "id": "929e4450-0237-4ed2-9404-b7e1e0a00309",
            "version": "1.0"
        }
    }'
Paramètre Description
name Le nom de votre Zoho CRM connexion de base. Vous pouvez utiliser ce nom pour rechercher votre Zoho CRM connexion de base.
description Une description facultative de votre Zoho CRM connexion de base.
auth.specName Type d'authentification utilisé pour la connexion.
auth.params.endpoint Le point de terminaison de Zoho CRM le serveur auquel vous faites votre demande.
auth.params.accountsUrl L’URL du compte est utilisée pour générer vos jetons d’accès et d’actualisation. L’URL doit être spécifique au domaine.
auth.params.clientId L’ID client correspondant à votre Zoho CRM compte utilisateur.
auth.params.clientSecret Le secret client qui correspond à votre Zoho CRM compte utilisateur.
auth.params.accessToken Le jeton d’accès autorise votre accès sécurisé et temporaire à votre Zoho CRM compte.
auth.params.refreshToken Un jeton d’actualisation est un jeton utilisé pour générer un nouveau jeton d’accès, une fois que votre jeton d’accès a expiré.
connectionSpec.id ID de spécification de connexion pour Zoho CRM: 929e4450-0237-4ed2-9404-b7e1e0a00309.

Réponse

Une réponse réussie renvoie les détails de la connexion de base nouvellement créée, y compris son identifiant unique (id). Cet ID est requis à l’étape suivante pour créer une connexion source.

{
    "id": "2484f2df-c057-4ab5-84f2-dfc0577ab592",
    "etag": "\"10033e77-0000-0200-0000-5e96785b0000\""
}

Étapes suivantes

En suivant ce tutoriel, vous avez créé un fichier Zoho CRM connexion de base à l’aide de Flow Service et ont obtenu la valeur d'ID unique de la connexion. Vous pouvez utiliser cet ID dans le tutoriel suivant pour apprendre à exploration des systèmes CRM à l’aide de l’API Flow Service.

Sur cette page