Connecteur CRM Salesforce¶
Ce plugin relie votre boutique Shopware 6 à la plateforme CRM leader mondial Salesforce. Les nouveaux clients sont automatiquement créés en tant que contacts et comptes, les commandes sont cartographiées en tant qu'opportunités dans votre pipeline commercial et tous les changements de statut sont documentés en tant qu'activités – en temps réel, entièrement automatique et sans effort manuel.
Points forts
- 👤 Création automatique de clients comme contact dans Salesforce
- 🏢 Les clients B2B avec nom d'entreprise sont créés comme compte Salesforce
- 💼 Chaque commande crée automatiquement une opportunité dans votre pipeline
- 🔔 Le paiement, l'expédition et l'annulation sont documentés comme activités
- 🔐 Connexion sécurisée OAuth-2.0 via une application Salesforce connectée
- 🧪 Support du bac à sable – testez en toute sécurité avant la mise en production
❓ FAQ¶
Qu'est-ce que Salesforce?
Salesforce est la plateforme CRM leader mondial. Via l'API REST Salesforce, il est possible de créer et mettre à jour automatiquement des contacts, des comptes, des opportunités et des activités. Pour utiliser le service, vous avez besoin d'un compte Salesforce actif avec accès à l'API.
Quelles données sont synchronisées avec Salesforce?
Les nouveaux clients sont créés en tant que contact, pour les clients professionnels (B2B), un compte est également créé. Chaque commande devient une opportunité dans le pipeline configuré. Les changements de statut tels que le paiement, l'expédition ou l'annulation sont documentés en tant qu'activités à l'opportunité correspondante.
Comment la connexion à Salesforce est-elle établie?
La connexion s'effectue via OAuth 2.0 avec une application Salesforce connectée – sécurisée et sans transmission de mot de passe. Dans Salesforce, vous créez une application connectée, stockez Consumer Key et Secret dans le plugin et autorisez l'accès une seule fois.
Le bac à sable Salesforce est-il pris en charge?
Oui. Vous pouvez d'abord tester l'intégration en toute sécurité par rapport à votre bac à sable Salesforce (test.salesforce.com) et ne basculer vers l'environnement de production (login.salesforce.com) qu'après contrôle réussi.
La synchronisation est-elle automatique?
Oui. Le transfert s'effectue en temps réel basé sur les événements via l'infrastructure Shopware Events/Flow. Dans les paramètres du plugin, vous spécifiez les événements Shopware à envoyer à Salesforce.
Qu'est-ce que la synchronisation bidirectionnelle?
Les modifications dans Salesforce – par exemple une opportunité sur « Closed Won » – peuvent éventuellement fonctionner à l'envers et par exemple mettre à jour le groupe de clients dans Shopware. Cette direction inverse peut être désactivée.
Le plugin est-il conforme au RGPD?
Toutes les données transférées restent dans votre propre instance Salesforce. La connexion s'effectue exclusivement via l'accès officiel autorisé par vous via OAuth.
Quelles sont les conditions préalables?
Le plugin nécessite le plugin CNK Foundation (à partir de la version 3.0.4) et Shopware 6.7. Du côté de Salesforce, un compte actif avec accès à l'API et une application connectée sont nécessaires.
🔧 Installation¶
- Condition préalable : Plugin CNK Foundation (à partir de la version 3.0.4)
- Condition préalable : Compte Salesforce actif avec application connectée
- Installation via le gestionnaire de plugins Shopware ou via Composer
- Activer le plugin :
bin/console plugin:install --activate CnkPlatformSalesForceConnector - Effectuez la configuration dans la zone d'administration de Shopware
⚙️ Configuration¶
Accès OAuth (Application connectée)¶
| Paramètre | Description |
|---|---|
| Environnement | Production (login.salesforce.com) ou bac à sable (test.salesforce.com) |
| Consumer Key | Consumer Key de l'application Salesforce connectée |
| Consumer Secret | Secret correspondant de l'application connectée |
| Connecter à Salesforce | Bouton qui démarre le flux d'autorisation OAuth-2.0 et confirme la connexion dans l'admin |
Vous créez l'application connectée dans Salesforce sous Setup → App Manager → New Connected App avec les paramètres OAuth activés. L'URL de rappel affichée dans le plugin doit y être enregistrée en tant qu'URL de redirection autorisée.
Attribution des opportunités et du pipeline¶
| Paramètre | Description | Standard |
|---|---|---|
| Pipeline / Type d'enregistrement | Liste de sélection des pipelines d'opportunité existants dans Salesforce | Standard |
| Étape de démarrage | Étape dans laquelle les nouvelles opportunités sont créées | première étape |
| Schéma du nom de l'opportunité | Motif du nom (par exemple Commande {orderNumber}) | Commande {orderNumber} |
| Montant | Reprendre le montant de la commande comme montant de l'opportunité | Activé |
Sélection d'événement¶
| Paramètre | Description | Standard |
|---|---|---|
| Créer un contact | Transférer un nouveau client comme contact (+ compte pour B2B) | Activé |
| Commande → Opportunité | Créer une opportunité lors de la saisie de la commande | Activé |
| Paiement | Enregistrer la réception du paiement comme activité | Activé |
| Expédition | Enregistrer l'expédition comme activité | Activé |
| Annulation | Enregistrer l'annulation comme activité | Activé |
| Bidirectionnel | Refléter le statut de l'opportunité de Salesforce vers Shopware | Désactivé |
🔄 Synchronisations en détail¶
Synchronisation des contacts et des comptes¶
Lors du déclencheur sélectionné (par exemple inscription ou première commande), le client est créé dans Salesforce :
- Le client est créé en tant que contact avec nom, e-mail et numéro de téléphone
- Si une entreprise est enregistrée (B2B), un compte est également créé et le contact est lié
- Les clients déjà transférés sont reconnus par l'ID Salesforce enregistré et mis à jour (pas de doublon)
Création d'opportunités¶
Chaque commande génère une opportunité dans le pipeline configuré :
- L'opportunité est attribuée au contact/compte correspondant
- Le nom et le montant sont définis selon la configuration
- L'ID d'opportunité Salesforce est enregistré à la commande Shopware pour éviter les créations doubles
Activités de statut¶
Les changements de statut de la commande sont documentés comme activités à l'opportunité – par exemple « Paiement reçu », « Expédié » ou « Annulé ». L'équipe commerciale voit l'historique complet directement dans Salesforce.
Synchronisation bidirectionnelle (optionnelle)¶
Si la direction inverse est activée, des comparaisons régulières évaluent les modifications dans Salesforce. Exemple : Si une opportunité passe à « Closed Won », le groupe de clients du client Shopware correspondant peut être automatiquement ajusté.
📊 Tableau de bord de synchronisation¶
Le tableau de bord de synchronisation dans la zone d'administration offre :
- Aperçu de tous les enregistrements synchronisés (Contacts, Comptes, Opportunités, Activités)
- Statut de chaque transfert (réussi / échoué)
- Journal des erreurs avec message de détail de l'API Salesforce
- Bouton Synchroniser manuel pour relancer les transferts échoués
🛒 Cas d'usage typiques¶
Ventes Enterprise B2B¶
Les clients professionnels sont gérés comme un compte avec des contacts assignés dans Salesforce. Chaque commande est une opportunité dans le pipeline et donne à l'équipe commerciale un aperçu immédiat du comportement d'achat.
Entreprises moyennes et grandes¶
Les commandes récurrentes créent des opportunités traçables incluant l'historique des activités. L'équipe commerciale peut faire du cross-selling et up-selling ciblés.
Onboarding sécurisé via bac à sable¶
L'intégration complète peut être testée dans le bac à sable Salesforce avant la mise en production – sans impact sur les données de production.
⭐ Avantages pour les exploitants de boutiques¶
- Pas de transfert manuel de clients et de commandes vers le CRM
- L'équipe commerciale travaille entièrement dans Salesforce – avec des données en temps réel du magasin
- Connexion sécurisée OAuth-2.0 via une application connectée
- Test sans risque grâce au support du bac à sable
- Conforme au RGPD : Les données restent dans la propre instance Salesforce
🧩 Ensemble des fonctionnalités¶
- Création de clients comme contact et – pour B2B – comme compte
- Création d'opportunités à partir de commandes dans le pipeline configurable
- Documentation du paiement, de l'expédition et de l'annulation comme activités
- Synchronisation bidirectionnelle optionnelle (statut de l'opportunité → groupe de clients)
- Tableau de bord de synchronisation avec journal des erreurs et retry manuel
- Support du bac à sable pour tests sans risque
- Connexion sécurisée OAuth-2.0 via une application Salesforce connectée
- Sélection d'événements librement configurable
📚 Documentation¶
Plus de contenu et de captures d'écran de documentation seront fournis dans les prochaines versions du plugin.
Documentation technique de l'API Salesforce : https://developer.salesforce.com/docs/apis