Konektor Salesforce CRM¶
Ten plugin łączy Twój sklep Shopware 6 z wiodącą na świecie platformą CRM Salesforce. Nowi klienci są automatycznie tworzeni jako kontakty i konta, zamówienia są mapowane jako oportuności w Twojej pipeline sprzedażowej i wszystkie zmiany statusu są dokumentowane jako aktywności – w czasie rzeczywistym, całkowicie automatycznie i bez ręcznego wysiłku.
Najważniejsze cechy
- 👤 Automatyczne tworzenie klientów jako kontaktów w Salesforce
- 🏢 Klienci B2B z nazwą firmy są tworzeni jako konto Salesforce
- 💼 Każde zamówienie automatycznie tworzy oportuność w Twojej pipeline
- 🔔 Płatność, wysyłka i anulowanie są dokumentowane jako aktywności
- 🔐 Bezpieczne połączenie OAuth-2.0 za pośrednictwem połączonej aplikacji Salesforce
- 🧪 Wsparcie piaskownicy – bezpieczne testowanie przed wdrożeniem
❓ Najczęściej zadawane pytania¶
Czym jest Salesforce?
Salesforce to wiodąca na świecie platforma CRM. Za pośrednictwem interfejsu API REST Salesforce możliwe jest automatyczne tworzenie i aktualizowanie kontaktów, kont, oportuności i aktywności. Do korzystania z usługi potrzebujesz aktywnego konta Salesforce z dostępem do API.
Jakie dane są synchronizowane z Salesforce?
Nowych klientów tworzy się jako kontakty, dla klientów biznesowych (B2B) tworzone jest również konto. Każde zamówienie staje się oportunością w skonfigurowanej pipeline. Zmiany statusu, takie jak płatność, wysyłka lub anulowanie, są dokumentowane jako aktywności na odpowiedniej oportunności.
Jak nawiązane jest połączenie z Salesforce?
Połączenie odbywa się za pośrednictwem OAuth 2.0 z połączoną aplikacją Salesforce – bezpieczne i bez transmisji hasła. W Salesforce tworzysz połączoną aplikację, przechowujesz Consumer Key i Secret w pluginie i udzielasz autoryzacji jednorazowo.
Czy piaskownica Salesforce jest obsługiwana?
Tak. Najpierw możesz bezpiecznie przetestować integrację względem swojej piaskownicy Salesforce (test.salesforce.com) i tylko po pomyślnej weryfikacji przejść do środowiska produkcyjnego (login.salesforce.com).
Czy synchronizacja jest automatyczna?
Tak. Transfer odbywa się w czasie rzeczywistym na podstawie zdarzeń za pośrednictwem infrastruktury Shopware Events/Flow. W ustawieniach wtyczki określasz, które zdarzenia Shopware mają być wysłane do Salesforce.
Czym jest synchronizacja dwukierunkowa?
Zmiany w Salesforce – na przykład ustawienie oportuności na „Closed Won" – mogą opcjonalnie działać w odwrotnym kierunku i na przykład aktualizować grupę klientów w Shopware. Ten kierunek odwrotny można wyłączyć.
Czy plugin jest zgodny z RODO?
Wszystkie przesłane dane pozostają w Twojej własnej instancji Salesforce. Połączenie odbywa się wyłącznie za pośrednictwem autoryzowanego przez Ciebie dostępu OAuth.
Jakie są warunki wstępne?
Plugin wymaga wtyczki CNK Foundation (od wersji 3.0.4) i Shopware 6.7. Po stronie Salesforce wymagane jest aktywne konto z dostępem do API i połączona aplikacja.
🔧 Instalacja¶
- Warunek wstępny: Plugin CNK Foundation (od wersji 3.0.4)
- Warunek wstępny: Aktywne konto Salesforce z połączoną aplikacją
- Instalacja za pośrednictwem menedżera wtyczek Shopware lub przez Composer
- Aktywuj plugin:
bin/console plugin:install --activate CnkPlatformSalesForceConnector - Wykonaj konfigurację w obszarze administracji Shopware
⚙️ Konfiguracja¶
Dostęp OAuth (Połączona aplikacja)¶
| Ustawienie | Opis |
|---|---|
| Środowisko | Produkcja (login.salesforce.com) lub piaskownica (test.salesforce.com) |
| Consumer Key | Consumer Key z połączonej aplikacji Salesforce |
| Consumer Secret | Odpowiadający Secret połączonej aplikacji |
| Połącz z Salesforce | Przycisk, który uruchamia przepływ autoryzacji OAuth-2.0 i potwierdza połączenie w administracji |
Tworzysz połączoną aplikację w Salesforce w Setup → App Manager → New Connected App z włączonymi ustawieniami OAuth. Wyświetlany w pluginie adres URL回调 musi być tam zarejestrowany jako autoryzowany adres URL przekierowania.
Przypisanie oportuności i pipeline¶
| Ustawienie | Opis | Standard |
|---|---|---|
| Pipeline / Typ rekordu | Lista wyboru istniejących pipeline oportuności w Salesforce | Standard |
| Etap początkowy | Etap, w którym tworzone są nowe oportunności | pierwszy etap |
| Schemat nazwy oportuności | Wzór nazwy (np. Zamówienie {orderNumber}) | Zamówienie {orderNumber} |
| Kwota | Przyjmij kwotę zamówienia jako kwotę oportuności | Włączone |
Wybór zdarzenia¶
| Ustawienie | Opis | Standard |
|---|---|---|
| Utwórz kontakt | Przesyłanie nowego klienta jako kontaktów (+ konto dla B2B) | Włączone |
| Zamówienie → Oportuność | Utwórz oportuność po otrzymaniu zamówienia | Włączone |
| Płatność | Zarejestruj potwierdzenie płatności jako aktywność | Włączone |
| Wysyłka | Zarejestruj wysyłkę jako aktywność | Włączone |
| Anulowanie | Zarejestruj anulowanie jako aktywność | Włączone |
| Dwukierunkowy | Odzwierciedl status oportuności z Salesforce na Shopware | Wyłączone |
🔄 Synchronizacje w szczegółach¶
Synchronizacja kontaktów i kont¶
Po wybranym wyzwalaczu (np. rejestracja lub pierwsze zamówienie) klient jest tworzony w Salesforce:
- Klient jest tworzony jako kontakt z imieniem, e-mailem i numerem telefonu
- Jeśli zarejestrowana jest firma (B2B), tworzane jest również konto i kontakt jest powiązany
- Klienci już przesłani są rozpoznawani przez zarejestrowany identyfikator Salesforce i aktualizowani (brak duplikatu)
Tworzenie oportuności¶
Każde zamówienie generuje oportuność w skonfigurowanej pipeline:
- Oportuność jest przypisana do odpowiedniego kontaktu/konta
- Nazwa i kwota są ustawiane zgodnie z konfiguracją
- Identyfikator oportuności Salesforce jest rejestrowany w zamówieniu Shopware, aby zapobiec duplikatom
Aktywności statusu¶
Zmiany statusu zamówienia są dokumentowane jako aktywności na oportuności – na przykład „Otrzymana płatność", „Wysłane" lub „Anulowane". Zespół sprzedaży widzi pełną historię bezpośrednio w Salesforce.
Synchronizacja dwukierunkowa (opcjonalna)¶
Jeśli kierunek odwrotny jest włączony, regularne porównania oceniają zmiany w Salesforce. Przykład: Jeśli oportuność jest ustawiona na „Closed Won", grupa klientów odpowiedniego klienta Shopware może być automatycznie dostosowana.
📊 Pulpit nawigacyjny synchronizacji¶
Pulpit nawigacyjny synchronizacji w obszarze administracji oferuje:
- Przegląd wszystkich zsynchronizowanych rekordów (Kontakty, Konta, Oportuności, Aktywności)
- Status każdego transferu (powodzenie / nieudane)
- Dziennik błędów z wiadomością szczegółów API Salesforce
- Ręczny przycisk Synchronizuj do ponownego uruchomienia nieudanych transferów
🛒 Typowe przypadki użycia¶
Sprzedaż Enterprise B2B¶
Klienci biznesowi są zarządzani jako konto z przypisanymi kontaktami w Salesforce. Każde zamówienie jest oportunością w pipeline i daje zespołowi sprzedaży natychmiastowy przegląd zachowania zakupowego.
Średnie i duże przedsiębiorstwa¶
Powtarzające się zamówienia tworzą śledzone oportuności, w tym historię aktywności. Zespół sprzedaży może wykonywać ukierunkowaną sprzedaż krzyżową i upselling.
Bezpieczne wdrażanie za pośrednictwem piaskownicy¶
Pełna integracja może być testowana w piaskownicy Salesforce przed wdrożeniem – bez wpływu na dane produkcyjne.
⭐ Korzyści dla operatorów sklepów¶
- Brak ręcznego transferu klientów i zamówień do CRM
- Zespół sprzedaży pracuje w całości w Salesforce – z danymi w czasie rzeczywistym ze sklepu
- Bezpieczne połączenie OAuth-2.0 za pośrednictwem połączonej aplikacji
- Bezpieczne testowanie dzięki wsparciu piaskownicy
- Zgodny z RODO: Dane pozostają w Twojej własnej instancji Salesforce
🧩 Zestaw funkcji¶
- Tworzenie klientów jako kontaktów i – dla B2B – jako kont
- Tworzenie oportuności z zamówień w konfigurowanej pipeline
- Dokumentacja płatności, wysyłki i anulowania jako aktywności
- Opcjonalna synchronizacja dwukierunkowa (status oportuności → grupa klientów)
- Pulpit nawigacyjny synchronizacji z dziennikiem błędów i ręcznym ponownym uruchomieniem
- Wsparcie piaskownicy dla bezpiecznego testowania
- Bezpieczne połączenie OAuth-2.0 za pośrednictwem połączonej aplikacji Salesforce
- Swobodnie konfigurowalne wybieranie zdarzenia
📚 Dokumentacja¶
Więcej zawartości dokumentacji i zrzuty ekranu będą dostarczone w kolejnych wersjach wtyczki.
Dokumentacja techniczna API Salesforce: https://developer.salesforce.com/docs/apis