Zoho CRM Connector¶
Dieses Plugin verbindet Ihren Shopware 6 Shop mit Zoho CRM und schließt die Lücke zwischen Online-Shop und Vertriebsteam. Neue Kunden werden automatisch als Kontakte angelegt, Firmenkunden zusätzlich als Konto (Account), Bestellungen als Deals in Ihrer Vertriebspipeline abgebildet und alle Statusänderungen als Aktivitäten protokolliert – in Echtzeit, vollautomatisch und ohne manuellen Aufwand.
Highlights
- 👤 Automatische Anlage von Kunden als Kontakt in Zoho CRM
- 🏢 B2B-Kunden mit Firmennamen werden als Zoho-Konto (Account) angelegt
- 💼 Jede Bestellung erzeugt automatisch einen Deal in Ihrer Pipeline
- 🔔 Zahlung, Versand und Stornierung werden als Aktivitäten protokolliert
- 🔐 Sichere OAuth-2.0-Verbindung ohne manuelle API-Schlüssel
- 📊 Sync-Dashboard mit Fehlerprotokoll und manuellem Sync-Button
❓ FAQ¶
Was ist Zoho CRM?
Zoho CRM ist eine weit verbreitete CRM- und Sales-Plattform. Über die offizielle Zoho CRM REST API lassen sich Kontakte, Konten (Accounts), Deals und Aktivitäten automatisiert anlegen und aktualisieren. Für die Nutzung benötigen Sie einen aktiven Zoho-CRM-Account.
Welche Daten werden mit Zoho CRM synchronisiert?
Neue Kunden werden als Kontakt angelegt, bei Firmenkunden (B2B) zusätzlich als Konto (Account). Jede Bestellung wird zu einem Deal in der konfigurierten Pipeline. Statusänderungen wie Zahlung, Versand oder Stornierung werden als Aktivitäten am zugehörigen Deal protokolliert.
Wie wird die Verbindung zu Zoho hergestellt?
Die Anbindung erfolgt über OAuth 2.0 – sicher und ohne manuelle API-Schlüssel. In der Zoho API Console legen Sie einen OAuth-Client an, hinterlegen Client-ID und Secret im Plugin und autorisieren den Zugriff einmalig. Die passende Zoho-Region (EU, COM, IN, AU) ist wählbar.
Erfolgt die Synchronisation automatisch?
Ja. Die Übertragung läuft ereignisbasiert in Echtzeit über die Shopware Event-/Flow-Infrastruktur. In den Plugin-Einstellungen legen Sie fest, welche Shopware-Events (z. B. Registrierung, Bestelleingang, Zahlungseingang) an Zoho CRM gesendet werden.
Was bedeutet bidirektionale Synchronisation?
Änderungen in Zoho CRM – etwa das Setzen eines Deals auf „gewonnen" – können optional zurück nach Shopware wirken und dort z. B. die Kundengruppe aktualisieren. Diese Rückrichtung ist abschaltbar.
Was passiert, wenn eine Übertragung fehlschlägt?
Jede Übertragung wird im Sync-Dashboard mit Status protokolliert. Fehlgeschlagene Übertragungen erscheinen im Fehlerprotokoll und können manuell erneut angestoßen werden (Retry).
Ist das Plugin DSGVO-konform?
Alle übertragenen Daten verbleiben in Ihrer eigenen Zoho-Instanz. Die Anbindung erfolgt ausschließlich über den offiziellen, von Ihnen autorisierten Zoho-OAuth-Zugang.
Welche Voraussetzungen gibt es?
Das Plugin setzt das CNK Foundation Plugin (ab Version 3.0.4) und Shopware 6.7 voraus. Auf Seite von Zoho werden ein aktiver CRM-Account und ein OAuth-Client (Client-ID & Secret) benötigt.
🔧 Installation¶
- Voraussetzung: CNK Foundation Plugin (ab Version 3.0.4)
- Voraussetzung: aktiver Zoho-CRM-Account mit OAuth-Client
- Installation über den Shopware Plugin-Manager oder per Composer
- Plugin aktivieren:
bin/console plugin:install --activate CnkPlatformZohoCrm - Konfiguration im Shopware-Administrationsbereich vornehmen
⚙️ Konfiguration¶
OAuth-Zugang¶
| Einstellung | Beschreibung |
|---|---|
| Zoho-Region | Rechenzentrum Ihres Zoho-Accounts: EU (.eu), COM (.com), IN (.in), AU (.com.au) |
| Client-ID | Client-ID des OAuth-Clients aus der Zoho API Console |
| Client-Secret | Zugehöriges Secret des OAuth-Clients |
| Mit Zoho verbinden | Schaltfläche, die den OAuth-2.0-Autorisierungsfluss startet und die Verbindung im Admin bestätigt |
Den OAuth-Client legen Sie in der Zoho API Console (api-console.zoho.eu) als „Server-based Application" an. Die im Plugin angezeigte Redirect-URL muss dort als autorisierte Weiterleitung hinterlegt werden.
Deal- & Pipeline-Zuordnung¶
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Zielpipeline | Auswahlliste der in Zoho vorhandenen Pipelines/Layouts | Standard-Pipeline |
| Start-Phase | Phase, in der neue Deals angelegt werden | erste Phase |
| Deal-Titelschema | Muster für den Deal-Titel (z. B. Bestellung {orderNumber}) | Bestellung {orderNumber} |
| Deal-Wert | Bestellsumme als Deal-Wert übernehmen | Ein |
Event-Auswahl¶
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Kontakt anlegen | Neuen Kunden als Kontakt (+ Konto bei B2B) übertragen | Ein |
| Bestellung → Deal | Bei Bestelleingang einen Deal anlegen | Ein |
| Zahlung | Zahlungseingang als Aktivität protokollieren | Ein |
| Versand | Versand als Aktivität protokollieren | Ein |
| Stornierung | Stornierung als Aktivität protokollieren | Ein |
| Bidirektional | Deal-Status aus Zoho nach Shopware zurückspiegeln | Aus |
🔄 Synchronisierungen im Detail¶
Kontakt- & Konto-Synchronisation¶
Beim ausgewählten Auslöser (z. B. Registrierung oder erste Bestellung) wird der Kunde in Zoho CRM angelegt:
- Der Kunde wird als Kontakt mit Name, E-Mail und Telefonnummer angelegt
- Bei hinterlegter Firma (B2B) wird zusätzlich ein Konto (Account) erstellt und der Kontakt verknüpft
- Bereits übertragene Kunden werden anhand der gespeicherten Zoho-ID erkannt und aktualisiert (kein Duplikat)
Deal-Erstellung¶
Jede Bestellung erzeugt einen Deal in der konfigurierten Pipeline:
- Der Deal wird dem zugehörigen Kontakt/Konto zugeordnet
- Titel und Wert werden gemäß Konfiguration gesetzt
- Die Zoho-Deal-ID wird an der Shopware-Bestellung gespeichert, um Doppelanlagen zu verhindern
Status-Aktivitäten¶
Statusänderungen der Bestellung werden als Aktivitäten am Deal protokolliert – etwa „Zahlung eingegangen", „Versandt" oder „Storniert". So sieht das Vertriebsteam den kompletten Verlauf direkt in Zoho CRM.
Bidirektionale Synchronisation (optional)¶
Ist die Rückrichtung aktiviert, werten regelmäßige Abgleiche Änderungen in Zoho aus. Beispiel: Wird ein Deal auf „gewonnen" gesetzt, kann die Kundengruppe des zugehörigen Shopware-Kunden automatisch angepasst werden.
📊 Sync-Dashboard¶
Das Sync-Dashboard im Administrationsbereich bietet:
- Übersicht aller synchronisierten Datensätze (Kontakte, Konten, Deals, Aktivitäten)
- Status je Übertragung (erfolgreich / fehlgeschlagen)
- Fehlerprotokoll mit Detailmeldung der Zoho-API
- Manueller Sync-Button zum erneuten Anstoßen einzelner oder fehlgeschlagener Übertragungen
🛒 Typische Anwendungsfälle¶
B2B-Vertrieb¶
Firmenkunden werden als Konto mit zugeordneten Kontakten in Zoho geführt. Jede Bestellung landet als Deal in der Pipeline und gibt dem Vertrieb sofort Einblick in das Kaufverhalten.
Großhandel & Mittelstand¶
Wiederkehrende Bestellungen erzeugen nachvollziehbare Deals inkl. Aktivitätenverlauf. Das Vertriebsteam kann gezielt Cross- und Up-Selling betreiben.
Lead-Nurturing¶
Neue Registrierungen werden als Kontakte angelegt und können in Zoho weiter qualifiziert werden, noch bevor die erste Bestellung erfolgt.
⭐ Vorteile für Shopbetreiber¶
- Kein manuelles Übertragen von Kunden und Bestellungen ins CRM
- Vertriebsteam arbeitet durchgängig in Zoho CRM – mit Echtzeit-Daten aus dem Shop
- Sichere OAuth-2.0-Anbindung ohne manuelle API-Schlüssel
- Vollständige Nachvollziehbarkeit durch Zoho-IDs in Shopware
- DSGVO-konform: Daten verbleiben in der eigenen Zoho-Instanz
🧩 Funktionsumfang¶
- Anlage von Kunden als Kontakt und – bei B2B – als Konto (Account)
- Deal-Erstellung aus Bestellungen in der konfigurierbaren Pipeline
- Protokollierung von Zahlung, Versand und Stornierung als Aktivitäten
- Optionale bidirektionale Synchronisation (Deal-Status → Kundengruppe)
- Sync-Dashboard mit Fehlerprotokoll und manuellem Retry
- Sichere OAuth-2.0-Anbindung inkl. Auswahl der Zoho-Region
- Frei konfigurierbare Event-Auswahl
- Fehlerprotokollierung über Shopware-Logging
📚 Dokumentation¶
Weitere Dokumentationsinhalte und Screenshots folgen mit den nächsten Versionen des Plugins.
Technische API-Dokumentation von Zoho CRM: https://www.zoho.com/crm/developer/docs/api/v6/