Salesforce

Salesforce

Votre admin Salesforce crée une petite app dans Salesforce et vous donne deux codes. Vous les collez dans Dominium Pilot, puis vous connectez votre compte.
Pour : Vous et votre admin Salesforce15 minutes

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

  1. Setup → External Client App Manager → New External Client App.

    Nom : Dominium Pilot. Contact Email : votre courriel. Distribution State : Local.

  2. Cochez « Enable OAuth » et collez cette Callback URL :
    Callback URL
    https://dominiumpilot.ca/api/auth/callback/salesforce
  3. 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, …)
  4. 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

Salesforce met parfois quelques minutes à activer une nouvelle app. Attendez 5 minutes avant l’étape 5.

4Enregistrer l’app dans Dominium PilotVous

  1. Réglages → Intégration CRM, « Type de CRM » : Salesforce.
  2. Sur la ligne « App Salesforce », cliquez sur « Utiliser une autre app ».
  3. Collez la « Clé du client (Consumer Key) » et le « Secret du client (Consumer Secret) », puis « Enregistrer l’app ».

5Connecter votre compteVous

  1. Sur la ligne « Compte », cliquez sur « Connecter », puis « Autoriser » chez Salesforce.
  2. 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 SalesforceQuand
LeadPour chaque nouveau prospect. S’il existe déjà comme Lead ou Contact (même courriel), il est réutilisé.
Contact, Account, OpportunityQuand une visite est réservée : le Lead est converti, l’Opportunity placée à l’étape choisie.
EventLa visite, à sa date et son heure.
NoteLe résumé de la demande et de la conversation.

Si ça bloque

MessageQuoi faire
redirect_uri_mismatchLa 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).