# 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.
---
# 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.md?ask=
```
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.