Łącznik Zoho CRM¶
Ta wtyczka łączy Twój sklep Shopware 6 z Zoho CRM i wypełnia lukę między sklepem online a zespołem sprzedaży. Nowi klienci są automatycznie tworzeni jako kontakty, klienci B2B jako konta, zamówienia jako deals w Twojej pipeline'u sprzedaży i wszystkie zmiany statusu jako działania – w czasie rzeczywistym, całkowicie automatycznie i bez ręcznego wysiłku.
Najważniejsze cechy
- 👤 Automatyczne tworzenie klientów jako kontaktu w Zoho CRM
- 🏢 Klienci B2B z nazwą firmy są tworzeni jako konto Zoho
- 💼 Każde zamówienie automatycznie tworzy deal w Twojej pipeline
- 🔔 Płatność, wysyłka i anulowanie są rejestrowane jako działania
- 🔐 Bezpieczne połączenie OAuth 2.0 bez ręcznych kluczy API
- 📊 Panel synchronizacji z dziennikiem błędów i przyciskiem ręcznej synchronizacji
❓ Często zadawane pytania¶
Co to jest Zoho CRM?
Zoho CRM to powszechnie stosowana platforma CRM i sprzedażowa. Poprzez oficjalne API REST Zoho CRM, kontakty, konta, deals i działania mogą być automatycznie tworzone i aktualizowane. Aby go używać, potrzebujesz aktywnego konta Zoho CRM.
Jakie dane są synchronizowane z Zoho CRM?
Nowi klienci są tworzeni jako kontakt, dla klientów B2B, tworzone jest dodatkowe konto. Każde zamówienie staje się deal w skonfigurowanej pipeline. Zmiany statusu, takie jak płatność, wysyłka lub anulowanie, są rejestrowane jako działania na odpowiadającym deal.
Jak jest nawiązywane połączenie z Zoho?
Połączenie jest nawiązywane za pośrednictwem OAuth 2.0 – bezpiecznie i bez ręcznych kluczy API. W konsoli API Zoho tworzysz klienta OAuth, rejestrujesz identyfikator klienta i tajemnicę w wtyczce i autoryzojesz dostęp jednorazowo. Odpowiedni region Zoho (EU, COM, IN, AU) jest wybieralny.
Czy synchronizacja odbywa się automatycznie?
Tak. Transfer odbywa się w czasie rzeczywistym za pośrednictwem infrastruktury Shopware Event/Flow. W ustawieniach wtyczki definiujesz, które zdarzenia Shopware (na przykład rejestracja, otrzymanie zamówienia, otrzymanie płatności) są wysyłane do Zoho CRM.
Co oznacza synchronizacja dwukierunkowa?
Zmiany w Zoho CRM – takie jak ustawienie deal na « wygrano » – mogą opcjonalnie wpłynąć na Shopware i, na przykład, zaktualizować grupę klientów. Ten kierunek odwrotny można wyłączyć.
Co się dzieje, jeśli transfer nie powiedzie się?
Każdy transfer jest rejestrowany na Panelu synchronizacji ze statusem. Nieudane transfery pojawiają się w dzienniku błędów i mogą być ponownie wznowione ręcznie (Retry).
Czy wtyczka jest zgodna z RODO?
Wszystkie przesłane dane pozostają w Twojej własnej instancji Zoho. Połączenie odbywa się wyłącznie poprzez oficjalny, autoryzowany przez Ciebie dostęp Zoho OAuth.
Jakie są wymagania wstępne?
Wtyczka wymaga wtyczki CNK Foundation (od wersji 3.0.4) i Shopware 6.7. Po stronie Zoho potrzebujesz aktywnego konta CRM i klienta OAuth (identyfikator klienta i tajemnica).
🔧 Instalacja¶
- Wymaganie : Wtyczka CNK Foundation (od wersji 3.0.4)
- Wymaganie : Aktywne konto Zoho CRM z klientem OAuth
- Instalacja za pośrednictwem menedżera wtyczek Shopware lub przez Composer
- Aktywuj wtyczkę :
bin/console plugin:install --activate CnkPlatformZohoCrm - Wykonaj konfigurację w obszarze administracyjnym Shopware
⚙️ Konfiguracja¶
Dostęp OAuth¶
| Ustawienie | Opis |
|---|---|
| Region Zoho | Centrum danych Twojego konta Zoho : EU (.eu), COM (.com), IN (.in), AU (.com.au) |
| Identyfikator klienta | Identyfikator klienta klienta OAuth z konsoli API Zoho |
| Tajemnica klienta | Odpowiadająca tajemnica klienta OAuth |
| Połącz z Zoho | Przycisk, który rozpoczyna przepływ autoryzacji OAuth 2.0 i potwierdza połączenie w admin |
Tworzysz klienta OAuth w Konsoli API Zoho (api-console.zoho.eu) jako aplikację serwerową. Wyświetlany w wtyczce adres URL przekierowania musi tam być zarejestrowany jako autoryzowane przekierowanie.
Mapowanie Deal i Pipeline¶
| Ustawienie | Opis | Standard |
|---|---|---|
| Pipeline docelowa | Lista wyboru istniejących pipeline/układów w Zoho | Domyślna pipeline |
| Faza początkowa | Faza, w której tworzone są nowe deals | pierwsza faza |
| Schemat tytułu deal | Wzór dla tytułu deal (na przykład Zamówienie {orderNumber}) | Zamówienie {orderNumber} |
| Wartość deal | Zaakceptuj sumę zamówienia jako wartość deal | Aktywne |
Wybór zdarzeń¶
| Ustawienie | Opis | Standard |
|---|---|---|
| Utwórz kontakt | Prześlij nowego klienta jako kontakt (+ konto dla B2B) | Aktywne |
| Zamówienie → Deal | Utwórz deal przy otrzymaniu zamówienia | Aktywne |
| Płatność | Zarejestruj otrzymanie płatności jako działanie | Aktywne |
| Wysyłka | Zarejestruj wysyłkę jako działanie | Aktywne |
| Anulowanie | Zarejestruj anulowanie jako działanie | Aktywne |
| Dwukierunkowe | Odzwierciedl status deal z Zoho w Shopware | Nieaktywne |
🔄 Szczegółowe synchronizacje¶
Synchronizacja kontaktów i kont¶
Na wybranym zdarzeniu (na przykład rejestracja lub pierwsze zamówienie) klient jest tworzony w Zoho CRM :
- Klient jest tworzony jako kontakt z nazwą, e-mailem i numerem telefonu
- Dla zarejestrowanej firmy (B2B), tworzone jest dodatkowe konto i kontakt jest powiązany
- Wcześniej przesłani klienci są rozpoznawani przez przechowywany identyfikator Zoho i aktualizowani (bez duplikatów)
Tworzenie deal¶
Każde zamówienie tworzy deal w skonfigurowanej pipeline :
- Deal jest przypisany do odpowiadającego kontaktu/konta
- Tytuł i wartość są ustawiane zgodnie z konfiguracją
- Identyfikator deal Zoho jest przechowywany w zamówieniu Shopware, aby zapobiec duplikatom
Działania statusu¶
Zmiany statusu zamówienia są rejestrowane jako działania na deal – na przykład « Płatność otrzymana », « Wysłane » lub « Anulowane ». W ten sposób zespół sprzedaży widzi pełną historię bezpośrednio w Zoho CRM.
Synchronizacja dwukierunkowa (opcjonalna)¶
Jeśli kierunek odwrotny jest włączony, okresowe uzgodnienia oceniają zmiany w Zoho. Przykład : Jeśli deal jest ustawiony na « wygrano », grupa klientów odpowiadającego klienta Shopware może być automatycznie dostosowana.
📊 Panel synchronizacji¶
Panel synchronizacji w obszarze administracyjnym oferuje :
- Przegląd wszystkich zsynchronizowanych rekordów (kontakty, konta, deals, działania)
- Status każdego transferu (udany / nieudany)
- Dziennik błędów ze szczegółową wiadomością z API Zoho
- Przycisk ręcznej synchronizacji do ponownego uruchomienia poszczególnych lub nieudanych transferów
🛒 Typowe przypadki użycia¶
Sprzedaż B2B¶
Klienci B2B są zarządzani jako konto z przypisanymi kontaktami w Zoho. Każde zamówienie trafia jako deal w pipeline i daje zespołowi sprzedaży natychmiastowy przegląd zachowania zakupowego.
Handel hurtowy i małe przedsiębiorstwa¶
Powtarzające się zamówienia tworzą śledzone deals obejmujące historię działań. Zespół sprzedaży może przeprowadzać docelową sprzedaż krzyżową i zwiększającą.
Nurturing leadi¶
Nowe rejestracje są tworzone jako kontakty i mogą być dalej kwalifikowane w Zoho, zanim nastąpi pierwsze zamówienie.
⭐ Korzyści dla operatorów sklepu¶
- Brak ręcznego przesyłania klientów i zamówień do CRM
- Zespół sprzedaży pracuje konsekwentnie w Zoho CRM – z danymi w czasie rzeczywistym ze sklepu
- Bezpieczne połączenie OAuth 2.0 bez ręcznych kluczy API
- Pełna śledowalność za pośrednictwem identyfikatorów Zoho w Shopware
- Zgodne z RODO : Dane pozostają w Twojej własnej instancji Zoho
🧩 Zakres funkcji¶
- Tworzenie klientów jako kontakt i – dla B2B – jako konto
- Tworzenie deal z zamówień w konfigurowalnej pipeline
- Rejestracja płatności, wysyłki i anulowania jako działań
- Opcjonalna synchronizacja dwukierunkowa (status deal → grupa klientów)
- Panel synchronizacji z dziennikiem błędów i ręcznym retry
- Bezpieczne połączenie OAuth 2.0 obejmujące wybór regionu Zoho
- Swobodnie konfigurowalny wybór zdarzeń
- Rejestracja błędów poprzez rejestrowanie Shopware
📚 Dokumentacja¶
Zawartość dodatkowej dokumentacji i zrzuty ekranu będą dostarczone w następnych wersjach wtyczki.
Dokumentacja techniczna API Zoho CRM : https://www.zoho.com/crm/developer/docs/api/v6/
📬 Support¶
W przypadku pytań, sugestii dotyczących ulepszeń lub dostosowań, prosimy o kontakt za pośrednictwem poczty elektronicznej na adres support@cnk-plugins.de.