Salesforce
Avant de commencer
- Un administrateur Salesforce, pour les étapes 1 à 3. Envoyez-lui cette page.
- Votre Salesforce de production : les environnements de test (sandbox) ne sont pas pris en charge.
- Être administrateur du projet dans Dominium Pilot, pour les étapes 4 et 5.
1Créer l’app Dominium PilotAdmin Salesforce
- Setup → External Client App Manager → New External Client App.
Nom :
Dominium Pilot. Contact Email : votre courriel. Distribution State :Local. - Cochez « Enable OAuth » et collez cette Callback URL :Callback URL
https://dominiumpilot.ca/api/auth/callback/salesforce - Ajoutez ces OAuth Scopes :
- Manage user data via APIs (
api) - Perform requests at any time (
refresh_token,offline_access) - Access the identity URL service (
id, …)
- Manage user data via APIs (
- Cochez « Require Proof Key for Code Exchange (PKCE) », puis Create.
2Autoriser les utilisateursAdmin Salesforce
Dans l’app : Policies → App Authorization, choisissez « All users can self-authorize ».
3Copier les deux codesAdmin Salesforce
Settings → OAuth Settings → Consumer Key and Secret. Copiez la clé et le secret, et transmettez-les au gestionnaire par un moyen sûr.
Attention
4Enregistrer l’app dans Dominium PilotVous
- Réglages → Intégration CRM, « Type de CRM » : Salesforce.
- Sur la ligne « App Salesforce », cliquez sur « Utiliser une autre app ».
- Collez la « Clé du client (Consumer Key) » et le « Secret du client (Consumer Secret) », puis « Enregistrer l’app ».
5Connecter votre compteVous
- Sur la ligne « Compte », cliquez sur « Connecter », puis « Autoriser » chez Salesforce.
- Choisissez « Créer l’opportunité à l’étape », puis « Terminer ».
Pour vérifier : réservez une visite de test, puis retrouvez dans Salesforce le contact, l’opportunité et l’événement. Annulez ensuite la visite dans Dominium Pilot.
Ce qui arrive dans Salesforce
| Dans Salesforce | Quand |
|---|---|
| Lead | Pour chaque nouveau prospect. S’il existe déjà comme Lead ou Contact (même courriel), il est réutilisé. |
| Contact, Account, Opportunity | Quand une visite est réservée : le Lead est converti, l’Opportunity placée à l’étape choisie. |
| Event | La visite, à sa date et son heure. |
| Note | Le résumé de la demande et de la conversation. |
Si ça bloque
| Message | Quoi faire |
|---|---|
redirect_uri_mismatch | La Callback URL ne correspond pas exactement, ou l’app n’est pas encore active : vérifiez-la et réessayez dans 5 minutes. |
| « Salesforce n’a pas validé la connexion » | La clé ou le secret a été mal collé (espace en trop, caractère manquant). Recollez-les. |
| « Enregistrez d’abord la clé et le secret… » | Faites l’étape 4 avant l’étape 5. |
| « Non autorisé » | Seul un administrateur du projet peut enregistrer l’app. |
| « Reconnexion nécessaire » | L’accès a été révoqué ou a expiré dans Salesforce : cliquez sur « Reconnecter ». |
Questions fréquentes
Que lit Dominium Pilot ? Les étapes d’opportunité, les Leads et Contacts (pour éviter les doublons, et relancer vos prospects si vous l’activez) et les opportunités qu’il a créées.
Peut-on couper l’accès ? Oui : révoquez l’app dans Salesforce, ou désactivez l’intégration dans Dominium Pilot.
Faut-il une édition particulière ? L’accès API doit être inclus dans votre édition Salesforce (Enterprise, Unlimited, Performance ou Developer).