Aperçu

L'intégration Salesforce garde les contacts Salesforce et les profils Vome alignés. La synchronisation va dans les deux sens : les contacts créés ou modifiés dans Salesforce arrivent dans Vome, et les événements de Vome repartent vers Salesforce par un webhook.

Vous installez un package géré dans votre org Salesforce, vous le pointez vers Vome avec une clé API, puis vous définissez la correspondance des champs.

L'intégration Salesforce exige le forfait Ultime, puisqu'elle s'authentifie au moyen d'une clé API Vome.

C'est l'intégration la plus exigeante offerte par Vome. Elle relève d'un administrateur Salesforce, pas d'une coordonnatrice ou d'un coordonnateur. Prévoyez le temps qu'il faut et faites-la d'abord dans un bac à sable.

Pourquoi l'utiliser

• Une seule fiche par personne dans les deux systèmes. Votre équipe de développement philanthropique et votre équipe des participants cessent de travailler sur deux listes différentes.

• L'engagement bénévole devient visible côté collecte de fonds. Celle ou celui qui donne du temps et celle ou celui qui donne de l'argent apparaissent sur la même fiche de contact.

• Aucune exportation manuelle. La synchronisation s'exécute à la création d'un contact, à sa modification, et selon un calendrier quotidien.

• Vous maîtrisez la correspondance. Elle se configure dans Salesforce, c'est donc vous qui décidez quels champs voyagent et lesquels restent en place.

Ce qui se synchronise, et dans quel sens

• De Salesforce vers Vome. Les données de contact et de compte, à partir de trois déclencheurs : création d'un contact, modification d'un contact, et une exécution planifiée quotidienne.

• De Vome vers Salesforce. Des mises à jour événementielles livrées à un point final de webhook que vous exposez depuis un Salesforce Site, par exemple à l'ajout d'un nouveau profil dans Vome.

Avant de commencer

Il vous faut :

• un accès System Administrator dans Salesforce;

• une clé API Vome, ainsi que le Client ID et le Client Secret de la connexion;

• un abonnement Vome au forfait Ultime;

• un bac à sable pour tester, fortement recommandé avant de toucher à la production.

Générer votre clé API Vome

1. Dans la barre de navigation de gauche de Vome, cliquez sur Intégrations & Applis.

2. Cliquez sur APIs & webhooks.

3. Ouvrez l'onglet Clés API, cliquez sur Générer une clé secrète, donnez-lui un titre comme « Salesforce », et copiez-la immédiatement. La clé n'est affichée qu'une fois.

Comment configurer l'intégration

La marche à suivre détaillée, avec le lien d'installation du package géré, se trouve sur le site de documentation développeur de Vome. Dans les grandes lignes :

1. Installez le package géré dans votre org Salesforce. Utilisez d'abord le lien d'installation pour bac à sable si vous testez.

2. Activez « Deploy Metadata from Non-Certified Package Versions via Apex » dans les Apex Settings.

3. Créez un Salesforce Site et accordez l'accès public à la classe Apex VomeWebhookEndpoint. C'est ce qui permet à Vome de renvoyer les événements vers Salesforce.

4. Configurez Vome Settings, OAuth Configuration et Field Mapping au moyen des Custom Metadata Types.

5. Activez le flux « Sync Contact To Vome Trigger ».

6. Passez en revue le tableau de bord d'intégration, dans ses onglets Settings, Field Mapping et Integration Rules.

7. Confirmez que les trois règles d'intégration existent et sont actives.

8. Affectez l'ensemble d'autorisations « Vome Integration User » aux personnes concernées.

9. Enregistrez l'URL de votre Salesforce Site comme point final de webhook dans Vome, sous Intégrations & Applis puis APIs & webhooks.

Raisons fréquentes d'une non-synchronisation

• Le bloc de correspondance des champs est inactif. Rien ne traverse tant que la correspondance n'est pas active.

• Le flux de synchronisation n'a jamais été activé. Installer le package ne l'active pas pour vous.

• Le point final de webhook n'est pas enregistré dans Vome. Sans lui, rien ne repart de Vome vers Salesforce. Consultez l'onglet Journaux de la console développeur de Vome pour voir ce qui a été tenté.

• L'ensemble d'autorisations n'a pas été affecté. Sans lui, l'intégration ne se comporte pas comme prévu pour ces personnes.

Documentation développeur

Le guide d'installation complet, avec les liens du package et les valeurs de métadonnées exactes, est ici, en anglais : https://docs.vomevolunteer.com/integrations-and-automations/salesforce

Pour le modèle de clés et d'événements sous-jacent, voyez Comment fonctionnent l'API et les webhooks de Vome ?

Besoin d'aide ?

Si la synchronisation se comporte mal, écrivez à notre équipe de support depuis https://support.vomevolunteer.com/. Dites-nous quel sens échoue, de Salesforce vers Vome ou de Vome vers Salesforce, cela mène beaucoup plus vite à la bonne réponse.

Résumé

• Synchronisation des contacts dans les deux sens entre Salesforce et Vome, avec le forfait Ultime.

• De Salesforce vers Vome : à la création d'un contact, à sa modification, et chaque jour.

• De Vome vers Salesforce : par un point final de webhook exposé depuis un Salesforce Site.

• La configuration relève d'un System Administrator Salesforce et passe par un package géré.

• Si rien ne se synchronise, vérifiez d'abord la correspondance des champs, le flux de synchronisation et l'enregistrement du webhook.