
# FluentCRM

> **Dla kogo jest to rozwiązanie?** Dla firm, które przechowują swoją listę mailingową we FluentCRM na własnej stronie WordPress i chcą, aby konwersacje ją zasilały. Jeśli nie korzystasz z FluentCRM, możesz pominąć tę stronę.
>
> Używasz innego systemu CRM lub narzędzia do e-mail marketingu? Każde narzędzie z API można podłączyć: zobacz [Łączenie z narzędziem, którego nie wymieniliśmy](connecting-other-tools.md).

FluentCRM to wtyczka CRM i e-mail marketingu działająca wewnątrz WordPressa: zarządza kontaktami, tagami, listami i wysyłanymi kampaniami. Połączenie jej z <span data-t="appName">DM Champ</span> dodaje do Twoich [automatyzacji](../automations/automations.md) kroki, które zapisują dane w systemie. Dzięki temu nowy lead z WhatsAppa staje się kontaktem we FluentCRM z odpowiednim tagiem, a stworzona przez Ciebie sekwencja e-mail przejmuje dalsze działania. Bez eksportowania, kopiowania i wklejania oraz czekania do piątku.

Na Twojej stronie WordPress nie jest instalowane żadne oprogramowanie. Łączysz swoją stronę za pomocą własnych danych logowania, a my wywołujemy API, które FluentCRM już udostępnia.

**Dostępność:** Automatyzacje są dostępne na każdym koncie. Znajdują się już na pasku bocznym i nie ma potrzeby niczego włączać ani o to prosić.

---

## Czego potrzebujesz

FluentCRM korzysta z REST API WordPressa, więc wymaga dokładnie tych samych danych, co połączenie z [WordPressem](wordpress.md):

- **Strona WordPress, na której działa FluentCRM**, dostępna przez **https**, z WordPressem w wersji **5.6 lub nowszej**.
- Włączone **ładne bezpośrednie odnośniki** (**Ustawienia → Bezpośrednie odnośniki**, dowolna opcja poza "Proste"), co sprawia, że adres `/wp-json/` działa.
- **Hasło aplikacji** dla użytkownika WordPressa, w imieniu którego ma działać automatyzacja: **Użytkownicy → Profil → Hasła aplikacji → Dodaj nowe**. WordPress wyświetla je tylko raz, w blokach oddzielonych spacjami. Skopiuj je wraz ze spacjami.

Ten użytkownik musi mieć uprawnienia do zarządzania FluentCRM w WordPressie. Twoje właściwe hasło logowania nigdy nie jest używane, a późniejsze usunięcie hasła aplikacji unieważnia dokładnie to połączenie.

---

## Łączenie z FluentCRM

Połączenie nawiązuje się z poziomu automatyzacji, przy pierwszym użyciu kroku FluentCRM.

1. Otwórz **Automatyzacje** na pasku bocznym (w grupie **AI Studio**) i otwórz lub utwórz automatyzację.
2. Dodaj krok i wyszukaj **FluentCRM** w selektorze kroków.
3. Wybierz żądaną akcję. Krok poprosi o wcześniejsze nawiązanie połączenia.
4. Wypełnij trzy pola:
   - **Adres URL strony** to adres strony WordPress, na której działa FluentCRM, zaczynający się od `https://`.
   - **Nazwa użytkownika WordPress** to nazwa użytkownika, za pomocą której loguje się ta osoba, a nie jej adres e-mail.
   - **Hasło aplikacji** to hasło utworzone powyżej, wklejone wraz ze spacjami.
5. Kliknij połącz.

Przed zapisaniem czegokolwiek sprawdzamy poprawność danych, odczytując jeden kontakt z FluentCRM. Błędne dane lub strona, na której `/wp-json/` nie działa, zostaną odrzucone z wyświetleniem przyczyny. Twoje hasło aplikacji jest przechowywane w formie zaszyfrowanej i nigdy nie jest ponownie wyświetlane.

---

## Tagi i listy są podawane jako identyfikatory (ID)

To jedyna rzecz, o której musisz wiedzieć, zanim zaczniesz cokolwiek budować. Każde pole, które przyjmuje tagi lub listy, wymaga podania ich **numerów ID** oddzielonych przecinkami, a nie ich nazw. `1, 2` działa; `Newsletter, VIP` nie działa.

Numery te znajdziesz we FluentCRM: otwórz **Tagi** lub **Listy** w menu FluentCRM, a identyfikator każdego wiersza będzie widoczny w pasku adresu po jego otwarciu. Zapisz kilka, których planujesz użyć, i gotowe.

---

## Akcje

Każda akcja to krok na kanwie automatyzacji, a każde pole akceptuje dane z wcześniejszych kroków za pomocą standardowych przycisków wstawiania danych.

### Utwórz lub zaktualizuj kontakt

Dodaje kontakt lub aktualizuje ten, który już posiada podany adres e-mail. Ponowne wysłanie tego samego adresu e-mail powoduje aktualizację zamiast błędu, więc możesz uruchamiać tę akcję dla każdego nowego leada bez wcześniejszego sprawdzania.

- **Email** to adres e-mail kontaktu. Wymagane. Zazwyczaj jest to adres e-mail kontaktu z wyzwalacza.
- **Imię**, **Nazwisko** oraz **Telefon** są opcjonalne.
- **Status** to `subscribed`, `pending`, `unsubscribed` lub `bounced`. Pozostawienie pola pustego oznacza `subscribed`.
- **Tag IDs** to tagi, które zostaną przypisane do kontaktu, oddzielone przecinkami. Opcjonalne.
- **List IDs** to listy, do których kontakt zostanie dodany, oddzielone przecinkami. Opcjonalne.

### Znajdź kontakt według adresu e-mail

Wyszukuje kontakt według adresu e-mail i zwraca jego identyfikator, tagi oraz listy.

- **Email** to adres, który ma zostać wyszukany. Wymagane.

Wynik tej akcji jest tym, czego potrzebują kolejne kroki, ponieważ operują one na identyfikatorze kontaktu.

### Dodaj tagi do kontaktu

Przypisuje jeden lub więcej tagów do istniejącego już kontaktu.

- **Contact ID** określa, którego kontaktu dotyczy akcja. Wymagane. Zazwyczaj pobierane z wcześniejszego kroku **Znajdź kontakt według adresu e-mail** w automatyzacji.
- **Email** to adres e-mail kontaktu. Wymagane, ponieważ FluentCRM wymaga adresu e-mail przy każdej aktualizacji.
- **Tag IDs** to tagi, które mają zostać przypisane, oddzielone przecinkami. Wymagane.
- **Status** jest opcjonalny i domyślnie ustawiony na `subscribed`.

### Usuń tagi z kontaktu

Te same pola, usuwające tagi zamiast je dodawać.

### Dodaj kontakt do list

- **Identyfikator kontaktu**, **Adres e-mail** oraz **Identyfikatory list** (oddzielone przecinkami), z tą samą opcjonalną wartością **Status**.

---

## Przykładowa automatyzacja

**Każdy nowy lead z WhatsApp trafia do FluentCRM i jest oznaczany tagiem na podstawie źródła pochodzenia.**

1. **Wyzwalacz:** przychodząca wiadomość od nowego kontaktu.
2. **Utwórz lub zaktualizuj kontakt**, podając adres e-mail, imię i numer telefonu kontaktu z wyzwalacza oraz **Identyfikator listy** Twojej głównej listy.
3. **Dodaj tagi do kontaktu** nie jest tutaj potrzebne, ponieważ krok 2 może już zawierać **Identyfikatory tagów**. Użyj tego kroku, gdy tag pojawia się później w trakcie rozmowy.

Oraz wersja, w której tag pojawia się później, co jest bardziej użytecznym rozwiązaniem:

1. **Wyzwalacz:** tag zostaje dodany do kontaktu, np. `asked about pricing`, przez Twojego agenta AI.
2. **Znajdź kontakt według adresu e-mail**, używając adresu e-mail kontaktu.
3. **Dodaj tagi do kontaktu**, używając identyfikatora z kroku 2, tego samego adresu e-mail oraz identyfikatora tagu FluentCRM dla Twojej sekwencji cennikowej.

Własna automatyzacja FluentCRM wysyła następnie sekwencję e-mail, którą uruchamia dany tag. Rozmowa odbywa się na WhatsApp, pielęgnowanie relacji (nurture) poprzez e-mail, a nikt nie musi ręcznie przenosić danych między nimi.

---

## Warto wiedzieć

- **Kroki wymagające identyfikatora kontaktu muszą następować po kroku wyszukiwania.** To standardowy schemat: znajdź kontakt, a następnie wykonaj działanie na identyfikatorze zwróconym przez krok wyszukiwania.
- **Dane wyjściowe są przekazywane dalej.** Wszystko, co zwraca dana akcja, jest dostępne dla kolejnych kroków jako zmienne.
- **Identyfikatory, nie nazwy,** dla każdego pola tagu i listy. Nazwa w tym polu po prostu nie będzie pasować.
- **Niektórzy dostawcy hostingu usuwają nagłówek Authorization** zanim dotrze on do WordPressa, co sprawia, że poprawne hasło aplikacji wygląda na błędne. Jeśli Twoje dane są na pewno poprawne, a połączenie nadal jest odrzucane, to jest to kwestia do wyjaśnienia z dostawcą hostingu.
- **Nie ma wyzwalacza, który monitoruje FluentCRM.** Nic nie odpytuje go o zmiany. Aby FluentCRM uruchomił automatyzację, dodaj wyzwalacz **Webhook** do automatyzacji i skieruj wychodzący webhook FluentCRM na adres, który otrzymasz.
- **Wszystko, czego nie ma na powyższej liście,** można nadal wykonać za pomocą kroku **Żądanie HTTP**.

---

## Następne kroki

- [Automatyzacje](../automations/automations.md): wyzwalacze, kroki, warunki i sposób tworzenia przepływu pracy.
- [WordPress](wordpress.md): wpisy i użytkownicy w tej samej witrynie, przy użyciu tych samych danych połączenia.
- [MemberPress](memberpress.md): członkostwa i płatności w Twojej witrynie WordPress.
- [Łączenie narzędzia, którego nie wymieniliśmy](connecting-other-tools.md): funkcje niestandardowe, API i webhooki.
