Pipedrive CRM Connector¶
Dieses Plugin verbindet Ihren Shopware 6 Shop mit Pipedrive CRM und schließt die Lücke zwischen Online-Shop und Vertriebsteam. Neue Kunden werden automatisch als Personen und Organisationen in Pipedrive angelegt, 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 Person (+ Organisation bei B2B)
- 💼 Jede Bestellung erzeugt automatisch einen Deal in Ihrer Pipeline
- 🔔 Zahlung, Versand und Stornierung werden als Aktivitäten protokolliert
- 🔄 Optionale bidirektionale Synchronisation (Deal-Status → Kundengruppe)
- 📊 Sync-Dashboard mit Fehlerprotokoll und manuellem Sync-Button
- ⚙️ Frei konfigurierbar, welche Shopware-Events übertragen werden
❓ FAQ¶
Was ist Pipedrive?
Pipedrive ist ein weit verbreitetes CRM- und Sales-Pipeline-Tool. Über die offizielle Pipedrive REST API lassen sich Personen, Organisationen, Deals und Aktivitäten automatisiert anlegen und aktualisieren. Für die Nutzung benötigen Sie einen aktiven Pipedrive-Account und einen API-Token.
Welche Daten werden mit Pipedrive synchronisiert?
Neue Kunden werden als Person angelegt, bei Firmenkunden (B2B) zusätzlich als Organisation. 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.
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 Pipedrive gesendet werden.
Was bedeutet bidirektionale Synchronisation?
Änderungen in Pipedrive – 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 bleiben in Ihrer eigenen Pipedrive-Instanz. Die Anbindung erfolgt ausschließlich über den offiziellen, von Ihnen autorisierten Pipedrive-API-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 Pipedrive werden ein aktiver Account und ein API-Token benötigt.
🔧 Installation¶
- Voraussetzung: CNK Foundation Plugin (ab Version 3.0.4)
- Voraussetzung: aktiver Pipedrive-Account mit API-Token
- Installation über den Shopware Plugin-Manager oder per Composer
- Plugin aktivieren:
bin/console plugin:install --activate CnkPlatformPipedrive - Konfiguration im Shopware-Administrationsbereich vornehmen
⚙️ Konfiguration¶
API-Zugang¶
| Einstellung | Beschreibung |
|---|---|
| API-Token | Persönlicher API-Token aus Ihrem Pipedrive-Account (Einstellungen → Persönliche Einstellungen → API) |
| Unternehmens-Domain | Ihre Pipedrive-Domain (z. B. meinunternehmen.pipedrive.com) |
| Verbindung testen | Schaltfläche, die den Token gegen die Pipedrive-API prüft und das Ergebnis direkt im Admin anzeigt |
Deal- & Pipeline-Zuordnung¶
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Zielpipeline | Auswahlliste der in Pipedrive vorhandenen Pipelines | erste 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 |
|---|---|---|
| Kunde anlegen | Neuen Kunden als Person/Organisation ü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 Pipedrive nach Shopware zurückspiegeln | Aus |
🔄 Synchronisierungen im Detail¶
Kontakt-Synchronisation¶
Beim ausgewählten Auslöser (z. B. Registrierung oder erste Bestellung) wird der Kunde in Pipedrive angelegt:
- Der Kunde wird als Person mit Name, E-Mail und Telefonnummer angelegt
- Bei hinterlegter Firma (B2B) wird zusätzlich eine Organisation erstellt und die Person verknüpft
- Bereits übertragene Kunden werden anhand der gespeicherten Pipedrive-ID erkannt und aktualisiert (kein Duplikat)
Deal-Erstellung¶
Jede Bestellung erzeugt einen Deal in der konfigurierten Pipeline:
- Der Deal wird der zugehörigen Person/Organisation zugeordnet
- Titel und Wert werden gemäß Konfiguration gesetzt
- Die Pipedrive-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 Pipedrive.
Bidirektionale Synchronisation (optional)¶
Ist die Rückrichtung aktiviert, werten regelmäßige Abgleiche Änderungen in Pipedrive 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 (Personen, Organisationen, Deals, Aktivitäten)
- Status je Übertragung (erfolgreich / fehlgeschlagen)
- Fehlerprotokoll mit Detailmeldung der Pipedrive-API
- Manueller Sync-Button zum erneuten Anstoßen einzelner oder fehlgeschlagener Übertragungen
🛒 Typische Anwendungsfälle¶
B2B-Vertrieb¶
Firmenkunden werden als Organisation mit zugeordneten Ansprechpartnern in Pipedrive geführt. Jede Bestellung landet als Deal in der Pipeline und gibt dem Vertrieb sofort Einblick in das Kaufverhalten.
Großhandel & Industrie¶
Wiederkehrende Bestellungen erzeugen nachvollziehbare Deals inkl. Aktivitätenverlauf. Das Vertriebsteam kann gezielt Cross- und Up-Selling betreiben.
Lead-Nurturing¶
Neue Registrierungen werden als Personen angelegt und können in Pipedrive 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 Pipedrive – mit Echtzeit-Daten aus dem Shop
- Vollständige Nachvollziehbarkeit durch Pipedrive-IDs in Shopware
- Selbst steuerbar, welche Events übertragen werden
- DSGVO-konform: Daten bleiben in der eigenen Pipedrive-Instanz
🧩 Funktionsumfang¶
- Anlage von Kunden als Person und – bei B2B – als Organisation
- 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
- Frei konfigurierbare Event-Auswahl
- API-Verbindungstest direkt in den Plugin-Einstellungen
- Fehlerprotokollierung über Shopware-Logging
📚 Dokumentation¶
Weitere Dokumentationsinhalte und Screenshots folgen mit den nächsten Versionen des Plugins.
Technische API-Dokumentation von Pipedrive: https://developers.pipedrive.com/docs/api/v1