Tutoriel : Envoyer des événements Salesforce depuis Amazon EventBridge - Amazon EventBridge
PrérequisÉtape 1 : Créer une connexionÉtape 2 : Créer la destination d’APIÉtape 3 : Créer une règleÉtape 4 : Tester la règleÉtape 5 : Nettoyer vos ressources

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Tutoriel : Envoyer des événements Salesforce depuis Amazon EventBridge

Vous pouvez l'utiliser EventBridge pour acheminer des événements vers des services tiers, tels que Salesforce.

Dans ce didacticiel, vous allez utiliser la EventBridge console pour créer une connexionSalesforce, une destination d'API pointant vers Salesforce et une règle vers laquelle acheminer les événementsSalesforce.

Prérequis

Pour suivre ce didacticiel, vous aurez besoin des ressources suivantes :

Étape 1 : Créer une connexion

Pour envoyer des événements à Salesforce, vous devez d’abord établir une connexion à l’API Salesforce.

Pour créer la connexion

  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le panneau de navigation, choisissez Destinations d’API.

  3. Choisissez l’onglet Connexions, puis sélectionnez Créer une connexion.

  4. Nommez et décrivez la connexion. Par exemple, entrez Salesforce pour le nom et Salesforce API Connection pour la description.

  5. Pour Type de destination, choisissez Partenaires, et pour Destinations partenaires, sélectionnez Salesforce dans la liste déroulante.

  6. Pour Point de terminaison d’autorisation, entrez l’une des adresses suivantes :

    • Si vous utilisez une organisation de production, entrez https://MyDomainName.my.salesforce.com./services/oauth2/token

    • Si vous utilisez un environnement de test (sandbox) sans domaines améliorés, entrez https://MyDomainName--SandboxName.my. salesforce.com/services /oauth2/token

    • Si vous utilisez un environnement de test (sandbox) avec domaines améliorés, entrez https://MyDomainName-- SandboxName.sandbox.my.salesforce.com/services/oauth2/token

  7. Pour Méthode HTTP, choisissez POST dans la liste déroulante.

  8. Pour ID client, entrez l’ID client de votre application connectée Salesforce.

  9. Pour Clé secrète du client, entrez la clé secrète du client de votre application connectée Salesforce.

  10. Pour les paramètres OAuth HTTP, entrez la paire clé/valeur suivante :

    Clé Valeur

    grant_type

    client_credentials

  11. Choisissez Créer.

Étape 2 : Créer la destination d’API

Maintenant que vous avez créé la connexion, vous allez créer la destination d’API à utiliser comme cible de la règle.

Pour créer la destination d’API

  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le panneau de navigation, choisissez Destinations d’API.

  3. Choisissez Créer une destination d’API.

  4. Nommez et décrivez la destination d’API. Par exemple, entrez SalesforceAD pour le nom et Salesforce API Destination pour la description.

  5. Pour Point de terminaison de la destination d’API, entrez https://MyDomainName.my.salesforce.com/services/data/v54.0/sobjects/MyEvent__e, Myevent__e correspondant à l’événement de plateforme auquel vous souhaitez envoyer les informations.

  6. Pour Méthode HTTP, choisissez POST dans la liste déroulante.

  7. Pour Limite du taux d’appel, entrez 300.

  8. Pour Connexion, choisissez Utiliser une connexion existante et sélectionnez la connexion Salesforce que vous avez créée à l’étape 1.

  9. Choisissez Créer.

Étape 3 : Créer une règle

Vous allez maintenant créer une règle de sorte que des événements soient envoyés à Salesforce lorsqu’un objet Amazon S3 est créé.

Pour créer une règle

  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le volet de navigation, choisissez Règles.

  3. Choisissez Créer une règle.

  4. Saisissez un nom et une description pour la règle. Par exemple, entrez SalesforceRule pour le nom et Rule to send events to Salesforce for S3 object creation pour la description.

  5. Pour Event bus (Bus d’événement), choisissez default (défaut).

  6. Pour Type de règle, choisissez Règle avec un modèle d’événement.

  7. Choisissez Suivant.

  8. Pour Event source (Source de l'événement), choisissez Other (Autres).

  9. Pour Modèle d’événement, entrez ce qui suit :

    {
  "source": ["aws.s3"]
}

  10. Choisissez Suivant.

  11. Pour les types de cibles, choisissez la destination de EventBridge l'API.

  12. Pour Destination d’API, choisissez Utiliser une destination d’API existante, puis choisissez la destination SalesforceAD que vous avez créée à l’étape 2.

  13. Pour Rôle d’exécution, choisissez Créer un rôle pour cette ressource spécifique.

  14. Pour Réglages supplémentaires, procédez comme suit :

    1. Pour Configurer l’entrée cible, choisissez Transformateur d’entrée dans la liste déroulante.

    2. Choisissez Configurer le transformateur d’entrée.

    3. Pour Exemples d’événements, entrez ce qui suit :

      {
  "detail":[]
}

    4. Pour Transformateur d’entrée cible, procédez comme suit :

      1. Pour Chemin d’entrée, entrez ce qui suit :

        {"detail":"$.detail"}

      2. Pour Modèle d’entrée, entrez ce qui suit :

        {"message": <detail>}

    5. Choisissez Confirmer.

  15. Choisissez Suivant.

  16. Choisissez Suivant.

  17. Consultez les détails de la règle et choisissez Create rule (Créer une règle).

Étape 4 : Tester la règle

Pour tester votre règle, créez un objet Amazon S3 en téléchargeant un fichier dans un compartiment EventBridge activé. Les informations relatives à l’objet créé seront envoyées à l’événement de la plateforme Salesforce.

Étape 5 : Nettoyer vos ressources

Vous pouvez maintenant supprimer les ressources que vous avez créées pour ce didacticiel, sauf si vous souhaitez les conserver. En supprimant AWS les ressources que vous n'utilisez plus, vous évitez des frais inutiles sur votre AWS compte.

Pour supprimer les EventBridge connexions

  1. Ouvrez la page de destination de l'API de la EventBridge console.

  2. Choisissez l'onglet Connections (Connexions).

  3. Sélectionnez la ou les connexions que vous avez créées.

  4. Sélectionnez Delete (Supprimer).

  5. Entrez le nom de la connexion et choisissez Supprimer.

Pour supprimer la ou les destinations de l' EventBridge API

  1. Ouvrez la page de destination de l'API de la EventBridge console.

  2. Sélectionnez la ou les destinations d’API que vous avez créées.

  3. Sélectionnez Delete (Supprimer).

  4. Entrez le nom de la destination d’API et choisissez Supprimer.

Pour supprimer la ou les EventBridge règles

  1. Ouvrez la page Règles de la EventBridge console.

  2. Sélectionnez la ou les règles que vous avez créées.

  3. Sélectionnez Delete (Supprimer).

  4. Sélectionnez Supprimer.