> For the complete documentation index, see [llms.txt](https://docs.messageflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.messageflow.com/pl/integracje/marketing-automation-and-enterprise/salesforce.md).
# Salesforce
*Połącz potęgę CRM z niezawodną wysyłką SMS*
Zintegruj platformę Salesforce z infrastrukturą MessageFlow, aby w pełni zautomatyzować komunikację mobilną ze swoimi klientami. Połączenie to umożliwia wysyłanie pojedynczych oraz masowych kampanii SMS bezpośrednio z poziomu Twojego CRM, wykorzystując dane zgromadzone w systemie.
## Przed rozpoczęciem
Do przeprowadzenia integracji niezbędne są dane uwierzytelniające z Twojego konta MessageFlow. Zaloguj się do panelu i wygeneruj odpowiednie klucze dostępowe, postępując zgodnie z poniższymi krokami:
1. Przejdź do sekcji **Konto -> Ustawienia -> API** w głównym panelu.
2. W polu wprowadzania danych wpisz wybraną nazwę klucza, a następnie kliknij przycisk **Generuj klucz API**.
3. System wygeneruje i wyświetli dwa unikalne parametry: **Application-Key** oraz **Authorization**.
Skopiuj wygenerowane klucze i przechowuj je w bezpiecznym miejscu.
{% hint style="warning" %}
**Uwaga dotycząca bezpieczeństwa**
Po przeładowaniu strony klucz służący do autoryzacji (*Authorization*) nie będzie już dostępny do podglądu i jego ponowne skopiowanie nie będzie możliwe. Wygenerowane dane stanowią poświadczenia dostępowe do infrastruktury wysyłkowej, dlatego nigdy nie udostępniaj ich osobom nieuprawnionym.
{% endhint %}
Do poprawnego działania wtyczki upewnij się również, że posiadasz co najmniej jedną zatwierdzoną nazwę nadawcy (SenderID). Domyślnie na koncie aktywny jest nadawca "SMS TEST". Instrukcję konfiguracji nowej nazwy znajdziesz w dokumentacji: [Nadawca SMS](/pl/sms/ustawienia-wspolne-sms/nadawca-sms.md#dodawanie-nowego-sender-id)
Dodatkowo pobierz i zainstaluj [aplikację MessageFlow](https://appexchange.salesforce.com/appxListingDetail?listingId=4205518a-bf77-4e59-b0dc-5de3855b84be) z oficjalnej platformy Salesforce AppExchange.
***
## Konfiguracja krok po kroku
### Część 1: Utworzenie External Client App w Salesforce
Autoryzacja wtyczki MessageFlow wymaga utworzenia dedykowanej aplikacji klienckiej wewnątrz Twojej instancji Salesforce.
1. Zaloguj się do Salesforce i z głównego menu wybierz ikonę zębatki, aby przejść do obszaru **Setup**.
2. W lewym panelu nawigacyjnym rozwiń sekcję **Platform Tools**, następnie **Apps** i wybierz **External Client Apps**.
3. Utwórz nową aplikację. W zakładce **Settings** w sekcji **Basic Information** uzupełnij pole **External Client App Name** oraz **Contact Email**. Zapisz ustawienia.
### Część 2: Konfiguracja uprawnień OAuth
Kolejnym krokiem jest zdefiniowanie uprawnień dostępu dla nowo utworzonej aplikacji.
1. Pozostań w widoku aplikacji klienckiej i przejdź do sekcji **OAuth Settings**.
2. W polu **Callback URL** wprowadź dokładny adres: `https://salesforce.messageflow.com/oauth`.
3. W sekcji **OAuth Scopes** odszukaj na liście i przenieś do kolumny wybranych uprawnień następujące pozycje:
* Access the identity URL service (id, profile, email, address, phone)
* Manage user data via APIs (api)
* Perform requests at any time (refresh\_token, offline\_access)
4. W sekcji **Flow Enablement** zaznacz opcję **Enable Client Credentials Flow**.
5. W sekcji Security zaznacz opcje **Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows** oraz **Enable Refresh Token Rotation**.
6. Zapisz konfigurację. Następnie kliknij przycisk **Consumer Key and Secret** widoczny na górze ekranu i skopiuj wygenerowany klucz (Client ID).
### Część 3: Połączenie we wtyczce MessageFlow
Ostatnim etapem jest sparowanie danych z obu systemów wewnątrz samej wtyczki.
1. Wyszukaj i uruchom aplikację **MessageFlow** w swoim menu głównym Salesforce (App Launcher).
2. Przejdź do zakładki **Configuration**.
3. W pierwszej sekcji **Connect** wklej przygotowane wcześniej dane ze swojego konta MessageFlow: **Authorization** oraz **Application-Key**. Zatwierdź przyciskiem **Change**.
4. W drugiej sekcji **Settings** wybierz z listy rozwijanej domyślną nazwę nadawcy w polu **Sender** (na przykład SMS TEST).
5. W polu **Access API Salesforce** wklej skopiowany wcześniej klucz **Client ID** i zapisz konfigurację, klikając **Save**.
***
### Kolejne kroki: Weryfikacja wysyłki
Aby upewnić się, że integracja funkcjonuje prawidłowo, przejdź do zakładki **Send SMS**. Wybierz nadawcę, wprowadź swój własny numer telefonu w polu **Recipient** oraz przykładową treść. Zaznacz opcję wysyłki **Immediately** i kliknij **Send**.
Status wysłanej wiadomości możesz natychmiast zweryfikować przechodząc do zakładki **Reports**, która wyświetla szczegółowe logi operacyjne bezpośrednio w interfejsie Salesforce.
***
## Funkcjonalności: Wysyłka z poziomu obiektów CRM
Po prawidłowym skonfigurowaniu integracji zyskujesz możliwość wysyłania wiadomości SMS bezpośrednio z kart poszczególnych obiektów w systemie Salesforce, takich jak Kontakty (Contacts), Potencjalni klienci (Leads) oraz Kampanie (Campaigns).
### Wysyłka z karty Kontaktu lub Leada
W widoku szczegółowym wybranego kontaktu po prawej stronie ekranu dostępny jest dedykowany komponent SMS Send. Pozwala on na szybką komunikację z daną osobą bez konieczności opuszczania jej profilu.
1. W polu **Sender** wybierz z listy autoryzowaną nazwę nadawcy.
2. W oknie **Text** wprowadź treść komunikatu.
3. Wykorzystaj zmienne personalizacyjne, aby automatycznie podstawić dane klienta z bazy CRM. Wtyczka obsługuje następujące tagi:
* {name} (imię i nazwisko)
* {firstname} (imię)
* {lastname} (nazwisko)
* {phone} (telefon stacjonarny/główny)
* {mobile} (telefon komórkowy)
* {email} (adres e-mail)
4. W sekcji **Sending date** określ preferowany czas wysyłki. Zaznacz opcję **Immediately**, aby wysłać wiadomość natychmiast, lub wybierz **At a specified time**, aby zaplanować ją na konkretną datę i godzinę.
5. Zatwierdź akcję, klikając przycisk **Send** pod formularzem.
### Wysyłka masowa z poziomu Kampanii
Analogiczny komponent **SMS Send** znajduje się w widoku szczegółów kampanii. Mechanika działania formularza jest identyczna jak w przypadku pojedynczych kontaktów.
Różnica polega na skali działania. Wysłana w ten sposób wiadomość trafi automatycznie do wszystkich rekordów przypisanych do danej kampanii (widocznych w sekcji Campaign Members). System samodzielnie podmieni parametry personalizacyjne dla każdego odbiorcy z osobna.