Comment connecter Salesforce

Cette intégration permet à Tulina de lire et écrire dans votre Salesforce — contacts, comptes, leads, opportunités et notes — au nom de votre organisation.

Qui peut faire ça. Un administrateur Salesforce, avec les droits pour créer une External Client App. Côté Tulina, un membre de l'org, ou un admin d'org ou d'équipe si vous voulez partager la connexion.

Combien de temps ça prend. 10 à 15 minutes.

Salesforce n'autorise pas un client OAuth partagé entre plusieurs entreprises, donc chaque organisation crée sa propre app dans son propre Salesforce. C'est attendu, et c'est exactement ce que ce guide détaille.

Étape 1 — Créer l'External Client App dans Salesforce

Pour y aller directement, ajoutez /lightning/setup/ManageExternalClientApplication/home à votre domaine Salesforce. Sinon :

1. Dans Salesforce, ouvrez Setup (l'icône d'engrenage, en haut à droite).
2. Dans Quick Find, tapez External Client Apps, puis cliquez sur External Client App Manager. Si votre org n'affiche que l'ancien menu, cherchez plutôt App Manager → New Connected App — même principe, libellés légèrement différents.
3. Cliquez sur New External Client App.
4. Remplissez les informations de base :
   • App name — par exemple Tulina
   • Contact Email — votre propre adresse email
   • Distribution State — Local
5. Sous API (Enable OAuth Settings), cochez Enable OAuth Settings, puis renseignez :
   • Callback URL — copiez-collez exactement https://mcp.oto.cx/api/salesforce/oauth/callback
   • Selected OAuth Scopes — ajoutez au moins Manage user data via APIs (api) et Perform requests at any time (refresh_token, offline_access)
   • Laissez Require Secret for the Web Server Flow coché. C'est le réglage standard pour une intégration côté serveur.
6. Enregistrez.

Étape 2 — Laisser passer les appels API

Par défaut, Salesforce peut bloquer les appels API selon l'adresse IP d'origine. Pour empêcher ce blocage sur Tulina :

1. Depuis la page de votre app, allez sur Manage → Edit Policies, ou l'onglet Policies pour une External Client App.
2. Sous OAuth Policies → IP Relaxation, choisissez Relax IP restrictions.

Il n'y a pas de champ ici pour autoriser une adresse précise : c'est un simple interrupteur pour dire si les restrictions IP de votre org s'appliquent à cette app. Les relâcher est le choix le plus simple et le plus courant pour ce type d'intégration.

Si votre politique de sécurité exige que les restrictions IP restent appliquées partout, l'alternative est Setup → Network Access, en ajoutant l'adresse sortante de Tulina comme Trusted IP Range — 151.115.148.128 à la fois dans Start IP Address et End IP Address, pour que seule cette adresse soit autorisée. À noter : ça s'applique à toute l'org, pas seulement à cette app, donc réservez cette option aux cas où relâcher n'est pas acceptable pour vous.

Étape 3 — Récupérer la consumer key et le secret

1. Toujours sur la page de l'app, cliquez sur Manage Consumer Details.
2. Salesforce vous demande de vérifier votre identité, avec un code envoyé par email ou via votre application d'authentification. Confirmez-le.
3. Copiez et conservez en lieu sûr la Consumer Key (l'identifiant client) et le Consumer Secret (le secret client).

Laissez 5 à 10 minutes à Salesforce après la création de l'app avant de vous connecter. Une app toute neuve met un peu de temps à se propager.

Étape 4 — Connecter Salesforce depuis Tulina

1. Dans Tulina, allez dans Connecteurs.
2. Trouvez la carte Salesforce et cliquez sur Connect Salesforce.
3. Renseignez les trois champs :
   • Consumer Key — celle copiée à l'étape 3
   • Consumer Secret — celui copié à l'étape 3
   • Login URL — l'URL de connexion de votre org, de la forme https://yourcompany.my.salesforce.com
4. Confirmez, puis cliquez sur Connect. Vous êtes envoyé vers Salesforce pour autoriser l'accès sur l'écran de consentement OAuth, et une fois approuvé vous revenez avec Salesforce connecté.

Un prérequis côté Salesforce : le compte qui autorise la connexion a besoin de la permission API Enabled, sur son profil ou via un permission set. Sans elle, la connexion échoue même quand les identifiants sont corrects.

Une fois Salesforce connecté, ces processus tournent dessus : Qualifier les leads entrants, Sourcer et qualifier des leads et Garder les comptes CRM à jour.

Dépannage

« Invalid client », ou « invalid client id ». La consumer key ou le secret a été copié avec un espace superflu — ou l'app ne s'est pas encore propagée, auquel cas attendez quelques minutes et réessayez.

Une erreur liée à l'IP, ou un accès refusé. Retournez à l'étape 2 et vérifiez IP Relaxation.

Pas de refresh token, ou la connexion ne persiste pas. Vérifiez que le scope Perform requests at any time (refresh_token, offline_access) a bien été sélectionné à l'étape 1.

Une incohérence sur le callback ou le redirect_uri. Le Callback URL dans Salesforce doit correspondre exactement, caractère pour caractère : https://mcp.oto.cx/api/salesforce/oauth/callback