Pardot nazywa się teraz Account Engagement i jest częścią Salesforce Marketing Cloud.

Poradnik wideo: przesyłanie e-maili do Pardot

Ten film pokazuje, jak przesyłać e-maile HTML z wtyczki Emailify do Figmy na platformę Pardot.

Jeśli w akapitach tekstu potrzebujesz linków AMPscript (na przykład %%=v(@url)=%%), natywne pole linku w Figmie zablokuje je jako nieprawidłowe adresy URL. Możesz to obejść, używając specjalnego formatu linku AMPscript w Emailify: https://ampscript.invalid/?%%=v(@url)=%%. Emailify umieści wtedy w wyeksportowanym HTML surowy tag AMPscript.

1. Utwórz aplikację Connected App w Pardot

Jeśli jeszcze jej nie masz, utwórz w Pardot nową aplikację Connected App. Otrzymasz z niej Consumer Key i Consumer Secret, które wkleisz do wtyczki w kroku 3 (Uwierzytelnienie w Pardot).

1. W prawym górnym rogu panelu administracyjnego Pardot kliknij Settings Icon, a potem Setup.
2. Na pasku wyszukiwania ustawień wpisz „App Manager” i kliknij wynik App Manager.
3. Kliknij przycisk New Connected App.
4. Nadaj aplikacji nazwę (na przykład Emailify Integration).
5. Dodaj dane kontaktowe właściciela aplikacji Connected App.
6. Zaznacz pole wyboru Enable OAuth Flows.
7. Jako Callback URL dodaj https://figma.com/.
8. W sekcji Selected OAuth Scopes dodaj poniższe zakresy, które pozwalają aplikacji uzyskać dostęp do Pardot i się w nim uwierzytelnić:

• Access content resources (content)
• Access the identity URL service (id, profile, email, address, phone)
• Manage Pardot services (pardot_api)
• Perform requests at any time (refresh _token, offline_access)

9. Zaznacz pole wyboru Require Secret for Web Server Flow.
10. Jeśli widzisz opcję Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows, upewnij się, że nie jest zaznaczona.
11. Kliknij Save.

2. Znajdź Business Unit ID w Pardot

Business Unit ID to 18-znakowy identyfikator zaczynający się od „0Uv”. Znajdziesz go w ten sposób:

1. Zaloguj się do Salesforce na to samo konto, którego używasz do logowania w Pardot.
2. Kliknij kartę Setup.
3. Znajdź listę rozwijaną Pardot i kliknij Pardot Account Setup.
4. Możesz mieć kilka jednostek biznesowych Pardot – wybierz Business Unit ID tej, której chcesz używać z Emailify.

3. Uwierzytelnij się w Pardot

W panelu eksportu Emailify wybierz z listy rozwijanej opcję Pardot (API) lub opcję dla testowego konta Pardot, a potem skopiuj i wklej w pola ustawień eksportu Emailify te dane uwierzytelniające i informacje z Pardot:

• Pardot Business Unit ID (na przykład 0UvXXXXXXXXXXXXXXX)
• Pardot Username, czyli nazwa użytkownika, której używasz do logowania (na przykład [email protected])
• Pardot Password, czyli hasło, którego używasz do logowania (na przykład *********)
• Consumer Key z Twojej aplikacji Connected App (na przykład y0Zd2jVHJ5Cc1wQg0l5yMJsXpPs...)
• Consumer Secret z Twojej aplikacji Connected App (na przykład 8C8F8D11A3B7B026A90C5C3...)

Po wklejeniu wszystkich tych danych Emailify uwierzytelni się w Twojej instancji Pardot.

Opcje endpointów API Pardot w Emailify

Jeśli korzystasz z instancji testowej lub sandboksa, możesz wybrać w opcjach eksportu Emailify inne opcje eksportu przez API Pardot. Poniżej znajdziesz endpointy, z których korzysta każda z nich:

Opcja Emailify	Domena autoryzacji	Domena treści
Pardot API	login.salesforce.com/services/oauth2/token?grant_type=password	pi.pardot.com
Pardot Test API	test.salesforce.com/services/oauth2/token?grant_type=password	pi.demo.pardot.com
Pardot Dev API	login.salesforce.com/services/oauth2/token?grant_type=password	pi.demo.pardot.com

Rozwiązywanie problemów z uwierzytelnianiem w Pardot

Jeśli masz problem z uwierzytelnieniem za pomocą nazwy użytkownika i hasła Pardot, najczęściej przyczyną jest włączone uwierzytelnianie wieloskładnikowe Salesforce (MFA) dla użytkownika Salesforce, z którego korzysta integracja.

Najczęstszym powodem niepowodzenia uwierzytelniania w Pardot są problemy z 2FA, ale często da się je rozwiązać w Pardot w ten sposób:

• Zmień ustawienie IP Relaxation na Relax IP Restrictions.
• Zmień ustawienie Permitted Users na All users may self-authorize.
• Włącz przełącznik Allow OAuth Username-Password Flows w OAuth and OpenID Connect Settings.
• Hasła nie mogą zawierać znaków specjalnych (na przykład # % & itp.) – mogą składać się tylko z liter i cyfr (na przykład mypa55word1234).

Jak zapewnić działanie użytkowników integracji API przy MFA w Salesforce

Salesforce wymusza MFA głównie przy interaktywnym logowaniu do interfejsu. Integracje oparte na API zwykle działają dalej bez interaktywnych monitów MFA, ale administrator Salesforce musi poprawnie skonfigurować użytkownika integracji.

Przy przesyłaniu przez API Pardot w Emailify najlepiej używać osobnego konta użytkownika integracji Salesforce zamiast wspólnego, osobistego loginu.

Zalecane: licencja użytkownika Salesforce Integration

Jeśli Twoja edycja Salesforce obejmuje licencje użytkowników Salesforce Integration, przypisz jedną z nich do osobnego użytkownika integracji, z którego korzysta Emailify.

Zalety:

• Ci użytkownicy są przeznaczeni wyłącznie do dostępu przez API.
• Nie mogą logować się do interfejsu Salesforce, więc z założenia nie dotyczą ich monity MFA w interfejsie.
• Pomagają oddzielić integrację od kont zwykłych użytkowników.
• Ich profil tylko do API ma zwykle domyślnie włączone API Enabled.

Aby sprawdzić, czy te licencje są dostępne:

1. W Salesforce przejdź do Setup.
2. Wyszukaj Company Information.
3. Otwórz Company Information.
4. Poszukaj pozycji Salesforce Integration na liście User Licenses.

Alternatywa: zwolnienie standardowego użytkownika Salesforce z MFA w interfejsie

Jeśli nie możesz użyć licencji użytkownika Salesforce Integration, a integracja korzysta ze standardowego użytkownika Salesforce, administrator Salesforce może zwolnić tego osobnego użytkownika integracji z MFA w interfejsie. Wystarczy przypisać mu zestaw uprawnień (Permission Set) z uprawnieniem systemowym Waive Multi-Factor Authentication for Exempt Users.

Aby to skonfigurować:

1. W Salesforce przejdź do Setup.
2. Wyszukaj Permission Sets.
3. Utwórz nowy zestaw uprawnień dla użytkownika integracji.
4. Otwórz System Permissions i kliknij Edit.
5. Włącz Waive Multi-Factor Authentication for Exempt Users.
6. Zapisz zestaw uprawnień.
7. Przypisz ten zestaw uprawnień do osobnego użytkownika integracji.

Jeśli integracja korzysta ze standardowej licencji użytkownika Salesforce, upewnij się też, że profil użytkownika nadal ma włączone API Enabled w System Permissions.

Dodatkowe zalecenia

• Używaj osobnego użytkownika integracji zamiast osobistego konta.
• Jeśli korzystasz z uwierzytelniania nazwą użytkownika i hasłem, przechowuj te dane oraz ewentualny token zabezpieczający w bezpiecznym miejscu.
• Przetestuj połączenie z Pardot w sandboksie, zanim wprowadzisz zmiany związane z MFA w środowisku produkcyjnym.
• Jeśli uwierzytelnianie zacznie zawodzić po wdrożeniu MFA, sprawdź w Login History użytkownika Salesforce dokładną przyczynę błędu.

Materiały Salesforce

• Best Practices for Configuring Your Integration User
• Exclude Exempt Users from MFA

4. Prześlij szablony e-maili do Pardot

Po udanym uwierzytelnieniu połączenia z API Pardot pojawią się pola i listy rozwijane, w których podasz te wymagane informacje:

• Sender Name

• Sender Address

• Campaign Name

• Folder Name

• Domain Tracking Name

Do eksportowanego szablonu możesz opcjonalnie dodać tagi obszarów treści Pardot:

• Editable Regions pozwala użytkownikom edytować tekst, obrazy i przyciski.
• Repeatable Regions pozwala użytkownikom kopiować lub przenosić odblokowane bloki treści najwyższego poziomu. Te bloki mają wspólną nazwę obszaru powtarzalnego (body_content), więc różne bloki mogą zamieniać się miejscami.
• Removable Regions pozwala użytkownikom usuwać odblokowane bloki treści najwyższego poziomu.

Przed przesłaniem lub eksportem szablonu włącz dowolną kombinację tych opcji. Gdy włączone są jednocześnie Repeatable Regions i Removable Regions, Emailify dodaje oba atrybuty do tego samego elementu otaczającego każdy odblokowany blok. Powtarzalne elementy otaczające mają wspólną nazwę body_content i leżą obok siebie, dzięki czemu różne bloki mogą się przemieszczać w obrębie grupy. Wokół każdego powtarzalnego bloku nie ma osobnego elementu otaczającego dla usuwania.

Stałe nagłówki i stopki

Przed eksportem zablokuj w Figmie nagłówek, stopkę lub inną warstwę nadrzędną leżącą bezpośrednio w ramce e-maila Emailify. Emailify eksportuje zablokowane warstwy najwyższego poziomu bez tagów obszarów powtarzalnych i usuwalnych – dotyczy to też wszystkich bloków wygenerowanych z zablokowanej grupy nadrzędnej. Warstwy treści zostaw odblokowane, aby przy włączonym Repeatable Regions użytkownicy mogli zmieniać ich kolejność.

Zablokuj samą warstwę najwyższego poziomu – zablokowanie tylko zagnieżdżonej warstwy tekstowej lub obrazu nie blokuje bloku nadrzędnego. Blokada decyduje o kopiowaniu, przenoszeniu i usuwaniu całych bloków. Edycją tekstu, obrazów i przycisków w ich wnętrzu nadal steruje Editable Regions. Aby blok znów był powtarzalny lub usuwalny, odblokuj warstwę nadrzędną i ponownie wyeksportuj szablon.

Gdy wybierzesz odpowiednie opcje i wszystko będzie gotowe, kliknij przycisk Upload To Pardot, aby wyeksportować do HTML e-maile zaznaczone w Figmie i automatycznie przesłać je do szablonów e-maili w Pardot.