Connettore Zoho CRM¶
Questo plugin connette il tuo negozio Shopware 6 con Zoho CRM e colma il divario tra il negozio online e il team di vendita. I nuovi clienti vengono creati automaticamente come contatti, i clienti B2B come account, gli ordini come deal nella tua pipeline di vendita e tutti i cambi di stato come attività – in tempo reale, completamente automatico e senza sforzo manuale.
Punti salienti
- 👤 Creazione automatica di clienti come contatto in Zoho CRM
- 🏢 I clienti B2B con nome aziendale vengono creati come account Zoho
- 💼 Ogni ordine crea automaticamente un deal nella tua pipeline
- 🔔 Il pagamento, la spedizione e l'annullamento vengono registrati come attività
- 🔐 Connessione sicura OAuth 2.0 senza chiavi API manuali
- 📊 Dashboard di sincronizzazione con registro degli errori e pulsante di sincronizzazione manuale
❓ Domande frequenti¶
Che cos'è Zoho CRM?
Zoho CRM è una piattaforma CRM e di vendita ampiamente diffusa. Attraverso l'API REST ufficiale di Zoho CRM, i contatti, gli account, i deal e le attività possono essere creati e aggiornati automaticamente. Per usarlo, hai bisogno di un account Zoho CRM attivo.
Quali dati vengono sincronizzati con Zoho CRM?
I nuovi clienti vengono creati come contatto, per i clienti B2B, viene creato un account aggiuntivo. Ogni ordine diventa un deal nella pipeline configurata. I cambi di stato come il pagamento, la spedizione o l'annullamento vengono registrati come attività sul deal corrispondente.
Come viene stabilita la connessione a Zoho?
La connessione avviene tramite OAuth 2.0 – sicura e senza chiavi API manuali. Nella console API di Zoho, crei un client OAuth, registri l'ID client e il segreto nel plugin e autorizzi l'accesso una sola volta. La regione Zoho appropriata (EU, COM, IN, AU) è selezionabile.
La sincronizzazione avviene automaticamente?
Sì. Il trasferimento avviene in tempo reale tramite l'infrastruttura Shopware Event/Flow. Nelle impostazioni del plugin, definisci quali eventi di Shopware (ad esempio registrazione, ricezione ordine, ricezione pagamento) vengono inviati a Zoho CRM.
Cosa significa sincronizzazione bidirezionale?
Le modifiche in Zoho CRM – come l'impostazione di un deal come « vinto » – possono facoltativamente influire su Shopware e, ad esempio, aggiornare il gruppo di clienti. Questa direzione inversa può essere disattivata.
Cosa accade se un trasferimento non riesce?
Ogni trasferimento viene registrato nel Dashboard di sincronizzazione con lo stato. I trasferimenti non riusciti compaiono nel registro degli errori e possono essere riavviati manualmente (Retry).
Il plugin è conforme al GDPR?
Tutti i dati trasferiti rimangono nella tua propria istanza di Zoho. La connessione avviene esclusivamente tramite l'accesso Zoho OAuth ufficiale che hai autorizzato.
Quali sono i requisiti?
Il plugin richiede il plugin CNK Foundation (a partire dalla versione 3.0.4) e Shopware 6.7. Da parte di Zoho, hai bisogno di un account CRM attivo e di un client OAuth (ID client & Secret).
🔧 Installazione¶
- Requisito : Plugin CNK Foundation (a partire dalla versione 3.0.4)
- Requisito : Account Zoho CRM attivo con client OAuth
- Installazione tramite Shopware Plugin Manager o per Composer
- Attiva il plugin :
bin/console plugin:install --activate CnkPlatformZohoCrm - Esegui la configurazione nell'area di amministrazione di Shopware
⚙️ Configurazione¶
Accesso OAuth¶
| Impostazione | Descrizione |
|---|---|
| Regione Zoho | Centro dati del tuo account Zoho : EU (.eu), COM (.com), IN (.in), AU (.com.au) |
| ID client | ID client del client OAuth dalla console API di Zoho |
| Segreto client | Secret corrispondente del client OAuth |
| Connetti a Zoho | Pulsante che avvia il flusso di autorizzazione OAuth 2.0 e conferma la connessione in admin |
Crei il client OAuth nella console API di Zoho (api-console.zoho.eu) come applicazione basata su server. L'URL di reindirizzamento visualizzato nel plugin deve essere registrato lì come reindirizzamento autorizzato.
Mappatura Deal e Pipeline¶
| Impostazione | Descrizione | Standard |
|---|---|---|
| Pipeline di destinazione | Elenco di selezione delle pipeline/layout esistenti in Zoho | Pipeline predefinita |
| Fase di inizio | Fase in cui vengono creati i nuovi deal | prima fase |
| Schema del titolo del deal | Modello per il titolo del deal (ad esempio Ordine {orderNumber}) | Ordine {orderNumber} |
| Valore del deal | Accetta la somma dell'ordine come valore del deal | Attivo |
Selezione degli eventi¶
| Impostazione | Descrizione | Standard |
|---|---|---|
| Crea contatto | Trasferisci un nuovo cliente come contatto (+ account per B2B) | Attivo |
| Ordine → Deal | Crea un deal alla ricezione dell'ordine | Attivo |
| Pagamento | Registra la ricezione del pagamento come attività | Attivo |
| Spedizione | Registra la spedizione come attività | Attivo |
| Annullamento | Registra l'annullamento come attività | Attivo |
| Bidirezionale | Rifletti lo stato del deal da Zoho a Shopware | Inattivo |
🔄 Sincronizzazioni nel dettaglio¶
Sincronizzazione contatti e account¶
Sull'evento selezionato (ad esempio registrazione o primo ordine), il cliente viene creato in Zoho CRM :
- Il cliente viene creato come contatto con nome, e-mail e numero di telefono
- Per un'azienda registrata (B2B), viene creato un account aggiuntivo e il contatto è collegato
- I clienti già trasferiti vengono riconosciuti dall'ID Zoho archiviato e aggiornati (nessun duplicato)
Creazione del deal¶
Ogni ordine crea un deal nella pipeline configurata :
- Il deal viene assegnato al contatto/account corrispondente
- Titolo e valore vengono impostati secondo la configurazione
- L'ID del deal di Zoho viene archiviato sull'ordine di Shopware per evitare duplicati
Attività di stato¶
I cambi di stato dell'ordine vengono registrati come attività sul deal – ad esempio « Pagamento ricevuto », « Spedito » o « Annullato ». In questo modo, il team di vendita vede la storia completa direttamente in Zoho CRM.
Sincronizzazione bidirezionale (facoltativa)¶
Se la direzione inversa è abilitata, le riconciliazioni periodiche valutano le modifiche in Zoho. Esempio : Se un deal è impostato su « vinto », 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, deal, attività)
- Stato per ogni trasferimento (riuscito / non riuscito)
- Registro degli errori con messaggio dettagliato dell'API di Zoho
- Pulsante di sincronizzazione manuale per riavviare i trasferimenti individuali o non riusciti
🛒 Casi d'uso tipici¶
Vendite B2B¶
I clienti B2B vengono gestiti come account con contatti assegnati in Zoho. Ogni ordine arriva come un deal nella pipeline e dà al team di vendita una visione immediata del comportamento d'acquisto.
Commercio all'ingrosso e piccole imprese¶
Gli ordini ricorrenti creano deal tracciabili includendo la cronologia delle attività. Il team di vendita può eseguire Cross- e Up-Selling mirati.
Nurturing dei lead¶
Le nuove registrazioni vengono create come contatti e possono essere ulteriormente qualificate in Zoho prima del primo ordine.
⭐ Vantaggi per i proprietari di negozio¶
- Nessun trasferimento manuale di clienti e ordini nel CRM
- Il team di vendita lavora costantemente in Zoho CRM – con dati in tempo reale dal negozio
- Connessione sicura OAuth 2.0 senza chiavi API manuali
- Piena tracciabilità tramite gli ID di Zoho in Shopware
- Conforme al GDPR : I dati rimangono nella tua propria istanza di Zoho
🧩 Ambito funzionale¶
- Creazione di clienti come contatto e – per B2B – come account
- Creazione di deal da ordini nella pipeline configurabile
- Registrazione del pagamento, della spedizione e dell'annullamento come attività
- Sincronizzazione bidirezionale facoltativa (stato del deal → gruppo di clienti)
- Dashboard di sincronizzazione con registro degli errori e retry manuale
- Connessione sicura OAuth 2.0 inclusa la selezione della regione Zoho
- Selezione degli eventi liberamente configurabile
- Registrazione degli errori tramite la registrazione di Shopware
📚 Documentazione¶
I contenuti di documentazione aggiuntivi e le schermate saranno forniti con le prossime versioni del plugin.
Documentazione tecnica dell'API di Zoho CRM : https://www.zoho.com/crm/developer/docs/api/v6/
📬 Support¶
Per domande, suggerimenti per miglioramenti o personalizzazioni, contattateci per email all'indirizzo support@cnk-plugins.de.