# 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="/files/k0Z9VRi99HLenOA82NnX" 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="/files/gZ4vrDiWY5OV6qqe1D0z" 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="/files/FyrebAWp9ELQxT1CXAGj" 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="/files/NSnkIFu1pQucwMcy707h" 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="/files/hmCJlsnvgUgnTMU8xVjY" 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="/files/jQ5ZubLW9hwpM5ehneb6" 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="/files/1IhHgYBn2ktH9GTjHG9J" 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="/files/5WZKFlNKaYyjcWn98jsM" 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="/files/Za00UQlCwAP2v9cCHPPO" 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](/pl/sms/ustawienia-wspolne-sms/nadawca-sms.md)
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="/files/i0DsoNjvHO2ajwcQpmvQ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/3Qqp3FeCmHev2WfehLHg" 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="/files/tZ3NNWiRd6lFKGm3Wzy6" 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.messageflow.com/pl/integracje/marketing-automation-and-enterprise/salesforce-marketing-cloud.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.