🔗 Intégration de Salesforce avec Un1ty (3CX)

L’intégration native entre Salesforce CRM et Un1ty (3CX) vous permet d’automatiser la gestion de vos appels, de synchroniser vos contacts et de suivre les interactions directement dans Salesforce.

🛠️ Étape 1 : Configurer une application dans Salesforce

🔑 1. Se connecter à Salesforce

• Connectez-vous sur https://login.salesforce.com

  ou créez un compte développeur via : https://developer.salesforce.com/signup

  

  

🧭 2. Accéder au gestionnaire d’applications

• Cliquez sur l’icône d’engrenage, puis sélectionnez « Configuration ».

• Dans le menu latéral gauche, sous « OUTILS DE LA PLATEFORME », cliquez sur :

  Applications > Gestionnaire d’applications

• Cliquez sur le bouton « Nouvelle application connectée » en haut à droite.

🧾 3. Créer l’application

• Dans la fenêtre contextuelle, cliquez sur « Créer une application connectée », puis sur Continuer.

• Complétez les informations de base :

  • Nom de l'application : Intégration Un1ty (3CX)

  • E-mail de contact

🛡️ 4. Activer les paramètres OAuth

• Faites défiler vers API (Activer les paramètres OAuth) et cochez :

  • ✅ « Activer les paramètres OAuth »

  • ✅ « Exiger un secret pour le flux du serveur Web »

  • ✅ « Exiger un secret pour le flux de jetons d'actualisation »

  • 🔐 PKCE (Proof Key for Code Exchange) est pris en charge depuis la version 20 update 6 d’Un1ty. Vous pouvez activer l'option :

    « Exiger l’extension de clé de preuve pour l’échange de codes (PKCE) pour les flux d’autorisation pris en charge »

    (Optionnel mais recommandé)

🔗 5. URL de rappel (Redirect URL)

• Renseignez l’URL de votre console Un1ty (3CX), en ajoutant /api/oauth2crm à la fin.

  👉 Exemple : https://my-unity.example.com/api/oauth2crm

🧾 6. Définir les permissions (Scopes OAuth)

Cochez les options suivantes :

• openid

• profile

• email

• address

• phone

• full (Accès complet)

• api

• web

• refresh_token, offline_access (pour les requêtes permanentes)

👉 Cliquez sur « Enregistrer ».

🔍 Étape 2 : Récupérer les identifiants d’API

• Retournez dans Applications > Gestionnaire d’applications

• Recherchez votre application, puis cliquez sur « Afficher »

• Dans la section API (OAuth), cliquez sur « Gérer les informations du client »

• Copiez les champs :

  • 🗝️ Clé client (Client Key)

  • 🔐 Secret client

🧷 Étape 3 : Modifier les politiques OAuth

• Cliquez sur « Gérer », puis sur « Modifier les politiques »

• Dans la section Politiques OAuth :

  • Définissez « Utilisateurs autorisés » sur « Tous les utilisateurs peuvent s’auto-autoriser »

  • Cliquez sur « Enregistrer »

🧮 Étape 4 : Configurer Un1ty (3CX)

⚙️ 1. Accéder à la console d’administration

• Ouvrez votre console d’administration Un1ty (3CX)

• Allez dans « Intégrations » > « CRM »

📋 2. Sélectionner Salesforce

• Choisissez « SalesforceV2 » dans le menu déroulant.

🔐 3. Renseigner les identifiants

• Renseignez :

  • Clé client (Client ID)

  • Secret client

• Cliquez sur « Enregistrer »

🔄 4. Lancer l’autorisation

• Cliquez sur « Autoriser »

• Une fenêtre Salesforce s’ouvre : connectez-vous au compte Salesforce contenant les données CRM

• Cliquez sur « Autoriser » pour donner accès à Un1ty

🧪 5. Vérification du jeton

• Une fois l’accès autorisé, le champ Jeton d’actualisation s'affichera automatiquement sous le bouton « Autoriser »