Connecteur Zoho CRM¶
Ce plugin connecte votre boutique Shopware 6 avec Zoho CRM et comble l'écart entre la boutique en ligne et l'équipe commerciale. Les nouveaux clients sont automatiquement créés comme contacts, les clients B2B en tant que compte, les commandes comme deals dans votre pipeline de ventes et tous les changements de statut comme activités – en temps réel, entièrement automatique et sans effort manuel.
Points forts
- 👤 Création automatique de clients comme contact dans Zoho CRM
- 🏢 Les clients B2B avec nom de société sont créés comme compte Zoho
- 💼 Chaque commande crée automatiquement un deal dans votre pipeline
- 🔔 Le paiement, l'expédition et l'annulation sont enregistrés comme activités
- 🔐 Connexion sécurisée OAuth 2.0 sans clés API manuelles
- 📊 Tableau de bord de synchronisation avec journal d'erreurs et bouton de synchronisation manuel
❓ FAQ¶
Qu'est-ce que Zoho CRM?
Zoho CRM est une plateforme CRM et de vente très répandue. Via l'API REST officielle de Zoho CRM, les contacts, les comptes, les deals et les activités peuvent être créés et mis à jour automatiquement. Pour l'utiliser, vous avez besoin d'un compte Zoho CRM actif.
Quelles données sont synchronisées avec Zoho CRM?
Les nouveaux clients sont créés comme contact, pour les clients B2B, un compte supplémentaire est créé. Chaque commande devient un deal dans le pipeline configuré. Les changements de statut comme le paiement, l'expédition ou l'annulation sont enregistrés comme activités sur le deal correspondant.
Comment la connexion à Zoho est-elle établie?
La connexion se fait via OAuth 2.0 – sécurisée et sans clés API manuelles. Dans la console API Zoho, vous créez un client OAuth, enregistrez l'ID client et le secret dans le plugin et autorisez l'accès une seule fois. La région Zoho appropriée (EU, COM, IN, AU) est sélectionnable.
La synchronisation se fait-elle automatiquement?
Oui. Le transfert s'effectue en temps réel via l'infrastructure Shopware Event/Flow. Dans les paramètres du plugin, vous définissez quels événements Shopware (par exemple inscription, réception de commande, réception de paiement) sont envoyés à Zoho CRM.
Qu'est-ce que la synchronisation bidirectionnelle?
Les modifications dans Zoho CRM – comme la définition d'un deal comme « gagné » – peuvent éventuellement affecter Shopware et, par exemple, mettre à jour le groupe de clients. Cette direction inverse peut être désactivée.
Que se passe-t-il en cas d'échec du transfert?
Chaque transfert est enregistré dans le Tableau de bord de synchronisation avec le statut. Les transferts échoués apparaissent dans le journal d'erreurs et peuvent être relancés manuellement (Retry).
Le plugin est-il conforme au RGPD?
Toutes les données transférées restent dans votre propre instance Zoho. La connexion se fait exclusivement via l'accès Zoho OAuth officiel que vous avez autorisé.
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 Zoho, un compte CRM actif et un client OAuth (ID client & Secret) sont nécessaires.
🔧 Installation¶
- Prérequis : Plugin CNK Foundation (à partir de la version 3.0.4)
- Prérequis : Compte Zoho CRM actif avec client OAuth
- Installation via le gestionnaire de plugins Shopware ou par Composer
- Activer le plugin :
bin/console plugin:install --activate CnkPlatformZohoCrm - Effectuer la configuration dans l'espace d'administration Shopware
⚙️ Configuration¶
Accès OAuth¶
| Paramètre | Description |
|---|---|
| Région Zoho | Centre de données de votre compte Zoho : EU (.eu), COM (.com), IN (.in), AU (.com.au) |
| ID client | ID client du client OAuth de la console API Zoho |
| Secret client | Secret correspondant du client OAuth |
| Connecter à Zoho | Bouton qui démarre le flux d'autorisation OAuth 2.0 et confirme la connexion dans l'admin |
Vous créez le client OAuth dans la console API Zoho (api-console.zoho.eu) en tant qu'application serveur. L'URL de redirection affichée dans le plugin doit y être enregistrée comme redirection autorisée.
Correspondance Deal & Pipeline¶
| Paramètre | Description | Standard |
|---|---|---|
| Pipeline cible | Liste de sélection des pipelines/mises en page existantes dans Zoho | Pipeline standard |
| Phase de démarrage | Phase dans laquelle les nouveaux deals sont créés | première phase |
| Schéma du titre du deal | Modèle pour le titre du deal (par exemple Commande {orderNumber}) | Commande {orderNumber} |
| Valeur du deal | Accepter la somme de la commande comme valeur du deal | Actif |
Sélection des événements¶
| Paramètre | Description | Standard |
|---|---|---|
| Créer contact | Transférer un nouveau client comme contact (+ compte pour B2B) | Actif |
| Commande → Deal | Créer un deal à la réception de la commande | Actif |
| Paiement | Enregistrer la réception du paiement comme activité | Actif |
| Expédition | Enregistrer l'expédition comme activité | Actif |
| Annulation | Enregistrer l'annulation comme activité | Actif |
| Bidirectionnel | Refléter le statut du deal de Zoho vers Shopware | Inactif |
🔄 Synchronisations en détail¶
Synchronisation des contacts et des comptes¶
À l'événement sélectionné (par exemple inscription ou première commande), le client est créé dans Zoho CRM :
- Le client est créé comme contact avec nom, e-mail et numéro de téléphone
- Pour une entreprise enregistrée (B2B), un compte supplémentaire est créé et le contact est lié
- Les clients déjà transférés sont reconnus par l'ID Zoho stocké et mis à jour (pas de doublon)
Création de deal¶
Chaque commande crée un deal dans le pipeline configuré :
- Le deal est assigné au contact/compte correspondant
- Le titre et la valeur sont définis selon la configuration
- L'ID du deal Zoho est stocké sur la commande Shopware pour éviter les doublons
Activités de statut¶
Les changements de statut de la commande sont enregistrés comme activités sur le deal – par exemple « Paiement reçu », « Expédié » ou « Annulé ». Ainsi, l'équipe commerciale voit l'historique complet directement dans Zoho CRM.
Synchronisation bidirectionnelle (optionnelle)¶
Si la direction inverse est activée, les rapprochements périodiques évaluent les modifications dans Zoho. Exemple : Si un deal est défini sur « gagné », le groupe de clients du client Shopware correspondant peut être automatiquement ajusté.
📊 Tableau de bord de synchronisation¶
Le tableau de bord de synchronisation dans l'espace d'administration offre :
- Aperçu de tous les enregistrements synchronisés (contacts, comptes, deals, activités)
- Statut pour chaque transfert (réussi / échoué)
- Journal d'erreurs avec message détaillé de l'API Zoho
- Bouton de synchronisation manuel pour relancer les transferts individuels ou échoués
🛒 Cas d'utilisation typiques¶
Vente B2B¶
Les clients B2B sont gérés en tant que compte avec des contacts assignés dans Zoho. Chaque commande atterrit comme un deal dans le pipeline et donne à l'équipe commerciale un aperçu immédiat du comportement d'achat.
Commerce de gros et petit commerce¶
Les commandes récurrentes créent des deals traçables incluant l'historique des activités. L'équipe commerciale peut effectuer des Cross- et Up-Selling ciblés.
Nurturing des leads¶
Les nouvelles inscriptions sont créées comme contacts et peuvent être qualifiées davantage dans Zoho avant la première commande.
⭐ Avantages pour les exploitants de boutique¶
- Aucun transfert manuel de clients et de commandes dans le CRM
- L'équipe commerciale travaille systématiquement dans Zoho CRM – avec des données en temps réel du magasin
- Connexion sécurisée OAuth 2.0 sans clés API manuelles
- Traçabilité complète via les ID Zoho dans Shopware
- Conforme au RGPD : Les données restent dans votre propre instance Zoho
🧩 Portée des fonctionnalités¶
- Création de clients comme contact et – pour B2B – comme compte
- Création de deal à partir de commandes dans le pipeline configurable
- Enregistrement du paiement, de l'expédition et de l'annulation comme activités
- Synchronisation bidirectionnelle optionnelle (statut du deal → groupe de clients)
- Tableau de bord de synchronisation avec journal d'erreurs et retry manuel
- Connexion sécurisée OAuth 2.0 incluant la sélection de la région Zoho
- Sélection d'événements librement configurable
- Enregistrement des erreurs via la journalisation Shopware
📚 Documentation¶
Le contenu de la documentation supplémentaire et les captures d'écran seront fournis avec les prochaines versions du plugin.
Documentation technique de l'API Zoho CRM : https://www.zoho.com/crm/developer/docs/api/v6/
📬 Support¶
Pour toute question, suggestion d'amélioration ou personnalisation, veuillez nous contacter par e-mail à support@cnk-plugins.de.