Connecteur Salesforce

:: : (info) () Pour télécharger l'application, visitez : Bibliothèque::: :

Introduction

Salesforce est une plateforme logicielle de gestion de la relation client (CRM) basée sur le cloud, utilisée dans des applications allant du suivi des pistes de vente à la gestion des commandes et des stocks.

Objectif

Ce document détaille le connecteur API REST de Salesforce que l'on trouve dans la bibliothèque Tulip. Une fois configurées, ces fonctions du connecteur peuvent être utilisées pour récupérer, interroger et modifier les données Salesforce à partir d'une application Tulip.

Documentation de l'API

La documentation de l'API Salesforce REST est disponible ici. Notez que certaines fonctions de connecteur incluses dans cet article effectuent des requêtes à l'aide de SOQL (Salesforce Object Query Language), dont la syntaxe complète est documentée ici.

:::(Info) (Variations de l'API) Remarque : Salesforce prend en charge un certain nombre d'API à travers une variété de méthodes, dont la liste complète peut être consultée ici.
Cet article et les connecteurs auxquels il se rapporte sont conçus pour utiliser l'API REST de Salesforce.
:: :

Première installation

:::(Warning) (Avertissement sur les permissions) Avertissement : la génération des valeurs suivantes nécessite des permissions de niveau développeur ou administrateur dans Salesforce. :: : L'authentification de l'API Salesforce suit les normes OAuth 2.0. Le processus suivant décrit comment générer un jeton de rafraîchissement, qui sera ensuite utilisé par n'importe quelle application Tulip pour récupérer le jeton d'accès nécessaire pour se connecter avec succès à Salesforce.

1. Créez une application connectée dans Salesforce. Pour ce faire, accédez à l'espace "Configuration" de Salesforce. Ensuite, accédez à OUTILS DE LA PLATEFORME >> Apps >> Apps connectées >> Gérer les apps connectées.
2. Créez une nouvelle application connectée. Incluez
   a. tous les scopes requis par votre application, mais veillez à inclure refresh_token. b. Sélectionnez Activer les paramètres OAuth et saisissez l'URL de rappel à l'adresse https://login.salesforce.com/services/oauth2/success.
3. Une fois terminé, cliquez sur Manage Consumer Details (Gérer les détails du consommateur ) pour voir votre "Consumer Key" et "Consumer Secret". Ceux-ci seront utilisés plus tard.
4. Maintenant, dans Tulip, ouvrez la fonction Connector [Setup] Get Auth Code URL. Copiez et collez la "Consumer Key" générée à l'étape 3 ci-dessus comme paramètre de requête client_id.
5. "Exécutez la fonction de connecteur.
6. Observez qu'une URL a été générée en tant que "sortie" du connecteur. Collez cette URL dans la fenêtre de votre navigateur.
7. Répondez à l'invite d'authentification qui apparaît pour autoriser Tulip à interagir avec votre instance Salesforce.
8. Si l'authentification est réussie, votre navigateur devrait être redirigé vers une nouvelle page qui indique Autorisation de l'application d'accès à distance. Le code d'autorisation se trouve dans l'URL de cette page.
   Par exemple, dans l'URL https://login.salesforce.com/services/oauth2/success?code=asdf1234, le code d'autorisation est asdf1234.
9. Enregistrez ce code d'autorisation. Notez que le code doit se terminer par deux symboles d'égalité : ==. Si le code se termine par %3D%3D, supprimez ces caractères et remplacez-les par ==.
10. Naviguez jusqu'à la fonction [Setup] Get Refresh Token Tulip Connector. Dans les paramètres de la requête, collez toutes les informations recueillies ci-dessus :
    • grant_type= authorization_code
    • redirect_uri= https://login.salesforce.com/services/oauth2/success
    • client_id= la clé du consommateur de l'étape 3 ci-dessus
    • client_secret= le secret du consommateur de l'étape 3 ci-dessus
    • code= le code d'autorisation de l'étape 9 ci-dessus
11. Exécutez ce connecteur et enregistrez le refresh_token qui apparaît dans la réponse.
12. Enfin, accédez à la fonction [Auth] Get Access Token Connector. Remplissez les paramètres de requête suivants :
    • grant_type= authorization_code
    • client_id= la clé du consommateur de l'étape 3 ci-dessus
    • client_secret= le secret du consommateur de l'étape 3 ci-dessus
    • refresh_token= le jeton de rafraîchissement de l'étape 10 ci-dessus
13. Exécutez le connecteur. Notez que la réponse comprend un access_token, qui est mappé en tant que sortie. Sauvegarder le connecteur pour sauvegarder le jeton de rafraîchissement.

Une fois que cette fonction est capable de générer un access_token, la configuration est terminée ! Cet access_token peut maintenant être utilisé dans n'importe quelle autre fonction du connecteur aussi longtemps que le permettent les paramètres de temporisation configurés à l'étape 2.

Détails de la connexion Tulip

Pour permettre à vos connecteurs de s'interfacer avec Salesforce, saisissez le sous-domaine de votre instance Salesforce en tant que "Sous-domaine par défaut", dans les détails de connexion du connecteur.
Par exemple, si l'instance Salesforce se trouve à l'adresse sample.my.salesforce.com, le sous-domaine par défaut doit être sample.my.

Notez que toutes les fonctions de connecteur présentées ici sont conçues pour fonctionner avec Salesforce REST API v46.0.

Fonctions de connecteur

Il existe deux types principaux de connecteurs : les connecteurs de type objet et les connecteurs de type requête.
Notez que les deux connecteurs nécessitent un access_token, alors assurez-vous d'exécuter [Auth] Get Access Token dans votre application avant de les utiliser ! Il est généralement recommandé de générer un nouveau jeton d'accès au démarrage de l'application ou du processus, et de le sauvegarder dans une variable d'application pour une utilisation ultérieure.

Connecteurs de type objet

• Retourne tous les champs de l'objet en question.
• Utiliser le point de terminaison ./services/data/v46.0/sobjects/<nom de l'objet>/<identification de l'objet>.
• Exemple : Connecteur [Opportunité] Obtenir tous les champs

Connecteurs de type requête

• Renvoie uniquement les champs spécifiés dans la requête.
• Ils peuvent renvoyer des informations liées (par exemple, le nom du compte lié à une opportunité) ou agrégées (par exemple, un nombre d'enregistrements).
• Utiliser le point de terminaison ./services/data/v46.0/query
• Nécessite l'écriture d'une requête à l'aide de SOQL (documentation here{target=_blank}).
• Exemple : Connecteur [Ordre] Obtenir tous les ordres de statut

Fonctions de connexion incluses

Les fonctions de connecteur suivantes sont incluses dans ce pack et sont destinées à servir d'introduction aux fonctions possibles via l'API Salesforce : * [Setup] Get Auth Code URL & [Setup] Get Refresh Token * Utilisé uniquement lors de la première installation. Voir ci-dessus pour plus d'informations.* [Auth] Get Access Token * Utilisé pour générer un jeton d'accès, qui doit être inclus dans toutes les fonctions de connecteur suivantes.* Fonctions [Opportunity] :
* Obtenir tous les champs * *Renvoie tous les champs de l'opportunité interrogée. Nécessite le jeton d'accès et l'ID de l'*opportunité. * Change Stage * Met à jour l'étape de l'opportunité indiquée avec la valeur spécifiée.* Fonctions [Order] : * Get All Orders of Status * Renvoie une liste de toutes les commandes d'un statut spécifié.* Count Orders of Status * Renvoie un décompte de toutes les commandes d'un statut spécifié.* Get Order Number from ID * Renvoie un numéro de commande à partir d'un ID de commande spécifié.

Pour modifier ces fonctions en fonction de vos besoins, suivez les conseils ci-dessous :

1. Pour modifier les fonctions de connecteur de type objet, il suffit de changer l'objet indiqué dans l'URL. Ajoutez ou supprimez de nouvelles sorties si nécessaire. 2. Pour modifier les fonctions de connexion de type requête, tous les changements doivent être effectués dans la requête. Celle-ci se trouve dans les paramètres de la requête, avec la clé q.
2. Astuce : limiter le nombre de réponses d'une requête avec la fonction LIMIT(nombre_de_réponses)

Vous avez trouvé ce que vous cherchiez ?

Vous pouvez également vous rendre sur community.tulip.co pour poser votre question ou voir si d'autres personnes ont rencontré une question similaire !