Integracja z Salesforce Marketing Cloud

Krok 1: Konfiguracja w Salesforce Marketing Cloud

Pierwszym krokiem jest utworzenie Installed Package w Salesforce Marketing Cloud, który będzie służył jako punkt autoryzacji dla MessageFlow do komunikacji z Twoim kontem SFMC.

1. Zaloguj się do Salesforce Marketing Cloud.

2. W prawym górnym rogu ekranu kliknij ikonę swojego profilu/użytkownika i z rozwiniętego menu wybierz opcję Setup (Konfiguracja).

1. W lewym menu nawigacyjnym przejdź do: Platform Tools (Narzędzia platformy) -> Apps (Aplikacje) -> Installed Packages (Zainstalowane pakiety).

1. Kliknij przycisk New (Nowy).

2. Wprowadź Nazwę dla pakietu (np. MessageFlow_Integration) i opcjonalny opis. Kliknij Save (Zapisz).

Dodanie komponentu API Integration (uwierzytelnienie)

1. Na stronie szczegółów nowo utworzonego pakietu, kliknij przycisk Add Component (Dodaj komponent).

1. Wybierz typ komponentu: API Integration (Integracja API) i typ integracji: Server-to-Server. Kliknij Next (Dalej).

2. Nadaj niezbędne uprawnienia (Scope) dla tego pakietu. Zalecane minimum to:

   pola konfiguracyjne dla nowej aktywności:

   • W sekcji Channels -> SMS: Zaznacz Read (Odczyt) i Send (Wysyłka).

   • W sekcji Data -> Data Extensions: Zaznacz Read (Odczyt) i Write (Zapis).

   • W sekcji Contacts -> List and Subscribers: Zaznacz Read (Odczyt) i Write (Zapis).

   • W sekcji Webhooks: Zaznacz Read (Odczyt) i Write (Zapis).

1. Kliknij Save (Zapisz).

2. Po zapisaniu uprawnień, na stronie szczegółów pakietu zobaczysz wygenerowane klucze. Skopiuj i zapisz następujące wartości – będą potrzebne w kolejnym kroku:

   pola konfiguracyjne dla nowej aktywności:

   • Client ID

   • Client Secret

   • Authentication Base URI (w formacie https://xxx.auth.marketingcloudapis.com/)

Dodanie komponentu Journey Builder Activity (aktywność SMS)

1. Będąc na stronie szczegółów tego samego pakietu, ponownie kliknij Add Component.

2. Tym razem jako typ komponentu wybierz Journey Builder Activity.

1. Wypełnij pola konfiguracyjne dla nowej aktywności:

   • Name: Wprowadź nazwę, która będzie widoczna w Journey Builder (np. MessageFlow SMS).

   • Category: Wybierz kategorię, w której ma się pojawić aktywność (np. Messages).

   • Endpoint URL: Wklej tutaj unikalny adres URL, który został wygenerowany dla Ciebie w panelu integracyjnym MessageFlow (znajdziesz go w Kroku 2).

2. Kliknij Save (Zapisz).

Krok 2: Konfiguracja w Panelu Integracyjnym MessageFlow

Teraz należy wprowadzić dane z SFMC do panelu integracyjnego MessageFlow i wygenerować klucze specyficzne dla tej integracji.

1. Zaloguj się do panelu integracyjnego MessageFlow dla Salesforce Marketing Cloud pod adresem: https://salesforce.messageflow.com/panel/login.

1. Przejdź do sekcji Settings (Ustawienia).

2. Wypełnij pola dotyczące połączenia z Salesforce Marketing Cloud (SFMC)

   pola konfiguracyjne dla nowej aktywności:

   • ClientID: Wklej wartość Client ID skopiowaną z SFMC.

   • ClientSecret: Wklej wartość Client Secret skopiowaną z SFMC.

   • Base auth URL: Wklej wartość Authentication Base URI skopiowaną z SFMC.

3. Wygeneruj klucze MessageFlow do komunikacji z SFMC:

   • Webhook token: Kliknij przycisk Generate i skopiuj wygenerowany token oraz nowy URL SFMC

   • Key: Kliknij przycisk Generate i skopiuj wygenerowany klucz.

   (Zanotuj oba klucze, będą potrzebne przy konfiguracji webhooków lub niestandardowych aktywności w Journey Builder).

1. Wybierz domyślny Sender ID z rozwijanej listy. Będzie on używany jako domyślna nazwa nadawcy dla Twoich SMS-ów. Więcej informacji: Nagłówki SMS

2. Kliknij przycisk Save (Zapisz), aby zapisać wszystkie ustawienia.

Krok 3: Pierwsze Kroki w Journey Builder

Po pomyślnej konfiguracji, w palecie aktywności Journey Builder w Twoim środowisku Salesforce Marketing Cloud pojawi się nowa, niestandardowa aktywność, np. "MessageFlow SMS".

1. Przejdź do Journey Builder, aby stworzyć nową lub edytować istniejącą ścieżkę klienta (np. Multi-Step Journey).

1. Zdefiniuj źródło wejścia (Entry Source): Każda ścieżka musi mieć zdefiniowane źródło danych, czyli listę kontaktów, która ją rozpocznie. W Salesforce Marketing Cloud do zarządzania danymi o kontaktach służy narzędzie Contact Builder, w którym tworzysz i zarządzasz tabelami danych, czyli Data Extensions.

   • Na obszar roboczy ścieżki przeciągnij kafelek Data Extension z panelu Entry Sources po lewej stronie.

   • Kliknij na dodany kafelek, a następnie na przycisk Select Data Extension.

   

   • Z listy wybierz Data Extension, które zawiera kontakty mające wejść do Twojej ścieżki, i zatwierdź wybór.

2. Kliknij na dodaną aktywność, aby otworzyć jej okno konfiguracyjne. Znajdziesz tam opcje pozwalające na zdefiniowanie treści wiadomości SMS, wybranie nadawcy oraz zmapowanie numeru telefonu odbiorcy z odpowiedniej kolumny w Twoim Data Extension.

Krok 4: Zakończenie Konfiguracji

Po wykonaniu powyższych kroków, podstawowa konfiguracja połączenia między MessageFlow a Salesforce Marketing Cloud jest zakończona. Twoje środowisko SFMC jest teraz uprawnione do komunikacji z platformą MessageFlow.