# Salesforce Marketing Cloud

Poniższa instrukcja przeprowadzi Cię krok po kroku przez proces integracji **MessageFlow** z **Salesforce Marketing Cloud**, umożliwiając efektywne zarządzanie wysyłkami SMS bezpośrednio z Twojego środowiska marketingowego.

## **Wprowadzenie**

Integracja MessageFlow z Salesforce Marketing Cloud pozwala na wzbogacenie Twojej strategii komunikacji o wiadomości SMS, w pełni zsynchronizowane z Twoimi danymi o klientach i automatyzacjami marketingowymi. Dzięki temu możesz wysyłać spersonalizowane i kontekstowe SMS-y bezpośrednio z Journey Builder lub Automation Studio, a także monitorować statusy dostarczenia wiadomości.

## **Wymagania Wstępne**

Przed rozpoczęciem integracji upewnij się, że posiadasz:

* **Klucze API z Twojego konta MessageFlow**. Będą one potrzebne do zalogowania się do panelu integracyjnego. Jeśli jeszcze ich nie masz, wygeneruj je w głównym panelu MessageFlow:
  * Przejdź do sekcji **Konto -> Ustawienia -> API**.
  * Wprowadź nazwę dla nowego klucza (np. SFMC\_Integration\_Key) i kliknij **Generuj klucz API**.
  * System wygeneruje dwie wartości: **Authorization** oraz **Application-Key**. Skopiuj je i przechowuj w bezpiecznym miejscu.

{% hint style="info" %}
Uwaga: Ze względów bezpieczeństwa, wartość Authorization jest widoczna tylko raz, bezpośrednio po jej wygenerowaniu. Po odświeżeniu strony jej ponowne skopiowanie nie będzie możliwe. Nie udostępniaj kluczy osobom nieupoważnionym.
{% endhint %}

* **Aktywne konto Salesforce Marketing Cloud** z uprawnieniami administratora lub rolą umożliwiającą tworzenie i zarządzanie Installed Packages (Pakietami Zainstalowanymi) oraz dostępem do Setup (Konfiguracji).
* **Dostęp do niezależnego panelu integracyjnego** dla Salesforce Marketing Cloud, który znajduje się pod adresem: **<https://salesforce.messageflow.com/panel/login>**.

## Proces Konfiguracji

{% stepper %}
{% step %}

### 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).

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2Frw9VPTNoJKnJGtufNXQz%2FZrzut%20ekranu%202025-06-13%20100042.png?alt=media&#x26;token=daee2bdf-b9d0-4aae-b9dc-bf379c4babe5" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2Fo4k1mAcOFLuROljMJCeF%2FZrzut%20ekranu%202025-06-13%20100127.png?alt=media&#x26;token=a23c8953-eb64-4e33-82ac-321762c0e3dc" alt=""><figcaption></figcaption></figure>

4. Kliknij przycisk **New** (Nowy).
5. Wprowadź Nazwę dla pakietu (np. MessageFlow\_Integration) i opcjonalny opis. Kliknij **Save** (Zapisz).

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2FbtyEJ8KwwEXOzGPJUtDH%2FZrzut%20ekranu%202025-06-13%20100530.png?alt=media&#x26;token=bcebeff0-73c5-408e-b8d3-9d2f7a1e9455" alt=""><figcaption></figcaption></figure>

#### Dodanie komponentu API Integration (uwierzytelnienie)

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

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2FbOK1JHQKzetjvzJr2MqF%2FZrzut%20ekranu%202025-06-13%201029342.jpg?alt=media&#x26;token=4deef91f-80ca-4a2d-b904-3070a5fd0b4f" alt=""><figcaption></figcaption></figure>

7. Wybierz typ komponentu: **API Integration** (Integracja API) i typ integracji: **Server-to-Server**. Kliknij Next (Dalej).
8. 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).

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2F9gejBwXpBbsozwvEFq8Q%2FZrzut%20ekranu%202025-06-13%20103154.png?alt=media&#x26;token=8e7ce97d-f898-4034-b6ea-7d42816c8843" alt=""><figcaption></figcaption></figure>

9. Kliknij **Save** (Zapisz).
10. 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/>)

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2FqfjfIUnKTCeCQQIOP8dH%2FZrzut%20ekranu%202025-06-13%20113956.jpg?alt=media&#x26;token=b057c291-418c-4576-abb4-091b4d4f6235" alt=""><figcaption></figcaption></figure>

#### Dodanie komponentu Journey Builder Activity (aktywność SMS)

11. Będąc na stronie szczegółów tego samego pakietu, ponownie kliknij **Add Component**.
12. Tym razem jako typ komponentu wybierz **Journey Builder Activity.**

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2FNxJtPiy8JsScNgKnbHvV%2FZrzut%20ekranu%202025-06-13%20123000.png?alt=media&#x26;token=9aaff190-4229-4eb3-98a3-16e5f8c04646" alt=""><figcaption></figcaption></figure>

13. 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).
14. Kliknij **Save** (Zapisz).
    {% endstep %}

{% step %}

### 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>.

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2FOI2kdKMHj9qfK2s4Kb00%2FZrzut%20ekranu%202025-06-13%20103810.png?alt=media&#x26;token=9472532d-6be6-49a6-b4e6-ba08f98aaf43" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Uwaga: Do logowania w tym miejscu użyj danych z klucza API wygenerowanego w Twoim głównym panelu MessageFlow - Authorization jako login oraz Application-Key jako hasło.
{% endhint %}

2. Przejdź do sekcji **Settings** (Ustawienia).
3. 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.
4. 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.&#x20;

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

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2FhUurnqCgHvLAMCpMZCoU%2FZrzut%20ekranu%202025-06-13%20110206.png?alt=media&#x26;token=079c29cc-1ba2-4b1a-9ba0-4fd5a06fc041" alt=""><figcaption></figcaption></figure>

5. 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: [nadawca-sms](https://docs.messageflow.com/pl/sms/ustawienia-wspolne-sms/nadawca-sms "mention")
6. Kliknij przycisk **Save** (Zapisz), aby zapisać wszystkie ustawienia.
   {% endstep %}

{% step %}

### 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)**.

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2F1FT68rD6AbKOcyh73Ite%2FZrzut%20ekranu%202025-06-13%20123407.png?alt=media&#x26;token=151ec268-b9a7-478a-aaaa-3c14f755ab3d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2Fdpg9fik0p4ldvqZUkaPh%2FZrzut%20ekranu%202025-06-13%20123441.png?alt=media&#x26;token=039c92b7-29fb-44a6-a735-873f50798d58" alt=""><figcaption></figcaption></figure>

2. **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**.

   <figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2FvW5gLU26807VsWbke7Qy%2FZrzut%20ekranu%202025-06-13%20123459.png?alt=media&#x26;token=22622a55-a0eb-4a8f-828e-e056ad2b145b" alt=""><figcaption></figcaption></figure>

   * Z listy wybierz Data Extension, które zawiera kontakty mające wejść do Twojej ścieżki, i zatwierdź wybór.
3. 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.

{% hint style="info" %}
Powyższe kroki pokazują, jak rozpocząć korzystanie z naszej integracji. Aby uzyskać szczegółowe informacje na temat tworzenia, zarządzania i optymalizacji ścieżek w Journey Builder, zapoznaj się z [**oficjalną dokumentacją Salesforce Marketing Cloud**](https://help.salesforce.com/s/articleView?id=mktg.mc_jb_journey_builder.htm\&type=5).
{% endhint %}
{% endstep %}

{% step %}

### 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.
{% endstep %}
{% endstepper %}

{% hint style="info" %}

#### Ważne Uwagi i Rozwiązywanie Problemów

* **Dokładność Kluczy**: Pamiętaj aby odczekać kilka minut po wygenerowaniu nowych kluczy w panelu MessageFlow. Upewnij się, że wszystkie klucze i adresy URL są skopiowane dokładnie, bez dodatkowych spacji.&#x20;
* **Uprawnienia Pakietu**: Zawsze sprawdzaj, czy Twój Installed Package w SFMC ma wystarczające uprawnienia do operacji, które planujesz wykonać.
* **Testowanie**: Zawsze zaczynaj od testowych wysyłek do małej grupy, aby upewnić się, że integracja działa poprawnie.
  {% endhint %}