Connettore Salesforce CRM¶
Questo plugin collega il tuo negozio Shopware 6 alla piattaforma CRM leader mondiale Salesforce. I nuovi clienti vengono creati automaticamente come contatti e account, 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 contatto in Salesforce
- 🏢 I clienti B2B con nome azienda vengono creati come account Salesforce
- 💼 Ogni ordine crea automaticamente un'opportunità nella tua pipeline
- 🔔 Il pagamento, la spedizione e l'annullamento vengono documentati come attività
- 🔐 Connessione sicura OAuth-2.0 tramite un'applicazione Salesforce collegata
- 🧪 Supporto sandbox – test gefahrlos prima del lancio
❓ Domande frequenti¶
Cos'è Salesforce?
Salesforce è la piattaforma CRM leader mondiale. Tramite l'API REST di Salesforce, è possibile creare e aggiornare automaticamente contatti, account, opportunità e attività. Per utilizzare il servizio, è necessario un account Salesforce attivo con accesso all'API.
Quali dati vengono sincronizzati con Salesforce?
I nuovi clienti vengono creati come contatto, per i clienti aziendali (B2B), viene creato anche un account. Ogni ordine diventa un'opportunità nella pipeline configurata. I cambi di stato come pagamento, spedizione o annullamento vengono documentati come attività sull'opportunità corrispondente.
Come viene stabilita la connessione a Salesforce?
La connessione viene effettuata tramite OAuth 2.0 con un'applicazione Salesforce collegata – sicura e senza condivisione di password. In Salesforce, crei un'app collegata, memorizzi Consumer Key e Secret nel plugin e autorizzi l'accesso una sola volta.
La sandbox Salesforce è supportata?
Sì. Puoi testare dapprima l'integrazione in modo sicuro rispetto alla tua sandbox Salesforce (test.salesforce.com) e solo dopo verifiche riuscite passare all'ambiente di produzione (login.salesforce.com).
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 da inviare a Salesforce.
Cos'è la sincronizzazione bidirezionale?
I cambiamenti in Salesforce – come l'impostazione di un'opportunità su "Closed Won" – possono facoltativamente funzionare al contrario e ad esempio aggiornare il gruppo di clienti in Shopware. Questa direzione inversa può essere disabilitata.
Il plugin è conforme al GDPR?
Tutti i dati trasferiti rimangono nella tua propria istanza Salesforce. La connessione viene effettuata esclusivamente tramite l'accesso autorizzato da te via OAuth.
Quali sono i prerequisiti?
Il plugin richiede il plugin CNK Foundation (a partire dalla versione 3.0.4) e Shopware 6.7. Dal lato Salesforce, è necessario un account attivo con accesso all'API e un'app collegata.
🔧 Installazione¶
- Prerequisito: Plugin CNK Foundation (a partire dalla versione 3.0.4)
- Prerequisito: Account Salesforce attivo con app collegata
- Installazione tramite il gestore plugin di Shopware o via Composer
- Attiva il plugin:
bin/console plugin:install --activate CnkPlatformSalesForceConnector - Esegui la configurazione nell'area di amministrazione di Shopware
⚙️ Configurazione¶
Accesso OAuth (App collegata)¶
| Impostazione | Descrizione |
|---|---|
| Ambiente | Produzione (login.salesforce.com) o sandbox (test.salesforce.com) |
| Consumer Key | Consumer Key dall'app Salesforce collegata |
| Consumer Secret | Secret corrispondente dell'app collegata |
| Connetti a Salesforce | Pulsante che avvia il flusso di autorizzazione OAuth-2.0 e conferma la connessione nell'admin |
Crei l'app collegata in Salesforce sotto Setup → App Manager → New Connected App con le impostazioni OAuth abilitate. L'URL di callback visualizzato nel plugin deve essere registrato lì come URL di reindirizzamento autorizzato.
Assegnazione opportunità e pipeline¶
| Impostazione | Descrizione | Standard |
|---|---|---|
| Pipeline / Tipo di record | Elenco di selezione delle pipeline di opportunità esistenti in Salesforce | Standard |
| Fase iniziale | Fase in cui vengono create nuove opportunità | prima fase |
| Schema nome opportunità | Modello per il nome (ad esempio Ordine {orderNumber}) | Ordine {orderNumber} |
| Importo | Adotta l'importo dell'ordine come importo dell'opportunità | Abilitato |
Selezione evento¶
| Impostazione | Descrizione | Standard |
|---|---|---|
| Crea contatto | Trasferisci nuovo cliente come contatto (+ account per B2B) | 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 Salesforce a Shopware | Disabilitato |
🔄 Sincronizzazioni nel dettaglio¶
Sincronizzazione contatti e account¶
Al trigger selezionato (ad esempio registrazione o primo ordine), il cliente viene creato in Salesforce:
- Il cliente viene creato come contatto con nome, email e numero di telefono
- Se un'azienda è registrata (B2B), viene creato anche un account e il contatto viene collegato
- I clienti già trasferiti vengono riconosciuti dall'ID Salesforce registrato e aggiornati (nessun duplicato)
Creazione opportunità¶
Ogni ordine genera un'opportunità nella pipeline configurata:
- L'opportunità viene assegnata al contatto/account corrispondente
- Il nome e l'importo vengono impostati secondo la configurazione
- L'ID dell'opportunità Salesforce 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 Salesforce.
Sincronizzazione bidirezionale (opzionale)¶
Se la direzione inversa è abilitata, i confronti periodici valutano i cambiamenti in Salesforce. Esempio: Se un'opportunità viene impostata su "Closed Won", 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 (Contatti, Account, Opportunità, Attività)
- Stato di ogni trasferimento (riuscito / non riuscito)
- Registro errori con messaggio di dettaglio dell'API Salesforce
- Pulsante Sincronizza manuale per riavviare i trasferimenti non riusciti
🛒 Casi d'uso tipici¶
Vendite Enterprise B2B¶
I clienti aziendali vengono gestiti come un account con contatti assegnati in Salesforce. Ogni ordine è un'opportunità nella pipeline e fornisce al team di vendita una visione immediata del comportamento di acquisto.
Aziende medie e grandi¶
Gli ordini ricorrenti creano opportunità tracciabili inclusa la cronologia delle attività. Il team di vendita può eseguire cross-selling e upselling mirati.
Onboarding sicuro tramite sandbox¶
L'intera integrazione può essere testata nella sandbox Salesforce prima del lancio – senza impatto sui dati di produzione.
⭐ Vantaggi per i gestori di negozi¶
- Nessun trasferimento manuale di clienti e ordini al CRM
- Il team di vendita lavora completamente in Salesforce – con dati in tempo reale dal negozio
- Connessione sicura OAuth-2.0 tramite un'app collegata
- Test senza rischio grazie al supporto sandbox
- Conforme al GDPR: I dati rimangono nella tua propria istanza Salesforce
🧩 Set di funzionalità¶
- Creazione di clienti come contatto e – per B2B – come account
- 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
- Supporto sandbox per test senza rischio
- Connessione sicura OAuth-2.0 tramite un'app Salesforce collegata
- Selezione evento liberamente configurabile
📚 Documentazione¶
Ulteriore contenuto e screenshot della documentazione saranno forniti nelle prossime versioni del plugin.
Documentazione tecnica dell'API Salesforce: https://developer.salesforce.com/docs/apis
📬 Support¶
Per domande, suggerimenti per miglioramenti o personalizzazioni, contattateci per email all'indirizzo support@cnk-plugins.de.