Connettore Pipedrive CRM¶
Questo plugin collega il tuo negozio Shopware 6 a Pipedrive CRM e colma il divario tra il tuo negozio online e il tuo team di vendita. I nuovi clienti vengono creati automaticamente come persone e organizzazioni in Pipedrive, gli ordini vengono mappati come opportunità nella tua pipeline di vendita e tutti i cambi di stato vengono documentati come attività – in tempo reale, completamente automatico e senza sforzo manuale.
Punti salienti
- 👤 Creazione automatica di clienti come persona (+ organizzazione per B2B)
- 💼 Ogni ordine crea automaticamente un'opportunità nella tua pipeline
- 🔔 Il pagamento, la spedizione e l'annullamento vengono documentati come attività
- 🔄 Sincronizzazione bidirezionale opzionale (stato opportunità → gruppo clienti)
- 📊 Dashboard di sincronizzazione con registro errori e pulsante sincronizzazione manuale
- ⚙️ Completamente configurabile, quali eventi Shopware vengono trasferiti
❓ Domande frequenti¶
Cos'è Pipedrive?
Pipedrive è uno strumento CRM e pipeline di vendita molto diffuso. Tramite l'API REST ufficiale di Pipedrive, è possibile creare e aggiornare automaticamente persone, organizzazioni, opportunità e attività. Per utilizzare il servizio, è necessario un account Pipedrive attivo e un token API.
Quali dati vengono sincronizzati con Pipedrive?
I nuovi clienti vengono creati come persona, per i clienti aziendali (B2B), viene creata anche un'organizzazione. Ogni ordine diventa un'opportunità nella pipeline configurata. I cambi di stato come pagamento, spedizione o annullamento vengono documentati come attività sull'opportunità corrispondente.
La sincronizzazione è automatica?
Sì. Il trasferimento avviene in tempo reale basato su eventi tramite l'infrastruttura Shopware Events/Flow. Nella configurazione del plugin, specifichi gli eventi Shopware (ad esempio registrazione, immissione ordine, ricezione pagamento) da inviare a Pipedrive.
Cos'è la sincronizzazione bidirezionale?
I cambiamenti in Pipedrive – come l'impostazione di un'opportunità su "vinta" – possono facoltativamente funzionare al contrario e ad esempio aggiornare il gruppo di clienti in Shopware. Questa direzione inversa può essere disabilitata.
Cosa succede se un trasferimento ha esito negativo?
Ogni trasferimento viene registrato nel dashboard di sincronizzazione con uno stato. I trasferimenti non riusciti vengono visualizzati nel registro errori e possono essere riavviati manualmente (Retry).
Il plugin è conforme al GDPR?
Tutti i dati trasferiti rimangono nella tua propria istanza Pipedrive. La connessione viene effettuata esclusivamente tramite l'accesso autorizzato da te all'API Pipedrive.
Quali sono i prerequisiti?
Il plugin richiede il plugin CNK Foundation (a partire dalla versione 3.0.4) e Shopware 6.7. Dal lato Pipedrive, è necessario un account attivo e un token API.
🔧 Installazione¶
- Prerequisito: Plugin CNK Foundation (a partire dalla versione 3.0.4)
- Prerequisito: Account Pipedrive attivo con token API
- Installazione tramite il gestore plugin di Shopware o via Composer
- Attiva il plugin:
bin/console plugin:install --activate CnkPlatformPipedrive - Esegui la configurazione nell'area di amministrazione di Shopware
⚙️ Configurazione¶
Accesso API¶
| Impostazione | Descrizione |
|---|---|
| Token API | Token API personale dal tuo account Pipedrive (Impostazioni → Impostazioni personali → API) |
| Dominio aziendale | Il tuo dominio Pipedrive (ad esempio miaazienda.pipedrive.com) |
| Prova connessione | Pulsante che verifica il token contro l'API Pipedrive e mostra il risultato direttamente nell'admin |
Assegnazione pipeline e opportunità¶
| Impostazione | Descrizione | Standard |
|---|---|---|
| Pipeline di destinazione | Elenco di selezione delle pipeline esistenti in Pipedrive | prima pipeline |
| Fase iniziale | Fase in cui vengono create nuove opportunità | prima fase |
| Schema nome opportunità | Modello per il nome dell'opportunità (ad esempio Ordine {orderNumber}) | Ordine {orderNumber} |
| Valore opportunità | Adotta l'importo dell'ordine come valore dell'opportunità | Abilitato |
Selezione evento¶
| Impostazione | Descrizione | Standard |
|---|---|---|
| Crea cliente | Trasferisci nuovo cliente come persona/organizzazione | Abilitato |
| Ordine → Opportunità | Crea un'opportunità al ricevimento dell'ordine | Abilitato |
| Pagamento | Registra il ricevimento del pagamento come attività | Abilitato |
| Spedizione | Registra la spedizione come attività | Abilitato |
| Annullamento | Registra l'annullamento come attività | Abilitato |
| Bidirezionale | Rispecchia lo stato dell'opportunità da Pipedrive a Shopware | Disabilitato |
🔄 Sincronizzazioni nel dettaglio¶
Sincronizzazione contatti¶
Al trigger selezionato (ad esempio registrazione o primo ordine), il cliente viene creato in Pipedrive:
- Il cliente viene creato come persona con nome, email e numero di telefono
- Se un'azienda è registrata (B2B), viene creata anche un'organizzazione e la persona viene collegata
- I clienti già trasferiti vengono riconosciuti dall'ID Pipedrive registrato e aggiornati (nessun duplicato)
Creazione opportunità¶
Ogni ordine genera un'opportunità nella pipeline configurata:
- L'opportunità viene assegnata alla persona/organizzazione corrispondente
- Il nome e il valore vengono impostati secondo la configurazione
- L'ID dell'opportunità Pipedrive viene registrato nell'ordine Shopware per evitare creazioni duplicate
Attività di stato¶
I cambi di stato dell'ordine vengono documentati come attività sull'opportunità – ad esempio "Pagamento ricevuto", "Spedito" o "Annullato". Il team di vendita vede la cronologia completa direttamente in Pipedrive.
Sincronizzazione bidirezionale (opzionale)¶
Se la direzione inversa è abilitata, i confronti periodici valutano i cambiamenti in Pipedrive. Esempio: Se un'opportunità viene impostata su "vinta", il gruppo di clienti del cliente Shopware corrispondente può essere regolato automaticamente.
📊 Dashboard di sincronizzazione¶
Il dashboard di sincronizzazione nell'area di amministrazione offre:
- Panoramica di tutti i record sincronizzati (Persone, Organizzazioni, Opportunità, Attività)
- Stato di ogni trasferimento (riuscito / non riuscito)
- Registro errori con messaggio di dettaglio dell'API Pipedrive
- Pulsante Sincronizza manuale per riavviare i trasferimenti non riusciti
🛒 Casi d'uso tipici¶
Vendite B2B¶
I clienti aziendali vengono gestiti come un'organizzazione con contatti assegnati in Pipedrive. Ogni ordine è un'opportunità nella pipeline e fornisce al team di vendita una visione immediata del comportamento di acquisto.
Commercio all'ingrosso e industria¶
Gli ordini ricorrenti creano opportunità tracciabili inclusa la cronologia delle attività. Il team di vendita può eseguire cross-selling e upselling mirati.
Lead nurturing¶
Le nuove registrazioni vengono create come persone e possono essere ulteriormente qualificate in Pipedrive prima del primo ordine.
⭐ Vantaggi per i gestori di negozi¶
- Nessun trasferimento manuale di clienti e ordini al CRM
- Il team di vendita lavora completamente in Pipedrive – con dati in tempo reale dal negozio
- Tracciabilità completa tramite ID Pipedrive in Shopware
- Controllo completo su quali eventi vengono trasferiti
- Conforme al GDPR: I dati rimangono nella tua propria istanza Pipedrive
🧩 Set di funzionalità¶
- Creazione di clienti come persona e – per B2B – come organizzazione
- Creazione di opportunità da ordini nella pipeline configurabile
- Documentazione di pagamento, spedizione e annullamento come attività
- Sincronizzazione bidirezionale opzionale (stato opportunità → gruppo clienti)
- Dashboard di sincronizzazione con registro errori e ritentativi manuali
- Selezione evento liberamente configurabile
- Prova della connessione API direttamente nelle impostazioni del plugin
- Registrazione degli errori tramite la registrazione di Shopware
📚 Documentazione¶
Ulteriore contenuto e screenshot della documentazione saranno forniti nelle prossime versioni del plugin.
Documentazione tecnica dell'API Pipedrive: https://developers.pipedrive.com/docs/api/v1
📬 Support¶
Per domande, suggerimenti per miglioramenti o personalizzazioni, contattateci per email all'indirizzo support@cnk-plugins.de.