Salesforce Lightning
Uwaga:
Niektóre obrazy i łącza w tym artykule mogą być dostępne tylko w języku angielskim.Uwaga:
W niniejszym przewodniku opisano funkcje najnowszej wersji 1.59.1 integracji PandaDoc <> Salesforce.Dostępność:
PandaDoc: plan Enterprise.
Salesforce: „Professional”, „Enterprise”, „Unlimited” lub „Developer Edition”.
Integracja będzie działać dla obiektów szans, potencjalnych klientów, kontaktów i obiektów niestandardowych.
Przejdź do:
- Łączenie PandaDoc z Salesforce
- Instalowanie pakietu PandaDoc w AppExchange
- Konfigurowanie PandaDoc dla obiektu Salesforce
- Przekazywanie danych z Salesforce do PandaDoc
- Przekazywanie informacji z Salesforce do PandaDoc (za pośrednictwem pól)
- Przekazywanie danych o produktach z Salesforce do tabel z cennikami PandaDoc
- Tworzenie i wysyłanie dokumentów
- Łączenie dokumentu z szansą w Salesforce
- Aktualizowanie dokumentu wartościami pól z Salesforce
- Często zadawane pytania
- Rozwiązywanie problemów
Funkcje
- Zmienne: istnieje możliwość automatycznego przekazywania informacji z Salesforce do dokumentów PandaDoc za pomocą zmiennych.
- Produkty: przenieś informacje o produktach z transakcji Salesforce do tabel z cennikami PandaDoc.
- Tworzenie dokumentów: można tworzyć dokumenty PandaDoc z obiektów szans, kont, kontaktów, potencjalnych klientów i obiektów niestandardowych Salesforce.
- Śledzenie statusu: istnieje możliwość śledzenia statusu dokumentu w Salesforce.
- Synchronizacja danych między Salesforce i PandaDoc (niedostępne w wersjach Group i Professional)
Łączenie PandaDoc z Salesforce
Uwaga:
Zobacz nasz przewodnik po konfiguracji w prawym dolnym narożniku karty Salesforce w PandaDoc, aby szybko i łatwo skonfigurować integrację.- W PandaDoc przejdź do menu „Settings” (Ustawienia) „Integrations” (Integracje) kliknij „Salesforce” wybierz miejsce, w którym chcesz włączyć integrację: środowisko piaskownicy lub produkcji.
- Na tym etapie może być konieczne zalogowanie się do Salesforce. Kliknij „Allow” (Zezwól), aby autoryzować dostęp PandaDoc do Salesforce.
- Konto PandaDoc jest teraz połączone z Salesforce. Przejdź do instalacji pakietu PandaDoc w AppExchange, jak opisano w następnym rozdziale.
Instalowanie pakietu PandaDoc w AppExchange
Uwaga:
Musisz mieć uprawnienia administratora Salesforce, aby zainstalować moduł PandaDoc i go skonfigurować.- Zaloguj się na konto Salesforce: https://login.salesforce.com/
- Naszą aplikację można znaleźć w witrynie SFDC AppExchange.
- Kliknij „Get It Now” (Pobierz teraz).
- Kliknij „Install for All Users” (Zainstaluj dla wszystkich użytkowników), a następnie kliknij „Upgrade/Install” (Uaktualnij/zainstaluj).
- Wybierz „Yes, grant access to these third-party web sites” (Tak, przyznaj dostęp do tych witryn internetowych innych firm) i kliknij „Continue” (Kontynuuj).
- Proces instalacji rozpocznie się i może trochę potrwać. Kliknij „Done” (Gotowe) po zakończeniu.
Konfigurowanie modułu PandaDoc dla obiektu Salesforce
Uwaga:
Poniższe instrukcje dotyczą konfiguracji obiektu szans, ale można je wykorzystać również w przypadku każdego innego obiektu.Ostrzeżenie:
Konto Salesforce musi mieć funkcję Moja domena, aby można było korzystać ze składnika PandaDoc Lightning.- Otwórz rekord szansy.
- W prawym górnym narożniku kliknij ikonę koła zębatego Edit Page (Edytuj stronę).
- Nastąpi przeniesienie do trybu edycji, w którym można dodać moduł PandaDoc do układu strony.
- Na lewym panelu przewiń w dół i znajdź składnik PandaDoc Documents Lightning.
- Przeciągnij i upuść go na układ strony w dowolnym miejscu.
- Można dodać dowolną liczbę składników PandaDoc.
- Po dodaniu składnika należy ustawić jego wysokość oraz tryb wyświetlania: w sekcji dokumentów powiązanych będą wyświetlane wszystkie dokumenty utworzone z obiektu szans, a w sekcji szablonów będą wyświetlane szablony, za pomocą których można tworzyć dokumenty.
- Zapisz i aktywuj składnik, klikając „Save” (Zapisz) i „Activation” (Aktywacja) w prawym górnym narożniku.
Przekazywanie danych z SFDC do PandaDoc
Aby przekazać dane z Salesforce do dokumentu PandaDoc, najpierw należy utworzyć szablon i skonfigurować go za pomocą zmiennych (podobnie jak pola scalania).
Przekazywanie pól Salesforce do PandaDoc
Przed skonfigurowaniem szablonu za pomocą zmiennych utwórz listę zmiennych dla każdego obiektu, który będzie używany w PandaDoc.
Uwaga:
Zmienne muszą być skonfigurowane dla każdego obiektu osobno. Tylko zmienne wymienione w danym obiekcie będą dostępne podczas tworzenia dokumentu na jego podstawie (brak wypełniania międzyobiektowego).- W tym celu kliknij przycisk App Launcher i przejdź do menu PandaDoc Setup (Konfiguracja PandaDoc). Przewiń w dół do „Salesforce to PandaDoc data flow” (Przepływ danych z Salesforce do PandaDoc) i kliknij „Configure tokens” (Skonfiguruj tokeny).
- Następnie wybierz obiekt, dla którego chcesz zmodyfikować listę tokenów. Jeśli PandaDoc jest zainstalowany w innym obiekcie, kliknij „Add object” (Dodaj obiekt).
- Po prawej stronie zostanie wyświetlona domyślna lista zmiennych/tokenów. Aby dodać więcej, zaznacz pola, które chcesz dodać do listy zmiennych/tokenów i kliknij „Save” (Zapisz).
- Otwórz szablon PandaDoc w osobnym oknie przeglądarki, a następnie skopiuj i wklej nazwy zmiennych wraz z nawiasami kwadratowymi do szablonu.
- Podczas tworzenia dokumentu z Salesforce przy użyciu tego szablonu zmienne zostaną wypełnione informacjami z systemu CRM.
Ostrzeżenie:
Zaszyfrowane pole tekstowe nie może być przekazywane za pośrednictwem zmiennej!Uwaga:
Jeśli pole w Salesforce będzie puste, zmienna w dokumencie nie zostanie wypełniona i pole trzeba będzie wypełnić ręcznie.Przekazywanie odbiorców z Salesforce do PandaDoc
Uwaga:
Przekazywanie informacji o odbiorcach najlepiej działa w przypadku ról PandaDoc. Tutaj dowiesz się, jak skonfigurować role w szablonie.Salesforce domyślnie wypycha następujące informacje o odbiorcy w zależności od obiektu, w którym jest moduł PandaDoc:
- Z szansy: dane kontaktowe roli
- Z konta: dane kontaktowe + możliwe do wypchnięcia informacje o koncie
- Z potencjalnego klienta: informacje o potencjalnym kliencie
- Z kontaktu: dane kontaktowe
- Z ofert: dane kontaktowe
Można skonfigurować, które pole z Salesforce będzie mapowane do roli w PandaDoc, jak również ustawić, które pola będą wysyłane jako następujące parametry:
- Imię
- Nazwisko
- Pole firmy
- Pole numeru telefonu
- Pole roli
- Przejdź do modułu uruchamiania aplikacji i wybierz opcję konfigurowania odbiorców w ramach Pandadoc.
- Wyświetli się domyślne mapowanie dla domyślnych obiektów. Można je zmienić lub dodać nowe mapowania dla obiektów niestandardowych.
Aby system PandaDoc automatycznie mapował odbiorcę do określonej roli, są potrzebne 2 rzeczy:
- Pole roli skonfigurowane w mapowaniu odbiorców
- Identyczne nazwy ról w Salesforce i w szablonie PandaDoc
Gdy konfiguracja będzie prawidłowa, PandaDoc wstawi odpowiedniego odbiorcę do odpowiedniej roli podczas tworzenia dokumentów.



Uwaga:
PandaDoc pobiera wszystkie powiązane kontakty z Salesforce do dokumentu. Aby usunąć jakiś kontakt, usuń go w oknie podręcznym roli lub w sekcji odbiorców w dokumencie.Jeśli generujesz dokumenty z oferty lub sprawy, być może korzystasz z pola wyszukiwania do konkretnego rekordu kontaktu. Możesz określić, które pola wyszukiwania mają być wykorzystywane jako odbiorcy, przechodząc do konfiguracji PandaDoc przewijając w dół do ustawień dostosowywania obiektów. Znajdź obiekt do skonfigurowania i kliknij przycisk konfiguracji po prawej stronie.
Następnie wybierz pole, które ma być wykorzystywane jako odbiorca i kliknij przycisk Save (Zapisz). Maksymalnie można wybrać pięć pól.
Następnie skonfiguruj mapowanie odbiorcy. I to wszystko!




Filtrowanie odbiorców
Można filtrować kontakty przekazywane do dokumentów PandaDoc jako odbiorcy na podstawie pól tak/nie w rekordzie (tzw. pól wartości logicznych).
- Przejdź do modułu uruchamiania aplikacji PandaDoc Setup (Konfiguracja PandaDoc) Configure Recipients (Konfiguracja odbiorców).
- Przewiń w dół do opcji „Recipients Filtering” (Filtrowanie odbiorców).
- Kliknij „Enable Filtering” (Włącz filtrowanie).
- Wybierz pole, na podstawie którego będą filtrowani odbiorcy wartości.
- Wybierz wartość pola, na podstawie której będą filtrowani odbiorcy: prawda — tak, fałsz — nie.
Jeśli skonfigurowano mapowanie odbiorców dla kont, można skonfigurować je tak, aby przekazywało informacje o koncie (e-mail, telefon itp.) do PandaDoc jako odbiorca.
W tym celu przejdź do konfiguracji PandaDoc - przewiń w dół do ustawień konstruktora JSON, obok nazwy obiektu konta kliknij przycisk „Setup” (Konfiguracja) - zaznacz pole obok „Send Account as recipient” (Wyślij konto jako odbiorca) i kliknij przycisk „Save” (Zapisz).
Uwaga:
Role kontaktów Salesforce i role szablonów PandaDoc nie mogą mieć dwóch kontaktów przypisanych do jednej roli.Jeśli masz jakiekolwiek sugestie dotyczące funkcjonalności PandaDoc - podaj pomysł na portalu idei lub napisz na adres support@pandadoc.com.
Przekazywanie informacji z Salesforce do PandaDoc (za pośrednictwem pól)
Dane można przekazywać do pól PandaDoc podobnie jak w przypadku zmiennych. Jednak w przeciwieństwie do zmiennych nie trzeba wstawiać nawiasów kwadratowych.
Z listy tokenów skopiuj token bez nawiasów kwadratowych do pola scalania.
Po wysłaniu dokumentu odbiorca zobaczy wstępnie wypełnione dane i będzie mógł zaktualizować to pole, o ile zostało ono do niego przypisane.
Przekazywanie danych produktów do tabeli z cennikiem
PandaDoc może wysyłać produkty z obiektów szans, potencjalnych klientów, kontaktów lub kont do tabeli z cennikiem w dokumencie. W tym poradniku omówimy, jak przekazać produkty z obiektu szans do PandaDoc, jednak konfiguracja jest taka sama dla innych obiektów.
Najpierw zamapuj pola produktów z obiektu szans do pól tabeli z cennikiem.
- Przejdź do konfiguracji PandaDoc Configure Pricing Items PandaDoc (Konfiguracja pozycji cen w PandaDoc).
- Produkty z obiektu szans będą wyświetlane domyślnie, ale można wybrać inny obiekt, dla którego chcesz skonfigurować mapowanie.
- Następnie zamapuj pola produktów z obiektu szans do pól tabeli z cennikiem i kliknij Save (Zapisz).
- Poniżej w sekcji sortowania pozycji cen można ustawić kolejność, w jakiej produkty mają być wyświetlane w tabeli z cennikiem PandaDoc.



Teraz skonfiguruj tabelę z cennikiem, aby zaakceptować produkty z Salesforce.
- Otwórz szablon PandaDoc, dodaj tabelę z cennikiem.
- Kliknij Properties (Właściwości) na górze tabeli z cennikiem i w ustawieniach po prawej stronie włącz opcję Data merge (Scalanie danych).
Uwaga:
Produkty mogą zostać przekazane do PandaDoc w innej kolejności niż ta wymieniona w obiekcie szans.To koniec konfiguracji! Po rozpoczęciu tworzenia nowego dokumentu z obiektu szans (zakładając, że zostały do niego dodane produkty) należy wybrać szablon. Produkty zostaną dodane do tabeli z cennikiem. Jeśli niektóre pola nie są wyświetlane, kliknij znak plusa po prawej stronie tabeli z cennikiem i zaznacz pola w obszarze Add hidden (Dodaj ukryte).
Przekazywanie pól niestandardowych produktów do tabeli z cennikiem
Czasami trzeba przekazać więcej niż standardowy zestaw pól produktów.
- Najpierw dodaj pola produktów z obiektu szans do listy tokenów/zmiennych, przechodząc do konfiguracji PandaDoc konfiguracji tokenów. Wybierz produkt z obiektu szans i zaznacz po prawej stronie pola do przekazania. Pojawią się one na liście tokenów po lewej stronie.
- Kliknij Save (Zapisz). To koniec konfiguracji!
- Tabela z cennikiem w szablonie musi mieć włączoną opcję automatycznego importu.
- Podczas tworzenia dokumentu z szablonu kliknij znak plusa po prawej stronie tabeli z cennikiem.
- Wybierz niestandardowe pola produktów w obszarze Add hidden (Dodaj ukryte).
Jeśli dodawanie pól niestandardowych z ukrytych kolumn przy każdym tworzeniu dokumentu wydaje się zbyt skomplikowane, jest na to sposób.
- Utwórz dokument i odkryj niestandardowe pola produktów.
- Następnie kliknij pionowy wielokropek w prawym górnym narożniku i wybierz Convert to Template (Konwertuj do szablonu). Nowy szablon zostanie otwarty w nowej karcie przeglądarki.
- W szablonie można usunąć produkty z tabeli z cennikiem, ale należy zachować kolumny pól niestandardowych.
- Użyj tego szablonu, gdy następnym razem otworzysz dokument z Salesforce. Kolumny zostaną wypełnione wartościami pól niestandardowych produktów.
Tworzenie i wysyłanie dokumentów
Po utworzeniu i skonfigurowaniu szablonu można przystąpić do tworzenia i wysyłania dokumentów z Salesforce.
- Przejdź do rekordów, znajdź moduł PandaDoc, kliknij „New Document” (Nowy dokument).
- Wybierz szablon i przypisz odbiorców do ról, jeśli istnieją.
- Kliknij „Start editing” (Rozpocznij edycję) i sprawdź dokument: zmienne, treść, listę odbiorców, przypomnienia, a następnie wyślij dokument.
- Teraz można wrócić do rekordu w Salesforce i śledzić status dokumentu.
- Po ukończeniu dokumentu jego plik w formacie pdf pojawi się na karcie plików w rekordzie. (Chociaż jest to część synchronizacji dwukierunkowej, jest ona domyślnie włączona podczas instalacji pakietu PandaDoc).
Dodawanie plików w widoku obiektu
Jeśli nie widzisz plików w obiekcie, być może trzeba je dodać do widoku obiektu.
Aby to zrobić, wróć do układów stron obiektu w ustawieniach:
- Na ekranie głównym, w prawym górnym narożniku znajdź ikonę konfiguracji w postaci koła zębatego.
- Po wejściu na stronę Settings (Ustawienia), przejdź do listy Object Manager (Menedżer obiektów) i wybierz opcję Opportunity (Szansa).
- W obszarze szans przejdź do układu strony i wybierz układ szans.
- Na stronie układu szansy za pomocą górnego paska narzędzi znajdź Related Lists (Powiązane listy), a następnie dodaj pliki do powiązanych list i zapisz.
- Ponownie sprawdź w module szans, czy pliki są teraz widoczne z poziomu strony.
Łączenie dokumentu z szansą w Salesforce
Jeśli masz dokument utworzony w PandaDoc, który chcesz połączyć z szansą w Salesforce, mamy dla Ciebie rozwiązanie!
- Na karcie PandaDoc otwórz dokument, a następnie kliknij ikonę Salesforce po prawej stronie. Dokument musi mieć status wersji roboczej.
- Kliknij „Link” (Połącz). Pojawi się monit o zalogowanie się na konto Salesforce.
- Wybierz szansę z listy, a następnie kliknij „Link” (Połącz).
- Po prawej stronie w obszarze informacji o szansie można zobaczyć jej datę utworzenia, status oraz łączną kwotę. Uwaga: aby w PandaDoc były wyświetlane najbardziej aktualne informacje o szansach, należy je odświeżać.
- Teraz przejdź do rekordu szans Salesforce. Dokument zostanie wyświetlony w module PandaDoc, tak jakby został utworzony za pośrednictwem Salesforce.
Aby odłączyć dokument od szansy lub połączyć go z inną szansą, kliknij żądaną akcję na panelu integracji. Jeśli dokument został utworzony z innego obiektu (konto, kontakt itp.), nie można go odłączyć od tego obiektu i połączyć z szansą lub wyświetlić powiązanych informacji.
Aktualizowanie dokumentu wartościami pól z Salesforce
Uwaga:
dokument musi mieć status wersji roboczej dla tej funkcji.Jeśli informacje w rekordzie Salesforce zostaną zaktualizowane po utworzeniu dokumentu na jego podstawie, można zaktualizować dokument prawidłowymi wartościami:
- W dokumencie przejdź do panelu integracji, klikając ikonę Salesforce po lewej stronie w dokumencie PandaDoc.
- W obszarze danych dokumentu wybierz opcję „Import from CRM” (Import z CRM).
- Zmienne zostaną zaktualizowane najnowszymi informacjami z Salesforce.
- Z funkcji importowania z CRM można korzystać w dowolnym obiekcie w Salesforce: szansy, konta, potencjalnego klienta, kontaktu, obiektów niestandardowych.
Jeśli pole w Salesforce jest puste, odpowiednia zmienna nie zostanie odświeżona.
Ostrzeżenie:
Nie można aktualizować tabeli z cennikiem danymi produktów z Salesforce ani aktualizować pól PandaDoc lub zmiennych ról.Często zadawane pytania
Jak sprawdzić wersję integracji?
Otwórz Salesforce, kliknij znak plusa na górze, wpisz „zainstalowane pakiety” w polu szybkiego wyszukiwania i kliknij sekcję Installed packages (Zainstalowane pakiety), która pojawia się w wyszukiwaniu. Znajdź PandaDoc wśród zainstalowanych aplikacji i sprawdź wersję w kolumnie Version number (Numer wersji).
Jak zapewnić zespołowi pomocy technicznej PandaDoc dostęp do mojego konta w Salesforce?
Zespół pomocy technicznej może poprosić o dostęp do konta w Salesforce, aby pomóc rozwiązać problem lub odpowiedzieć na pytanie. Nie należy udzielać dostępu, jeśli nasz zespół pomocy technicznej nie poprosi o to.
W Salesforce Lightning:
- Zaloguj się do Salesforce, kliknij obraz (lub awatar) w prawym górnym narożniku, a następnie kliknij pozycję Settings (Ustawienia).
- Po lewej stronie w małym polu wyszukiwania wpisz „grant” (udziel), a następnie kliknij poniżej pozycję Grant Account Login Access (Udziel dostępu do konta).
W Salesforce Classic:
- Zaloguj się do Salesforce, a następnie kliknij pozycję My Settings (Moje ustawienia) w prawym górnym narożniku. (Ewentualnie kliknij imię i nazwisko, a następnie My Settings (Moje ustawienia)).
- Po lewej stronie w małym polu wyszukiwania wpisz „grant” (udziel), a następnie kliknij poniżej pozycję Grant Account Login Access (Udziel dostępu do konta).
W opcji „Access duration” (Czas dostępu) w obszarze „PandaDoc Support” (Pomoc techniczna PandaDoc” wybierz 3 dni.
Następnie wyślij na adres e-mail naszego zespołu pomocy technicznej identyfikator organizacji Salesforce ze strony informacji o firmie. Kliknij następujące pozycje: Setup (Konfiguracja) Company profile (Profil firmy) Company information (Informacje o firmie) i znajdź identyfikator obok pozycji Salesforce Organization ID (Identyfikator organizacji Salesforce).
Rozwiązywanie problemów
Kliknij problem, aby rozwinąć rozwiązanie.
Moduł PandaDoc jest pusty lub wyświetla następujący komunikat o błędzie: „Attempt to de-reference a null object” (Próba odwołania się do pustego obiektu). Wystąpił nieoczekiwany błąd.
Dzieje się tak, gdy obiekt, dla którego skonfigurowano zmienne, tabelę z cennikiem lub mapowanie odbiorców został usunięty lub jego nazwa została zmieniona.
Aby to naprawić, należy wykonać następujące czynności:
- Sprawdź, czy zainstalowano najnowszą wersję integracji.
- Przejdź do obszaru konfiguracji PandaDoc, kliknij Configure Tokens (Konfiguracja tokenów), a następnie otwórz obiekt, który wyświetla komunikat o błędzie lub pusty ekran.
- Dodaj nowe pole z lewej kolumny jako token/zmienną, a następnie kliknij Save (Zapisz).
- Jeśli problem nadal występuje, przejdź do ustawień dostosowywania obiektów na stronie konfiguracji PandaDoc, a następnie kliknij Setup (Konfiguracja) obok obiektu, w którym jest wyświetlany błąd.
- Jeśli otworzy się pusta strona, usuń obiekt z listy, a następnie dodaj go ponownie.
Moduł PandaDoc wyświetla błąd: „Unexpected token ‘FROM’ in opportunity” (Nieoczekiwany token „FROM” w obiekcie szansy).
Jeśli zobaczysz taki komunikat, być może nie masz uprawnień do niektórych obiektów Salesforce związanych z szansą. Możliwe że pliki nie zostały włączone na profilu lub firma dodała ostatnio nowy obiekt, który nie został jeszcze włączony na profilu.
Aby to naprawić, poproś administratora Salesforce o sprawdzenie uprawnień profilu i upewnij się, że masz dostęp do powiązanych obiektów.
Kontakty nie są przekazywane jako odbiorcy podczas tworzenia dokumentu z szansy.
Być może rozpoczęto testowanie integracji za pomocą kontaktów testowych. Możliwe, że żadne adresy e-mail nie są skojarzone z tymi kontaktami w Salesforce. Aby rozwiązać ten problem, dodaj prawidłowe adresy e-mail do kontaktów w Salesforce i spróbuj ponownie.